ルックアップコントロール

[アーティクル]
03/21/2023

この記事では、コントロールの検索動作を有効にする方法について説明します。また、複数選択ルックアップを作成する方法について説明し、現在サポートされていないルックアップシナリオの概要について説明します。

コントロールのルックアップ動作を有効化

拡張データ型にバインドされたコントロール

拡張データ型プロパティセット (実行中の FormDataSource が無い) を持つコントロールは、次の条件の下で検索を行います。

EDT にはそのテーブルリレーションまたはテーブルの参照ノードが設定されているかどうか。
FormHelp プロパティが設定されている場合 (カスタムルックアップ)、ルール #1 を true に設定する必要はありません。
コントロールでルックアップまたは lookupReference が上書きされている場合。このルールは、完全な非連結コントロール (EDT、フィールド、またはデータメソッドなし) にも適用されることに注意してください。これには、registerOverrideMethod などの上書きも含まれます。

フォームデータソースにバインドされたコントロール

データソースにバインドされたコントロールは、次の条件の下で検索されます。フィールドバインド

"lookup" または "lookupReference" (参照コントロール) メソッドが上書きされます。
1. FormDataSource フィールドでルックアップまたは lookupReference が上書きされている場合。
2. コントロールでルックアップまたは lookupReference が上書きされている場合。
  - これには、registerOverrideMethod などの上書きも含まれます。
このフィールドに EDT がある場合、"拡張データ型にバインドされたコントロール" セクションのルール #2 が適用されます。
バインディングフィールドは、DBFGetRef ルールごとにリレーションをマップします。
1. 高レベルのルール:
  1. フィールドを支持する EDT 関係が存在し、テーブル関係ノードが入力され、Ignore EDT Relations がフィールド上で false である場合、その関係が使用されます (ルックアップがある)。
  2. フィールドに対してリレーションマッピングが使用され、任意の固定フィールドリンク条件が満たされている場合は、そのリレーションが使用されます (ルックアップがある)。
    1. 検証は「はい」にする必要があります。
  3. 次の場合に発生する移行された EDT 関係の特殊なケースに注意してください。
    1. フィールドは、関係ノードが設定される EDT によってサポートされます。
    2. フィールドは、「EDTRelation」設定を「はい」にするテーブル関係によってサポートされます。
    3. テーブル関係リンクは SourceEDT が適切な EDT に設定されています。
  4. また、IgnoreEDTRelation がフィールド上で true にセットされているケースを持つことができます。このケースでは、このセクションのルール #3.1.2 が true である場合にのみルックアップが発生します。

データメソッドバインド

データメソッドの戻り値が EDT である場合、"拡張データ型にバインドされたコントロール"セクションのルール #1 と #2 が適用されます。
コントロールでルックアップまたは lookupReference が上書きされている場合。
- これには、registerOverrideMethod を使用した上書きも含まれます。

複数選択のルックアップ

複数選択ルックアップを構築するために利用可能なシステムフォーム

現在、複数選択ルックアップを作成するためのシステムフォームが 2 つあります。

SysLookup: 列挙に基づいて複数選択します。
SysLookupMultiselectGrid: データの収集に基づいて複数選択します。

SysLookupMultiselect フォームの変更点とは

SysLookupMultiselect は、Microsoft Dynamics AX 2012 で廃止の対象としてマークされ、削除されました。複数選択のルックアップシナリオでこのフォームを使用する場合、SysLookupMultiselectGrid を使用するように移行する必要があります。例については、チュートリアル LookupMultiSelectGrid のフォームを参照してください。

検索シナリオはサポートされていません

ルックアップボタンが使用されているときの複数のルックアップフォームを作成しています

ルックアップボタンを使用して複数のルックアップフォームを作成する場合にエラーが発生する可能性があります。たとえば、「ルックアップ」メソッドを上書きして新しいルックアップフォームを作成しても、「スーパー」 (別のルックアップフォームを作成します) も呼び出します。

SelectedControl() を使用してルックアップをホストしているコントロールを決定

ルックアップをホストしているコントロールを決定する SelectedControl() の使用はサポートされていません。場合によっては動作しますが、他の場合には失敗します。たとえば、曖昧性解消ルックアップでは、コントロールを離れる行為は、曖昧性解消ルックアップをトリガーすることであるため、親フォーム上でコントロールは選択されていません。。 SelectedControl() を使用する代わりに、ルックアップをホストしているコントロールを取得するいくつかの方法があります。

ルックアップフォームの「selectTarget」を確認してください。
```
FormStringControl selectTarget = formRun.selectTarget();
```
ルックアップフォーム引数の「callerFormControl」を確認してください。 SysTableLookup::getCallerControl(Args args) はその呼び出しをカプセル化することに注意してください。
```
FormStringControl argsCallerFormControl = args.callerFormControl();
```

ルックアップフォームインスタンスがカーネルによって自動的にスピンアップされる場合、selectTarget および callerFormControl が自動的に設定されることに注意してください。フォームインスタンスがアプリケーションコードで作成される場合、これらを次のように手動で設定できます。

public void lookup()
{
    Args args = new Args(formStr(<formName>));
    args.caller(element);
    args.callerFormControl(this);
    FormRun formRun = classfactory.formRunClass(args);
    formRun.init();
    this.performFormLookup(formRun);
}

ルックアップボタンを使用する際のスライダーのダイアログ (ルックアップフォームの代わりに) を作成しています

ルックアップボタンを使用すると、ルックアップコントロールによってルックアップフォームを開く必要があります (スライダーダイアログまたはその他の種類のフォームではありません)。これの第 1 の理由は、製品の整合性を保つことです。 2 番目の重要な理由は、ルックアップからスライダーダイアログを開くことは、ルックアップの新しい先行入力機能と互換性がないことです。

ルックアップ コントロール

コントロールのルックアップ動作を有効化

拡張データ型にバインドされたコントロール

フォーム データ ソースにバインドされたコントロール

複数選択のルックアップ

複数選択ルックアップを構築するために利用可能なシステム フォーム