More importantly the format will be different to successful items (which could complicate reporting). Admittedly, we could utilise the ‘Reason’ and the ‘Details’ fields, but it is quite cumbersome. Sometimes one may wish to provide output data for further analysis even if the item has failed (or an array of information for items that have failed). However, there are specific scenarios where the standard functionality is insufficient: if an item has failed, one can provide information about why the item has failed in the ‘Reason’ and the ‘Details’ fields. the progress is inherited if the item is postponed (since 19.10), the progress is inherited if the item is retried (since 19.10), If an item is successful, we can provide additional data that was gathered during processing in the output data and analytics data containers, The standard functionality is often enough for almost everything: Hence it is useful to have as much control over QueueItems as possible. Thus, Queues and QueueItems can be used for reporting (similarly to how UiPath Insights works). The QueueItem’s Specific Data container usually contains all the relevant input information and the QueueItem updates once the robot has finished processing it. Queues are used in the process: a list of work items are created, and the robot (or robots if there were multiple dispatchers) work their way through these items (one-by-one in an iterative fashion). Most enterprise RPA solutions follow a transactional or iterative design. Now that one is able to call these APIs with a robot, our attention can turn to the second question. Any of the listed APIs can be called: one should only be mindful to grant sufficient access rights to the robot’s user to allow it to make these calls. Authentication is handled by the activity itself (the call authenticates in the name of the robot that the process is being executed on) - it is a fairly simple way of calling a UiPath.WebAPI. The parameters are a serialised JSON payload (string) and one of the endpoints listed on the swagger site. These APIs can also be called with a robot using the Orchestrator HTTP Request activity. The latter would be a good choice since UiPath has provided a full Postman library with worked examples ( ). These APIs can be pinged from the swagger UI, but one may call these APIs with any suitable tool: SoapUi, Postman etc. OData will not be elaborated on, as it is outside of the scope of this blogpost, however there is a thorough documentation for all who are interested. A second one – containing the token, which authenticates the call - to perform the desired task. (One will need only their Orchestrator credentials for this).Ģ. A first call to authenticate, and to retrieve a bearer token. The easiest way to navigate to this page would be by writing “/swagger” at the end of Orchestrator’s URL (e.g: UiPath.WebAPI is based on the OData protocol (RESTful API), thus two calls are needed to perform any task:ġ. The first two questions will be covered in this post.Ī list of all available Orchestrator API endpoints can be found by navigating to its swagger page. How can these APIs be used to integrate Orchestrator with other systems? How can these APIs be used to automate deployment and ease operation?Ĥ. How can these APIs be used to enhance processes?ģ. How can an Orchestrator APIs be called - in general?Ģ. The topic will be split over two posts, and it will attempt to answer the following questions:ġ. Most “standard” Orchestrator related knowledge and queue related knowledge will be assumed ( ). In this blog post, the discussion will be around Orchestrator and more specifically how Orchestrator’s API endpoints can be used. Orchestrator – as a component of UiPath’s automation tool - is the team leader, that provides this much needed leadership. In this sense, a digital workforce is no different to our own: it requires guidance to function efficiently. While fish and birds rely much on their instincts for anything they do, group-work or group-organisation (for humans) tends to require leadership. One may find watching a school of fish (or a flock of birds) profoundly entertaining: the movement of these bodies is reminiscent of well-choreographed dances – it is a spectacular sight.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |