閱讀及檢閱 Automation Anywhere 文件

Automation Anywhere Automation 360

關閉內容

內容

開啟內容

列出特定文件夾 API 中的文件和文件夾

  • 已更新:2021/01/26

    列出特定文件夾 API 中的文件和文件夾

    返回bots有關特定父文件夾中對象(、文件夾和文件)的詳細信息。此端點返回對象 ID,該 ID 是在其他 API 中用於標識文件、文件夾或 bot的數值。

    先決條件

    註: 您可以在中查看, Control Room APIs Community Edition但 API 功能受限。您需要授權 Automation 360 版本才能存取 API 的完整功能。
    • 使用 驗證 API 來產生 JSON Web Token 。
    • 若要檢視私人工作區中的物件、您必須擁有 Bot Creator 授權和角色、其中包含 「檢視我的機器人程式 」功能權限。
    • 若要檢視公用工作區中的物件、您必須指派一個角色、其中包含 檢視我的機器人程式 功能權限、 以及檢視 bot 公用工作區中資料夾的內容權限。
    • 您需要您要搜尋的資料夾的資料夾 ID 。 使用以下系統信息庫管理 API 之一檢索對象 ID :

    此任務中的示例搜索包含字符串 finance 的子文件夾

    程序

    1. 將驗證令牌添加到請求標頭。
    2. 使用 POST 方法和端點 URL :<control_room _url>/v2/repository/folders/{folderId}/list
      { folderId } 是您要搜尋之資料夾的物件 ID 。
      要求本文:以下示例請求搜索 名稱中包含單詞 finance 的文件夾。
      {
        "filter": {
          "operator": "and",
          "operands": [
            {
              "operator": "substring",
              "field": "name",
              "value": "finance"
            },
            {
              "operator": "eq",
              "field": "folder",
              "value": "true"
            }
          ]
        }
      }

      支持的可過濾字段

    3. 發送請求。
      響應主體:在成功的請求中,此端點返回以下數據:
      • ID:與搜索參數匹配的對象的唯一數字標識符。
      • parentId:父文件夾的唯一數字標識符。
      • 文件夾:布爾值, 如果對象是文件夾則返回 true , 如果是 bot 或其他文件則返回 false 。
      在此範例回應中 , 端點會傳回 物件識別碼為 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
          }
        ]
      }
    使用數字標識符,如 後續 API 中的 ID 。
    傳送意見反饋