Resubmit Queue Item

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

Resubmit Queue Item

POST: /queue/resubmit/item

This method is used to resubmit an item to its queue. When an item is submitted again to the queue, both queue item and queue are affected.

Queue items can have the following statuses:

  • FINISHED_WARN: You can make changes to the queue item before resubmitting it. The previous processing finished but with warnings.
  • FINISHED_OK: You can't make changes to the queue item because it's finished being processed.
  • IN_PROCESS: You can't make changes to the queue item because it's currently being processed.
  • PENDING: It isn't recommended to make changes to the queue item before resubmitting it.
  • DISABLED: It isn't recommended to make changes to the queue item before resubmitting it.

Queues can have the following statuses:

  • PENDING
  • IN_PROCESS
  • FINISHED
  • RESERVED: You can't make changes to the queue.
  • CLOSED

After you resubmit a queue item, both the item's and the queue's status change to PENDING.

Request body

Parameter Example Required? Description
id "5da83220cabb54eb6f685eea" Yes Internal id of the queue item
key "testKey" No The item's key
reference "PENDING" No Item's state. Possible values are DISABLED, PENDING, IN_PROCESS, FINISHED_OK, FINISHED_WARN
remainingAttempts 10 No Number of remaining attempts
priority "HIGH" No Queue item's priority, possible values are HIGHEST, HIGHER, HIGH, NORMAL, LOW, LOWER, and LOWEST
functionalData {"a": "1", "b": "2","c": "3"} No Functional data associated with the queue item
labels ["11", "12"] No Permissions for the queue item

Example request body:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
   "id":"5da83220cabb54eb6f685eea",
   "key":"testKey",
   "reference":"PENDING",
   "remainingAttempts":10,
   "priority":"HIGH",
   "functionalData":{
      "a":"1",
      "b":"2",
      "c":"3"
   },
   "labels":[
      "11",
      "12"
   ]
}

Response

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

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

Element Example Data type Description
id "5cf8ec61deac351a6604fd74" String Internal id of the queue item
queueId "5cf8ec2adeac351a6604fd71" String Queue id to which the item belongs
queueName "nasdaq-queue-warnings-1attempt" String Queue name to which the item belongs
key "testKey" String key
reference   Array Array of data including details about the queues item's state
state "PENDING" String Item's state. Possible values are DISABLED, PENDING, IN_PROCESS, FINISHED_OK, FINISHED_WARN
duration 33 Integer Duration in milliseconds
lastExecutionResult - Array Array of data including details about the robotic process to last execute the queue and item, described below.
lastExecutionResult.id null String Internal id for the executed robotic process
lastExecutionResult.robotName "5e4a72abe18edacba723b298" String Robotic process name, immutable since creation
lastExecutionResult.robotId "5e4a72abe18edacba723b299" String Unique id for the executed robotic process
lastExecutionResult.executionNumber "1" Integer Execution number
lastExecutionResult.itemIndex 2 Integer Item index in this execution
lastExecutionResult.itemKey "jidoka" String Item key
lastExecutionResult.itemResult "OK" String Result
lastExecutionResult.itemSubResult null String Sub-result
lastExecutionResult.itemSubResultText null String Sub-result in text format
lastExecutionResult.itemResultDetail "jidoka" String Result details in text format
lastExecutionResult.properties "Time required": "0.33", "Number of results":"315000" Map Map of properties associated with the execution
lastExecutionResult.currentTimeMillis 1586870440301 String Time the queue items was processes, expressed in UNIX epoch time
lastExecutionResult.duration 3334 String Duration in milliseconds
lastExecutionResult.testing false Boolean Boolean indicating whether this execution was a test
remainingAttempts 9 Integer Number of remaining attempts
priority "HIGH" String Priority, possible values are HIGHEST, HIGHER, HIGH, NORMAL, LOW, LOWER, and LOWEST
executionResults "5da84a6bcabb54eb6f685f30" String List of executions where this queue item was processed
functionalData {"a": "1","b": "2","c": "3"} Array Functional data associated with the queue item
labels ["11", "12"] Array Permissions for this queue item
lastUpdatedTimestamp 1542807938000 String Date and time the queue item was last updated, expressed in UNIX epoch time
Units: milliseconds
createdTimestamp 1542807935990 String Date and time the queue item was created, expressed in UNIX epoch time
Units: milliseconds
lastNodeName "Machine 1" String Name of the resource to process the last queue item
lastNodeId "5dad800406938caad291b213" String Id of the resource to process the last queue item

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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
{
   "invocationResult":"OK",
   "result":{
      "lastUpdated":1627668581125,
      "errorMessage":null,
      "nextPageToken":null,
      "items":[
         {
            "id":"5cf8ec61deac351a6604fd74",
            "queueId":"5cf8ec2adeac351a6604fd71",
            "queueName":"nasdaq-queue-warnings-1attempt",
            "key":"testKey",
            "reference":[
               {
                  "state":"PENDING"
               }
            ],
            "duration":3334,
            "lastExecutionResult":[
               {
                  "id":null,
                  "robotName":"5e4a72abe18edacba723b298",
                  "robotId":"5e4a72abe18edacba723b299",
                  "executionNumber":"3",
                  "itemIndex":2,
                  "itemKey":"jidoka",
                  "itemResult":"OK",
                  "itemSubResult":null,
                  "itemSubResultText":null,
                  "itemResultDetail":"jidoka",
                  "properties":[
                     {
                        "Time required":"0.33",
                        "Number of results":"315000"
                     }
                  ],
                  "currentTimeMillis":1586870440301,
                  "duration":3334,
                  "testing":false
               }
            ],
            "remainingAttempts":4,
            "priority":"NORMAL",
            "executionResults":[
               "5cf8eef7deac351a6604fdcd",
               "5cf8ee7edeac351a6604fdbb"
            ],
            "functionalData":[
               {
                  "a":"1",
                  "b":"2",
                  "c":"3"
               }
            ],
            "labels":[
               "roleoperation"
            ],
            "lastUpdatedTimestamp":1561457843866,
            "createdTimestamp":1461457843868,
            "lastNodeName":"Machine 1",
            "lastNodeId":"5dad800406938caad291b213"
         }
      ]
   },
   "exceptionThrownText":null
}

Troubleshooting

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

  • None

This version of the Appian RPA documentation was written for Appian 21.4, and does not represent the interfaces or functionality of other Appian versions.
Open in Github Built: Fri, Nov 19, 2021 (11:59:11 AM)

On This Page

FEEDBACK