リアルタイム電卓を構築する

概要

UiPath Apps と UiPath Robot がすぐに通信できるようにするには、以下の手順を実行する必要があります。

• 次で構成されるプロジェクトを UiPath Studio で構築します。

  • Main.Xaml - トリガーの実行に使用されるメイン ワークフローです。

  • アプリによってトリガーされる複数のワークフロー - 基本的な算術演算に使用されます。これらのワークフローはエントリ ポイントとして設定します。

    算術演算子	Studio のワークフロー
    加算	Sum.xaml
    減算	Subtract.xaml
    乗算	Multiply.xaml
    除算	Divide.xaml

  • トリガー ワークフロー - このワークフローはテンプレートとしても使用できますが、ユーザーが作成して、業務のニーズに合わせてカスタマイズすることもできます。

• 以下のコンポーネントで構成されるアプリを UiPath Apps で構築します。

  • 2 つの入力コントロール - 数字を入力するコントロールです。

  • 4 つのボタン コントロール - トリガー ワークフロー ルールが設定されており、ボタンを、Studio のワークフローで表される特定の算術演算にバインドします。

  • 4 つのテキスト ボックス コントロール - 算術演算の結果が送信されるコントロールです。

UiPath Studio プロジェクトを構築する

注: 2023.4 以降の UiPath Studio と 2023.4 以降の UiPath Robot を使用していることを確認してください。

可能であれば、Studio プロジェクトをバックグラウンド プロセスとして開始するように設定することをお勧めします。これは、同じアプリを同時に複数のブラウザー ウィンドウで実行してもエラーがスローされないようにするのに役立ちます。

トリガー ワークフローを構築する (テンプレート)

1. UiPath Studio を開いて、新しいプロセスを作成します。
   1. 言語を選択します。
   2. [対応 OS] として [Windows] を選択します。
2. 以下のアクティビティ パッケージのバージョンがインストールされていることを確認してください。

   • UiPath.WorkflowEvents.Activities 2.0

   • UiPath.System.Activities 23.4+

3. Apps-Workflow Communication というテンプレートから開始するか、[プロジェクト] パネルで新しいワークフローを追加します。このワークフローには、UiPath Apps と UiPath Robot 間の通信チャネルを有効化するアクティビティとして、[Apps の要求トリガー] アクティビティと [Apps の要求を処理] アクティビティが含まれます。

   Apps-Workflow Communication テンプレートを使用する場合は、「電卓ワークフローを構築する」に進んでください。

4. [Apps の要求トリガー] アクティビティを追加します。これは、ワークフローの最初のアクティビティである必要があります。

   [Apps の要求トリガー] アクティビティをワークフローに追加すると、[TriggerEventArgs] 引数が自動的に作成されます。この引数を、[Apps の要求を処理] アクティビティで使用し、ワークフローの実行後に受信した応答ペイロードからのデータにアクセスに使用します。

5. Apps クライアントとの接続を失ったケースをキャッチするために、[条件分岐 (if)] アクティビティを追加します。ユーザーが Apps クライアントを閉じる際には、すべてのトリガーが停止する必要があります。
   1. [条件] フィールドに、式「ConditionTriggerEventArgs.ConnectionWithAppLost = true」を渡します。
   2. [Then] セクションに [ローカル トリガーを停止] アクティビティを追加します。
   3. [Else] セクションに [Apps の要求を処理] アクティビティを追加します。
   4. [Apps の要求を処理] アクティビティの [引数] フィールドで [Apps の要求トリガー] アクティビティによって自動で生成された [TriggerEventArgs] 引数を使用します。この引数には、[Apps の要求トリガー] アクティビティから受け取ったワークフロー ペイロードが含まれており、[Apps の要求を処理] アクティビティに渡されます。ワークフローの実行中に、[Apps の要求を処理] アクティビティはペイロードの情報を使用してワークフローを呼び出し、そのワークフローの完了時にワークフローの出力結果を返します。
      注:

      [Apps の要求を処理] アクティビティは、接続が失われた場合は、失われる条件の [Else] セクション内で使用する必要があります。これにより、UiPath Apps と UiPath Robot 間のアクティブな接続中にアクティビティが呼び出されるようになります。このため、接続が失われた時点でプロセスの実行は終了します。

電卓ワークフローを構築する

1. プロジェクトにフォルダーを作成し、「Calculator」という名前を付けます。この場所に電卓ワークフローを保存します。
2. フォルダー内に、算術演算ごとにワークフローを作成します。

   算術演算子	Studio のワークフロー
   加算	Sum.xaml
   減算	Subtract.xaml
   乗算	Multiply.xaml
   除算 (Division)	Divide.xaml

3. 前に作成したすべてのワークフローで、以下の引数を定義します。

   引数名	方向	引数の型
   number1	In	Int32
   number2	In	Int32
   結果	Out	Int32 Double - 除算用

   引数「number1」と「number2」は、Apps のユーザーが入力するデータです。

   引数「result」は、ワークフローの実行後に受け取る出力です。

4. 前に作成したすべてのワークフローで、[代入] アクティビティを追加します。次のように設定します。

   ワークフロー	[保存先] フィールド	[保存する値] フィールド
   Sum.xaml	結果	number1 + number2
   Subtract.xaml	結果	number1 - number2
   Multiply.xaml	結果	number1 * number2
   Divide.xaml	結果	Cint(Math.Truncate(Decimal.Divide(number1,number2)))

5. ワークフローを保存します。
6. 電卓ワークフローをエントリ ポイントとしてマークします。各ワークフローを右クリックして、[エントリ ポイントを有効化] オプションを選択します。これにより、XAML がアプリ内に確実に表示されます。

Main ワークフローを構築する

注:

Apps-Workflow Communication テンプレートを使用する場合、この手順はスキップしてください。

Main.xaml ファイルに [ローカル トリガーを実行] アクティビティを追加し、ファイルを保存します。

Orchestrator でプロジェクトを管理する

1. Studio で、プロジェクト パッケージを Orchestrator のフォルダーにパブリッシュします。
   注:

   プロジェクトを個人用ワークスペースにパブリッシュすると、対応するプロセスが自動的に作成されます。「Apps プロジェクトを構築する」に進んでください。

2. お使いの Orchestrator テナントで、Studio パッケージをパブリッシュしたフォルダーに移動します。
3. [オートメーション] > [プロセス] に移動して、[プロセスを追加] をクリックします。
4. [パッケージ ソース名] ドロップダウンから、Studio プロジェクトを選択します。
5. [エントリ ポイント] ドロップダウンから、[Main.xaml] を選択します。
6. 次のページで、必要に応じてプロセスを設定し、[作成] をクリックします。これで Studio プロジェクトが Orchestrator プロセスとして利用できるようになります。

Apps プロジェクトを構築する

注: [VB の式] オプションが有効化されている UiPath Apps を使用していることを確認してください。

コントロールを追加する

1. UiPath Apps のホーム ページの [構築] タブで [新しいアプリを作成] をクリックします。
2. アプリの [名前] を入力します。例: リアルタイムな電卓
3. [記述言語] として [VB] を選択します。
4. [MainPage]で、以下の [全般] プロパティを含む以下のコントロールを追加します。

   制御	[全般] プロパティ: 値	説明
   1. ラベル	テキスト: 「リアルタイムな電卓」	アプリにタイトルを追加します。
   2. テキストボックス (数) - 名前を「number1」に変更します。	ラベル: 「1 番目の数字」 ヒント テキスト: 「最初の整数を入力します。」	ユーザーがデータを入力できます。
   3. テキストボックス (数) - 名前を「number2」に変更します。	ラベル: 「2 番目の数字」 ヒント テキスト: 「二番目の整数を入力します。」	ユーザーがデータを入力できます。
   4. ボタン - 名前を「加算」に変更します。	テキスト: 「加算です。」	Sum.xaml ファイルの実行をトリガーします。
   5. テキストボックス - 名前を「加算結果」に変更します。	NA	Sum.xaml ファイルの応答を出力します。
   6. ボタン - 名前を「減算」に変更します。	テキスト: 「減算」	Subtract.xaml ファイルの実行をトリガーします。
   7. テキストボックス - 名前を「減算結果」に変更します。	NA	Subtract.xaml ファイルの応答を出力します。
   8. ボタン - 名前を「乗算」に変更します。	テキスト: 「乗算」	Multiply.xaml ファイルの実行をトリガーします。
   9. テキストボックス - 名前を「乗算結果」に変更します。	NA	Multiply.xaml ファイルの応答を出力します。
   4. ボタン - 名前を「除算」に変更します。	テキスト: 「除算」	Divide.xaml ファイルの実行をトリガーします。
   11. テキストボックス - 名前を「除算結果」に変更します。	NA	Divide.xaml ファイルの応答を出力します。

プロセスを追加する

プロセスをリソースとして追加し、Studio のワークフローを Apps のコントロールにバインドします。

1. アプリ内で [コントロールを追加] ドロップダウンを展開し、[プロセス] を選択します。
2. 現在のアカウントのテナントのリストが表示されます。必要なプロセスをホストするテナントを選択し、[次へ] をクリックします。
3. 左側のパネルから、プロセスを作成した Orchestrator フォルダーを展開してプロセスを選択し、[追加] をクリックします。たとえば、[Calculator] プロセスを選択します。

   アプリにプロセスを追加すると、メイン ワークフローと、エントリ ポイントとしてマークされたワークフローが、Studio プロジェクトで定義された入力引数と出力引数とともに表示されます。

[ボタン] コントロールにルールを追加する

すべての [ボタン] コントロールに TriggerWorkflow ルールを追加することで、アプリケーションに、Apps ユーザーがボタンをクリックするたびに特定のワークフローを実行するようアプリケーションに指示します。

すべての [ボタン] コントロールに対して、次の手順を繰り返します。

1. [ボタン] コントロールを選択します。
2. 右側の [イベント] パネルで [ルールを作成] をクリックします。ルールを設定 ウィザードが開きます。
3. [トリガー ワークフロー] ルールを探して選択します。
4. [ワークフロー ファイル] フィールドで、前に追加したプロセス (「Calculator」) を展開し、対応するワークフロー (.xaml ファイル) を選択します。たとえば、[加算] ボタンは「calculator_Sum_xaml」ファイルを参照する必要があります。
5. [入力の上書き] フィールドをクリックして、前に選択したワークフローを展開します。
   1. 「number1」をダブルクリックして、1 つ目の入力引数として選択します。
   2. [値を入力] フィールドで、「tune」アイコンをクリックして式エディターを開き、次の VB 式を書き込みます。
      MainPage.number1.Value
   3. 「number2」をダブルクリックして、2 つ目の入力引数として選択します。
   4. [値を入力] フィールドで、「tune」アイコンをクリックして式エディターを開き、次の VB 式を書き込みます。
      MainPage.number2.Value
   注: 式内の「number1」および「number2」は、それぞれ「number1」と「number2」に名前が変更された [テキストボックス (数)] コントロールを参照します。これらのコントロールの値を入力引数の値として設定することで、ユーザー入力を Apps から Studio ワークフローに渡すことができます。

   
6. [完了時] フィールドを展開し、[値を設定] ルールを追加します。
   1. [設定する項目] フィールドで、「tune」アイコンをクリックして式エディターを開き、結果コントロールを参照します。たとえば、合計結果を得る場合は、次の VB 式を書き込みます。
      MainPage.sum_result.Value
   2. [値] フィールドで、「tune」アイコンをクリックして式エディターを開き、ワークフローの結果を参照します。たとえば、加算演算子を得る場合は、次の VB 式を書き込みます。
      Processes.Calculator.calculator_Sum_xaml.result.ToString
   注: [完了時] フィールドに [値を設定] ルールを追加することで、ワークフローの実行完了後に出力として返される値が使用されるため、ワークフローの結果を対応する結果コントロールにバインドするために使用する値が正しいことを確認できます。

   
7. 残りのボタンに対してこれまでの手順を繰り返します。

   [ボタン] コントロール	ワークフロー ファイル
   減算	calculator_Subtract_xaml
   乗算	calculator_Multiply_xaml
   除算	calculator_Divide_xaml

アプリを Orchestrator にパブリッシュしてデプロイする

アプリの実行の準備するには、アプリを Orchestrator テナント フィードにパブリッシュしてからデプロイする必要があります。

1. Apps で、上部のナビゲーション バーにある [パブリッシュ] をクリックします。
2. Orchestrator に切り替えて、目的のフォルダーに移動します。
3. [オートメーション] > [アプリ] に移動して、[アプリをデプロイ] をクリックします。アプリをデプロイ ウィザードが開きます。
4. [アプリ] ドロップダウンから、パブリッシュ済みのアプリを選択します。
5. [デプロイ] をクリックします。これで、アプリを Orchestrator フォルダーから実行できるようになります。

アプリを実行する

これでアプリを実行する準備ができました。

1. UiPath Assistant の [ホーム] パネルの [アプリ] カテゴリ下でアプリを検索します。
2. [実行] をクリックします。UiPath Robot Assistant にアクセス権を付与するよう求められます。
3. 2 つの数字を入力します。
4. 希望する算術演算のボタンをクリックします。

初回の計算には時間がかかります。これは、ジョブの最初のインスタンス化を行っているためです。その後は、ジョブは実行され続け、すぐに結果を返します。アプリのセッションを閉じると、ジョブは終了します。