Automation Anywhere 설명서 읽기 및 검토

Automation Anywhere Automation 360

콘텐츠 닫기

콘텐츠

콘텐츠 열기

bots 배포 API

  • 업데이트: 2/01/2021
    • Automation 360 v.x
    • 관리
    • RPA 작업 영역

bots 배포 API

Bot Runner 라이선스가 있는 사용자로서 지정된 기기에 bots을 배포합니다. 또한 bots을 배포할 때 봇에 변수를 전달할 수도 있습니다.

전제 조건

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

bot을 배포하고 변수 값을 bot에 전달하려면 API에 다음 정보를 제공합니다.

매개변수 필수 유형 설명
필드 숫자 배포할 bot의 식별자.

작업 영역 API별로 파일 및 폴더 나열

runAsUserIds 숫자 Control Room무인 봇 러너로 등록된 사용자에 대한 식별자입니다.

이용 가능한 무인 Bot Runners API 나열

poolIds 아니요 숫자 최소한 하나 이상의 활성 기기가 있는 기기 풀의 식별자입니다.
주: Bot Runner 라이선스와 연계된 사용자가 자신의 계정에 지정된 기본 기기를 갖고 있는 경우, bot이 그 기기에 배포됩니다. 기본 기기가 지정되지 않았거나, 다른 기기를 선택하려면 기기 풀을 지정해야 합니다.

기기 풀 API 나열

overrideDefaultDevice 아니요 부울 Bot Runner 사용자가 기본 기기에 지정되어 있는 상태에서 기기 풀을 지정하려면 이 매개변수를 true로 설정하십시오.

기본 기기로 배포하는 경우, 이 매개변수를 false로 설정합니다.

botInput 아니요 다양함 입력 변수 이름, 값 및 데이터 유형을 지정합니다.
numOfRunAsUsersToUse 아니요 숫자 runAsUserIds 목록에서 이용할 Bot Runners의 수를 지정합니다. 가중 시스템 알고리즘은 대기열에 있는 태스크 수가 가장 적은 Bot Runners를 선택합니다.
callbackInfo 아니요 객체 콜백 서버에 대한 URL 및 인증 토큰을 제공합니다. bot이 배포된 후 Control Room에서 배포 상태 및 출력 변수 값을 이 콜백 서버로 보냅니다.

프로시저

  1. 요청 헤더에 인증 토큰을 추가합니다.
  2. POST 메소드 및 엔드포인트 URL 이용: <your_control_room_url>/v3/automations/deploy.

    요청 본문:

    이 예시 요청 본문은 필요한 매개변수와 입력 변수에 대한 값을 지정합니다.
    {
      "fileId": 14277,
      "runAsUserIds": [
        2538
      ],
      "botInput": {
        "sDocHello": {
          "type": "STRING",
          "string": "Hello world, go be great."
        }
      }
    }
    이 예시 요청 본문에서는 4개의 runAsUserIds와 2개의 numberOfRunAsUsersToUse를 지정합니다. 가중 알고리즘은 배포 요청 당시 대기열에 있는 작업 수가 가장 적은 두 개의 Bot Runners를 선택합니다.
    {
      "fileId": 14277,
      "runAsUserIds": [
        2538,
        4256,
        2213,
        789
      ],
       "poolIds": [
        27
      ],
      "numOfRunAsUsersToUse": 2
    }
    이 예시 요청 본문에서는 overrideDefaultDevicetrue로 설정되어 있어서 bot은 Run-as user의 사용자의 기본 기기 대신 기기 풀에 배포됩니다. 이 예시에는 콜백 서버 URL을 지정하고 인증을 제공하는 구문도 포함되어 있습니다.
    {
      "fileId": 14277,
      "runAsUserIds": [
        245
      ],
       "poolIds": [
        27
      ],
      "overrideDefaultDevice": true,
      "callbackInfo": {
        "url": "https://callbackserver.com/storeBotExecutionStatus",
        "headers": {
          "X-Authorization": "eyJhbGciOiJSUzUxMiJ9.eyJzdWIiOiI0Ii"
        }
      }
    }
  3. 요청 전송.

    응답 본문:

    성공하면 Bot 배포 API는 deploymentId 이용하여 응답을 반환합니다.
    {
      "deploymentId": "14c2b6f8-c2a0-4a57-959d-ef413df0d179"
    }
    REST API는 HTTP 응답 코드를 이용하여 각 요청에 응답합니다. 응답 코드는 API 응답 코드를 참고하십시오.

다음 단계

다음 작업을 수행하십시오: 봇 배포 상태 요청 API.

피드백을 보내주십시오