Lesen und beachten Sie die Automation Anywhere-Dokumentation

Automation 360

Inhalt schließen

Inhalte

Inhalt öffnen

Auflisten von Dateien und Ordnern in einem bestimmten Ordner API

  • Aktualisiert: 2021/01/26
    • Automation 360 v.x
    • Verwalten
    • RPA Workspace
    • API-Dokumente

Auflisten von Dateien und Ordnern in einem bestimmten Ordner API

Gibt Details über Objekte (bots, Ordnern und Dateien) in einem bestimmten übergeordneten Ordner. Dieser Endpunkt gibt das Objekt idzurück, die ein numerischer Wert ist, der in anderen APIs verwendet wird, um die Datei, den Ordner oder bot.

Vorbereitungen

Anmerkung: Sie können die Control Room APIs in der Community Editionaber die API-Funktionalität ist begrenzt. Sie benötigen eine lizenzierte Automation 360 Edition, um die volle Funktionalität der APIs nutzen zu können.
  • Alle API-Aufrufe müssen ein Authentifizierungs-Token in der Kopfzeile der Anfrage enthalten. Verwenden Sie die Authentifizierung API, um ein JSON-Web-Token zu erzeugen. Einzelheiten finden Sie unter Authentifizierungs-API.
  • Um Objekte in Ihrem privaten Arbeitsbereich zu sehen, müssen Sie über eine Bot Creator Lizenz und eine Rolle haben, die die Option Meine Bots anzeigen Berechtigung enthält.
  • Um Objekte im öffentlichen Arbeitsbereich anzuzeigen, muss Ihnen eine Rolle zugewiesen werden, die die Option Meine Bots anzeigen und die Berechtigung Inhalt anzeigenbot Berechtigung für Ordner im öffentlichen Arbeitsbereich enthält.
  • Sie benötigen die Ordner-ID für den Ordner, in dem Sie suchen möchten. Verwenden Sie eine der folgenden Repository Management APIs, um die Objekt-ID abzurufen:

Das Beispiel in dieser Aufgabe sucht nach Unterordnern, die die Zeichenfolge Finanzen.

Prozedur

  1. Fügen Sie das Authentifizierungs-Token in die Kopfzeile der Anfrage ein.
  2. Verwenden Sie die POST-Methode und die Endpunkt-URL: <control_room_url>/v2/repository/folders/{folderId}/list
    {OrdnerId} ist die Objekt-ID des Ordners, in dem Sie suchen möchten.
    Körper der Anfrage: Die folgende Beispielanfrage sucht nach Ordnern, die das Wort Finanzen im Namen enthalten.
    {
      "filter": {
        "operator": "and",
        "operands": [
          {
            "operator": "substring",
            "field": "name",
            "value": "finance"
          },
          {
            "operator": "eq",
            "field": "folder",
            "value": "true"
          }
        ]
      }
    }

    Unterstützte filterbare Felder

  3. Senden Sie die Anforderung.
    Antworttext: Bei einer erfolgreichen Anfrage gibt dieser Endpunkt die folgenden Daten zurück:
    • idid: ein eindeutiger numerischer Bezeichner für das Objekt, das den Suchparametern entspricht.
    • parentId: ein eindeutiger numerischer Bezeichner für den übergeordneten Ordner.
    • Ordner: ein boolescher Wert, der true zurückgibt, wenn das Objekt ein Ordner ist und false ist, wenn es sich um eine bot oder eine andere Datei ist.
    In dieser Beispielantwort gibt der Endpunkt einen Ordner mit dem Objekt id von 40378 zurück.
    {
      "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
        }
      ]
    }
Verwenden Sie den numerischen Bezeichner, wie z. B. eine id in nachfolgenden APIs.
Feedback senden