閱讀及檢閱 Automation Anywhere 文件

Automation 360

關閉內容

內容

開啟內容

Bot Deploy

  • 已更新:2022/04/07
    • Automation 360 v.x
    • 最佳化
    • RPA 工作區
    • API 文件

Bot Deploy

As a user with a Bot Runner license, deploy bots on your assigned devices. You can also pass variables to bots when they are deployed.

Request

POST https://{{ControlRoomURL}}/v3/automations/deploy
Header: X-Authorization <<authentication token>>
使用 驗證 API 來產生 JSON Web Token 。
Request body with LIST input:
{
  "fileId": 86, 
  "runAsUserIds": [
    3 
  ],
  "poolIds": [],
  "overrideDefaultDevice": false,
  "callbackInfo": {
    "url": "https://callbackserver.com/storeBotExecutionStatus", 
    "headers": {
      "X-Authorization": "{{token}}" 
    }
  },
  "botInput": { 
    "iTestList": {
      "type": "LIST", //Type can be [ STRING, NUMBER, BOOLEAN, LIST, DICTIONARY, DATETIME ]
     "list": [
        { "type":"STRING",
         "string": "TestValues1" 
    },
     { "type":"STRING",
         "string": "TestValues2" 
    }
     ] //key must match type, in this case string
    }
  }
}
Request body with STRING input:
{
  "fileId": 87,
  "runAsUserIds": [
    3 
  ],
  "poolIds": [],
  "overrideDefaultDevice": false,
  "callbackInfo": {
    "url": "https://callbackserver.com/storeBotExecutionStatus", 
    "headers": {
      "X-Authorization": "{{token}}" 
    }
  },
  "botInput": { 
    "sInput1": {
      "type": "STRING", 
      "string": "Test Values1" 
    },
    "sInput2": {
      "type": "STRING",
      "string": "Test Values2"
    }
  }
}
Request body with DICTIONARY input:
{
  "fileId": 86, 
  "runAsUserIds": [
    3 
  ],
  "botInput": { 
    "iTestList": {
      "type": "DICTIONARY", //Type can be [ STRING, NUMBER, BOOLEAN, LIST, DICTIONARY, DATETIME ]
     "dictionary": [
         {
            "key":"key1",
            "value":{
               "type":"STRING",
               "string":"value1"
            }
         },
         {
            "key":"key2",
            "value":{
               "type":"STRING",
               "string":"value2"
            }
         }
      ] //key must match type, in this case string
    }
  }
}
Request body with DATE TIME input:
{
  "fileId": 87,
  "runAsUserIds": [
    3 
  ],
  "botInput": { 
    "dt_input": {
      "type": "DATETIME", 
      "string": "2022-04-07T00:15:00-06:00[USA/New York]" 
    },
    "dt_input": {
      "type": "DATETIME",
      "string": "2022-04-07T00:15:05-06:00[USA/New York]"
    }
  }
}

Request Parameters

Parameter Type Required Description
fileId Integer Yes File Id of bot to be deployed.

按工作空間 API 列出文件和文件夾

automationName String No Name of the automation to be deployed.
runAsUserIds Integer Yes List of runAs user ids to deploy bot. The bot will be deployed on associated default device for each runAsUserIds or on one of the devices from the device pool(s), if provided.

列出可用的無人值守 Bot Runners API

callbackInfo Object No CallbackInfo Provides the callback API URL and authentication token for the callback server. After the bot is deployed, the Control Room sends the deployment status and output variable values to this callback server.
poolIds Integer No Identifier of a device pool that has at least one active device. If you enter multiple pool IDs, enter the values in the order of which you want the API to check for available devices. If none of the devices are available at the time of deployment, the automation is queued.
Note: 如果與 Bot Runner 許可證關聯的用戶具有分配給其帳戶的默認設備,則 bot 會在該設備上部署。如果未指定默認設備,或者要選擇其他設備,則必須指定設備池。

列出設備池 API

overrideDefaultDevice Boolean No If the Bot Runner user is assigned to a default device and you want to specify a device pool, set this parameter to true.

If deploying to the default device, set this parameter to false.

runElevated Array No Whether to deploy the bot using elevated permissions or not. Possible values include - false, true.
numOfRunAsUsersToUse Integer No Specifies how many Bot Runners to use from the list of runAsUserIds provided. A weighted system algorithm selects the Bot Runners with the least number of queued tasks.
  • System will pick the specified number of runAsUsers with the least number of tasks queued for the user at the moment of deploy request.
  • If 0 then all the users will be used.
  • If the number is greater than the number of runAsUsers provided or less than 0 it will error out.
automationPriority String No The automation Priority. By default it is set to PRIORITY_MEDIUM. Possible values for automationPriority includes: PRIORITY_MEDIUM, PRIORITY_HIGH, and PRIORITY_LOW.
botLabel String No Label for the bot to be deployed.
botInput Object No A data structure containing a botInput Object. See below for more details.
botInput Object
type* String No By default it is STRING. Possible values for type includes: STRING, NUMBER, BOOLEAN, FILE, ITERATOR, LIST, DICTIONARY, TABLE, VARIABLE, CONDITIONAL, WINDOW, TASKBOT, DATETIME, UIOBJECT, RECORD, EXCEPTION, CREDENTIAL, COORDINATE, IMAGE, REGION, PROPERTIES, TRIGGER, CONDITIONALGROUP, FORM, FORMELEMENT, HOTKEY, and WORKITEM.
*The structure of the input varies depending on the type you want to input. This topic provides you with few of the mostly used sample.

Response

200 OK

For more information on the return codes, see API 回應碼.

{
    "deploymentId": "340a2949-aa44-41ab-af9b-f9343ae2581c"
}

Response Parameters

Parameter Type Description
deploymentId Integer The deployment Id created.
Note: 您可以在中查看, Control Room APIs Community Edition但 API 功能受限。您需要授權 Automation 360 版本才能存取 API 的完整功能。
REST API 會以 HTTP 回應碼回應每個要求。 有關響應代碼,請參閱 API 回應碼
傳送意見反饋