Chilkat Online Tools

VB.NET / Orchestrator API Documentation / Get Releases by Name

Back to Collection Items

' This example assumes the Chilkat API to have been previously unlocked.
' See Global Unlock Sample for sample code.

Dim http As New Chilkat.Http
Dim success As Boolean

Dim queryParams As New Chilkat.JsonObject
queryParams.UpdateString("$Filter","ProcessKey eq 'PetStore_AddPet_byQueueItem'")

' Adds the "Authorization: Bearer <access_token>" header.
http.AuthToken = "<access_token>"
http.SetRequestHeader("X-UIPATH-OrganizationUnitId","{{folderId}}")


Dim resp As Chilkat.HttpResponse = http.QuickRequestParams("GET","https://domain.com/orchestrator_/odata/Releases",queryParams)
If (http.LastMethodSuccess = False) Then
    Debug.WriteLine(http.LastErrorText)
    Exit Sub
End If


Dim sbResponseBody As New Chilkat.StringBuilder
resp.GetBodySb(sbResponseBody)

Dim jResp As New Chilkat.JsonObject
jResp.LoadSb(sbResponseBody)
jResp.EmitCompact = False

Debug.WriteLine("Response Body:")
Debug.WriteLine(jResp.Emit())

Dim respStatusCode As Integer = resp.StatusCode
Debug.WriteLine("Response Status Code = " & respStatusCode)
If (respStatusCode >= 400) Then
    Debug.WriteLine("Response Header:")
    Debug.WriteLine(resp.Header)
    Debug.WriteLine("Failed.")

    Exit Sub
End If



' Sample JSON response:
' (Sample code for parsing the JSON response is shown below)

' {
'   "@odata.context": "https://cloud.uipath.com/org/tenant/orchestrator_/odata/$metadata#Releases",
'   "@odata.count": 1,
'   "value": [
'     {
'       "Key": "6f459380-1b98-4f33-9682-6f8a7457490f",
'       "ProcessKey": "PetStore_AddPet_byQueueItem",
'       "ProcessVersion": "1.0.13",
'       "IsLatestVersion": false,
'       "IsProcessDeleted": false,
'       "Description": "Gets a queue item and adds a pet with item name",
'       "Name": "Add a pet to pet store by queue item",
'       "EnvironmentId": null,
'       "EnvironmentName": "",
'       "EntryPointId": null,
'       "InputArguments": null,
'       "ProcessType": "Process",
'       "SupportsMultipleEntryPoints": true,
'       "RequiresUserInteraction": true,
'       "AutoUpdate": false,
'       "FeedId": "ef94e92f-5f58-474b-963c-c3ef46391ca7",
'       "JobPriority": "Normal",
'       "CreationTime": "2021-03-16T09:04:00.607Z",
'       "OrganizationUnitId": 515128,
'       "OrganizationUnitFullyQualifiedName": "UnattendedProcesses",
'       "Id": 31025,
'       "Arguments": {
'         "Input": null,
'         "Output": null
'       },
'       "ProcessSettings": null
'     }
'   ]
' }

' Sample code for parsing the JSON response...
' Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code



Dim Key As String
Dim ProcessKey As String
Dim ProcessVersion As String
Dim IsLatestVersion As Boolean
Dim IsProcessDeleted As Boolean
Dim Description As String
Dim Name As String
Dim EnvironmentId As String
Dim EnvironmentName As String
Dim EntryPointId As String
Dim InputArguments As String
Dim ProcessType As String
Dim SupportsMultipleEntryPoints As Boolean
Dim RequiresUserInteraction As Boolean
Dim AutoUpdate As Boolean
Dim FeedId As String
Dim JobPriority As String
Dim CreationTime As String
Dim OrganizationUnitId As Integer
Dim OrganizationUnitFullyQualifiedName As String
Dim Id As Integer
Dim Input As String
Dim Output As String
Dim ProcessSettings As String

Dim odata_context As String = jResp.StringOf("""@odata.context""")
Dim odata_count As Integer = jResp.IntOf("""@odata.count""")
Dim i As Integer = 0
Dim count_i As Integer = jResp.SizeOfArray("value")
While i < count_i
    jResp.I = i
    Key = jResp.StringOf("value[i].Key")
    ProcessKey = jResp.StringOf("value[i].ProcessKey")
    ProcessVersion = jResp.StringOf("value[i].ProcessVersion")
    IsLatestVersion = jResp.BoolOf("value[i].IsLatestVersion")
    IsProcessDeleted = jResp.BoolOf("value[i].IsProcessDeleted")
    Description = jResp.StringOf("value[i].Description")
    Name = jResp.StringOf("value[i].Name")
    EnvironmentId = jResp.StringOf("value[i].EnvironmentId")
    EnvironmentName = jResp.StringOf("value[i].EnvironmentName")
    EntryPointId = jResp.StringOf("value[i].EntryPointId")
    InputArguments = jResp.StringOf("value[i].InputArguments")
    ProcessType = jResp.StringOf("value[i].ProcessType")
    SupportsMultipleEntryPoints = jResp.BoolOf("value[i].SupportsMultipleEntryPoints")
    RequiresUserInteraction = jResp.BoolOf("value[i].RequiresUserInteraction")
    AutoUpdate = jResp.BoolOf("value[i].AutoUpdate")
    FeedId = jResp.StringOf("value[i].FeedId")
    JobPriority = jResp.StringOf("value[i].JobPriority")
    CreationTime = jResp.StringOf("value[i].CreationTime")
    OrganizationUnitId = jResp.IntOf("value[i].OrganizationUnitId")
    OrganizationUnitFullyQualifiedName = jResp.StringOf("value[i].OrganizationUnitFullyQualifiedName")
    Id = jResp.IntOf("value[i].Id")
    Input = jResp.StringOf("value[i].Arguments.Input")
    Output = jResp.StringOf("value[i].Arguments.Output")
    ProcessSettings = jResp.StringOf("value[i].ProcessSettings")
    i = i + 1
End While

Curl Command

curl -G -d "$Filter=ProcessKey%20eq%20%27PetStore_AddPet_byQueueItem%27"
	-H "Authorization: Bearer <access_token>"
	-H "X-UIPATH-OrganizationUnitId: {{folderId}}"
https://domain.com/orchestrator_/odata/Releases

Postman Collection Item JSON

{
  "name": "Get Releases by Name",
  "event": [
    {
      "listen": "test",
      "script": {
        "exec": [
          "pm.test(\"Status code is 200\", function () {\r",
          "    pm.response.to.have.status(200);\r",
          "});\r",
          "\r",
          "//set release key\r",
          "var myResponse = pm.response.json();\r",
          "pm.collectionVariables.set(\"releaseKey\", myResponse.value[0].Key);\r",
          "console.log(pm.collectionVariables.get(\"releaseKey\"));"
        ],
        "type": "text/javascript"
      }
    },
    {
      "listen": "prerequest",
      "script": {
        "exec": [
          ""
        ],
        "type": "text/javascript"
      }
    }
  ],
  "request": {
    "method": "GET",
    "header": [
      {
        "key": "X-UIPATH-OrganizationUnitId",
        "value": "{{folderId}}",
        "type": "text"
      }
    ],
    "url": {
      "raw": "{{url}}/orchestrator_/odata/Releases?$Filter=ProcessKey eq 'PetStore_AddPet_byQueueItem'",
      "host": [
        "{{url}}"
      ],
      "path": [
        "orchestrator_",
        "odata",
        "Releases"
      ],
      "query": [
        {
          "key": "$Filter",
          "value": "ProcessKey eq 'PetStore_AddPet_byQueueItem'"
        }
      ]
    },
    "description": "So you've created a **Process** in UiPath Studio and published it to Orchestrator. Here's where you specify that process, by name, in order to start it remotely.\n\nWithin the URL, simply replace the string in the filter parameter with the name of your process and this call will return the `ReleaseKey` that you will need in step 3 to start the process."
  },
  "response": [
    {
      "name": "Get Releases by Name Copy",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "key": "X-UIPATH-TenantName",
            "value": "{{tenantName}}",
            "type": "text"
          },
          {
            "key": "X-UIPATH-OrganizationUnitId",
            "value": "{{folderId}}",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{url}}/odata/Releases?$filter=Name eq 'Add a pet to pet store by queue item'",
          "host": [
            "{{url}}"
          ],
          "path": [
            "odata",
            "Releases"
          ],
          "query": [
            {
              "key": "$filter",
              "value": "Name eq 'Add a pet to pet store by queue item'"
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Date",
          "value": "Wed, 31 Mar 2021 12:54:04 GMT"
        },
        {
          "key": "Content-Type",
          "value": "application/json; odata.metadata=minimal; odata.streaming=true"
        },
        {
          "key": "Transfer-Encoding",
          "value": "chunked"
        },
        {
          "key": "Connection",
          "value": "keep-alive"
        },
        {
          "key": "Cache-Control",
          "value": "no-cache, no-store, must-revalidate"
        },
        {
          "key": "Pragma",
          "value": "no-cache"
        },
        {
          "key": "Expires",
          "value": "-1"
        },
        {
          "key": "Vary",
          "value": "Accept-Encoding"
        },
        {
          "key": "Request-Context",
          "value": "appId=cid-v1:04884d99-0742-441b-a23c-847133cb0130"
        },
        {
          "key": "X-Robots-Tag",
          "value": "noindex,nofollow"
        },
        {
          "key": "X-Download-Options",
          "value": "noopen"
        },
        {
          "key": "X-XSS-Protection",
          "value": "1"
        },
        {
          "key": "X-Content-Type-Options",
          "value": "nosniff"
        },
        {
          "key": "X-Frame-Options",
          "value": "Deny"
        },
        {
          "key": "Strict-Transport-Security",
          "value": "max-age=31536000; includeSubDomains"
        },
        {
          "key": "Content-Security-Policy",
          "value": "default-src 'self';script-src 'self';style-src 'self' 'unsafe-inline';img-src 'self' data: https://*.blob.core.windows.net https://*.amazonaws.com blob:;font-src 'self' data:;connect-src 'self' wss: https://sentry.io https://studio-feedback.azure-api.net https://storage.googleapis.com https://*.service.signalr.net https://*.blob.core.windows.net https://*.amazonaws.com dc.services.visualstudio.com;worker-src 'self' blob:"
        },
        {
          "key": "X-Correlation-ID",
          "value": "d38b319c-dac3-46d0-bf60-a4b3b18902f1"
        },
        {
          "key": "OData-Version",
          "value": "4.0"
        },
        {
          "key": "api-supported-versions",
          "value": "12.0"
        },
        {
          "key": "CF-Cache-Status",
          "value": "DYNAMIC"
        },
        {
          "key": "cf-request-id",
          "value": "0929f232600000cba0252ce000000001"
        },
        {
          "key": "Expect-CT",
          "value": "max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""
        },
        {
          "key": "Server",
          "value": "cloudflare"
        },
        {
          "key": "CF-RAY",
          "value": "6389b963ce2fcba0-VIE"
        },
        {
          "key": "Content-Encoding",
          "value": "br"
        }
      ],
      "cookie": [
      ],
      "body": "{\n    \"@odata.context\": \"https://cloud.uipath.com/org/tenant/orchestrator_/odata/$metadata#Releases\",\n    \"@odata.count\": 1,\n    \"value\": [\n        {\n            \"Key\": \"6f459380-1b98-4f33-9682-6f8a7457490f\",\n            \"ProcessKey\": \"PetStore_AddPet_byQueueItem\",\n            \"ProcessVersion\": \"1.0.13\",\n            \"IsLatestVersion\": false,\n            \"IsProcessDeleted\": false,\n            \"Description\": \"Gets a queue item and adds a pet with item name\",\n            \"Name\": \"Add a pet to pet store by queue item\",\n            \"EnvironmentId\": null,\n            \"EnvironmentName\": \"\",\n            \"EntryPointId\": null,\n            \"InputArguments\": null,\n            \"ProcessType\": \"Process\",\n            \"SupportsMultipleEntryPoints\": true,\n            \"RequiresUserInteraction\": true,\n            \"AutoUpdate\": false,\n            \"FeedId\": \"ef94e92f-5f58-474b-963c-c3ef46391ca7\",\n            \"JobPriority\": \"Normal\",\n            \"CreationTime\": \"2021-03-16T09:04:00.607Z\",\n            \"OrganizationUnitId\": 515128,\n            \"OrganizationUnitFullyQualifiedName\": \"UnattendedProcesses\",\n            \"Id\": 31025,\n            \"Arguments\": {\n                \"Input\": null,\n                \"Output\": null\n            },\n            \"ProcessSettings\": null\n        }\n    ]\n}"
    }
  ]
}