Leggi e rivedi la documentazione di Automation Anywhere

Automation 360

Chiudi contenuti

Contenuti

Apri contenuti

Elencare i file e le cartelle di una cartella specifica API

  • Aggiornato: 2021/01/26
    • Automation 360 v.x
    • Gestisci
    • Spazio di lavoro RPA
    • Documenti API

Elencare i file e le cartelle di una cartella specifica API

Restituisce i dettagli sugli oggetti (bots, cartelle e file) in una specifica cartella padre. Questo endpoint restituisce l'oggetto idche è un valore numerico utilizzato in altre API per identificare il file, la cartella o l'oggetto. bot.

Prerequisiti

Nota: È possibile visualizzare il Control Room APIs nel file Community Editionma le funzionalità dell'API sono limitate. È necessario disporre di una licenza Automation 360 Edition per accedere a tutte le funzionalità delle API.
  • Tutte le chiamate API devono contenere un token di autenticazione nell'intestazione della richiesta. Usare la funzione Autenticazione per generare un token web JSON. Vedi API di autenticazione.
  • To view objects in your private workspace, you must have a Bot Creator license and a role that includes the View my bots feature permission.
  • To view objects in the public workspace, you must be assigned a role that includes the View my bots feature permission and the View content bot permission to folders in the public workspace.
  • È necessario l'ID della cartella in cui si desidera effettuare la ricerca. Utilizzare una delle seguenti API di gestione del repository per recuperare l'ID dell'oggetto:

L'esempio di questo task cerca le sottocartelle che contengono la stringa finanza.

Procedura

  1. Aggiungere il token di autenticazione all'intestazione della richiesta.
  2. Utilizzare il metodo POST e l'URL dell'endpoint: <control_room_url>/v2/repository/folders/{folderId}/list
    {folderId} è l'ID oggetto della cartella in cui si desidera effettuare la ricerca.
    Corpo della richiesta: La seguente richiesta di esempio cerca le cartelle che contengono la parola finanza nel nome.
    {
      "filter": {
        "operator": "and",
        "operands": [
          {
            "operator": "substring",
            "field": "name",
            "value": "finance"
          },
          {
            "operator": "eq",
            "field": "folder",
            "value": "true"
          }
        ]
      }
    }

    Campi filtrabili supportati

  3. invia la richiesta.
    Corpo della risposta: In caso di richiesta andata a buon fine, questo endpoint restituisce i seguenti dati:
    • id: un identificatore numerico unico per l'oggetto che corrisponde ai parametri di ricerca.
    • parentId: un identificatore numerico univoco per la cartella padre.
    • cartella: un valore booleano che restituisce vero se l'oggetto è una cartella e falso se è un file bot o un altro file.
    In questo esempio di risposta, l'endpoint restituisce una cartella con l'oggetto id di 40378.
    {
      "page": {
        "offset": 0,
        "total": 329,
        "totalFilter": 1
      },
      "list": [
        {
          "id": "40378",
          "parentId": "2",
          "name": "EOD-finance-reports",
          "path": "Automation Anywhere\\Bots\\APAC\\EOD-finance-reports",
          "description": "",
          "type": "application/vnd.aa.directory",
          "size": "0",
          "folder": true,
          "folderCount": "0",
          "productionVersion": "",
          "latestVersion": "",
          "locked": false,
          "lockedBy": "0",
          "createdBy": "2587",
          "lastModifiedBy": "2587",
          "lastModified": "2020-09-02T05:26:51.162916Z",
          "permission": {
              "delete": true,
              "download": false,
              "upload": false,
              "run": true,
              "publishBotstore": false,
              "viewContent": true,
              "clone": false,
              "editContent": true,
              "createFolder": true,
              "move": true,
              "cancelCheckout": false,
              "revertCheckout": false
        },
          "workspaceId": "0",
          "botStatus": "DRAFT",
          "hasErrors": false,
          "workspaceType": "UNKNOWN",
          "metadata": false,
          "uri": "",
          "version": "0",
          "hasTriggers": false
        }
      ]
    }
Usare l'identificatore numerico, come ad esempio un id nelle API successive.
Invia feedback