Automation Anywhere 설명서 읽기 및 검토

Automation Anywhere Automation 360

콘텐츠 닫기

콘텐츠

콘텐츠 열기

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

  • 업데이트: 2021/01/26

    특정 폴더 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와 같은 숫자 식별자를 이용합니다.
    피드백을 보내주십시오