分析コード エントリ コントロールの取得

分析コード エントリ コントロールおよび関連するコントローラー クラスについて説明します。

一般的なアプローチ

設計の目標は、コントロールの実装をカプセル化し、コントロールをサポートするクラスとやり取りするフォームを必要としないことです。 この設計に合わせて、LedgerDimensionEntryController、LedgerDefaultDimensionEntryController などのように、すべてのフォームは直接コントローラー クラスではなく、分析コードのエントリ コントロール インスタンス API のみと対話する必要があります。操作されたプロパティおよびコントローラーで呼び出されたメソッドは、コントロールで呼び出される必要があります。

メモ :

• アップグレード スクリプトは、constructInGroupWithValues() メソッドおよび constructInTabWithValues() メソッドを使用して作成された分析コード エントリ コントロールのみを処理します。 他のコントロールは、手動でアップグレードする必要があります。
• アップグレード スクリプトは、ヘルパー メソッドのパラメーターとして送信された分析コード エントリ コントロールを処理しません。 このコードは、手動でアップグレードする必要があります。
• Dynamics AX 2012 では、既定の分析コード コントロールのコンテナーは、「必要なアクセス許可」 = 手動に設定することでセキュリティ保護可能なコントロールとして定義できました。 コントロールへのアクセスは、セキュリティ モデルで付与されているため、アクセスを正しく表示および管理することができました。 既定の分析コードのコントロールは、デザイン時のエクスペリエンスになりました。 したがって、フォームでは、コントロールのコンテナーを保護可能なコントロールとして定義する必要がなくなりました。 ほとんどの場合、手動の設定を削除するためにメタデータを制御するフォームを更新して、セキュリティ モデルのコントロールへの参照を削除する必要があります。 Dimension Entry コントロールに対して細かいセキュリティ制御を維持するために使用される場合、この設定は [手動] のままにすることができます。
• Dynamics AX 2012 では、parmAttributeSetDataSource および parmAttributeValueSetDataSource がデータ ソースと既定の分析コード コントロールに関連付けられたデータ ソースのフィールドを設定するために使用されていました。 これらは通常、DimensionDefaultingController インスタンスを作成した直後にフォームの init メソッドで設定されていました。 すべての呼び出し parmAttributeSetDataSource および parmAttributeValueSetDataSource はアップグレード後に削除されます。 これらの呼び出しの値を使用して、アップグレードされたコントロールのメタデータを設定します。 アップグレード後、これらの呼び出しをすべて削除した後、フォームが正常に機能していることを確認するために、フォームをチェックする必要があります。
• ディメンション入力コントロールはフォーム デザインでモデル化されるようになりました。 分析コードの入力管理を検索するには、デザイン要素を展開するか、フォーム デザインで "DimensionEntry" を検索します。 デザイン時に新しいコントロールがどのようなものかを次に示します。

プロパティ

分析コード エントリ コントロールのカスタム プロパティは、コントローラー グループの下にあります。

プロパティの詳細

コントローラー クラス プロパティ

各コントローラーの詳細は、以下のテーブルを参照してください。

いくつかの分析コード入力コントロールには、コントローラー プロパティが設定されていない可能性があります。 この場合、コントローラーはコントロールの値データ フィールドの EDT から推測されます。 一連の分析コード エントリ コントロールの特定のプロパティを以下に示します。 これらのプロパティは、上記の一般的なアプローチのセクション (DimensionEntryControlHeader) で選択した、分析コード入力コントロールの PurchTable フォームのプロパティです。 この分析コード エントリ コントロールは、PurchTableのTable テーブルの DefaultDimension フィールドを使用しています。 PurchTable の DefaultDimension フィールドの拡張データ型プロパティは、LedgerDefaultDimensionValueSet (以下を参照) に設定されます。 実行時に、この EDT は LedgerDefaultDimensionEntryController にマップされます。 したがって、この場合 DimensionEntryControlHeader コントロールは LedgerDefaultDimensionEntryController を使用します。 次の例は、EDT とそれがマップされているコントローラーを示しています。

拡張データ型およびマップされるコントローラー

スクリプト TODO のアップグレード

Dynamics AX 2012

/* TODO: (Code Upgrade) [Dimension entry control]
Replace this based on the migration guidance. */
DimensionEntryControl.reactivate();

財務と運用

reactivate メソッドは、分析コード エントリ コントロールを現在の設定でリフレッシュします。 このメソッドは、会社または表示された分析コード リストが変更された場合にのみ、コントロールを更新します。 この呼び出しは、これらのどちらも以前に変更されていない場合に削除できます。 それ以外の場合は、呼び出しはそのままにします。 reactivate() の直前で parmCompany() が呼び出され、それが reactivate() より前に呼び出された唯一の DEC API であり、そのメソッドがデータソースの active() 中に呼び出された場合、最適化を手動で行うことでパフォーマンスを向上させ、コードの取り込みを削減することができます。

1. データ ソースのアクティブ プロセス中に、parmCompany() および reactivate() 呼び出しを削除します。

2. 最初のユーザーとフォームとのやりとりの前に呼び出されるフォーム init()、run()、datasource init()、または同様のメソッドでは、次のコード行を追加します。

   DimensionEntryControl.parmCompanyReference(
       fieldStr([myTable], [myCompanyContextField]);
   

   この変更により、DEC はアクティブなレコードが変更されたときに更新される会社フィールド参照を自動的に見つけ出し、それに応じてディメンションのリストを更新できます。

Dynamics AX 2012

/* TODO: (Code Upgrade) [Dimension entry control]
Replace this based on the migration guidance. */
DimensionEntryControl.setEditability(true, 0);

財務と運用

特定の編集可能なディメンション セットが必要な場合は、この呼び出しを次のように置き換えます。

DimensionEntryControl.parmEditableDimensionSet(
    editableDimensionSet);

Dynamics AX 2012

/* TODO: (Code Upgrade) [Dimension entry control]
This method can be removed if there is
no custom implementation */
// dimensionDefaultingController.pageActivated();

財務と運用

このコールを、分析コード エントリ コントロールの親コントロールの pageActivated メソッドまたは Form Init メソッド内で実行する場合、削除することができます。 上記の場所以外のメソッド呼び出しの意図は明確ではありません。 呼び出しを削除して、コントロールをテストします。

Dynamics AX 2012

/* TODO: (Code Upgrade) [Dimension entry control]
Replace this based on the migration guidance. */
DimensionEntryControl.deleted();

財務と運用

データ ソースの削除メソッド内にはない deleted() の呼び出しのために、TODO が残されます。 これらの呼び出しは、データソースの削除メソッド内にのみ存在すると予想され、置換はありません。 呼び出しを削除して、コントロールをテストしてみてください。

Dynamics AX 2012

/* TODO: (Code Upgrade) [Dimension entry control]
Replace this based on the migration guidance. */
// dimensionDefaultingController.writing();

財務と運用

分析コード エントリ コントロール フレームワークは、値を保存します。 呼び出しを削除して、コントロールをテストします。

Dynamics AX 2012

/* TODO: (Code Upgrade) [Dimension entry control]
Replace this based on the migration guidance. */
dimensionDefaultingController::findBackingEntityInstance();

財務と運用

エンティティを検索するには、getEntityInstance メソッドを DimensionAttributeValue から呼び出す必要があります。 この呼び出しを次のようなものに置き換えます。

DimensionAttributeValue dimAttrValue =
    DimensionAttributeValue::
        findByDimensionAttributeAndValueNoError(
            dimensionAttributeTable, dimensionValue);
if (dimAttrValue) {
    common = dimAttrValue.getEntityInstance();
}

Dynamics AX 2012

/* TODO: (Code Upgrade) [Dimension entry control]
Replace this based on the migration guidance. */
DimensionEntryControlHeader.updateValues(NoYesUnchanged::Yes);

財務と運用

ここに 1 つのパラメーターがある場合のみ updateValues() メソッドが呼び出されるため、呼び出しは allowEdit() の呼び出しに置き換えることができます。

DimensionEntryControlHeader.allowEdit(
    NoYesUnchanged::Yes);

Dynamics AX 2012

/* TODO: (Code Upgrade) [Dimension entry control]
Replace this based on the migration guidance. */
DimensionEntryControlHeader.updateValues(
    NoYesUnchanged::No, true);

財務と運用

この場合、updateValues() の呼び出しには 2 つのパラメーターがあるので、コントロールの編集機能を変更するには allowEdit() の呼び出しと置き換え、コントロールの値をクリアするには loadAttributeValueSet() の呼び出しと置き換える必要があります。

DimensionEntryControlHeader.allowEdit(
    NoYesUnchanged::No);
DimensionEntryControlHeader.loadAttributeValueSet(0);

削除する可能性のあるメソッド

分析コード エントリ コントロールを保持するデータソースまたは tabpage/グループの残りのメソッドは、カスタム ロジックがない場合、削除することができます。 次のテーブルは、削除する必要があるカスタマイズのないメソッドの例を示しています。

Dynamics AX 2012

public int active(){int ret;ret = super();return ret;}

財務と運用

このメソッドはデータソースにあります。 カスタム ロジックがない場合に削除することができます。

Dynamics AX 2012

public void delete(){super();}

財務と運用

このメソッドはデータソースにあります。 カスタム ロジックがない場合に削除することができます。

Dynamics AX 2012

public void deleted(){super();}

財務と運用

このメソッドはデータソースにあります。 カスタム ロジックがない場合に削除することができます。

Dynamics AX 2012

public void deleting(){super();}

財務と運用

このメソッドはデータソースにあります。 カスタム ロジックがない場合に削除することができます。

Dynamics AX 2012

public boolean validateDelete(){boolean ret;ret = super();return ret;}

財務と運用

このメソッドはデータソースにあります。 カスタム ロジックがない場合に削除することができます。

Dynamics AX 2012

public void write(){super();}

財務と運用

このメソッドはデータソースにあります。 カスタム ロジックがない場合に削除することができます。

Dynamics AX 2012

public void writing(){super();}

財務と運用

このメソッドはデータソースにあります。 カスタム ロジックがない場合に削除することができます。

Dynamics AX 2012

public void written(){super();}

財務と運用

このメソッドはデータソースにあります。 カスタム ロジックがない場合に削除することができます。

Dynamics AX 2012

public boolean validateWrite(){boolean ret;ret = super();return ret;}

財務と運用

このメソッドはデータソースにあります。 カスタム ロジックがない場合に削除することができます。

Dynamics AX 2012

public void pageActivated()
{
    super();
    /* TODO: (Code Upgrade) [Dimension entry control] This method can be removed if
    there is no custom implementation */
    // dimensionDefaultingController.pageActivated();
}

財務と運用

この方法は分析コード エントリ コントロールを保持する TabPage またはグループになります。 カスタム ロジックがない場合は、メソッドを削除することができます。

コンパイル エラー

このセクションでは、取り残される可能性のある一般的なコンパイル エラーに対処する方法について説明します。

Dynamics AX 2012

フォーム上 (PurchTable):

purchTableForm.parmDimensionDefaultingControllerHeader(
    dimensionDefaultingControllerHeader);

クラス内 (PurchTableForm):

public DimensionDefaultingController
parmDimensionDefaultingControllerHeader(
    DimensionDefaultingController
        _dimensionDefaultingControllerHeader =
        dimensionDefaultingControllerHeader)
{
   dimensionDefaultingControllerHeader =
       _dimensionDefaultingControllerHeader;
   return dimensionDefaultingControllerHeader;
}

財務と運用

フォーム上 (PurchTable):

purchTableForm.parmDimensionEntryControlHeader(
    DimensionEntryControlHeader);

クラス内 (PurchTableForm):

public DimensionEntryControl
parmDimensionEntryControlHeader(
    DimensionEntryControl
       _dimensionEntryControlHeader =
       dimensionEntryControlHeader)

{
    dimensionEntryControlHeader =
        _dimensionEntryControlHeader;
    return dimensionEntryControlHeader;
}

その他のリソース

ダイアログの分析コード エントリ コントロールのサポート