In questo evento tratteremo l'utilizzo delle WebApi messe a disposizione da UiPath per interfacciarsi con Orchestrator. Un focus sulla documentazione e qualche piccolo esempio di utilizzo ed integrazione. 📕 Ordine del giorno - Come collegarsi e ottenere un token di autenticazione - Come effettuare le chiamate di GET o POST - Qualche integrazione utile tra API e altre applicazioni 👨‍💻 Flavio Martinelli, UiPath Rome Chapter Leader, Head of Automation @Nethex 👨‍💻 Salvatore Amato, RPA Specialist

1. Webinar - Utilizzo delle WebApi dell'Orchestrator
UiPath – Rome Community Chapter presenta

2. UiPath Community – Rome Chapter 2
Speakers
Flavio Martinelli
Head of Automation @ Nethex
RPA Service Line Manager @ Soft Strategy
Salvatore Amato
RPA Expert Consultant
fmartinelli@softstrategy.it salvatoreamato.private@protonmail.com

3. UiPath Community – Rome Chapter 3
Timeline Eventi Community
Un viaggio nel mondo del professionista RPA.
Evento in CoHost con il Chapter di Torino.
Link -> Evento
28
Ottobre
2022
Webinar - Utilizzo delle WebApi dell'Orchestrator.
31
Gennaio
2023
Stay Tuned!!!
Upcoming

4. UiPath Community – Rome Chapter 4
Sondaggio

5. UiPath Community – Rome Chapter 5
Agenda
• Setup Orchestrator. Recupero variabili utili alle chiamate API
• Download degli esempi di Postman
• Setup chiamata di Autenticazione. Focus su differenze tra Community (Cloud),
OnPremise e External Applications
• Esempi di chiamate per ricevere informazioni da Orchestrator
• Chiamata di Start Job, normale e con Input Argument
• Esempi integrazione con sistemi esterni: Web App e Telegram
• Esempio di chiamata Api da UiPath Studio

6. UiPath Community – Rome Chapter 6
Setup Orchestrator. Recupero variabili utili alle chiamate API
Dalla pagina di UiPath
Administration, cliccare sul proprio
tenant e poi nel tab Orchestrator,
cliccare sui tre puntini e selezionare
API Access
Collegandosi poi al proprio
orchestrator e selezionando la
Modern Folder utilizzata salvare
questi valori.

7. UiPath Community – Rome Chapter 7
Download degli esempi di Postman
https://postman.uipath.rocks/#1008f80c-7d3f-48e9-9968-f918f52a5efe
E’ possibile scaricare una collezione di chiamate preimpostate su Postman
relative ad Orchestrator di UiPath.
https://docs.uipath.com/orchestrator/reference/read-me
Documentazione su API Orchestrator

8. UiPath Community – Rome Chapter 8
Setup chiamata di Autenticazione
POST /oauth/token HTTP/1.1
Host: account.uipath.com
Content-Type: application/json
Cookie: *
Content-Length: 164
{
"grant_type": "refresh_token",
"client_id": {CLIENT ID}
"refresh_token": {USER KEY}
}
AUTH Orchestrator Cloud
POST /api/Account/Authenticate HTTP/1.1
Host: {ORCHESTRATOR URL}
Content-Type: application/json
Content-Length: 116
{
"password": {PASSWORD ACCOUNT}
"usernameOrEmailAddress": {USERNAME
ACCOUNT},
"tenancyName": {NOME TENANT}
}
AUTH On Premise
POST /identity/connect/token HTTP/1.1
Host: {ORCHESTRATOR URL}
Content-Type: application/x-www-form-
urlencoded
Content-Length: *
grant_type=client_credentials&client_id={CLI
ENT ID}&client_secret={CLIENT
SECRET}&scope=OR.Robots%20OR.Robot
s.Read%20OR.Robots.Write%20OR.Machin
es%20OR.Machines.Read%20OR.Machines.
Write%20OR.Execution%20OR.Execution.R
ead%20OR.Execution.Write%20OR.Assets%
20OR.Assets.Read%20OR.Assets.Write%20
OR.Queues%20OR.Queues.Write%20OR.Jo
bs%20OR.Jobs.Read%20OR.Jobs.Write%20
OR.Users%20OR.Users.Read%20OR.Users.
Write
AUTH External App

9. UiPath Community – Rome Chapter 9
External Applications

10. UiPath Community – Rome Chapter 10
Esempi di chiamate
GET
/{{cloudOrg}}/{{cloudTenant}}/odata/Releases
?$filter=ProcessKey eq 'PetStore_UpdatePet'
HTTP/1.1
Host: {{cloudUrl}}
X-UIPATH-OrganizationUnitId: 1734790
Authorization: Bearer {AUTH TOKEN}
GET RELEASE
{"@odata.context":"https://cloud.uipath.com/Flavio0506/FlavioCommunityOrchestr
ator/orchestrator_/odata/$metadata#Releases","@odata.count":1,"value":[{"Key":"
95b324ed-17b1-4571-9f7a-
597e49bbca93","ProcessKey":"comm_processo2","ProcessVersion":"1.0.1","IsLat
estVersion":false,"IsProcessDeleted":false,"Description":"comm_processo2","Nam
e":"comm_processo2","EnvironmentId":null,"EnvironmentName":"","EntryPointId":
156327,"InputArguments":null,"ProcessType":"Process","SupportsMultipleEntryPo
ints":true,"RequiresUserInteraction":true,"IsAttended":false,"IsCompiled":true,"Aut
omationHubIdeaUrl":null,"AutoUpdate":false,"FeedId":"bc0bf486-523f-415a-bb6e-
fe3e6731f76b","JobPriority":"Normal","SpecificPriorityValue":45,"OrganizationUnitI
d":447369,"OrganizationUnitFullyQualifiedName":"Shared","TargetFramework":"W
indows","RobotSize":null,"AutoCreateConnectedTriggers":true,"RemoteControlAc
cess":"None","LastModificationTime":null,"LastModifierUserId":null,"CreationTime"
:"2023-01-
13T15:22:24.827Z","CreatorUserId":157857,"Id":382500,"Arguments":{"Input":"[]","
Output":"[]"},"ProcessSettings":null,"VideoRecordingSettings":null,"Tags":[],"Reso
urceOverwrites":[]}]}
RESPONSE

11. UiPath Community – Rome Chapter 11
Esempi di chiamate
GET
/Flavio0506/FlavioCommunityOrchestrator/or
chestrator_/odata/Jobs?$Filter=State eq
'Successful'&$orderby=EndTime DESC
HTTP/1.1
Host: cloud.uipath.com
Content-Type: application/json
X-UIPATH-TenantName: 59497
X-UIPATH-OrganizationUnitId: 447369
Authorization: Bearer {AUTH TOKEN}
Cookie: UiPathBrowserId=*
GET PROCESS STATUS
{"@odata.context":
"https://cloud.uipath.com/Flavio0506/FlavioCommunityOrchestrator/orchestrator_/odata/$metadata#Jobs
","@odata.count": 1,"value": [{"Key": "0188caec-f8be-4c50-97e6-120d119fe33b","StartTime": "2023-01-
13T16:00:38.303Z","EndTime": "2023-01-13T16:00:42.86Z","State": "Successful","JobPriority":
"Normal","SpecificPriorityValue": 45,"Source": "Manual","SourceType": "Manual","BatchExecutionKey":
"6e2f9f72-25a3-4e93-8081-1061b2256d01","Info": "Job completed","CreationTime": "2023-01-
13T16:00:37.71Z","StartingScheduleId": null,"ReleaseName": "comm_processo2","Type":
"Unattended","InputArguments": null,"OutputArguments": "{}","HostMachineName": {NOME
MACCHINA},"HasMediaRecorded": false,"HasVideoRecorded": false,"PersistenceId":
null,"ResumeVersion": null,"StopStrategy": null,"RuntimeType": "Unattended","RequiresUserInteraction":
true,"ReleaseVersionId": 736580,"EntryPointPath": "Main.xaml","OrganizationUnitId":
447369,"OrganizationUnitFullyQualifiedName": "Shared","Reference": "","ProcessType":
"Process","ProfilingOptions": null,"ResumeOnSameContext": false,"LocalSystemAccount": {USERNAME
PC},"OrchestratorUserIdentity": null,"RemoteControlAccess":
"None","MaxExpectedRunningTimeSeconds": null,"Id": 49932516}]}
RESPONSE

12. UiPath Community – Rome Chapter 12
Esempi di chiamate
POST
/Flavio0506/FlavioCommunityOrchestrator/or
chestrator_/odata/Jobs/UiPath.Server.Config
uration.OData.StartJobs HTTP/1.1
Host: cloud.uipath.com
Content-Type: application/json
X-UIPATH-OrganizationUnitId: 447369
Authorization: Bearer {AUTH TOKEN}
{
"startInfo": {
"ReleaseKey": "5afe79b8-5da8-4cad-
9fbb-b9883b3f627c",
"Strategy": "ModernJobsCount",
"JobsCount": 1,
"InputArguments":
"{"inMessaggio":"Processo Correttamente
Startato"}"
}
}
START JOB CON INPUT
{"@odata.context":"https://cloud.uipath.com/Flavio0506/FlavioCommunityOrchestrator/orchestrator_/oda
ta/$metadata#Jobs","value":[{"Key":"928b70b3-69d9-4341-aa94-
9f7197f8dd2b","StartTime":null,"EndTime":null,"State":"Pending","JobPriority":"Normal","SpecificPriority
Value":45,"Source":"Manual","SourceType":"Manual","BatchExecutionKey":"192ce1a1-2213-4d7f-98e3-
0bdacecd55fd","Info":null,"CreationTime":"2023-01-
25T11:53:44.133Z","StartingScheduleId":null,"ReleaseName":"comm_processo1","Type":"Unattended","
InputArguments":"{"inMessaggio":"Processo Correttamente
Startato"}","OutputArguments":null,"HostMachineName":null,"HasMediaRecorded":false,"HasVideoRec
orded":null,"PersistenceId":null,"ResumeVersion":null,"StopStrategy":null,"RuntimeType":"Unattended","
RequiresUserInteraction":true,"ReleaseVersionId":null,"EntryPointPath":"Main.xaml","OrganizationUnitId
":447369,"OrganizationUnitFullyQualifiedName":null,"Reference":"","ProcessType":"Process","ProfilingO
ptions":null,"ResumeOnSameContext":false,"LocalSystemAccount":"","OrchestratorUserIdentity":null,"Re
moteControlAccess":"None","MaxExpectedRunningTimeSeconds":null,"Id":50202453}]}
RESPONSE

13. UiPath Community – Rome Chapter 13
Esempio Telegram

14. UiPath Community – Rome Chapter 14
Esempio Web Application

15. UiPath Community – Rome Chapter 15
Grazie per l’attenzione!!
https://community.uipath.com/rome/