プロセスの処理の中間結果を使用して Apps でリアルタイムの進行状況を追跡する

概要

プロセスの処理の中間結果の動作について理解を深めるために、このページで説明する例を構築できます。

この手順に従って、[中間結果を送信] アクティビティを使用して UiPath Apps に中間データを送信するプロセスを Studio で作成します。表にデータが入力されるのに応じて進行状況バーをリアルタイムで表示するアプリを作成します (スライダー コントロールを使用)。

この例では、以下を構築します。

• オートメーション プロセス
• UiPath Apps を使用するアプリ

チュートリアル

プロセスを構築する

このチュートリアルのプロセスを使用して、[プロセスの中間結果] アクティビティの機能を説明します。プロセスは次の 2 つの入力を取ります。

• 処理する項目の数
• 各項目のステップの数

プロセスはこれらの入力を使用して実行され、以下の中間結果をアプリに送信します。

• プロセスが現在実行中の項目
• 項目の現在のステップ
• 特定の項目の進行状況の割合
• 各ステップを入力する表 (タイムスタンプを含む)

1. Studio を開いて、新しいプロセスを作成します。
2. 次の引数を作成します。

   引数名	方向	引数の型	既定値
   in_number_of_steps	In	Int32	3
   in_number_of_items	In	Int32	2
   out_progress_percentage	Out	Int32	-
   out_progress_datatable	Out	データ テーブル	-
   out_current_step	Out	Int32	-
   out_current_item	Out	Int32	-

3. ワークフロー デザイナーに [シーケンス] をドラッグします。
   • 次の変数を作成します。

     変数名	変数型	既定値
     var_item	Int32	1
     var_step	Int32	1
     var_percentage	Int32	0

4. [シーケンス] コンテナーに、[データ テーブルを構築] アクティビティを追加します。
   • [データ テーブル] フィールドに out_progress_datatable 引数を追加します。
   • 表に 4 つの列を追加します。
     • Item Number (Int32)
     • Step Number (Int32)
     • 「時間」を DateTime として
     • Progress % を Int32 で
   • [繰り返し (前判定)] アクティビティを [データ テーブルを構築] アクティビティの下に追加し、以下のように設定します。
5. [条件] フィールドに var_item<=in_number_of_items を追加します。

• 本体に [繰り返し (前判定)] アクティビティを追加します。
  • [条件] フィールドに var_step<=in_number_of_steps を追加します。
  • 本体に [データ行を追加] アクティビティを追加します。
    • [列配列] フィールドに「{var_item,var_step,now(),(var_step/in_number_of_steps) * 100}」を追加します。
    • [データ テーブル] フィールドに「out_progress_datatable」を追加します。
  • [データ行を追加] の下に [待機] アクティビティを追加します。[期間] フィールドに「00:00:02」(2 秒) を追加します。
  • [待機] の下に [中間結果を送信] アクティビティを追加します。
    • [引数名] フィールドに out_progress_datatable を追加し、[引数値] フィールドに out_progress_datatable を追加します。
  • [中間結果を送信] の下に [複数代入] アクティビティを追加します。
    • [左辺値 (To)] フィールドに　var_percentage を追加し、[右辺値 (Value)] フィールドに Convert.ToInt32((var_step/in_number_of_steps) * 100) を追加します。
  • [複数代入] の下に [中間結果を送信] アクティビティを追加します。
    • [引数名] フィールドに out_progress_percentage を追加し、[引数値] フィールドに var_percentage を追加します。
  • 前の [中間結果を送信] アクティビティの下に、2 番目の [中間結果を送信] アクティビティを追加します。
    • [引数名] フィールドに out_current_step を追加し、[引数値] フィールドに var_step を追加します。
  • 3 番目の [中間結果を送信] アクティビティを追加します。
    • [引数名] フィールドに out_current_item を追加し、[引数値] フィールドに var_item を追加します。
  • 最後の [中間結果を送信] アクティビティの下に [複数代入] アクティビティを追加します。
    • [左辺値 (To)] フィールドに　var_step を追加し、[右辺値 (Value)] フィールドに var_step+1 を追加します。
  • 最後の [繰り返し (前判定)] の下に [複数代入] アクティビティを追加します。
  • [左辺値 (To)] フィールドに　var_step を追加し、[右辺値 (Value)] フィールドに 1 を追加します。
  • [左辺値 (To)] フィールドに　var_item を追加し、[右辺値 (Value)] フィールドに var_item+1 を追加します。
  • [左辺値 (To)] フィールドに　var_percentage を追加し、[右辺値 (Value)] フィールドに 1 を追加します。

結果

最終的に、ワークフローは以下のようになります。

アプリを構築する

このチュートリアルのアプリは、先ほど構築したプロセスから情報を受け取ります。アプリには、プロセスから受け取った以下の中間結果が表示されます。

• プロセスが現在実行中の項目
• 項目の現在のステップ
• 特定の項目の進行状況の割合
• 各ステップを入力する表 (タイムスタンプを含む)

アプリの構築を開始する前に、「プロセスを構築する」のセクションのオートメーション プロセスを作成して、Orchestrator にパブリッシュしてください。

1. 既存のアプリケーションを開くか、新しいアプリケーションを開始します。
2. 「前提条件」セクションのプロセスを参照します。
3. ページにコンテナーを追加します。
4. コンテナーにヘッダー コントロールを追加します。[アプリ] - [プロセスの中間結果] を [テキスト] プロパティに追加します。これがアプリのタイトルになります。
5. 前のヘッダー コントロールの下に 2 番目の ヘッダー コントロールを追加します。[テキスト] プロパティに [入力] を追加します。フォント サイズをやや小さ目にしてください (例: 20 px)。
   1. コンテナー内にテキストボックス コントロールを追加します。[値のバインド] プロパティに、前に参照したプロセスの in_number_of_items 引数を追加します。[既定のテキスト] プロパティに「2」を追加し、[ラベル] プロパティに「Number of items (iterations)」を追加します。
   2. テキストボックス コントロールの右側に分割バーを追加します。
   3. 分割バーの右側にテキストボックス コントロールを追加します。[値のバインド] プロパティに、前に参照したプロセスの in_number_of_steps 引数を追加します。[既定のテキスト] プロパティに「3」を追加し、[ラベル] プロパティに「Number of steps in item」を追加します。
   4. テキストボックスの右側にボタン コントロールを追加します。[テキスト] プロパティに「Start Process」を追加します。[クリック時] イベントに [プロセスを開始] ルールを設定します。開始時に参照されるプロセスを開始するルールを設定し、Attended とマークします。
6. コンテナーの下に分割バーを追加します。
7. 分割バーの下にヘッダーを追加します。[プロセスの中間結果] を [テキスト] プロパティに追加します。
   
   

   

   
   
8. ヘッダーの下にコンテナーを追加します。
9. さらに 2 つの コンテナー コントロールを追加し、一方を互いに入れ子にします。
   1. 最後のコンテナー内にラベルを追加します。[テキスト] プロパティに「Current item being processed:」を追加します。
   2. 前のラベルの横に 2 番目のラベルを追加します。[テキスト] プロパティに、参照されるプロセスの out_current_item 引数を追加します。
10. 最後のコンテナーの下にコンテナーを追加します。
    1. 最後のコンテナー内にラベルを追加します。[テキスト] プロパティに「Current step:」を追加します。
    2. 前のラベルの横に 2 番目のラベルを追加します。[テキスト] プロパティに、参照されるプロセスの out_current_step 引数を追加します。
11. 最後の 2 つのコンテナーの右側に、分割バーを追加します。
    
    

    

    
    
12. 分割バーの右側にコンテナーを追加し、最初のコンテナー内に別のコンテナーを追加します。
    1. ラベル コントロールを追加し、[テキスト] プロパティに「Step completion % : 」を追加します。
    2. コンテナー コントロールをさらに 2 つ追加し、一方を互いに入れ子にします。また、最後のコンテナー内にラベル コントロールを 1 つとスライダー コントロールを 1 つ追加します。ラベルの [テキスト] プロパティに、プロセスの out_progress_percentage 引数を追加します。[スライダー] プロパティを設定します。[スライド インクリメント] を 0 に設定し、[既定値] を 0 に設定します。
13. 下に分割バーを追加します。
14. 分割バーの下に表コントロールを追加します。
    1. [データ ソース] フィールドに、プロセスの out_progress_datatable 引数を追加します。
    2. [Item Number] 列を追加して、データテーブル プロセスの Item Number をソースとして指定します。
    3. [Step Number] 列を追加して、データテーブル プロセスの Step Number をソースとして指定します。
    4. [Time] 列を追加し、データテーブル プロセスの Time をソースとして指定します。
    5. [Progress %] 列を追加し、データテーブル プロセスの Progress % をソースとして指定します。

結果

最終的に、アプリは以下のようになります。

結果

アプリをプレビューする場合、[プロセスを開始] ボタンを押します。

このアプリは、プロセスに関する以下の中間情報を提供します。

• 現在処理中の項目
• 現在のステップ
• ステップの完了率 (%)
• 項目、ステップ番号、タイムスタンプ、進行状況に関する情報を含む表
  
  

  

  
  

テキスト フィールドを使用して、項目数または項目のステップ数を変更することもできます。

サンプル ワークフロー

ワークフロー全体とアプリを確認するか、今後の参考にするには、こちらからファイルをダウンロードしてください。