Automation Anywhere 설명서 읽기 및 검토

Automation Anywhere Automation 360

콘텐츠 닫기

콘텐츠

콘텐츠 열기

특정 폴더 API에 있는 파일 및 폴더 나열

  • 업데이트: 1/26/2021
    • Automation 360 v.x
    • 관리
    • RPA 작업 영역
    • API 문서

특정 폴더 API에 있는 파일 및 폴더 나열

특정 상위 폴더에 있는 객체(bots, 폴더 및 파일)에 대한 세부정보를 반환합니다. 이 엔드포인트는 파일, 폴더 또는 bot을 식별하기 위해 다른 API에서 이용되는 숫자 값인 객체 id를 반환합니다.

전제 조건

주: Community Edition에서 Control Room APIs을 볼 수 있지만, API 기능은 제한됩니다. API의 전체 기능에 액세스하려면 라이선스가 인가된 Automation 360 에디션이 필요합니다.
  • 인증 API를 이용하여 JSON 웹 토큰을 생성합니다. 인증 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: 상위 폴더에 대한 고유 숫자 식별자입니다.
    • 폴더: 객체가 폴더인 경우 true를 반환하고 bot 또는 다른 파일인 경우 false를 반환하는 부울 값.
    이 예시 응답에서 엔드포인트는 객체 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와 같은 숫자 식별자를 이용합니다.
피드백을 보내주십시오