- 概要
- 吹き出し
- 複雑なシナリオ
- 資格情報
- Data Service
- フォーム
- リリース ノート
- プロジェクトの対応 OS
- リアルタイム フォーム
- フォーム データを更新する
- JavaScript を使用してフォームを実行する
- CSS を使用してフォームをカスタマイズする
- 条件付きコンポーネント
- 複数のコンポーネントを列の同じ行に追加する
- データ テーブル コンポーネントを使用する
- ファイル/フォルダー パスを取得
- データ グリッド コンポーネントからセルの値を読み取る
- PDF ファイルを表示する
- フォーム内で画像を表示する
- データ グリッドをスクロールする
- フォームで開発者ツールを使用する
- フォーム コンポーネントの値を計算する
- フォーム内の日付を管理する
- フォーム内のハイパーリンクを開く
- フォームに既定のタブを表示する
- コンポーネントのラベル全体を表示する
- ドロップダウン リストの長い文字列を検索する
- 23.4 より前のフォーム エクスペリエンスについて
- プロジェクトの対応 OS
- リアルタイム フォーム
- 動的なチェック ボックス
- 条件付きドロップダウン
- 既定タブを表示する
- 画像を表示する
- PDF ファイルを表示する
- ラベル全体を表示する
- 動的な HTML 要素
- 日付を管理する
- ドロップダウンで長い文字列を検索する
- ローカル CSS ファイルを使用してフォームをカスタマイズする
- チェックボックスの変更時に [実行] ブロックを実行する
- 列の幅をカスタマイズする
- フォーム データを更新する
- コレクション データをリセットする
- 高度な論理
- ドロップダウン オプションの変更時に [実行] ブロックを実行する
- データ グリッド コンポーネントからセルの値を読み取る
- 条件付きコンポーネント
- データ グリッド コンポーネントをスクロールする
- グリッド コンポーネントを使用する
- 開発ツール
- 計算値
- 動的ドロップダウン
- ボタンのクリックでタブを切り替える
- フォーム内のハイパーリンクを開く
- FTP
- IPC
- 永続性
- リリース ノート
- プロジェクトの対応 OS
- 永続性アクティビティ パッケージについて
- 一括編集フォーム デザイナー
- ジョブを開始し参照を取得 (Start Job And Get Reference)
- ジョブ完了まで待機し再開
- キュー アイテムを追加し参照を取得 (Add Queue Item And Get Reference)
- キュー アイテム完了まで待機し再開
- フォーム タスク完了まで待機し再開
- 時間差で再開 (Resume After Delay)
- タスクを割り当て
- 外部タスクを作成
- 外部タスクの完了を待機して再開
- タスクを完了する
- タスクを転送 (Forward Task)
- フォーム タスクを取得 (Get Form Tasks)
- タスク データを取得 (Get Task Data)
- アプリ タスクを取得
- タスクのコメントを追加
- タスクのラベルを更新
- アプリ タスクを作成
- アプリ タスク完了まで待機し再開
- タスク タイマーを設定
- Automation Ops パイプライン
- システム
- リリース ノート
- システム アクティビティ パッケージについて
- プロジェクトの対応 OS
- サポートされている文字エンコード
- 正規表現ビルダー ウィザード
- データ列を追加
- データ行を追加
- ログ フィールドを追加
- 日付に加算または減算
- トランザクション アイテムを追加
- キュー アイテムを追加
- コレクションに項目を追加
- リストに項目を追加
- 文字列を追加書き込み
- 警告音
- 繰り返しを終了
- ファイルを参照
- フォルダーを参照
- コレクションを構築
- データ テーブルを構築
- キュー アイテムを一括追加
- 文字種を変更
- 型を変更
- False か確認
- True か確認
- データ テーブルをクリア
- コレクションをデータ テーブルに変換
- コメント
- ファイルを圧縮 (Zip)
- ファイルをコピー
- フォルダーをコピー
- テキストを結合
- コメント アウト/無効化されたアクティビティ
- 現在の繰り返しをスキップ/現在の繰り返しをスキップ
- ファイルを作成
- フォルダーを作成
- リストを作成
- カスタム入力
- 削除する
- ファイルを削除
- フォルダーを削除
- ストレージ ファイルを削除
- キュー アイテムを削除
- ローカル トリガーを無効化
- 繰り返し (後判定)
- ファイルを URL からダウンロード
- ストレージ ファイルをダウンロード
- ローカル トリガーを有効化
- ビジネス ルールを評価
- コレクション内での有無
- ファイルを展開 (Unzip)
- テキストから日付と時刻を抽出
- テキストを取得
- ファイル変更トリガー
- ファイルの存在を確認
- コレクションをフィルター
- データ テーブルをフィルター
- フォルダーの存在を確認
- 繰り返し (コレクションの各要素)
- 繰り返し (フォルダー内の各ファイル)
- ファイル変更トリガー v3
- 検索して置換
- 一致するパターンを探す
- 繰り返し (フォルダー内の各フォルダー)
- 繰り返し (データ テーブルの各行)
- 日付をテキストとして書式設定
- 値を書式化
- テキストからデータ テーブルを生成
- アセットを取得
- 資格情報を取得/Orchestrator の資格情報を取得
- 現在のジョブの情報を取得
- 特殊フォルダーのパスを取得
- 環境変数を取得
- ファイル情報を取得
- フォルダー情報を取得
- ジョブを取得
- プロセスを取得
- 行項目を取得
- トランザクション アイテムを取得
- ユーザー名/パスワードを取得
- キュー アイテムを取得
- グローバル変数変更トリガー
- 入力ダイアログ
- コードを呼び出し
- COM メソッドを呼び出し
- PowerShell を呼び出し
- プロセスを呼び出し
- VBScript を呼び出し
- ワークフロー ファイルを呼び出し
- テキストの一致を確認
- データ テーブルを結合
- プロセスを強制終了
- 対話型ワークフローを起動
- ストレージ ファイルのリストを取得
- メッセージをログ
- データ テーブルを検索
- 手動トリガー
- コレクションを結合
- データ テーブルをマージ
- メッセージ ボックス
- 日付を変更
- テキストを変更
- ファイルを移動
- フォルダーを移動
- 複数代入
- キューへの新しいアイテムの追加
- グローバル変数の変更を通知
- Orchestrator への HTTP 要求
- データ テーブルを出力
- パスの存在を確認
- トランザクション アイテムを延期
- プロセス終了トリガー
- プロセス開始トリガー
- アラートを生成
- リストの項目を読み込み
- テキスト ファイルを読み込み
- ストレージ テキストを読み込み
- データ列を削除
- データ行を削除
- 重複行を削除
- コレクションから削除
- ログ フィールドを削除
- 一致するパターンを置換
- 繰り返し (指定回数)
- トリガーを繰り返し
- ファイル名を変更
- フォルダー名を変更
- ステータスを報告
- タイマーをリセット
- タイマーを再開
- リトライ スコープ
- 復帰
- プロセスを並列実行
- アセットを設定
- 資格情報を設定
- 環境変数を設定
- トランザクションの進行状況を設定
- トランザクションのステータスを設定
- 停止すべきか確認
- テキストを分割
- データ テーブルを並べ替え
- ローカル トリガーを実行
- タイマーを開始
- ジョブを開始
- ジョブを停止
- ローカル トリガーを停止
- タイマーを停止
- テキストを左右に分割
- テキストを大文字/小文字にする
- タイム トリガー
- トリガー スコープ
- タイムアウト スコープ
- 行項目を更新
- リストの項目を更新
- ストレージ ファイルをアップロード
- ダウンロードを待機
- キュー アイテムを待機
- 繰り返し (前判定)
- ワークフロー プレースホルダー
- ストレージ テキストを書き込み
- テキスト ファイルに書き込み
- データ行を追加
- AddQueueItem
- トランザクション アイテムを追加
- 文字列を追加書き込み
- BulkAddQueueItems
- データ テーブルをクリア
- Zip ファイルを圧縮 (CompressZipFiles)
- ファイルをコピー
- ファイルを作成
- フォルダーを作成
- ファイルまたはフォルダーを削除
- キュー アイテムを削除
- ストレージ ファイルを削除
- ストレージ ファイルをダウンロード
- Unzip ファイルを抽出 (ExtractUnzipFiles)
- データ テーブルをフィルター
- アセットを取得
- 資格情報を取得
- GetJobs
- Get Queue Item
- GetQueueItems
- ローカル パスのリソースを取得
- 行項目を取得
- トランザクション アイテムを取得
- プロセスを呼び出し
- データ テーブルを結合
- ストレージ ファイルのリストを取得
- データ テーブルを検索
- データ テーブルをマージ
- ファイルを移動
- Orchestrator への HTTP 要求
- OutputDataTable
- パスの存在を確認
- トランザクション アイテムを延期
- ストレージ テキストを読み込み
- テキスト ファイルを読み込み
- データ列を削除
- 重複行を削除
- 置換
- アセットを設定
- 資格情報を設定
- SetTransactionProgress
- トランザクションのステータスを設定
- データ テーブルを並べ替え
- StartJob
- StopJob
- 行項目を更新
- ストレージ ファイルをアップロード
- キュー アイテムを待機
- ストレージ テキストを書き込み
- テキスト ファイルに書き込み
- テスト
- リリース ノート
- テスト アクティビティ パッケージについて
- プロジェクトの対応 OS
- プロジェクト設定
- Address
- AddTestDataQueueItem
- AttachDocument
- BulkAddTestDataQueueItems
- DeleteTestDataQueueItems
- GetTestDataQueueItem
- GetTestDataQueueItems
- GivenName
- LastName
- RandomDate
- RandomNumber
- RandomString
- RandomValue
- VerifyAreEqual
- VerifyAreNotEqual
- VerifyContains
- VerifyExpression
- VerifyExpressionWithOperator
- VerifyIsGreater
- VerifyIsGreaterOrEqual
- VerifyIsLess
- VerifyIsLessOrEqual
- VerifyIsRegexMatch
- VerifyRange
- ワークフロー イベント
- Workflow Foundation
ドロップダウンの高度なコントロール
このページのチュートリアルでは、[フォーム タスクを作成] アクティビティ内で UiPath フォーム デザイナーを使用してドロップダウン リストを使用する方法を説明します。このチュートリアルの結果を達成するために最もよく使われるプロパティは、FormData(Collection) です。
フォーム アクション内のドロップダウン コントロールに値を設定するために、動的なデータの送信を必要とするワークフローで使用します。
この方法では、UiPath フォーム デザイナーの [データ] タブで静的な値を追加する代わりに、文字列リスト型の変数にドロップダウン リストの値を格納します。
以下の例では、国の動的ドロップダウンを作成し、変数を国のリストで初期化して、ユーザーが選択した国を取得するための追加の変数を作成します。
動的ドロップダウンを作成するには、以下の手順を実行します。
- [フォーム タスクを作成] アクティビティの [フォーム データ] の右にある三点リーダー (
...
) をクリックします。 -
以下の設定で、動的なドロップダウンの引数を追加します。
- 名前:
countryList_dropdown
- 方向: 入力
- 型: 文字列リスト (
List<String>
) -
値: Ctrl + K を押して、変数名として
listOfCountries
を入力します。listOfCountries
変数には、ドロップダウン リストの項目が格納されます。注: 文字列の配列も使用できますが、その場合はフォーム デザイナーでドロップダウン コンポーネントを手動で追加し、[フィールド キー] の値を追加する必要があります。
- 名前:
-
ユーザーの選択をワークフローに返す必要がある場合は、選択された値を取得する別の引数を、以下の設定で追加します。
- 名前:
country
(ドロップダウン コンポーネントのフィールド キー) - 方向: 入力/出力または出力
- 型: String
- 値: Ctrl + K を押して、変数名として
selectedCountry
を入力します。
- 名前:
- [OK] をクリックして [フォーム データ] を閉じます。
-
[変数] パネルを開き、
new List(of string) from { "India", "Romania", "US" }
を既定値listOfCountries
で初期化します。ヒント: 初期化する代わりに、他のアクティビティでlistOfCountries
に値を設定することもできます。
1 つのドロップダウン (親) で選択した値に応じて第 2 のドロップダウン (子) の値を設定する場合に、タスクベースのフォームで使用します。
カスケード ドロップダウンを作成するには、以下の手順を実行します。
- [フォーム タスクを作成] アクティビティの [フォーム データ] の右にある三点リーダー (
...
) をクリックします。 -
親ドロップダウンをワークフローにバインドします。
この例では、listOfCountries
List<String> 型変数をドロップダウン リストとしてワークフローに渡す引数を作成します。注:listOfCountries
変数には、親ドロップダウン リストの項目、つまり国のリストが格納されます。- この引数に
CountryList_dropdown
という名前を付けます。この引数の [フィールド キー] プロパティの名前はCountryList
です。 - [方向] を [入力] に設定します。2.3.[型] を
System.Collections.Generic.List<System.String>
に設定します。 - [値] を
listOfCountries
List<String> 型変数に設定します。
- この引数に
-
子ドロップダウンをワークフローにバインドします。
この例では、Dictionary<String, List<String>> 型変数stateDictionaryList
をドロップダウン リストとしてワークフローに渡す引数を作成します。注:stateDictionaryList
変数には、子ドロップダウン リストの項目、つまり各国の州が格納されます。 - この引数に
stateDictList_dropdown
という名前を付けます。この引数の [フィールド キー] プロパティの名前はstateDictList
です。 - [方向] を [入力] に設定します。3.3.[型] を
System.Collections.Generic.Dictionary<System.String, System.Collections.Generic.List<System.String>
に設定します。 - [値] を Dictionary<String, List<String>> 型変数
stateDictionaryList
に設定します。 -
子ドロップダウンを親ドロップダウンにバインドします。
子ドロップダウンの名前で引数を作成し、サフィックス_parent
を追加します。次に、引数の [値] を親ドロップダウンの名前に設定します (例:”ParentDropdownVariableName”
)。この例では、stateDictList_parent
という名前の引数を作成します。子ドロップダウンはstateDictList
であり、そこにサフィックス_parent
を追加します。-
[方向] を [入力] に設定します。
-
[型] を
String
型に設定します。 -
[値] を
”CountryList”
に設定します。Dictionary 型変数stateDictList
に値を設定する際は、ディクショナリのキーは、親ドロップダウン リストの値で、対応する値は、親がそのキーに設定されたときにフォームに表示されるオプションのリストであることに注意してください。ヒント:[フォーム データ] コレクションに事前に入力される値 (例: 国や州のフィールドの値) を渡すことができます。
子の値を渡す場合は、予期しない動作が生じないようにするために、必ず親の値も含めてください。
-
-
親ドロップダウンから文字列リスト変数に各値をマッピングします。親ドロップダウンのリスト (ディクショナリ) は、任意の方法で入力できますが、この例では、各値に対して [Add to Dictionary] アクティビティを使用します。
- ディクショナリ: 子ドロップダウンのディクショナリ
stateDictList
です。 - キー: 親ドロップダウンの文字列リストからの値
CountryList
です。この例では、"US"
、"India"
、"Romania"
です。 - 値: Ctrl + K を押して、文字列リスト変数の名前を入力します。この変数には、親でキーの値が選択されたときに子ドロップダウンに表示される値、
usaStatesList
、indianStatesList
、romanianCountyList
が、それぞれ格納されます。
- ディクショナリ: 子ドロップダウンのディクショナリ
- 上記の手順のアクティビティ (1 つまたは複数) は、必ず[フォーム タスクを作成] アクティビティよりも前に配置してください。
- [OK] をクリックして [フォーム データ] を閉じます。
-
[変数] パネルを開き、作成した新しい文字列リスト変数を次の既定値で初期化します。
indianStatesList
に対してはnew List(of string) from { "Odisha", "Rajasthan", "Karnataka" }
usaStatesList
に対してはnew List(of string) from {"Florida", "Georgia", "Washington"}
romanianCountyList
に対してはnew List(of string) from {"Cluj", "Prahova", "Constanta"}
こちらからこれらのサンプルをダウンロードします。
編集グリッド コンポーネントまたはデータ グリッド コンポーネント内でカスケード ドロップダウンを使用するには、以下の手順を実行します。
- 上記の手順に従って、ドロップダウン フィールドを作成します ([フォーム データ] ウィザードを使用)。
- フォーム デザイナーを開きます。
-
ドロップダウン フィールドがフォーム内に作成されない場合は、以下を確認します。
<dropdownKey>
、<dropdownKey>_dropdown
、および<dropdownKey>_parent
の各引数が [フォーム データ] コレクションに正しく追加されている。-
[入力フィールドを生成] ボックスがオンになっている。
- 編集グリッド コンポーネントまたはデータ グリッド コンポーネントをドラッグ アンド ドロップします。
- 手順 1 で作成したドロップダウンを編集グリッド コンポーネントまたはデータ グリッド コンポーネントにドラッグ アンド ドロップします。
- 子ドロップダウンの設定メニューを開きます。
-
[論理] タブで、事前設定済みの高度な論理を確認します。
- [アクション] > [スキーマ定義] フィールドに移動します。
-
スキーマ式で、
[data.<parent_dropdown_key>]
を[row.<parent_dropdown_key>]
に置き換えます。
注: row キーワードは、グリッド行の親値を使用することをフォームに指示します。 - フォームを保存します。
既定では、ドロップダウンに最大 4 つの検索結果が表示されます。この制限は、フォーム設計のプロパティ設定で変更できます。
ドロップダウンの検索結果の数を設定するには、以下の手順を実行します。
- UiPath フォーム デザイナーで、[編集] をクリックしてドロップダウン リストの設定を開き、[データ] タブを選択します。
- [Choices.js オプション] に
{ "searchResultLimit" : x }
を追加します。x
x
は表示する結果の最大数です。
ドロップダウン メニューの文字列が 50 文字を超える場合、表示から省略されることがあります。
検索用語と一致するすべてのオプションを表示するには、次の手順を実行します。
- 編集するドロップダウン リスト コンポーネントの [JSON を編集] をクリックします。
-
[コンポーネント JSON] フィールドで、以下のプロパティを追加します。
... "fuseOptions": { "distance": 800, }, "threshold": 1, "useExactSearch": false, ...
... "fuseOptions": { "distance": 800, }, "threshold": 1, "useExactSearch": false, ...
threshold
プロパティは、アルゴリズムが指定の検索用語の検索操作を停止するポイントを指定します。たとえば、threshold
が 0
の場合、文字と位置が完全に一致する必要があります。threshold
が 1
の場合は、綴りに間違いがあっても、任意の文字に一致できます。ユース ケースに応じて threshold
の値を調整してください。