スケジュールの要求

動的なロボット割り当てを使用してスケジュールを開始する

以下の要求では、APITest という名前のスケジュールを GMT 標準時のタイム ゾーンに作成し、5 か月ごとに日曜日にトリガーすることができます。

StartStrategy パラメーターを使用すると、ジョブの実行方法を選択できます。

StartStrategy に設定可能な値

値 (Value)	名前	説明	フォルダー コンテキスト
-1	すべてのロボット	プロセスのロボット グループに存在する各ロボットに対して 1 回、ジョブを実行します。	クラシック
0	カスタム ロボット	指定した各ロボットで 1 回、ジョブを実行します。ロボットを指定するには、ロボット ID を ExecutorRobots の値として含めます。例: '"ExecutorRobots" : {"Id" : 44881	クラシック
1	1 台のロボット	プロセスが存在するフォルダーへのアクセス権を持つ任意のユーザーの、動的に選択されたロボット上でジョブを実行します。 また、MachineRobots で指定したロボットで実行するようにジョブを設定することもできます。以下の要求本文で例をご確認ください。	モダン
その他の任意の数	動的に割り当て	指定した数のジョブを作成し、そのジョブを実行するロボットを動的に選択します。その場合、プロセスのモダン フォルダー内で利用可能なロボットから選択するか、クラシック フォルダーのロボット グループ内のロボットから選択します。 モダン フォルダーの場合は、リスト パラメーター MachineRobots を使用して、1 つ以上のマシン テンプレートまたはロボット、あるいはマシン テンプレートとロボットの両方を指定することもできます。この場合、StartStrategy の値は、指定したロボット、またはロボットとマシンの組み合わせそれぞれでジョブを実行する回数を表します。 クラシック フォルダーではこのように指定することはできません。指定した場合、ExecutorRobots パラメーターは無視されます。	クラシックまたはモダン

POST

https://{yourDomain}/odata/ProcessSchedules

要求ヘッダー

キー	値 (Value)
認可	Bearer

要求本文

{
  "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"
}

応答コード

200 OK

応答本文

{
    "@odata.context": "https://{yourDomain}/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
}

入力パラメーター値を使用してスケジュールを開始する

/odata/ProcessSchedules エンドポイントに対する以下の POST 要求では、ID が 55 のプロセス上に「API_schedule_test」という名前の有効なスケジュールを作成すると同時に、プロセスの一部のパラメーターにカスタム値を追加できます。このスケジュールは、利用可能なすべてのロボットで 5 分ごとに開始されます。非稼働日は考慮されません。

注: 入力パラメーターの JSON 表現は、引数名、エスケープされた文字、スペース、ブラケット (かっこ)、引数の値を含め、全体で 10,000 文字以下となっています。

POST

https://{yourDomain}/odata/ProcessSchedules

要求ヘッダー

キー	値 (Value)
認可	Bearer

要求本文

{
      "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
    }

応答コード

200 OK

応答本文

{
    "@odata.context": "https://{yourDomain}/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
}