Studio ガイド

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

UiPath 固有の変数

GenericValue 変数

GenericValue 変数は、テキスト、数値、日付、または配列といった種類のデータを格納することができる変数型であり、Studio 特有のものです。

GenericValue 変数は、特定のアクションを実行できるように自動的に他の型に変換されます。ただし、これらの変数の型はプロジェクトに対して常に正しく変換されるとは限らないため、使用には十分な注意が必要です。

UiPath Studio には GenericValue 変数の自動変換メカニズムがあり、式を正しく定義することで、目的の結果を得ることができます。式の最初の要素は、Studio から操作するガイドラインとして使用されることを考慮してください。たとえば、2 つの GenericValue 変数を追加し、式の最初の変数が String として定義されてた場合、最初に代入された値を元に 2 つの値を結合し、文字列となります。 Integer として定義した場合の結果は、合計の値となります。

.NET メソッドのサポート

名前 / 構文	説明
CompareTo `Function GenericValue.CompareTo(other As GenericValue) As Integer` `Function GenericValue.CompareTo(obj As Object) As Integer`	詳細はこちらをクリックしてください。
次の値を含む `Function GenericValue.Contains(other As String) As Boolean`	詳細はこちらをクリックしてください。文字列変数の特定の部分に、部分文字列が含まれているかどうかを確認するために使用しす。たとえば、文章に特定の単語が含まれているかどうかを確認するには、式は `[SentenceVariable].Contains("term")` である必要があります。`[SentenceVariable]`は文を含む GenericValue 変数で、`"term"` を検索する単語です。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
次に等しい `Function GenericValue.Equals(other As GenericValue) As Boolean` `Function GenericValue.Equals(obj As Object) As Boolean`	詳細はこちらをクリックしてください。
GetHashCode `Function GenericValue.GetHashCode() As Integer`	詳細はこちらをクリックしてください。
GetType `Function Object.GetType() As Type`	詳細はこちらをクリックしてください。
GetTypeCode `Function GenericValue.GetTypeCode() As TypeCode`	詳細はこちらをクリックしてください。
IndexOf `Function GenericValue.IndexOf(value As String) As Integer` `Function GenericValue.IndexOf(value As String, comparisonType As StringComparison) As Integer` `Function GenericValue.IndexOf(value As String, startIndex As Integer) As Integer` `Function GenericValue.IndexOf(value As String, startIndex As Integer, comparisonType As StringComparison) As Integer`	詳細はこちらをクリックしてください。文字列変数の中に含まれる部分文字列のインデックスを返すために使用します。たとえば、文字列の中のインデックス "locate" という単語を [Find 'locate' in this sentence] という文字列の中で見つけたい場合、式は `[SentenceVariable].IndexOf("locate")` でなければなりません。`[SentenceVariable]` は GenericValue 変数です。 `"locate"` は検索される単語です。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
長さ `Function GenericValue.Lenght() As Integer`	詳細はこちらをクリックしてください。 String 変数の文字数を返すために使用します。たとえば、単語の文字数を調べるには、式が `[WordVariable].Length` でなければなりません。`[WordVariable]` は単語を含む GenericValue 変数です。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
置換 `Function GenericValue.Replace(oldValue As String, new value As String) As String`	詳細はこちらをクリックしてください。 String 変数に含まれるデータを置き換えるために使用します。たとえば、ローカルのファイルパス `C:\ExampleFolder\Main.xaml` を対応するサーバーのファイルパス `C:/ExampleFolder/Main.xaml` に変更する場合、式は `[PathVariable].Replace("\","/")` とする必要があります。`[PathVariable]` は GenericValue 変数です。 `"\"` は置換される文字、`"/"` は置換する文字として使用されます。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
Split `Function GenericValue.Split(ParamArray separator As Char()) As String()` `Function GenericValue.Split(ParamArray separator As String()) As String()` `Function GenericValue.Split(separator As Char(), options As StringSplitOptions) As String()` `Function GenericValue.Split(separator As String(), options As StringSplitOptions) As String()`	詳細はこちらをクリックしてください。文字列変数からそれぞれのコンポーネントを返すために使用します。たとえば、[年] を MM.DD.YYYY の日付形式から抽出する場合は、式は `[DateVariable].Split(".".ToCharArray)(2)` でなければなりません。`[DateVariable]` は日付を含むGenericValue 変数で、`"."` はセパレーターとして使用される文字であり、`.ToCharArray` はセパレーターで区切られた要素を持つ配列を作るメソッドです。また、`(2)` は返される要素のインデックスで、この場合は、[年] を表します。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
Substring `Function GenericValue.Substring(startIndex As Integer) As String` `Function GenericValue.Substring(startIndex As Integer, length As Integer) As String`	詳細はこちらをクリックしてください。文字列変数に含まれる部分文字列を返すために使用します。たとえば、[There are 100 machines available]という文から単語を抽出する場合、式は`[SentenceVariable].Substring(10,3)` である必要があります。`[SentenceVariable]` は文を含むGenericValue 変数、[10] は返される最初の文字のインデックス、[3] は最初の文字から始まる部分文字列の文字数です。この例では、結果の部分文字列は [100] になります。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
ToBoolean `Function GenericValue.ToBoolean(provider As IFormatProvider) As Boolean`	詳細はこちらをクリックしてください。
ToByte `Function GenericValue.ToByte(provider As IFormatProvider) As Byte`	詳細はこちらをクリックしてください。
ToChar `Function GenericValue.ToChar(provider As IFormatProvider) As Char`	詳細はこちらをクリックしてください。
ToDecimal `Function GenericValue.ToDecimal(provider As IFormatProvider) As Decimal` `Function GenericValue.ToDecimal(format As NumberStyles) As Decimal`	詳細はこちらをクリックしてください。
ToDouble `Function GenericValue.ToDouble(provider As IFormatProvider) As Double` `Function GenericValue.ToDouble(format As NumberStyles) As Double`	詳細はこちらをクリックしてください。
ToInt `Function GenericValue.ToInt(culture As IFormatProvider) As Integer?` `Function GenericValue.ToInt() As Integer?`	指定した値を null を許容する整数に変換するために使用します。このメソッドを Boolean データ型の GenericValue 変数で使用すると、「True」と「False」の値がそれぞれ 1 と 0 に変換されます。
ToInt16 `Function GenericValue.ToInt16(provider As IFormatProvider) As Short`	詳細はこちらをクリックしてください。このメソッドを Boolean データ型の GenericValue 変数で使用すると、「True」と「False」の値がそれぞれ 1 と 0 に変換されます。
ToInt32 `Function GenericValue.ToInt32(provider As IFormatProvider) As Integer`	詳細はこちらをクリックしてください。このメソッドを Boolean データ型の GenericValue 変数で使用すると、「True」と「False」の値がそれぞれ 1 と 0 に変換されます。
ToInt64 `Function GenericValue.ToInt64(provider As IFormatProvider) As Long`	詳細はこちらをクリックしてください。このメソッドを Boolean データ型の GenericValue 変数で使用すると、「True」と「False」の値がそれぞれ 1 と 0 に変換されます。
ToLower `Function GenericValue.ToLower() As String`	詳細はこちらをクリックしてください。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
ToLowerInvariant `Function GenericValue.ToLowerInvariant() As String`	詳細はこちらをクリックしてください。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
ToSByte `Function GenericValue.ToSByte(provider As IFormatProvider) As SByte`	詳細はこちらをクリックしてください。
ToSingle `Function GenericValue.ToSingle(provider As IFormatProvider) As Single`	詳細はこちらをクリックしてください。
ToString `Function GenericValue.ToString(formatProvider As IFormatProvider) As String` `Function GenericValue.ToString(format As String, formatProvider As IFormatProvider) As String` `Function GenericValue.ToString() As String`	詳細はこちらをクリックしてください。
ToType `Function GenericValue.ToType(conversionType As Type, provider As IFormatProvider) As Object`	詳細はこちらをクリックしてください。
ToUInt16 `Function GenericValue.ToUInt16(provider As IFormatProvider) As UShort`	詳細はこちらをクリックしてください。このメソッドを Boolean データ型の GenericValue 変数で使用すると、「True」と「False」の値がそれぞれ 1 と 0 に変換されます。
ToUInt32 `Function GenericValue.ToUInt32(provider As IFormatProvider) As UInteger`	詳細はこちらをクリックしてください。このメソッドを Boolean データ型の GenericValue 変数で使用すると、「True」と「False」の値がそれぞれ 1 と 0 に変換されます。
ToUInt64 `Function GenericValue.ToUInt64(provider As IFormatProvider) As Ulong`	詳細はこちらをクリックしてください。このメソッドを Boolean データ型の GenericValue 変数で使用すると、「True」と「False」の値がそれぞれ 1 と 0 に変換されます。
ToUpper `Function GenericValue.ToUpper() As String`	詳細はこちらをクリックしてください。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
ToUpperInvariant `Function GenericValue.ToUpperInvariant() As String`	詳細はこちらをクリックしてください。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
Trim `Function GenericValue.Trim(ParamArray trimChars As Char()) As String` `Function GenericValue.Trim() As String`	詳細はこちらをクリックしてください。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
TrimEnd `Function GenericValue.TrimEnd(ParamArray trimChars As Char()) As String`	詳細はこちらをクリックしてください。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。
TrimStart `Function GenericValue.TrimStart(ParamArray trimChars As Char()) As String`	詳細はこちらをクリックしてください。このメソッドを Int、Float、または Boolean データ型の GenericValue 変数で使用すると、データは自動的に String に変換され、それに応じて処理されます。

[値を書式化] アクティビティ本体で Ctrl + K、Ctrl + M、Ctrl + Shift + M のいずれかを直接使用すると、作成される変数または引数の型が GenericValue になります。その他のアクティビティでは、アクティビティに必要な型と同じになります。

GenericValue 変数の使用例

GenericValue 変数の動作を確認するためには、式の定義方法によって結果が変わるような操作をするオートメーションを作成する必要があります。異なるデータ型の 2 つの GenericValue 変数を作成し、結果を [出力] パネルに表示します。

新しいプロジェクトを作成します。
3 つの GenericValue 変数 Int、 Str、および Result を作成します。
Int 変数の [既定値] 列に 12 を入力し、Str 変数に "34" と入力します。最初の変数は整数として処理され、2 番目の変数は文字列として処理されます。
デザイナー パネルに[代入] アクティビティを追加し、 Start ノードに接続します。
[プロパティ] パネルの [左辺値 (To)] フィールドに、Result 変数を入力します。
[右辺値 (Value)] フィールドに、「Int + Str」と入力します。
[ 1 行を書き込み ] アクティビティを追加して、[ 代入 ] アクティビティに接続します。
アクティビティカードをダブルクリックし、[テキスト] フィールドに Result 変数を入力します。

プロジェクトは次のスクリーンショットのようになります。

docs image 9. F5 キーを押してオートメーションを実行します。[ 出力 ] パネルには、2 つの数値の合計が表示されます。

docs image 10. 以前追加した [代入 ] アクティビティに戻り、[ 右辺値 (Value)] フィールドを Str + Intに変更し、変数の順序を逆にします。プロジェクトは次のスクリーンショットのようになります。

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168405-0095bd04.webp)
![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168405-0095bd04.webp)

11. F5 キーを押してオートメーションを実行します。[出力] パネルには、2 つの数値が連結されて表示されます。

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-171684-f3d0024b.webp)
![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-171684-f3d0024b.webp)

UiPath Studio は、式で定義された最初の要素を実行する操作のガイドラインとして使用します。式の最初の要素が整数、または整数として入力されたジェネリック値変数の場合、UiPath Studio は要素を合計します。

式の最初の要素が文字列、または文字列として入力されたジェネリック値変数の場合、UiPath Studio は要素を連結します。

サンプルをダウンロードする

QueueItem 変数

QueueItem 型変数のセクションに進む前に、「キューおよびトランザクションについて」でキューとトランザクションの概要を確認することをお勧めします。

このテーマに関して詳しく学習する前に、キューアイテム (Orchestrator 内のキューに格納されるアイテム) と QueueItem 変数 (Studio でキューアイテムを処理するために使用される変数) の違いをしっかり理解しておいてください。UiPath では、この2つを「QueueItem 変数」と「キューアイテム」と呼んで区別しています。

大まかに言うと、QueueItem 変数は、その名前が示すとおり、アイテムのコンテナーであるキューから抽出したアイテムを格納します。一般的にこの抽出の目的は、さまざまな状況でキューアイテムを使用できるようにすることです。たとえば、銀行で 50 件の顧客に関する預金レポートがあるとします。第三者の金融アプリケーションを使用して、5000 ドル未満の自行払い小切手 (On-Us Check) を以前預金したことのある顧客ごとのデータを処理する場合を考えます。ここでは、QueueItem 変数が顧客ごとの情報を順番に格納するワークフローを作成できます。QueueItem 変数が読み取った各エントリは、キューアイテムに格納され、Orchestrator の指定したキューに追加されます。このプロセスの結果は、対応するキューアイテムにそれぞれ格納された顧客の情報を含む1つのキューになります。

条件に一致するデータをさらに処理するには、以前作成したキューから、該当する 5000 ドル未満の自行払い小切手 (On-Us Check) を持つ項目を抽出するために、別のワークフローを作成しなければなりません。こうしたプロジェクトの作成手順については、このトピックの最後で説明します。

.NET メソッドのサポート

名前 / 構文	説明
次に等しい `Function Object.Equals(obj As Object) As Boolean`	詳細はこちらをクリックしてください。
GetHashCode `Function Object.GetHashCode() As Integer`	詳細はこちらをクリックしてください。
GetType `Function Object.GetType() As Type`	詳細はこちらをクリックしてください。
ToString `Function Object.ToString() As String`	詳細はこちらをクリックしてください。

サポートされるプロパティ

名前 / 構文	説明
AssignedTo `Property QueueItem.AssignedTo As String`	詳細はこちらをクリックしてください。
期限日 `Property QueueItem.DueDate As Date?`	項目が処理されるべき最終の日時です。空白の場合は、項目を任意の日時に処理できます。
延期日 `Property QueueItem.DueDate As Date?`	項目が処理可能な最短の日時です。空白の場合は、項目を可能な限り早く処理できます。
ID `Property QueueItem.Id As Long?`	詳細はこちらをクリックしてください。
ItemKey `Property QueueItem.ItemKey As Guid`	項目の一意の識別子です。たとえば、`1bf829e1-cd6b-4275-a364-19db3cfe09c7` です。
優先度 `Property QueueItem.Priority As QueueItemPriority`	Studio で定義されているキューアイテムの優先度です。[プロパティ] パネルの [優先度] フィールドに表示されます。
ProcessingException `Property QueueItem.ProcessingException As ProcessingException`	失敗した項目の処理例外です。
進行状況 `Property QueueItem.Progress As String`	ステータスが [進行中] であるキューアイテムに関するカスタム進行状況情報です。
QueueDefinitionId `Property QueueItem.QueueDefinitionId As Long`	キューアイテム/トランザクションが作成されたキューの一意の識別子です。
QueueName `Property QueueItem.QueueName As String`	処理されたアイテムを含むキューの名前です。
参照 `Property QueueItem.Reference As String`	キューアイテムをすぐに識別するためのユーザー定義の値です。
RetryNo `Property QueueItem.RetryNo As Integer`	アイテムをリトライした回数です。
レビューステータス `Property QueueItem.ReviewStatus As String`	Orchestrator から取得したキューアイテムのリビジョンステータスです。
RowVersion `Property QueueItem.RowVersion As Byte()`	バージョンスタンプに使用する内部フィールドです。実行中のトランザクションのプロパティが変わるごとに更新されます。
SpecificContent `Property QueueItem.SpecificContent As Dictionary(Of String, Object)`	[キューアイテムを追加] アクティビティの設定に従って、実行中のトランザクションに関連するカスタムデータを格納するキーと値のペアのコレクションです。
StartTransactionTime `Property QueueItem.StartTransactionTime As Date?`	トランザクション処理の開始日時です。
ステータス `Property QueueItem.Status As QueueItemStatus`	Orchestrator から取得したキューアイテムのステータスです。

QueueItem 変数の使用例

この例の性質上、このセクションは 2 つの部分に分かれています。キューおよびキューアイテムの操作で使用する2つのメインワークフローそれぞれを表しています。

キューにアイテムをアップロードする

アイテムをキューに追加する方法を説明するために、.xlsx ファイルに含まれるエントリを処理するオートメーションプロジェクトを作成します。たとえば、銀行で 50 件の顧客に関する預金レポートがあるとします。第三者の金融アプリケーションを使用して、5000 ドル未満の自行払い小切手 (On-Us Check) を以前預金したことのある顧客ごとのデータを処理する場合を考えます。レポートには、顧客の名前、自行払い小切手 (On-Us Check) の金額に加えて、現金化 (Cash In) と他行払い小切手 (Not On-Us Check) の金額が記載されているとします。ここでは、QueueItem 変数が顧客ごとの情報を順番に格納するワークフローを作成します。QueueItem 変数が読み取った各エントリは、キューアイテムに格納され、Orchestrator の指定したキューに追加されます。このプロセスの結果は、顧客ごとの固有情報を含む1つのキューになります。実際のワークフローに進む前に、顧客レポートをこちらで確認しておくと良いでしょう。これから、「July Reports」シートで操作を行います。

後で面倒なことが起きないように、次のことを行います。

新しいシーケンスを作成します。
シーケンス内部に [Excel プロセススコープ ] アクティビティを追加します。
[ Excel ファイルを使用 ] アクティビティを追加し、このアクティビティの [ Excel ファイル ] フィールドでブックの場所を定義します。
[ 範囲を読み込み ] アクティビティを追加し、レポートから値の範囲を読み込んで DataTable 型変数に格納します。
[範囲] フィールドの右側にあるプラス記号 > [Excel] > [Excel 内で示す] を選択し、セルの範囲 (例: A1:D51) を選択します。
[保存先] フィールドで、Ctrl + K を押して、読み込んだデータ範囲を格納する新しい DataTable 型変数を作成します。dt_DataTable1 またはそれに類似した名前を付けます。[変数] ウィンドウには、新しく作成された変数も表示されます (下図参照)。
次に、[繰り返し ( データテーブルの各行 )] アクティビティを デザイナー パネルに追加し、空白のフィールドに、「row」と DataTable 型変数 dt_DataTable1をそれぞれ入力します。このアクティビティは、データテーブルの各行に対してアクティビティ内で定義したアクションを実行します。シーケンスは、次のスクリーンショットと同じように表示されます。
[繰り返し (データテーブルの各行)] アクティビティ内に [キューアイテムを追加] アクティビティを追加します。これにより、スプレッドシートの各行について、1 つのアイテムが 1 つのキュー (後述の手順 8～12 を参照) に追加されます。
[キュー名] フィールドに、アイテムを格納するキューの名前を指定します。ここでは、「ReportQueue」とします。
[アイテム情報] の下にあるフィールドをクリックしてディクショナリビルダー ウィンドウを開きます。レポートの列に対応する引数を 4 つ作成します。これらを次のように定義します。
- Name - [方向] と [種類] は既定値のままにして、[値] を row(0).ToString に設定します。これにより、ブックの各行でカウンターが 0 の列から値を取得します。この場合は、顧客の名前です。
- CashIn - [方向] と [種類] は既定値のままにして、[値] を row(1).ToString に設定します。これにより、ブックの各行でカウンターが 1 の列から値を取得します。この場合は [Cash In] の値です。
- OnUsCheck - [方向] と [種類] は既定値のままにして、[値] を row(2).ToString に設定します。これにより、ブックの各行でカウンターが 2 の列から値を取得します。この場合は、[On-Us Check] の値です。
- NotOnUsCheck - [方向] と [種類] は既定値のままにして、[値] を row(3).ToString に設定します。これにより、ブックの各行でカウンターが 3 の列から値を取得します。この場合は、[Not On-Us Check] の値です。
ディクショナリビルダー ウィンドウは、次のスクリーンショットのように表示されます。
Studio のロボットを Orchestrator に接続します。手順については、こちらをご覧ください。
https://cloud.uipath.com に移動します。資格情報を使用してログインし、項目を格納するための「ReportQueue」というキューを作成します。ここで、前の手順 (手順 8) で使用した名前と同じ名前を必ず使用してください。
Studio に戻ります。この時点で、ワークフローはエラーを発生させることなく機能しているはずです。次の手順は、これを Orchestrator が使用できるようにすることです。このために、[デザイン] > [パブリッシュ] をクリックします。
このプロセスを実行するには、[デザイン] > [実行] をクリックします。

注:
キューアイテムは処理された後にトランザクションとなり、それ以降はトランザクションとして取り扱われることに留意してください。
再び https://cloud.uipath.com に移動して、このトランザクションを表示します。

キューのトランザクションを処理する

キューのトランザクションをさらに処理する方法を説明するために、2つ目のワークフローを作成します。このワークフローでは、該当するキューから 5000 ドル未満の自行払い小切手 (On-Us Check) のトランザクションを取得します。条件に合う各トランザクションについて、値が収集され、サードパーティのダミーアプリケーションに導入されます。それ以外については、ビジネス例外としてラベル付けします。

[デザイン] > [新規作成] > [フローチャート] に移動し、上記で開始したプロジェクトで新しいファイルを作成します。
サードパーティのダミーアプリケーションを開くために、[ アプリケーション/ブラウザーを使用 ] アクティビティを追加します。Start ノードに接続します。
[プロパティ] パネルに、必須の情報 (表示名、ファイルパス、セレクター) を入力し、該当する資格情報でログインするようにアクティビティを設定します。admin を [ユーザー名] フィールドに、password を [パスワード] フィールドに使用します。
[ファイルパス] フィールドには、アプリケーションのパスを入力します。
[セレクター] フィールドで、セレクターエディターを使用して UIDemo のセレクターを定義します。
[ 停止すべきか確認] アクティビティを デザイナー パネルに追加し、[ アプリケーションを開く] アクティビティに接続します。
[ フロー条件分岐] アクティビティを デザイナー パネルに追加し、[ 停止すべきか 確認] アクティビティと接続します。この最後の 2 つのアクティビティは、ジョブの実行中に停止を行ったかどうかをチェックします。これにより、停止がトリガーされた後にさまざまな安全のためのルーチンを実行するワークフローをさらに設定する可能性があります。こうしたルーチンの例を次に示します。
- [ メッセージをログ ] アクティビティを追加して、これまでに追加したフロー条件分岐の [True ] 分岐に接続します。
- [プロパティ] パネルの [メッセージ] フィールドに、停止がトリガーされた場合に表示するメッセージとして、「Stop process required」(停止プロセスが必要) などの文言を入力します。
- [ アプリケーションを閉じる ] アクティビティを追加して、これまでに追加した [メッセージをログ ] アクティビティに接続します。
- [プロパティ] パネルの [表示名] フィールドで、「アプリケーションを閉じる」の後に「UIDemo.exe UIDemo」と入力します。
[ トランザクションアイテムを取得 ] アクティビティを、これまでに追加したフロー条件分岐 (手順 7 ) の False 分岐に接続します。このアクティビティは、キューからトランザクションアイテムを取得し、ループが反復処理されるたびに順番に QueueItem 変数に格納します。
[プロパティ] ウィンドウの [キュー名] フィールドに、アイテムを格納するキューの名前を入力します。ここでは、「キューにアイテムをアップロードする」セクションで定義したように、「ReportQueue」いう名前を使います。
[トランザクションアイテム] フィールドで、Ctrl + K を押して、読み込んだトランザクションアイテムを格納する QueueItem 変数を作成します。「TransItem」またはそれに類似した名前を付けます。
[フロー条件分岐] アクティビティをデザイナー パネルに追加し、[トランザクションアイテムを取得] アクティビティと接続します。
[プロパティ] ウィンドウの [条件] フィールドに、TransItem isNot Nothing と入力します。この詳細は次のとおりです。このアクティビティはキューの最後まで達しているか判別するために各項目の値を確認します。
手順 7 で作成した [フロー条件分岐] の [False] 分岐を [メッセージをログ] アクティビティに接続します。これによって、キューの最後に達したときにジョブが確実に停止するようになります。
別の [フロー条件分岐] アクティビティをデザイナー パネルに追加し、手順 11 で作成した [フロー条件分岐] の [True] 分岐に接続します。
[プロパティ] ペインの [条件] フィールドに、「cint(TransItem.SpecificContent("OnUSCheck").ToString) < 5000」と入力します。上記の式は、QueueItem 変数の OnUSCheck 値を String 型変数に変換し、さらに整数に変換します。こうして取得した値について、条件に適合しているかどうかをチェックします。
- cint は変数を String 型から Integer 型に変換します。
- TransItem は、アイテムを格納するために使用する QueueItem 変数 (手順 18) です。
- SpecificContent("OnUSCheck") は、各アイテムの On US Check 引数の内容を取得します。
- .ToString は QueueItem 変数のコンテンツを String 型変数に変換します。
- < 5000 は、チェック対象となる条件です。
[トランザクションのステータスを設定] アクティビティをデザイナー パネルに追加し、前の [フロー条件分岐] (手順 13) の [False] 分岐に接続します。
[プロパティ] ウィンドウで、[ステータス] フィールドが [失敗] に設定され、[エラーの種類] が [ビジネス] に設定されていることが確認します。このように、自行払い小切手 (On US Check) の額が 5000 以上であるトランザクションは、失敗としてマークされ、ビジネス例外となります。
[トランザクションアイテム] フィールドに TransItem 変数を追加します。
[理由] フィールドに、失敗したトランザクションに対して表示するメッセージとして、「OnUSCheck amount is bigger than 5000」(自行払い小切手の金額が 5000 以上です) などの文言を入力します。
[トランザクションのステータスを設定] アクティビティを [停止すべきか確認] アクティビティ (手順 6) に接続し、キューの次のトランザクションのループとプロセスを作成します。
[シーケンス] アクティビティをデザイナー パネルに追加し、[フロー条件分岐] (手順 13) の [True] 分岐に接続します。このシーケンス内に、[ トライキャッチ] アクティビティを追加し、項目処理中に、可能性のあるエラーがすべて、アプリケーションエラーとして正しくラベル付けされるように設定します。
UIDemo アプリケーションを開き、ユーザー名 admin、パスワード password でログインします。
UIDemo アプリケーションの [現金化 (Cash In)]、[自行払い小切手 (On Us Check)]、[他行払い小切手 (Not On Us Check)] の各フィールドについて、次の一連のアクティビティを実行します。
- これまでに追加した [ トライキャッチ ] アクティビティに、アプリケーションを開くための [ アプリケーション/ブラウザーを使用 ] アクティビティを追加します。
- [文字を入力] アクティビティを追加します。
- [画面上でターゲットを指定] をクリックし、UIDemo インターフェイスから、「現金化 (Cash In)」に対応する空白のフィールドを選択します。
- [以下を入力] フィールドに、「transItem.SpecificContent("CashIn").ToString」と入力します。この式のそれぞれの項目については、前述の手順 15 で説明しています。この式は、各 QueueItem 変数の値を String 型変数に変換します。
前の[文字を入力] アクティビティの後に [ テキストを取得] アクティビティを追加し、オプションメニューから [画面上でターゲットを指定] を選択します。
UIDemo アプリケーションでトランザクション番号を指定して、[確認] をクリックします。
[テキスト] フィールドに新しい変数 (たとえば、TransNumber) を設定します。これにより、最初の条件を満たすキューアイテムごとにトランザクション番号を取得します。
[トランザクションのステータスを設定] アクティビティを [テキストを取得] アクティビティの後に追加します。
[ステータス] フィールドが [成功] に設定され、[エラーの種類] が [アプリケーション] に設定されていることを確認します。このように、値のセットがアプリケーションに正常に導入された場合、トランザクションのステータスが「成功」となるか、それ以外の場合はアプリケーション例外とラベル付けされます。
[出力] ウィンドウで、新しい引数を定義し、これまでに作成した変数 TransNumber (手順 25) を値として追加します。
[トランザクションアイテム] フィールドに TransItem 変数を追加します。
[トランザクションのステータスを設定] アクティビティの後に [クリック] アクティビティを追加します。
[画面上でターゲットを指定] をクリックし、UIDemo インターフェイスで [Accept] ボタンを選択します。
[トライキャッチ] アクティビティは、次のスクリーンショットのように表示されます。
フローチャートに戻って、これまでに追加した [シーケンス] アクティビティ (手順 21) を[停止すべきか確認] アクティビティ (手順 6) に接続し、キューの次のトランザクションのループとプロセスを作成します。
フローチャートは、次のスクリーンショットのように表示されます。
このプロセスを実行するには、[デザイン] > [実行] をクリックします。
実行が終了したら、https://cloud.uipath.com に移動し、処理済みのトランザクションを表示できます。各処理に関する詳細情報も確認できます。