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 変数を作成し、結果を [出力] パネルに表示します。

1. 新しいプロジェクトを作成します。

2. 3 つの GenericValue 変数 Int、 Str、および Result を作成します。

3. Int 変数の [既定値] 列に 12 を入力し、Str 変数に "34" と入力します。最初の変数は整数として処理され、2 番目の変数は文字列として処理されます。

   

4. デザイナー パネルに[代入] アクティビティを追加し、 Start ノードに接続します。

5. [プロパティ] パネルの [左辺値 (To)] フィールドに、Result 変数を入力します。

6. [右辺値 (Value)] フィールドに、「Int + Str」と入力します。

7. [ 1 行を書き込み ] アクティビティを追加して、[ 代入 ] アクティビティに接続します。

8. アクティビティ カードをダブルクリックし、[テキスト] フィールドに Result 変数を入力します。

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

9. Press F5 to execute your automation. Note that, in the Output panel, the sum of the two numbers is displayed.

10. Go back to the previously added Assign activity and change the Value field to Str + Int, to reverse the order of the variables. The project should look as in the following screenshot.

![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)

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」シートで操作を行います。

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

1. 新しいシーケンスを作成します。

2. シーケンス内部に [Excel プロセス スコープ ] アクティビティを追加します。

3. [ Excel ファイルを使用 ] アクティビティを追加し、このアクティビティの [ Excel ファイル ] フィールドでブックの場所を定義します。

4. [ 範囲を読み込み ] アクティビティを追加し、レポートから値の範囲を読み込んで DataTable 型変数に格納します。

5. On the right side of the Range field, select Plus > Excel > Indicate in Excel and select a range of cells (for example, A1:D51).

6. [保存先] フィールドで、Ctrl + K を押して、読み込んだデータ範囲を格納する新しい DataTable 型変数を作成します。dt_DataTable1 またはそれに類似した名前を付けます。[変数] ウィンドウには、新しく作成された変数も表示されます (下図参照)。

   

7. 次に、[繰り返し ( データ テーブルの各行 )] アクティビティを デザイナー パネルに追加し、空白のフィールドに、「row」と DataTable 型変数 dt_DataTable1をそれぞれ入力します。このアクティビティは、データ テーブルの各行に対してアクティビティ内で定義したアクションを実行します。シーケンスは、次のスクリーンショットと同じように表示されます。

   

8. [繰り返し (データ テーブルの各行)] アクティビティ内に [キュー アイテムを追加] アクティビティを追加します。これにより、スプレッドシートの各行について、1 つのアイテムが 1 つのキュー (後述の手順 8～12 を参照) に追加されます。

9. [キュー名] フィールドに、アイテムを格納するキューの名前を指定します。ここでは、「ReportQueue」とします。

10. [アイテム情報] の下にあるフィールドをクリックしてディクショナリ ビルダー ウィンドウを開きます。レポートの列に対応する引数を 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] の値です。

11. ディクショナリ ビルダー ウィンドウは、次のスクリーンショットのように表示されます。

    

12. Studio のロボットを Orchestrator に接続します。手順については、こちらをご覧ください。

13. https://cloud.uipath.com に移動します。資格情報を使用してログインし、項目を格納するための「ReportQueue」という キューを作成します。ここで、前の手順 (手順 8) で使用した名前と同じ名前を必ず使用してください。

14. Studio に戻ります。この時点で、ワークフローはエラーを発生させることなく機能しているはずです。次の手順は、これを Orchestrator が使用できるようにすることです。このために、[デザイン] > [パブリッシュ] をクリックします。

15. このプロセスを実行するには、[デザイン] > [実行] をクリックします。

    注:

    キュー アイテムは処理された後にトランザクションとなり、それ以降はトランザクションとして取り扱われることに留意してください。

16. 再び https://cloud.uipath.com に移動して、このトランザクションを表示します。

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

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

1. [デザイン] > [新規作成] > [フローチャート] に移動し、上記で開始したプロジェクトで新しいファイルを作成します。

2. サードパーティのダミー アプリケーションを開くために、[ アプリケーション/ブラウザーを使用 ] アクティビティを追加します。Start ノードに接続します。

3. [プロパティ] パネルに、必須の情報 (表示名、ファイル パス、セレクター) を入力し、該当する資格情報でログインするようにアクティビティを設定します。admin を [ユーザー名] フィールドに、password を [パスワード] フィールドに使用します。

4. [ファイル パス] フィールドには、アプリケーションのパスを入力します。

5. [セレクター] フィールドで、セレクター エディターを使用して UIDemo のセレクターを定義します。

6. [ 停止すべきか確認] アクティビティを デザイナー パネルに追加し、[ アプリケーションを開く] アクティビティに接続します。

7. [ フロー条件分岐] アクティビティを デザイナー パネルに追加し、[ 停止すべきか 確認] アクティビティと接続します。この最後の 2 つのアクティビティは、ジョブの実行中に停止を行ったかどうかをチェックします。これにより、停止がトリガーされた後にさまざまな安全のためのルーチンを実行するワークフローをさらに設定する可能性があります。こうしたルーチンの例を次に示します。

   • [ メッセージをログ ] アクティビティを追加して、これまでに追加したフロー条件分岐の [True ] 分岐に接続します。
   • [プロパティ] パネルの [メッセージ] フィールドに、停止がトリガーされた場合に表示するメッセージとして、「Stop process required」(停止プロセスが必要) などの文言を入力します。
   • [ アプリケーションを閉じる ] アクティビティを追加して、これまでに追加した [メッセージをログ ] アクティビティに接続します。
   • [プロパティ] パネルの [表示名] フィールドで、「アプリケーションを閉じる」の後に「UIDemo.exe UIDemo」と入力します。

8. [ トランザクション アイテムを取得 ] アクティビティを、これまでに追加したフロー条件分岐 (手順 7 ) の False 分岐に接続します。このアクティビティは、キューからトランザクション アイテムを取得し、ループが反復処理されるたびに順番に QueueItem 変数に格納します。

9. [プロパティ] ウィンドウの [キュー名] フィールドに、アイテムを格納するキューの名前を入力します。ここでは、「キューにアイテムをアップロードする」セクションで定義したように、「ReportQueue」いう名前を使います。

10. [トランザクション アイテム] フィールドで、Ctrl + K を押して、読み込んだトランザクション アイテムを格納する QueueItem 変数を作成します。「TransItem」またはそれに類似した名前を付けます。

11. [フロー条件分岐] アクティビティをデザイナー パネルに追加し、[トランザクション アイテムを取得] アクティビティと接続します。

12. [プロパティ] ウィンドウの [条件] フィールドに、TransItem isNot Nothing と入力します。この詳細は次のとおりです。このアクティビティはキューの最後まで達しているか判別するために各項目の値を確認します。

13. 手順 7 で作成した [フロー条件分岐] の [False] 分岐を [メッセージをログ] アクティビティに接続します。これによって、キューの最後に達したときにジョブが確実に停止するようになります。

14. 別の [フロー条件分岐] アクティビティをデザイナー パネルに追加し、手順 11 で作成した [フロー条件分岐] の [True] 分岐に接続します。

15. [プロパティ] ペインの [条件] フィールドに、「cint(TransItem.SpecificContent("OnUSCheck").ToString) < 5000」と入力します。上記の式は、QueueItem 変数の OnUSCheck 値を String 型変数に変換し、さらに整数に変換します。こうして取得した値について、条件に適合しているかどうかをチェックします。

    • cint は変数を String 型から Integer 型に変換します。
    • TransItem は、アイテムを格納するために使用する QueueItem 変数 (手順 18) です。
    • SpecificContent("OnUSCheck") は、各アイテムの On US Check 引数の内容を取得します。
    • .ToString は QueueItem 変数のコンテンツを String 型変数に変換します。
    • < 5000 は、チェック対象となる条件です。

16. [トランザクションのステータスを設定] アクティビティをデザイナー パネルに追加し、前の [フロー条件分岐] (手順 13) の [False] 分岐に接続します。

17. [プロパティ] ウィンドウで、[ステータス] フィールドが [失敗] に設定され、[エラーの種類] が [ビジネス] に設定されていることが確認します。このように、自行払い小切手 (On US Check) の額が 5000 以上であるトランザクションは、失敗としてマークされ、ビジネス例外となります。

18. [トランザクション アイテム] フィールドに TransItem 変数を追加します。

19. [理由] フィールドに、失敗したトランザクションに対して表示するメッセージとして、「OnUSCheck amount is bigger than 5000」(自行払い小切手の金額が 5000 以上です) などの文言を入力します。

20. [トランザクションのステータスを設定] アクティビティを [停止すべきか確認] アクティビティ (手順 6) に接続し、キューの次のトランザクションのループとプロセスを作成します。

21. [シーケンス] アクティビティをデザイナー パネルに追加し、[フロー条件分岐] (手順 13) の [True] 分岐に接続します。このシーケンス内に、[ トライ キャッチ] アクティビティを追加し、項目処理中に、可能性のあるエラーがすべて、アプリケーション エラーとして正しくラベル付けされるように設定します。

22. UIDemo アプリケーションを開き、ユーザー名 admin、パスワード password でログインします。

23. UIDemo アプリケーションの [現金化 (Cash In)]、[自行払い小切手 (On Us Check)]、[他行払い小切手 (Not On Us Check)] の各フィールドについて、次の一連のアクティビティを実行します。

    • これまでに追加した [ トライ キャッチ ] アクティビティに、アプリケーションを開くための [ アプリケーション/ブラウザーを使用 ] アクティビティを追加します。
    • [文字を入力] アクティビティを追加します。
    • [画面上でターゲットを指定] をクリックし、UIDemo インターフェイスから、「現金化 (Cash In)」に対応する空白のフィールドを選択します。
    • [以下を入力] フィールドに、「transItem.SpecificContent("CashIn").ToString」と入力します。この式のそれぞれの項目については、前述の手順 15 で説明しています。この式は、各 QueueItem 変数の値を String 型変数に変換します。

24. 前の[文字を入力] アクティビティの後に [ テキストを取得] アクティビティを追加し、オプション メニューから [画面上でターゲットを指定] を選択します。

25. UIDemo アプリケーションでトランザクション番号を指定して、[確認] をクリックします。

26. [テキスト] フィールドに新しい変数 (たとえば、TransNumber) を設定します。これにより、最初の条件を満たすキュー アイテムごとにトランザクション番号を取得します。

27. [トランザクションのステータスを設定] アクティビティを [テキストを取得] アクティビティの後に追加します。

28. [ステータス] フィールドが [成功] に設定され、[エラーの種類] が [アプリケーション] に設定されていることを確認します。このように、値のセットがアプリケーションに正常に導入された場合、トランザクションのステータスが「成功」となるか、それ以外の場合はアプリケーション例外とラベル付けされます。

29. [出力] ウィンドウで、新しい引数を定義し、これまでに作成した変数 TransNumber (手順 25) を値として追加します。

30. [トランザクション アイテム] フィールドに TransItem 変数を追加します。

31. [トランザクションのステータスを設定] アクティビティの後に [クリック] アクティビティを追加します。

32. [画面上でターゲットを指定] をクリックし、UIDemo インターフェイスで [Accept] ボタンを選択します。

33. [トライ キャッチ] アクティビティは、次のスクリーンショットのように表示されます。

    

34. フローチャートに戻って、これまでに追加した [シーケンス] アクティビティ (手順 21) を[停止すべきか確認] アクティビティ (手順 6) に接続し、キューの次のトランザクションのループとプロセスを作成します。

35. フローチャートは、次のスクリーンショットのように表示されます。

    

36. このプロセスを実行するには、[デザイン] > [実行] をクリックします。

37. 実行が終了したら、https://cloud.uipath.com に移動し、処理済みのトランザクションを表示できます。各処理に関する詳細情報も確認できます。

• トランザクションが成功した場合

  

• トランザクションが失敗した場合

  

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