条件付きドロップダウン

条件付きドロップダウンを使用すると、他のフォームコンポーネントで以前に指定した選択に基づいて、ドロップダウンからオプションを選択できます。

たとえば、ドロップダウンリストから特定の州を選択した場合、条件付きドロップダウンにはその州の各都市が表示されます。

チュートリアル

この機能を使用するには、次の手順を実行します。

型 List<String> または Dictionary<String, String> のワークフロー変数を定義して、親ドロップダウンを作成します。例: stateList
型 Dictionary<String, List<String>> または Dictionary<String, Dictionary<String, String>> のワークフロー変数を定義して、子ドロップダウンを作成します。例: cityStateMap
ワークフローシーケンスに [コードを呼び出し] アクティビティをドラッグアンドドロップします。
[引数を編集] をクリックして、前に作成した変数を入力/出力引数として追加します。[OK] をクリックします。
[コードを編集] をクリックします。コードを入力して、データを初期化し、ドロップダウンにデータを設定します。たとえば、以下のコードスニペットはドロップダウンを初期化して (stateList と cityStateMap)、そこに項目を追加します。
```
// initialize the parent dropdown
stateList = new List<string>();
// add items to the parent dropdown
stateList.Add("HP");
stateList.Add("Punjab");
// initialize the child dropdown
cityStateMap = new Dictionary<string,List<string>>();
// add items to the HP-child dropdown
cityStateMap.Add("HP",new List<string>());
cityStateMap["HP"].Add("Shimla");
cityStateMap["HP"].Add("Solan");
cityStateMap["HP"].Add("Hamirpur");
// add items to the Punjab-child dropdown
cityStateMap.Add("Punjab", new List<string>());
cityStateMap["Punjab"].Add("Chandigarh");
cityStateMap["Punjab"].Add("Patiala");
cityStateMap["Punjab"].Add("Jalandhar");// initialize the parent dropdown
stateList = new List<string>();
// add items to the parent dropdown
stateList.Add("HP");
stateList.Add("Punjab");
// initialize the child dropdown
cityStateMap = new Dictionary<string,List<string>>();
// add items to the HP-child dropdown
cityStateMap.Add("HP",new List<string>());
cityStateMap["HP"].Add("Shimla");
cityStateMap["HP"].Add("Solan");
cityStateMap["HP"].Add("Hamirpur");
// add items to the Punjab-child dropdown
cityStateMap.Add("Punjab", new List<string>());
cityStateMap["Punjab"].Add("Chandigarh");
cityStateMap["Punjab"].Add("Patiala");
cityStateMap["Punjab"].Add("Jalandhar");
```
[フォームを作成] アクティビティをドラッグアンドドロップします。
ユーザーのドロップダウン選択をワークフロー変数に格納します。以下に例を示します。
- 型 List<String> の cityListSelected—選択した州に対応するリストを格納します。
- 型 String の selectedState—選択した州を格納します。
- 型 String の selectedCity—選択した都市を格納します。
アクティビティの [プロパティ] パネルから、[フォームフィールドコレクション] ウィンドウを開きます。
フォーム内のドロップダウンフィールドを定義するには、次の操作を実行します。
- ドロップダウンフィールドを定義します。設定した名前がデータバインドに使用されます (「ドロップダウンコンポーネント」>「[フィールドキー] タブ」>「プロパティ名」を参照)。
- さらに、ドロップダウンフィールド名に _dropdown を追記して、ドロップダウンリストを定義します。
[値] 列で、ユーザー選択を以下のように設定します。
- 親ドロップダウンリストについては、手順 1 で定義したリストを使用します。
- 子ドロップダウンリストについては、手順 7 で格納した変数を使用します。
- 親ドロップダウンフィールドについては、手順 7 で格納した変数を使用します。
- 子ドロップダウンフィールドについては、手順 7 で格納した変数を使用します。
[OK] をクリックします。