別のアプリのレコードを参照して値を取得するフィールドです。顧客マスタから会社情報を引用するといった用途に使用します。
入力フォームでの表示
顧客名
自動入力されたフィールド
プロパティパネル
ラベル *
フィールドコード
参照先アプリ
紐づけキー
参照先が削除されたとき
| 設定項目 | 説明 |
|---|---|
| ラベル | 画面に表示されるフィールド名 |
| フィールドコード | API・計算式で使用する識別子 |
| 参照先アプリ | データを取得する元のアプリ（同じ環境内） |
| 紐づけキー | 参照先アプリのどのフィールドで照合するか。「重複禁止」が有効なフィールドのみ選択可能。文字列・数値・リンク・自動採番が対象 |
| 表示フィールド | ルックアップフィールド自体に、紐づけキーの値の代わりに表示する参照先フィールド。未設定では紐づけキーの値がそのまま表示される |
| 表示するフィールド | 検索ダイアログに表示する参照先フィールドを選択（表示フィールドとは別設定） |
| コピー先フィールドの設定 | 取得時に参照先の値をコピーするフィールドのマッピング |
| フィルタ条件 | 参照先レコードを絞り込む条件を設定。複数条件は AND / OR いずれかの結合方法を選択できる |
| ソート | 検索ダイアログでの参照先レコードの並び順 |
| 参照先が削除されたとき | 警告 / 制限 / 空にする / 何もしない から選択 |
コピー先フィールドの各マッピングには「コピー後の編集を許可」のチェックボックスがあります。
使用例: 顧客マスタから「住所」をコピーしつつ、個別案件で配送先住所のみ変更したい場合、 住所フィールドの編集許可をオンにします。
コピー先フィールドの設定は、update_form でフィールドの settings.lookupCopyMappings に配列として渡します。要素は次の形です。
| キー | 値 | 内容 |
|---|---|---|
sourceFieldId | 参照先アプリのフィールドid | コピー元（必須）。list_lookup_sources で確認できます |
targetFieldId | このアプリのフィールドid | コピー先（必須）。get_form で確認できます |
allowEdit | true / false | 「コピー後の編集を許可」（任意。既定 false） |
sourceFieldIdlist_lookup_sources で確認できますtargetFieldIdget_form で確認できますallowEdittrue / falsefrom / to、sourceFieldCode / targetFieldCode のような別名のキーは使えません。 送った場合は保存されず、応答に「送られてきたキー名」と期待される形が返りますコピー元とコピー先のフィールドは、データ型に互換性がある組み合わせのみマッピングできます。 コピー先として選択可能なフィールドは、コピー元の型に応じて自動的に絞り込まれます。
テーブル（サブテーブル）のサブフィールドにもルックアップを配置できます。 テーブル内のルックアップでは、参照先アプリの選択・紐づけキー・表示フィールド・コピーマッピングを通常のルックアップと同じUIで設定できます。
重要: テーブル内のルックアップは選択時点のスナップショットです。 参照先レコードの値が後から変更されても、テーブル行内のコピー済みの値は自動では更新されません。 通常のルックアップでは参照値フィールド（lookup_ref）を使って自動同期が可能ですが、 テーブル内ではこの自動同期の仕組みは利用できません。