コレクションステージ

コレクションの使用の概要については、コレクションのヘルプページを参照してください。このページは、コレクションステージのプロパティフォームを完成させるための実用的なガイドです。［コレクションプロパティ］ダイアログには、入力するフィールドがいくつかあります。

名前

入力した名前によってコレクションが識別され、プロセス図に表示されます。

説明

追加の説明フィールドには、さらに長い説明を入力できます。

フィールド

2つの方法のいずれかを使用して、コレクションにフィールドを追加します。

• ビジネスオブジェクトからのデータの使用 – ビジネスオブジェクトを使用してフィールドを追加するには、［フィールドをインポート］ボタンをクリックします。このオプションの詳細については、このページの「フィールドのインポート」セクションを参照してください。
• 手動 – 手動でフィールドを追加するには、［フィールドを追加］ボタンを必要なフィールドの数だけクリックします。ボタンを押すごとに、フィールドがコレクションに追加されます。次に、ドロップダウンメニューを使用して各フィールドのデータ型を選択します

入れ子のコレクションにフィールドを追加する

コレクションには他のコレクションを含めることができます。これらの「入れ子」のコレクション内のフィールドを手動で定義するには、フィールドを追加して［コレクション］のデータ型を選択します。新しいコレクションのフィールドが未定義であることを示すラベルが［フィールド］列の下に表示されます。行を選択してリンクをクリックし、このコレクションのフィールドを定義します。

入れ子のコレクションのフィールドが定義されているときは、どのコレクションの定義が現在編集中であるかを示す「パンくずリスト」が表示されます。親コレクションに戻るには、パンくずリスト内でその名前をクリックします。

パンくずリストの最初の名前は、コレクション自体の名前です。これをクリックすると、ステージの他の属性も変更できるステージの基本設定に戻ります。

単一行

単一行コレクションには厳密に1行の行があります。［フィールド］タブのチェックボックスをオンにすることによって、コレクション（ステージで定義されたプライマリコレクションまたは入れ子のコレクション）を単一行に設定できます。

注意： このチェックボックスがオンの状態でコレクションに行を追加した場合は、1行だけが残るまで追加した行が削除されます。逆に、コレクションに行がない場合は、行が1つ追加されます。

初期値を追加する

必要に応じて、コレクションに一連の初期値を設定できます。初期値を追加するには、［初期値］タブをクリックします。コレクションの初期値に新しい行を追加するには、［行を追加］ボタンをクリックします。ボタンをクリックするたびに新しい行が作成されます。行が追加された後は、行内のセルをクリックして値を設定できます。

入れ子のコレクションを値に入れる

コレクションに他のコレクションが含まれている場合は、編集する値内の行を選択し、そのコレクションを表すハイパーリンクをクリックすると、値を設定できます。

コレクションにデータがない場合は、リンクに「データなし」と表示されます。コレクションが空の場合、つまり行のないコレクションの場合は、「空」と表示されます。行がある場合は、「n行中のm行」と表示されます。「m」はコレクションの現在行を表し、「n」は行の総数を表します。

行が選択されると、「消去」というラベルのボタンが使用可能になります。このボタンはコレクションを削除します。つまり、データなしの状態にリセットします。

ネストされたコレクションの値が編集されているときは、どのレベルで値が変更されているかを示す「パンくずリスト」が表示されます。親コレクションに戻るには、パンくずリスト内でその名前をクリックします。

パンくずリストの最初の名前は、コレクション自体の名前です。これをクリックすると、コレクションの構造やそのネストされたコレクションなど、ステージの他の属性も変更できる基本的なステージ構成に戻ります。

ダイアログがネストされたコレクションの値（初期値または現在値）をナビゲートしている場合は［フィールド］タブを表示できますが、ここからフィールドを編集できません。フィールドを編集するには、パンくずリストの最初の名前をクリックしてステージ自体にナビゲートする必要があります。

アクションからフィールドをインポートする

アクションがコレクションを入力として受け入れる、またはコレクションを出力として発行する場合、そのアクションで定義されたフィールドは、ステージのプロパティダイアログの［フィールドをインポート］ボタンをクリックすることによってコレクションステージにインポートできます。

アクティベートされるとダイアログが開き、利用可能なすべてのビジネスオブジェクトと、それらのパラメーターでコレクションを定義したアクションがリストされます。

オブジェクトが選択されると、そのオブジェクトに適用可能なアクションのリストが表示されます。アクションを選択すると、定義されたコレクションのパラメーターが表示されます。

パラメーターを選択すると、そのパラメーターで定義されているフィールドのプレビューが表示されます。［OK］を押すと、現在開いているコレクション定義にフィールド定義が転送されます。

コレクションの定義は、最上位のコレクションだけでなくネストされたコレクションにもインポートできます。たとえば、Webサービスの名前とURL、Webサービスビジネスオブジェクトからインポートされた定義を持つ「入力」コレクションフィールド、同じWebサービスの出力からインポートされた定義を持つ別の出力コレクションを含む「Webサービス」コレクションを作成できます。