Studio ガイド

最終更新日時 2026年2月18日

コード化されたワークフローと Orchestrator API を使用したキューの生成

このチュートリアルでは、Swagger からアクセスする Orchestrator API を使用した、ランダムなキューを生成するオートメーションの構築方法を説明します。オートメーションにより新しいキューが作成され、ランダムなデータを含むキューアイテムが生成されて、キューに追加されます。

前提条件:

この例では、ライブラリまたはテストオートメーションを使用する必要があります。ただし、コード化されたワークフローは、あらゆる種類の RPA プロセスに使用できます。
System.Activities 23.10
Testing.Activities 23.10
Studio プロジェクトの [サービス] セクションに新しいサービス (Orchestrator) を追加します。
- 使用するインスタンスの Orchestrator API の Swagger 定義を [ファイルまたはリンク] に追加し、[読み込み] をクリックします。Swagger 定義のリンクの取得方法については、『API リファレンス』をご覧ください。
- [QueueDefinitions] を除くすべてのエンドポイントの選択を解除し、[保存] をクリックします。

[新規] を選択してコード化されたワークフローを作成し、[ファイル] グループから [コード化されたワークフロー] を選択します。
Execute メソッド内で、BuildClient(String, Boolean) メソッドを呼び出して、HttpClient オブジェクトのインスタンスを作成します。このメソッドは、指定されたスコープを持つ HTTP クライアントを構築します。

このメソッドは、以下の既定値を持つ 2 つのパラメーターを受け取ります。

scope "Orchestrator" - アクセストークンの取得先 OAuth 2.0 スコープです。
force True - 新しいアクセストークンを生成します。

var client = BuildClient();
var client = BuildClient();

QueueDefinitionsClient のインスタンスを作成し、そのクライアントインスタンスをパラメーターとして渡して、queueClient という名前の変数に代入します。このクライアント変数は、Orchestrator の キュー定義 API との対話に使用されます。
```
var queueClient = new QueueDefinitionsClient(client);
var queueClient = new QueueDefinitionsClient(client);
```

docs image

キュー名を生成し、新しいキューを作成します。

var queueName = "SampleQueue" + Guid.NewGuid().ToString("N");
var queue = queueClient.PostAsync(new QueueDefinitionDto() { Name = queueName }, null).Result;
var queueName = "SampleQueue" + Guid.NewGuid().ToString("N");
var queue = queueClient.PostAsync(new QueueDefinitionDto() { Name = queueName }, null).Result;

docs image

0 から 100 までの数値範囲を反復処理する [並列繰り返し (コレクションの各要素)] ループを作成します。ディクショナリを使用して、Address、FirstName、LastName の値を保存します。Address、GivenName、LastName のコード化されたオートメーション API を使用して、これらの項目のランダムな値を生成します。

このシナリオでは、オートメーションのパフォーマンスを向上させるために、単純な [繰り返し (コレクションの各要素)] の代わりに [並列繰り返し (コレクションの各要素)] が使用されます。

Parallel.ForEach(Enumerable.Range(0, 100), i =>
      {
        var data = new Dictionary<string, object>()
        {
          { "Address", testing.Address("Romania", "Bucharest")["City"].ToString() },
          { "FirstName", testing.GivenName() },
          { "LastName", testing.LastName() }
        };
Parallel.ForEach(Enumerable.Range(0, 100), i =>
      {
        var data = new Dictionary<string, object>()
        {
          { "Address", testing.Address("Romania", "Bucharest")["City"].ToString() },
          { "FirstName", testing.GivenName() },
          { "LastName", testing.LastName() }
        };

docs image

AddQueueItem のコード化されたオートメーション API を使用して、ランダムデータをキューに追加します。

system.AddQueueItem(queueName, null, DateTime.UtcNow, data, DateTime.UtcNow, QueueItemPriority.Normal, i.ToString(), 100);
system.AddQueueItem(queueName, null, DateTime.UtcNow, data, DateTime.UtcNow, QueueItemPriority.Normal, i.ToString(), 100);