列選択フォーム(ダイアログUI)
処理対象の列をルールで選ぶダイアログです。列名を 1 つずつ選ぶ列選択フォーム(シンプル UI)と違い、「指定文字を含む列名」「列型一致」といった条件を並べて、まとめて選べます。
選択済みの列も未選択の列も、型アイコン+列名の形式で表示されます。
画面構成
1. 設定フィールド
列選択の設定を行います。
1-1. 選択方法
| 設定 | 説明 | 補足 |
|---|---|---|
| 次を選択 | 当てはまった列を選択済みに加えます | 背景色は青色 |
| 次を削除 | 当てはまった列を選択済みから外します | 背景色は赤色 |
1 つめのルールが「次を削除」のときだけ、全列から始まります。 つまり「次を削除 + 指定文字を含む列名」1 本で「その文字を含む列以外を全部選ぶ」が書けます。
1-2. 一致方式
- すべての列: 入力データの全ての列を選択
- 列名一致: 一覧から選んだ列名そのものを選択
- 列型一致: 選択した列型の列を選択
- 指定文字から始まる列名: 入力した文字に前方一致した列名を選択
- 指定文字で終わる列名: 入力した文字に後方一致した列名を選択
- 指定文字を含む列名: 入力した文字に部分一致した列名を選択
- 正規表現一致: 入力した正規表現に一致した列名を選択
1-3. 列名の指定
一致方式に応じて、フォームが変化します。画面に出る名前は列名の指定で、一致方式に列型一致を選んだときだけデータ型の指定に変わります。
一致方式ごとのフォーム
| 一致方式 | フォーム | 説明 |
|---|---|---|
| すべての列 | なし | 入力するものがありません |
| 列名一致 | 列選択 | 列選択フォーム(シンプル UI)と同様の操作で列を選択可能 |
| 列型一致 | セレクト | 列型を複数選択可能 |
| 指定文字から始まる列名 | テキスト | 文字を入力します |
| 指定文字で終わる列名 | テキスト | 文字を入力します |
| 指定文字を含む列名 | テキスト | 文字を入力します |
| 正規表現一致 | テキスト | 正規表現を入力します |
入力が空のルールは無視されます。 空のルールを足しても選択済みは変わりません（すべての列だけは入力がなくても働きます）。
1-4. 設定の追加/削除ボタン
ルールを足して、複数の条件を組み合わせられます。ルールは上から順に適用されます。
- 次を選択のルールは、当てはまった列を選択済みに足します（足し算）
- 次を削除のルールは、当てはまった列を選択済みから引きます（引き算）
「次を選択」だけを並べたときは、どれかに当てはまれば選ばれる（OR）という形になります。足し算と引き算を混ぜるときは、並び順で結果が変わります。
1-5. 選択済み列名一覧
一致方式が列名一致のとき、選択した列名の一覧が表示されます。
2. 未選択列一覧
設定フィールドにおいて、選択されていない列がデータテーブル形式で表示されます。
また、その列数も表示されます。
3. 選択済み列一覧
設定フィールドにおいて、選択された列がデータテーブル形式で表示されます。
また、その列数も表示されます。
並び順は入力データの列順です。 選んだ順でもルールを書いた順でもないので、選んだ順に処理されることを当てにしないでください。
4. 設定反映コマンド
選択した列を処理設定に反映できます。
ダイアログ外をクリックすると、キャンセル扱いになります。
| コマンド | 説明 | 補足 |
|---|---|---|
| 適用 | 選択状態を処理設定に反映し、ダイアログを閉じる | 設定エラーが起きている場合はクリック不可 |
| キャンセル | 選択状態を処理設定に反映せず、ダイアログを閉じる |
設定反映後の表現
列選択を処理設定に反映後、列選択ボタンの左のバッジに「（数）列」と出て、下に選んだ列の一覧が並びます。1 列も選んでいないときはバッジが「未選択」になります。
設定ステータス
選んだ内容は、設定ボタンの左のバッジと、その下の一覧で分かります。1 つも選んでいなければバッジは未選択、選んであれば n 列 です。
設定にエラーが発生した場合、画面上で警告が表示されます。
| 原因 | 処理設定フィールドに出る文 | 列選択ダイアログ |
|---|---|---|
| 選んだ列名が入力データにない | 存在しない列が選択されています | その列名が赤く出ます |
| 選んだ列の型が、選べる型の範囲外 | 選択できない型の列が含まれます。選択可能な型は、{{types}}です。 | その列が赤く出ます |
直し方
| 原因 | 直し方 |
|---|---|
| 列名がない | 赤い列名をダイアログで削除します |
| 型が合わない | 表示されている型以外の列の選択を外します |
エラーが出ているあいだは、ダイアログの「適用」も実行ボタンも押せません。
その他
キー列を指定する結合に特化した警告
処理設定内のキー列を選択が左右のキー列名が同じで、かつ左右の入力列に、同じ列名が存在しない場合、警告が表示されます。
設定例
列名を指定して選択する
初期状態である一致方式が列名一致の場合、選択した列名を選択できます。
列型を指定して選択する
一致方式が列型一致の場合、選択した列型の列を選択できます。
文字を指定して選択する
一致方式が指定文字から始まる列名の場合、選択した文字で始まる列を選択できます。
全ての列を選択する
一致方式がすべての列の場合、全ての列を選択できます。
条件を反転して指定する
選択方法を次を削除にすると、当てはまった列を外せます。1 本目のルールでこれを使うと「〜以外の列を全部」が書けます。
複数条件を指定して選択する
設定の追加ボタンにて複数条件を追加し、柔軟な列選択が可能です。