Robot ガイド

最終更新日時 2024年12月18日

Robot API

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

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

相互運用性マトリクス

Robot のバージョン	API 22.4.x	API 21.10.x	API 20.10.x	API 19.10.x
Robot 22.4.x
Robot 21.10.x
Robot 20.10.x
Robot 19.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 })