Orchestrator 内でジョブを実行する

前提条件:

• Orchestrator 内にプロセスを作成します。
• CLI の exe ファイル (Windows の場合) または dll ファイル (Linux の場合) を実行します。
• 必要な Orchestrator API アクセスのアプリケーション スコープを追加します。

Orchestrator 内でジョブを実行するには、次の手順に従います。

1. uipcli jobを使用して、job タスクを実行します。これで、利用可能なサブタスクのリストを確認できます。
2. 必要なパラメーターを指定し、run サブタスクを実行します。

   次の表で、必要なパラメーターについて説明します。

   パラメーター	説明
   -i または --input_path (ワークフローのエントリ ポイントに入力パラメーターがある場合のみ必須)	実行するプロセスに対応する JSON 入力ファイルのフル パスです。 JSON ファイル形式の例: { "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
   -P または --priority	ジョブを実行する優先度です。以下を指定できます。- 低 - 標準 (既定) - 高
   -r または --robots	特定のロボット名をコンマで区切って列挙したリストです。
   -j または --jobscount	プロセスを実行する回数です。プロセスの既定の実行回数は 1 回です。
   -U または --user	ユーザーの名前です。ユーザーは、Orchestrator のユーザーではなくマシンのユーザーである必要があります。ローカル ユーザーの場合、MachineName\UserName の形式を使用してください。
   -M または --machine	プロセスを実行するマシンの名前です。
   -R または --result_path	JSON ファイル、またはジョブの結果を保存するフォルダーのフル パスです。結果は JSON ファイルとして返されます。
   -W または --timeout	ジョブの実行のタイムアウト (秒) です。既定値は 1800 秒です。
   -f または --fail_when_job_fails	1 つのジョブが失敗すると、コマンドは失敗します。既定値は True です。
   -w または --wait	コマンドは、ジョブが完了するまで待機します。既定値は True です。
   -b または --job_type (モダン フォルダーの場合のみ)	ジョブのランタイムの種類です。以下を選択できます。- Unattended- NonProduction
   -u または --username (ユーザー名とパスワードによる基本認証を使用する場合は必須)	Orchestrator への認証に使用するユーザー名です。対応するパスワードと組み合わせて使用する必要があります。
   -p または --password (ユーザー名とパスワードによる基本認証を使用する場合は必須)	Orchestrator への認証に使用するパスワードです。対応するユーザー名と組み合わせて使用する必要があります。
   -t または --token (トークンベースの認証を使用する場合は必須)	Orchestrator への認証に使用する OAuth2 更新トークンです。アカウント名およびクライアント ID と組み合わせて使用する必要があります。
   -a または --accountName (トークンベースの認証を使用する場合は必須)	Orchestrator Cloud RPA のアカウント名です。OAuth2 更新トークンおよびクライアント ID と組み合わせて使用する必要があります。
   -A または --accountForApp	Orchestrator Cloud RPA のアカウント名 (組織名) です。 外部アプリケーションの アプリケーション ID、 アプリケーション シークレット、 アプリケーション スコープ と組み合わせて使用する必要があります。
   -I または --applicationId (外部アプリケーション認証を使用する場合は必須)	外部アプリケーション ID です。アプリケーション アカウント、アプリケーション シークレット、アプリケーション スコープと組み合わせて使用する必要があります。
   -S または --applicationSecret (外部アプリケーション認証を使用する場合は必須)	外部アプリケーション シークレットです。アプリケーション アカウント、アプリケーション ID、アプリケーション スコープと組み合わせて使用する必要があります。
   --applicationScope (外部アプリケーション認証を使用する場合は必須)	アプリケーション スコープを単一のスペースで区切って列挙したリストです。外部アプリケーションのアプリケーション アカウント、アプリケーション ID、アプリケーション シークレットと組み合わせて使用する必要があります。
   -o または --organizationUnit	Orchestrator フォルダー (組織単位) の名前です。 サブフォルダーを入力するには、親フォルダーの名前とサブフォルダーの名前の両方を入力してください。例: AccountingTeam\TeamJohn
   -l、--language	Orchestrator の言語です。
   -y、--disableTelemetry	テレメトリ データを無効化します。
   --traceLevel	イベントのトレースを表示します。
   --identityUrl (Required for PaaS or MSI deployments)	Identity Server の URL です。
   Process Name (pos.0) (必須)	実行するプロセスの名前です。
   Orchestrator URL (pos.1) (必須)	Orchestrator インスタンスの URL です。
   Orchestrator Tenant (pos.2) (必須) SaaS デプロイの場合。 (任意) PaaS デプロイの場合。	プロセスを実行する Orchestrator インスタンスのテナントです。

使用状況:

uipcli job run <process_name> <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-j <jobscount>] [-R <result_path>] [-P <Low|Normal|High>] [-r <robots>] [-f <false|true>] [-W <timeout>] [-w <false|true>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--user <machine_user> --machine <machine_host_name>] [--job_type <Unattended|NonProduction>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

最小限のコマンドの例:

• uipcli job run ProcessName "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"

• uipcli job run ProcessName "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel "Information"

• uipcli job run ProcessName "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information"

• uipcli job run ProcessName "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.フォルダーまたは。BackgroundTasks またはTestSets またはTestSetExecutions またはTestSetSchedules またはSettings.Read または です。Robots.Read または です。Machines.Read または です。実行 OR.資産 OR.Users.Read OR.Jobs または です。Monitoring" -o "FolderName" --traceLevel "Information"