Studio ガイド

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

コード化されたワークフローと 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 つのパラメーターを受け取ります。
1. scope "Orchestrator" - アクセストークンの取得先 OAuth 2.0 スコープです。
2. force True - 新しいアクセストークンを生成します。
```
var client = BuildClient();var client = BuildClient();
```
QueueDefinitionsClient のインスタンスを作成し、そのクライアントインスタンスをパラメーターとして渡して、queueClient という名前の変数に代入します。このクライアント変数は、Orchestrator のキュー定義 API との対話に使用されます。
```
var queueClient = new QueueDefinitionsClient(client);var queueClient = new QueueDefinitionsClient(client);
```

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

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;

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() }
        };
```

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);