Zeitplanabfragen

Starten eine Zeitplans mit dynamischer Roboterzuordnung

Mit der folgenden Anforderung können Sie einen Zeitplan mit dem Namen ApiTest für die Zeitzone GMT Standard Time erstellen, der alle 5 Monate sonntags ausgelöst wird.

Mit dem Parameter StartStrategy können Sie auswählen, wie Sie den Auftrag ausführen möchten.

Mögliche Werte für StartStrategy

Wert	Name	Beschreibung	Ordnerkontext
-1	Alle Roboter	Führt den Auftrag einmal für jeden Roboter aus, der in der Umgebung des Prozesses vorhanden ist.	Klassisch
0	Benutzerdefinierte Roboter	Führt den Auftrag einmal auf jedem der angegebenen Roboter aus. Um die Roboter anzugeben, schließen Sie die Roboter-IDs als Werte in ExecutorRobotsein. Beispiel: `"ExecutorRobots" : [ {"Id" : 44881	Klassisch
1	1 Roboter	Führt den Auftrag an einem dynamisch ausgewählten Roboter eines Benutzers aus, der Zugriff auf den Ordner hat, in dem sich der Prozess befindet. Sie können auch festlegen, dass der Auftrag auf dem Roboter ausgeführt werden soll, den Sie in MachineRobots. angeben. Sehen Sie sich den Beispielanforderungstext unten an, um ein Beispiel zu sehen.	Modern
jede andere Zahl	Dynamische Zuteilung	Erstellt die angegebene Anzahl der Aufträge und wählt dynamisch die Roboter aus, auf denen sie ausgeführt werden sollen, aus den verfügbaren Robotern im modernen Ordner des Prozesses oder aus den Robotern in der Umgebung für klassische Ordner. Für moderne Ordner können Sie mit dem Listenparameter MachineRobots eine oder mehrere Maschinenvorlagen, Roboter oder sowohl Maschinenvorlagen als auch Roboter angeben. In diesem Fall stellt der Wert StartStrategy dar, wie oft der Auftrag auf jedem angegebenen Roboter oder jeder Roboter-Maschinen-Kombination ausgeführt werden soll. Dies ist für klassische Ordner nicht möglich, und wenn angegeben, wird der Parameter ExecutorRobots ignoriert.	klassisch oder modern

Posten

https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/odata/ProcessSchedules

Anforderungsheader

Schlüssel	Wert
Autorisierung	Inhaber

Anforderungstext

{
  "Name":"ApiTest",
  "ReleaseId":75,
  "ReleaseName":"BlankProcess_DocEnv",
  "StartProcessCron":"0 0 0 ? 1/5 SUN *",
  "StartProcessCronDetails":"{\"type\":4,\"minutely\":{},\"hourly\":{},\"daily\":{},\"weekly\":{\"weekdays\":[]},\"monthly\":{\"weekdays\":[{\"id\":\"SUN\",\"weekly\":\"Sunday\",\"monthly\":\"Sunday\"}],\"atMinute\":0,\"atHour\":0,\"frequencyInMonths\":\"5\"},\"advancedCronExpression\":\"\"}",
  "StartStrategy":15,
  "ExecutorRobots":[],
  "MachineRobots":[
    {
      "MachineId":null,
      "MachineName":null,
      "RobotId":44880,
      "RobotUserName":"acme\\john.doe"
    }
  ],
  "StopProcessExpression":"",
  "StopStrategy":null,
  "TimeZoneId":"GMT Standard Time"
}

Hinweis:

Um den korrekten Wert für den Parameter TimeZoneId zu ermitteln, senden Sie eine Anfrage GET an den API-Endpunkt /odata/Settings/UiPath.Server.Configuration.OData.GetTimezones . Suchen Sie in der Antwort den Eintrag für Ihre Zeitzone und kopieren Sie die Zeichenfolge im Feld Value . Wenn Sie dann den Zeitplan erstellen, geben Sie die Zeichenfolge als Wert des Parameters TimeZoneId im Anfragetext ein.

Antwortcode

200 OK

Antworttext

{
    "@odata.context": "https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/odata/$metadata#ProcessSchedules/$entity",
    "Enabled": true,
    "Name": "ApiTest",
    "ReleaseId": 75,
    "ReleaseKey": "00000000-0000-0000-0000-000000000000",
    "ReleaseName": null,
    "PackageName": null,
    "EnvironmentName": null,
    "EnvironmentId": "0",
    "StartProcessCron": "0 0 0 ? 1/5 SUN *",
    "StartProcessCronDetails": "{\"type\":4,\"minutely\":{},\"hourly\":{},\"daily\":{},\"weekly\":{\"weekdays\":[]},\"monthly\":{\"weekdays\":[{\"id\":\"SUN\",\"weekly\":\"Sunday\",\"monthly\":\"Sunday\"}],\"atMinute\":0,\"atHour\":0,\"frequencyInMonths\":\"5\"},\"advancedCronExpression\":\"\"}",
    "StartProcessCronSummary": null,
    "StartProcessNextOccurrence": null,
    "StartStrategy": 15,
    "StopProcessExpression": "",
    "StopStrategy": null,
    "ExternalJobKey": "8cda4b35-e835-445b-b477-1ea0961d62e5",
    "TimeZoneId": "GMT Standard Time",
    "TimeZoneIana": "Europe/London",
    "UseCalendar": false,
    "StopProcessDate": null,
    "InputArguments": "{}",
    "Id": 43
}

Starten eines Zeitplans mit Eingabeparameterwerten

Mit der folgenden POST-Abfrage an den Endpunkt /odata/ProcessSchedules können Sie einen aktivierten Zeitplan mit dem Namen „API_schedule_test“ für den Prozess mit der ID 55 erstellen und außerdem benutzerdefinierte Werte für einige der Prozessparameter hinzufügen. Der Zeitplan beginnt auf allen Robotern alle fünf Minuten. Nicht-Arbeitstage bleiben unberücksichtigt.

Hinweis:

Maximal 10.000 Zeichen für die Gesamtlänge der JSON-Darstellung der Eingabeparameter, einschließlich der Argumentnamen, aller Escape-Zeichen, Leerzeichen, Klammern und Argumentwerte werden akzeptiert.

Posten

https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/odata/ProcessSchedules

Anforderungsheader

Schlüssel	Wert
Autorisierung	Inhaber

Anforderungstext

{
      "Enabled": true,
      "Name": "API_schedule_test",
      "ReleaseId": 55,
      "ReleaseKey": "429cf1cc-283c-424f-a935-43f72c2ca719",
      "ReleaseName": "input_output_test_DocEnv",
      "PackageName": "input_output_test",
      "EnvironmentName": "DocEnv",
      "EnvironmentId": "7",
      "StartProcessCron": "0 0/5 * 1/1 * ? *",
      "StartProcessCronDetails": "{\"type\":0,\"minutely\":{\"atMinute\":5},\"hourly\":{},\"daily\":{},\"weekly\":{\"weekdays\":[]},\"monthly\":{\"weekdays\":[]},\"advancedCronExpression\":\"\"}",
      "StartProcessCronSummary": "Every 5 minutes",
      "StartProcessNextOccurrence": null,
      "StartStrategy": 0,
      "StopProcessExpression": "",
      "StopStrategy": null,
      "ExternalJobKey": "af486c19-c797-48cd-b586-cfb7a12110a2",
      "TimeZoneId": "Morocco Standard Time",
      "TimeZoneIana": "Africa/Casablanca",
      "UseCalendar": false,
      "StopProcessDate": null,
      "InputArguments": "{\"arrayStrings\":[\"test\",\"test\"],\"age\":666,\"trueOrFalse\":false,\"dateNow\":\"2012-04-23T18:25:43.511Z\",\"stringNew\":\"stringTest\",\"DoubleTest\":7.555555}",
      "Id": 37
    }

Hinweis:

Um den korrekten Wert für den Parameter TimeZoneId zu ermitteln, senden Sie eine Anfrage GET an den API-Endpunkt /odata/Settings/UiPath.Server.Configuration.OData.GetTimezones . Suchen Sie in der Antwort den Eintrag für Ihre Zeitzone und kopieren Sie die Zeichenfolge im Feld Value . Wenn Sie dann den Zeitplan erstellen, geben Sie die Zeichenfolge als Wert des Parameters TimeZoneId im Anfragetext ein.

Antwortcode

200 OK

Antworttext

{
    "@odata.context": "https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/odata/$metadata#ProcessSchedules/$entity",
    "Enabled": true,
    "Name": "API_schedule_test",
    "ReleaseId": 55,
    "ReleaseKey": "00000000-0000-0000-0000-000000000000",
    "ReleaseName": null,
    "PackageName": null,
    "EnvironmentName": null,
    "EnvironmentId": "0",
    "StartProcessCron": "0 0/5 * 1/1 * ? *",
    "StartProcessCronDetails": "{\"type\":0,\"minutely\":{\"atMinute\":5},\"hourly\":{},\"daily\":{},\"weekly\":{\"weekdays\":[]},\"monthly\":{\"weekdays\":[]},\"advancedCronExpression\":\"\"}",
    "StartProcessCronSummary": "Every 5 minutes",
    "StartProcessNextOccurrence": null,
    "StartStrategy": 0,
    "StopProcessExpression": "",
    "StopStrategy": null,
    "ExternalJobKey": "7ecbff8d-832d-41e1-a3ed-aee0957caffe",
    "TimeZoneId": "Morocco Standard Time",
    "TimeZoneIana": "Africa/Casablanca",
    "UseCalendar": false,
    "StopProcessDate": null,
    "InputArguments": "{\"arrayStrings\":[\"test\",\"test\"],\"age\":666,\"trueOrFalse\":false,\"dateNow\":\"2012-04-23T18:25:43.511Z\",\"stringNew\":\"stringTest\",\"DoubleTest\":7.555555,\"inOutTry\":\"2012-04-23T18:25:43.511Z\"}",
    "Id": 37
}