Leggi e rivedi la documentazione di Automation Anywhere

Automation Anywhre Automation 360

Chiudi contenuti

Contenuti

Apri contenuti

Elencare file e cartelle in una specifica cartella API

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

Elencare file e cartelle in una specifica cartella API

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

Prerequisiti

Nota: Puoi visualizzare in Control Room APIs, ma Community Edition la funzionalità API è limitata. È necessaria Automation 360 un'edizione con licenza per accedere alla funzionalità completa delle API.
  • Utilizza l'API di autenticazione per generare un token Web JSON. Vedere API di autenticazione.
  • Per visualizzare gli oggetti nel workspace privato, è necessario disporre di una Creatore di bot licenza e di un ruolo che include l'autorizzazione della funzionalità View my bots (Visualizza i miei bot).
  • Per visualizzare gli oggetti nel workspace pubblico, devi essere assegnato a un ruolo che include l'autorizzazione della funzione View my bots (Visualizza i miei bot) e l'autorizzazione View content (botVisualizza contenuto) alle cartelle nel workspace pubblico.
  • È necessario l'ID cartella per la cartella in cui si desidera effettuare la ricerca. Utilizzare una delle seguenti API di gestione del repository per recuperare l'ID oggetto:

L'esempio in questa attività cerca le sottocartelle che contengono la stringa finanziaria.

Procedura

  1. Aggiungere il token di autenticazione all'intestazione della richiesta.
  2. Utilizzare il metodo POST e l'URL dell'endpoint: <control_room_url>/{folderId}v2/repository/folders//list
    {folderId} è l'ID oggetto della cartella in cui si desidera eseguire la ricerca.
    Corpo della richiesta: La richiesta di esempio seguente 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. Inviare la richiesta.
    Corpo della risposta: In una richiesta riuscita, questo endpoint restituisce i seguenti dati:
    • id: un identificatore numerico univoco per l'oggetto che corrisponde ai parametri di ricerca.
    • parentId: un identificatore numerico univoco per la cartella padre.
    • folder: un valore booleano che restituisce true se l'oggetto è una cartella e false se è un file bot o un altro file .
    In questa risposta di esempio, l'endpoint restituisce una cartella con l'ID oggetto 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
        }
      ]
    }
Utilizza l'identificatore numerico, ad esempio un ID nelle API successive.
Invia feedback