メインコンテンツまでスキップ

ルックアップリスト

ルックアップリストは、カスタムフィールドテンプレート内のドロップダウンフィールドに値を入力するための、あらかじめ定義された値のセットです。例としては、ドキュメントタイプのリスト、プロジェクトコードのリスト、またはAI抽出向けにyes / no / unsureのように選択肢を制限したリストなどがあります。ルックアップリストは Lookup List Builder で設定し、カスタムフィールドテンプレートまたはバーチャルビューから値を取得します。

設定対象ユーザー​

New モジュールにアクセスできるユーザーです。Lookup List Builderは New > Custom Fields & Configuration > Lookup List Builder からアクセスできます。

事前準備​

  • リストに表示する値を含む Grid Link カスタムフィールドテンプレートを、ルックアップリストを設定する前に作成・保存しておく必要があります。カスタムフィールドテンプレートを参照してください。
  • リストで元データを絞り込みまたは加工する必要がある場合は、先にQuery Builderで該当するバーチャルビューを設定してください。Query Builderを参照してください。

Lookup List List パネル​

Lookup List List パネルには、データベース内に設定されているすべてのルックアップリストが表示されます。New > Custom Fields & Configuration > Lookup List Builder から開きます。

Lookup List List パネル

Lookup List List パネル

コントロール説明
Create Lookup List新しいルックアップリストを設定するためのManage Lookup Listエディターを開きます。

パネル内の各行は、設定済みのルックアップリスト1件を表します。リスト名をクリックすると、そのリストの Manage Lookup List エディターが開きます。

Manage Lookup List エディター​

Manage Lookup List エディターは、新しいルックアップリストを作成するとき、またはパネルから既存のリストを選択したときに開きます。

Manage Lookup List エディター

Manage Lookup List エディター

フィールド説明
List Nameルックアップリストの名前です。テンプレート内でLookupListまたはLookupListMultiフィールドタイプにリストを割り当てる際にこの名前が使用されます。
Custom Field Template / Virtual Viewルックアップリストの参照元の種類を選択します。Custom Field Template または Virtual View のいずれかを選択します。1つのルックアップリストにつき参照元は1つのみです。
Template picker参照元として Custom Field Template を選択すると、利用可能なカスタムフィールドテンプレートが表示される2つ目のドロップダウンが表示されます。リストの値の参照元とするテンプレートを選択します。
Reload List選択した参照元から現在の値を読み込み、エディターのプレビューに表示します。
Row Count選択した参照元から読み込まれた行数を表示します。
Save Changesルックアップリストの設定を保存します。

ルックアップリストの作成方法​

手順説明
1ルックアップリストに必要なフィールドを持つ Grid Link カスタムフィールドテンプレートを作成します。フィールド名がリストの列キーになります。テンプレートを保存します。カスタムフィールドテンプレートを参照してください。
2Manage Registers でテンプレートを開き、ドロップダウンの選択肢として表示させたい行を追加します。レジスターの管理を参照してください。
3元データの絞り込みや加工が必要な場合は、Query Builder でバーチャルビューを設定します。Query Builderを参照してください。
4New > Custom Fields & Configuration > Lookup List Builder に移動し、Create Lookup List をクリックします。
5List Name を入力し、該当するCustom Field TemplateまたはVirtual Viewを選択し、Reload List をクリックして値が表示されることを確認したら、Save Changes をクリックします。
6ルックアップリストを表示させたいテンプレートで、該当するフィールドの Field Type を LookupList または LookupListMulti に設定し、名前でルックアップリストを選択します。

トラブルシューティング​

リスク詳細
Reload Listをクリックしても値が表示されない選択したCustom Field Templateが空であるか、Virtual Viewがすべての行を除外している可能性があります。元データとクエリの設定を確認してください。
Field Typeのオプションにルックアップリストが表示されないルックアップリストは保存されるまで、テンプレートエディターのField Typeドロップダウンには表示されません。
ドロップダウンに誤った値が表示されるリストがVirtual Viewを参照元としている場合、基になるクエリが正しい行と列を選択しているか確認してください。
Row Countが0と表示される参照元のテンプレートに行が存在しない、またはVirtual Viewが結果を返していません。参照元にデータが存在すること、クエリが過剰にフィルタリングされていないことを確認してください。

関連する設定​