Get Robotic Process Items
This content applies solely to Appian RPA, which must be purchased separately from the Appian base platform.

Remember to include the appropriate authentication headers in your HTTP request message when using this method.

Get Robotic Process Items

POST: /robot/items

This method returns the list of items from one or more executions, when specified by executionId. If no executionId is specified, it returns all items processed within the date range.

Request body

The items to return must have been processed within the specified date range.

Parameter Example Required? Description
dateRange.start 1461457843868 Yes Date and time expressed in UNIX epoch time
Units: milliseconds
dateRange.end 1561457843866 Yes Date and time expressed in UNIX epoch time
Units: milliseconds
executionId "27" No Execution ID to filter the list of results.
pageSize 50 No The number of entries to return on each page of results. Acceptable values are between 1 and 250. 250 is the default.

Example request body:

1
2
3
4
5
6
7
8
{
    "dateRange" : {
            "start" : 1622505600000,
            "end" : 1625097599000
    },
    "executionId" : "27",
    "pageSize" : 50
}

Response

The call is successful if "invocationResult" = "OK".

The nextPageToken property is a token used to retrieve the next page of results. To use it, append the nextPageToken key and value to your original request body. The token is valid for 10 minutes and the response keeps generating a new nextPageToken as long as there are more results to retrieve. Each subsequent request should use the nextPageToken sent back in the previous response. When nextPageToken is null in the response, the current page is the last one and there are no more entries to retrieve.

The following elements are provided in the result.items key.

Element Example Data type Description
id null Integer Internal id for the executed robotic process
robotName "5e4a72abe18edacba723b298" String Robotic process name, immutable since creation
robotCustomName "robot-developmentguide-queues-search" String Robotic process human-readable name
robotId "5e4a72abe18edacba723b299" String Unique id for the executed robotic process
executionNumber 1 Integer Execution number
executionId "27" Integer Execution id
itemIndex 2 Integer Item index in this execution
itemKey "item1" String Item key
itemResult "OK" String Result
itemSubResult null String Sub-result
itemSubResultText null String Sub-result in text format
itemResultDetail "" String Result details in text format
properties "Time required": "0.33", "Number of results":"315000" Map Map of properties associated with the execution
currentTimeMillis 1586870440301 String Time the queue items was processed, expressed in UNIX epoch time
Units: milliseconds
duration 3334 String The length of time it took to process the item
Units: milliseconds
testing false String Boolean indicating whether this execution was a test

Example response body:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
{
   "invocationResult":"OK",
   "result":{
      "lastUpdated":1627668581125,
      "errorMessage":null,
      "nextPageToken":null,
      "items":[
         {
            "id":null,
            "robotName":"5e4a72abe18edacba723b298",
            "robotCustomName":"robot-developmentguide-queues-search",
            "robotId":"5e4a72abe18edacba723b298",
            "executionNumber":1,
            "executionId":"27",
            "itemIndex":2,
            "itemKey":"item2",
            "itemResult":"OK",
            "itemSubResult":null,
            "itemSubResultText":null,
            "itemResultDetail":null,
            "properties":[
               {
                  "Time required":"0.33",
                  "Number of results":"315000"
               }
            ],
            "currentTimeMillis":1586870440301,
            "duration":3334,
            "testing":false
         }
      ]
   },
   "exceptionThrownText":null
}

Troubleshooting

Possible reasons calls may be unsuccessful ("invocationResult" = "KO"):

  • None
Open in Github Built: Wed, Aug 17, 2022 (01:05:05 PM)

On This Page

FEEDBACK