Robot ガイド

最終更新日時 2025年11月22日

Robot API

Robot は、さまざまな自動化のニーズに応えることができます。その能力は、Robot API を活用することで著しく高まり、ドメイン固有のインターフェイスを作成するための、カスタマイズされたエクスペリエンスを提供します。

Robot API は独自のジョブの管理のみに使用するものであり、他のユーザー向けではありません。アクセスできるのは、ロボットがインストールされているマシンからのみです。API と Robot は同じバージョンを有し、各更新では後方互換性が確保されています。

相互運用性マトリクス

Robot のバージョン	API 2023.10.x	API 2023.4.x	API 2022.10.x	API 2022.4.x	API 2021.10.x
Robot 2023.10.x
Robot 2023.4.x
Robot 2022.10.x
Robot 2022.4.x
Robot 2021.10.x

Robot API を使用するには UiPath.Robot.api ライブラリが必要です。このライブラリは https://uipath.pkgs.visualstudio.com/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json フィードからダウンロードできます

以下の .NET Robot クライアント呼び出しを使用できます。

クライアントをアプリケーションに含める

var client = new RobotClient();var client = new RobotClient();

利用可能なプロセスリストを取得する

var processes = await client.GetProcesses(); 
var myProcess = processes.Single(process => process.Name == "MyProcess"); 
var job = myProcess.ToJob();var processes = await client.GetProcesses(); 
var myProcess = processes.Single(process => process.Name == "MyProcess"); 
var job = myProcess.ToJob();

プロセスキーを使用してジョブを開始する

var job = new Job("812e908a-7609-4b81-86db-73e3c1438be4");var job = new Job("812e908a-7609-4b81-86db-73e3c1438be4");

プロセス実行を開始する

{ 
await client.RunJob(job); 
} 
catch (Exception ex) 
{ 
Console.WriteLine(ex.ToString()); 
}{ 
await client.RunJob(job); 
} 
catch (Exception ex) 
{ 
Console.WriteLine(ex.ToString()); 
}

入力引数を追加する

job.InputArguments = {["numbers"] = new int[] { 1, 2, 3 }}; 
await client.RunJob(job);job.InputArguments = {["numbers"] = new int[] { 1, 2, 3 }}; 
await client.RunJob(job);

出力引数をエクスポートする

var jobOutput = await client.RunJob(job); 
Console.WriteLine(jobOutput.Arguments["sumOfNumbers"]);var jobOutput = await client.RunJob(job); 
Console.WriteLine(jobOutput.Arguments["sumOfNumbers"]);

プロセスを停止する

await client.RunJob(job, cancellationToken);await client.RunJob(job, cancellationToken);

プロセスのステータスを監視する

job.StatusChanged += (sender, args) => Console.WriteLine($"{((Job)sender).ProcessKey}: {args.Status}"); 
await client.RunJob(job);job.StatusChanged += (sender, args) => Console.WriteLine($"{((Job)sender).ProcessKey}: {args.Status}"); 
await client.RunJob(job);

イベントスケジューラーを使用する

new RobotClient(new RobotClientSettings { EventScheduler = TaskScheduler.Default })new RobotClient(new RobotClientSettings { EventScheduler = TaskScheduler.Default })