コレクション

コレクションは、複数のデータアイテムを1つにまとめたものです。通常、コレクションは、ビジネスオブジェクトから多数の異なる情報を1回のトランザクションで取得するために使用されます。情報が取り込まれたら、ループステージを使用してコレクション内の情報にシーケンシャルにアクセスできます。

コレクションのコンテンツは、行と列を含むテーブルとして考えると便利です。列はフィールドと呼ばれます。フィールドの名前は、ユーザーによって指定されるか、対応するビジネスオブジェクト内で定義されます。

フィールドは、式内で「ドット」構文（「コレクション名.フィールド名」）を使用してアクセスします。例：「Person」というステージで定義されているコレクション内の「Name」フィールドの場合は、計算ステージまたは決定ステージで参照（[Person.Name]）を使用してアクセスできます。

フィールド名に角括弧やドットを含めることはできません。これは参照先のコレクションの構造とフィールド名が衝突しないようにするためです。

定義済みと未定義

フィールドの名前とデータ型がコレクションステージのプロパティフォームで明示的に定義されている場合、コレクションは定義済みと言われます。このフィールド定義は、ユーザーによって考案される場合もあれば、コレクションが使用されるビジネスオブジェクトの設計者によって事前に決定されている場合もあります。

同様に、フィールドがプロパティフォームで定義されていない場合、コレクションは未定義と言われます。このような状況は、構造が変化する可能性のあるデータを含むシステムとやりとりするときに頻繁に発生します。例として、スプレッドシートに含まれるデータ（表形式）の取得などがあります。スプレッドシート内の表の列について何もわからない場合、コレクションの列（またはフィールド）にあらかじめラベルやデータ型をアタッチできません。コレクションのフィールドは実行時にのみ利用可能になります。

次のビデオでは、Blue Prismで未定義のコレクションを作成して使用する方法について説明しています。

入れ子のコレクション

コレクションはそれ自体にコレクションを含むことができます。これらのコレクションもまた、コレクションステージ内で定義済みになることや、データが入力されるまで未定義になることがあります。

入れ子のコレクションは、式内で上よりもさらに高いレベルの「ドット」構文を使用して参照できます。例：「Person」というステージに、「Type」、「Name」、「Grade」という3つのフィールドを持つ「Qualifications」というコレクションがある場合、これらのフィールドには、参照 [Person.Qualifications.Type]、[Person.Qualifications.Name]、[Person.Qualifications.Grade]を使用してアクセスできます。

同様に、ループの開始ステージでは、同じ構文を使用して入れ子のコレクションを直接ループできます。そのため、上の例の個人の資格をループするには、ループの開始ステージでコレクションをPerson.Qualificationsに設定します。これは通常、Personコレクションを反復処理するループステージ内でのみ意味があります。

ただし、内部コレクションビジネスオブジェクトは、入れ子のコレクションをサポートしません。内部アクションで参照する前に、まず入れ子のコレクションをコレクションステージに移動する必要があります。

現在の行

コレクションの行へのアクセスは、ループステージを使用して行う必要があります。ループステージは、コレクションの現在の行を自動的に更新し、ある行から次の行に順番に移動します。この変更は、ループの終了ステージに達するたびに発生します。ループステージに入る前に、コレクションは最初の行になります。ループステージは、コレクションの最後の行に到達するまで行を反復します。この時点でループは終了し、現在の行はなくなります。現在の行がないときにコレクションにアクセスしようとするとエラーになります。データに再度アクセスするには、何らかのアクションを実行して「現在の行」をもう一度設定する必要があります。該当するアクションの例として以下があります。

新しいループに入る。
新しい行をコレクションに追加する（これが現在の行になり、データの入力準備が整います）。