阅读和查看 Automation Anywhere 文档

Automation Anywhere Automation 360

关闭内容

内容

打开内容

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

  • 已更新:1/26/2021
    • Automation 360 v.x
    • 管理
    • RPA 工作区
    • API 文档

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

返回特定父文件夹中有关对象(bots、文件夹和文件)的详细信息。此端点返回对象 ID,这是在其他 API 中用于标识文件、文件夹或 bot 的数值。

先决条件

注: 您可以在 Control Room APIs 中查看 Community Edition,但 API 功能有限。您需要获得许可证的 Automation 360 Edition 才能访问 API 的全部功能。
  • 使用身份验证 API 生成 JSON Web 令牌。请参阅身份验证 API
  • 要查看您私有工作空间中的对象,您必须具有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:父文件夹的唯一数字标识符。
    • folder:一个布尔值,如果对象是文件夹,则返回 true,如果是 或其他文件,则返回 falsebot
    在本示例响应中,此端点返回的对象 ID 为 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
发送反馈