Automation Anywhere 설명서 읽기 및 검토

Automation Anywhere Automation 360

콘텐츠 닫기

콘텐츠

콘텐츠 열기

API를 실행하도록 bot 예약

  • 업데이트: 1/28/2021
    • Automation 360 v.x
    • 탐색
    • RPA 작업 영역

API를 실행하도록 bot 예약

bot이 무인 Bot Runner에서 한 번 또는 반복적으로 실행되도록 예약합니다.

전제 조건

주: Community Edition에서 Control Room APIs을 볼 수 있지만, API 기능은 제한됩니다. API의 전체 기능에 액세스하려면 라이선스가 인가된 Automation 360 에디션이 필요합니다.
  • 인증 API를 이용하여 JSON 웹 토큰을 생성합니다. 인증 API를 참고하십시오.
  • 다음 리소스가 할당되어 있어야 합니다.
    • 내 봇 보기 및 실행 기능 권한
    • bots이 포함된 폴더에 대한 실행 및 예약 권한
    • Bot Runner 라이선스가 부여된 사용자에 대한 액세스
    • 기본 기기 또는 기기 풀에 액세스합니다.
      주: Bot Runner 라이선스와 연계된 사용자가 자신의 계정에 지정된 기본 기기를 갖고 있는 경우, bot이 그 기기에 배포됩니다. 기본 기기가 지정되지 않았거나, 다른 기기를 선택하려면 기기 풀을 지정해야 합니다.

bot을 예약하려면 API에 다음과 같은 정보를 제공합니다.

매개변수 필수 사항 유형 설명
fileId 숫자 bot에 대한 식별자입니다. 작업 영역 API별로 파일 및 폴더 나열
runAsUserIds 숫자 Control Room무인 봇 러너로 등록된 사용자에 대한 식별자입니다.이용 가능한 무인 Bot Runners API 나열
poolIds 아니요 숫자 최소한 하나 이상의 활성 기기가 있는 기기 풀의 식별자입니다.
주: Bot Runner 라이선스와 연계된 사용자가 자신의 계정에 지정된 기본 기기를 갖고 있는 경우, bot이 그 기기에 배포됩니다. 기본 기기가 지정되지 않았거나, 다른 기기를 선택하려면 기기 풀을 지정해야 합니다.
기기 풀 API 나열

프로시저

  1. 요청 헤더에 인증 토큰을 추가합니다.
  2. POST 메소드 및 엔드포인트 URL(<control_room_url>/v1/schedule/automations)을 사용하십시오.
    요청 본문:
    이 요청 본문 예제에는 한 번 실행하도록 bot을 예약하는 데 필요한 매개변수가 포함되어 있습니다.
    {
       "name":"UpdateInventory.20.12.16.10.40.48",
       "fileId":"14277",
       "poolIds":[
          "27"
       ],
       "timeZone":"Asia/Calcutta",
       "runAsUserIds":[
          "472",
          "480",
          "80"
       ],
       "startDate":"2020-12-16",
       "startTime":"15:00",
       "scheduleType":"NONE"
       }
    이 요청 본문 예제에는 반복적으로 실행하도록 bot을 예약하는 데 필요한 매개변수가 포함되어 있습니다.
    {
       "name":"UpdateInventory.20.12.16.10.40.48",
       "fileId":"14277",
       "poolIds":[
          "27"
       ],
       "timeZone":"Australia/Melbourne",
       "runAsUserIds":[
          "1103",
          "36",
          "80"
       ],
       "startDate":"2020-12-16",
       "repeatOccurrence":{
          "endTime":"23:59",
          "runEvery":"1",
          "timeUnit":"HOURS"
       },
       "repeatEnabled":true,
       "endDate":"2020-12-24",
       "startTime":"20:45",
       "weeklyRecurrence":{
          "interval":"1",
          "daysOfWeek":[
             "TUE",
             "THU",
             "FRI"
          ]
       },
       "scheduleType":"WEEKLY"
    }
  3. 요청을 전송합니다.
    응답 본문: 이 두 개의 예제 응답에는 자동화에 대한 다음과 같은 정보가 포함되어 있습니다.
    • id: 자동화를 식별하는 숫자 값입니다. 자동화 업데이트 또는 자동화 API 삭제에서 이 매개변수를 사용합니다.
    • zonedNextRunDateTime: bot이 실행되도록 예약된 다음 번 날짜 및 시간입니다.
    이것은 한 번 실행하도록 예약된 bot에 대한 예제 응답입니다.
    {
        "id": "989",
        "name": "UpdateInventory.20.12.16.10.40.48",
        "fileId": "14277",
        "status": "ACTIVE",
        "deviceIds": [],
        "description": "",
        "rdpEnabled": false,
        "scheduleType": "NONE",
        "timeZone": "Asia/Calcutta",
        "startDate": "2021-12-16",
        "endDate": "",
        "startTime": "15:00",
        "repeatEnabled": false,
        "zonedNextRunDateTime": "2021-12-16T09:30:00Z",
        "createdBy": "1103",
        "createdOn": "2021-01-11T18:57:18.932407Z",
        "updatedBy": "1103",
        "updatedOn": "2021-01-11T18:57:18.932422Z",
        "tenantId": "1",
        "fileName": "appsheet",
        "filePath": "Automation Anywhere\\Bots\\appsheet",
        "runAsUserIds": [
            "480",
            "80",
            "472"
        ],
        "botInput": {},
        "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f",
        "poolId": [
            "11"
        ],
        "overrideDefaultDevice": false,
        "runElevated": false
    }
    이것은 반복적으로 실행하도록 예약된 bot에 대한 예제 응답입니다.
    {
        "id": "990",
        "name": "UpdateInventory.20.12.16.10.40.48",
        "fileId": "14277",
        "status": "ACTIVE",
        "deviceIds": [],
        "description": "",
        "rdpEnabled": false,
        "scheduleType": "WEEKLY",
        "weeklyRecurrence": {
            "interval": 1,
            "daysOfWeek": [
                "TUE",
                "THU",
                "FRI"
            ]
        },
        "timeZone": "Australia/Melbourne",
        "startDate": "2021-01-16",
        "endDate": "2021-12-24",
        "startTime": "20:45",
        "repeatEnabled": true,
        "repeatOccurrence": {
            "runEvery": "1",
            "timeUnit": "HOURS",
            "endTime": "23:59"
        },
        "zonedNextRunDateTime": "2021-01-19T09:45:00Z",
        "createdBy": "1103",
        "createdOn": "2021-01-11T18:59:31.182663Z",
        "updatedBy": "1103",
        "updatedOn": "2021-01-11T18:59:31.182669Z",
        "tenantId": "1",
        "fileName": "a_trigger",
        "filePath": "Automation Anywhere\\Bots\\a_trigger",
        "runAsUserIds": [
            "80",
            "36",
            "1103"
        ],
        "botInput": {},
        "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f",
        "poolId": [
            "7"
        ],
        "overrideDefaultDevice": false,
        "runElevated": false
    } 
    REST API는 HTTP 응답 코드를 이용하여 각 요청에 응답합니다. 응답 코드는 API 응답 코드를 참고하십시오.

다음 단계

자동화 일정 나열 API를 사용하여 예약된 모든 자동화에 대한 세부 정보를 검색합니다.
피드백을 보내주십시오