セグメント化されたエントリコントロールの移行のガイダンス

[アーティクル]
06/19/2024

この記事では、セグメント化されたエントリコントロールを Microsoft Dynamics AX 2012 のパターンから Microsoft Dynamics AX の新しいパターンに移行するプロセスについて説明します。

新しい設計の目標は、コントロールの実装をカプセル化し、コントロールをサポートするクラスとやり取りするフォームを必要としないことです。したがって、Microsoft Dynamics AX で、すべてのフォームは、セグメント化されたエントリ コントロールインスタンスのアプリケーションプログラミングインターフェイス (API) とのみ対話する必要があります。それらは、コントローラークラス (LedgerDimensionAccountController や DimensionDynamicAccountController など) と直接対話してはなりません。コントローラー上で以前に操作または呼び出された任意のプロパティは、コントロール上で呼び出される必要があります。

メモ :

一部の API は、コントローラーとコントロールで命名方法が違います。次のテーブルにこれらの API の一覧を示します。

コントローラメソッド (旧)	コントロールメソッド (新)
parmDate	parmControlDate
parmFilterLedgerPostingType	parmPostingType
parmDimensionAccountStorageUsage	parmDimensionAccountStorageUsageType

例
- 以前: controller.parmDate(systemDateGet())
- 以後: LedgerAccount.parmControlDate(systemDateGet());
この例では、コントローラー>LedgerDimensionAccountController インスタンスと LedgerAccount> 新規セグメント化エントリ コントロールのインスタンス。
コントロールやデータフィールドでオーバーライドされたメソッドでは、コードアップグレードルールが、コントローラーのメソッドの呼び出しを、特定のコントローラーを使用していた各コントロールインスタンスのメソッドの呼び出しに置き換えます。
例
- 以前:
```
Public void jumpRef()
{
    ledgerDimensionDefaultAccountcontroller.jumpRef();
}
```
- 以後:
```
Public void jumpRef()
{
    segmentedEntryControl1.jumpRef();
    segmentedEntryControl2.jumpRef();
}
```
これらの変更は、他の場所に移動する必要があるコードをコピーして貼り付ける方が簡単になるように行われています (例: loadSegments() およびその他の類似メソッドの一部のインスタンス)。メソッドを削除するかどうか決定するときは、この変更を無視することができます。決定内容は、メソッドにカスタムロジックにあるかどうかによって異なります。
コードのアップグレードスクリプトは、コントローラーがメソッド内でインスタンス化されるケースを処理しません。このような場合は、手動で移行する必要があります。
Microsoft Dynamics AX 2012 の MRU 機能は、Dynamics AX で削除されました。置き換えの予定はありません。
parmTaxCode が削除されました。交換はありません。

プロパティ

セグメント化エントリコントロールのカスタムプロパティは、コントローラーの下にあります。次のスクリーンショットは、例を示します。

セグメント化されたエントリコントロールのカスタムプロパティ。

すべてのプロパティがすべての コントローラー クラスタイプに適用されるわけではありません。選択したコントローラークラスに適用されないプロパティは無効になります。次のテーブルは、それぞれのプロパティに関する詳細を示します。

プロパティ	有効な値	用途
勘定タイプフィールド	データソースからのフィールド。	使用されるアカウントの種類を決定します。通常、複数セグメントの勘定科目から、Cust、Vend、Bank、Project などの他のックアップテーブルの単一セグメント値への仕訳入力に使用されます。
コントローラークラス	6 つのコントローラークラスのうちの 1 つです。たとえば LedgerDimensionDefaultAccountController です。	セグメント化されたエントリコントロールの動作およびパターンを決定します。このプロパティの詳細については以下で説明します。
財務勘定を含む	NoYes	財務勘定である主勘定が有効であるかどうかを決定します。
勘定合計を含む	NoYes	タイプが "合計" の主勘定が有効であるかどうかを判断します。
既定の勘定です。	TrueFalse	動的アカウントで、アカウントが既定または完全アカウントであるべきかどうかを決定します。
主勘定セグメントのロック	NoYes	主勘定セグメントがロックされているかどうかをコントロールします。通常は仕訳帳や構成に基づく配分に使用されます。
転記タイプ	LedgerPostingType 列挙の値。	主勘定が検証され、そのアカウントで使用される転記タイプが許可されているかどうかを確認されます。
手動入力のブロック状態の検証	NoYes	分析コードの「手動入力のブロック」ステータスを優先するかどうかを決定します。

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

次のテーブルは、それぞれのコントローラーに関する詳細を示します。

コントローラー	詳細情報
BudgetLedgerDimension	このコントローラーは、セグメント化された入力コントロールのデータ入力の予算に基づくサポートを提供します。このコントローラーを使用するときは、勘定構造をセグメント化エントリコントロールに提供する必要があります。
BudgetPlanningLedgerDimension	このコントローラーは、セグメント化された入力コントロールのデータ入力の予算計画に基づくサポートを提供します。このコントローラーを使用するときは、勘定構造をセグメント化エントリコントロールに提供する必要があります。
DimensionDynamicAccount	このコントローラーは、セグメント化された入力コントロールの複数のアカウントタイプのサポートを提供します。
LedgerDimensionAccountAlias	このコントローラーは、セグメント化された入力コントロールのアカウントエイリアスのサポートを提供します。
LedgerDimensionAccount	このコントローラーは、セグメント化された入力コントロールの複数のセグメントのデータ入力のサポートを提供します。
LedgerDimensionDefaultAccount	このコントローラーは、セグメント化された入力コントロールの既定のアカウントのサポートを提供します。

移行ステップ

ステップ１

AX 2012

SegmentedEntry は任意のコントロールの横にあるタイプとして表示され、SegmentedEntryControl と変更します。

Dynamics AX

簡単な方法は古いコントロールの名前に「_old」を追加し、新しいコントロール (コントロールの元の名前がある必要があります) を付け加え、すべての設定を移行した後、古いコントロールを削除します。

メモ

コントロールを参照するテストおよび他のコードが破損しないようにするには、新しいコントロールが古いコントロールと同じ名前であることを確認します。新しいコントロールを追加するには、セグメント化されたエントリ コントロールを含む親コントロールを右クリックしてから、新規>SegmentedEntryControl を選択します。

次のスクリーンショットは、新しいコントロールの外観を示しています。

ステップ２

AX 2012

jumpRef() コントロール/フィールドメソッドをオーバーライドします。

public void jumpRef()
{
    ledgerDimensionDefaultAccountController.jumpRef();
}

Dynamics AX

他の機能が含まれなくなった場合は jumpRef() メソッドを完全に削除します。その他のカスタム jumpRef 機能がある場合は、それをそのままにします。ただし、jumpRef がコントロールによって自動的に処理されます。

ステップ 3

AX 2012

loadAutoCompleteData() コントロールメソッドをオーバーライドします。

public void loadAutoCompleteData(LoadAutoCompleteDataEventArgs _e)
{
    ledgerDimensionDefaultAccountController.loadAutoCompleteData(_e);
    super(_e);
}

Dynamics AX

loadAutoCompleteData() メソッドを削除します。

ステップ 4

AX 2012

loadSegments() コントロールメソッドをオーバーライドします。

public void loadSegments()
{
    super();
    ledgerDimensionDefaultAccountController.loadSegments();
    ledgerDimensionDefaultAccountController.parmControl(this);
}

Dynamics AX

loadSegments() メソッドが、コントローラーの loadSegments() および parmControl() メソッドを呼ぶ以外に何もしない場合は、それを削除します。ただし、parmControl() 呼び出しに渡される SEC コントロールインスタンスをメモしておきます。呼び出されていたメソッドは、そのインスタンスで呼び出される必要があります。

ステップ 5

AX 2012

loadSegments() コントロールメソッドをオーバーライドします。

public void loadSegments()
{
    super();
    dimAccountController.parmControl(this);
    dimAccountController.parmJournalName(ledgerJournalTable.JournalName);
    dimAccountController.parmCurrency(ledgerJournalTrans.CurrencyCode);
    dimAccountController.parmDataAreaId(ledgerJournalTrans.Company ? ledgerJournalTrans.Company : curext());
    dimAccountController.parmDate(ledgerJournalTrans.TransDate);
    dimAccountController.parmTaxCode(ledgerJournalTrans.TaxCode);

    dimAccountController.loadSegments();
}

Dynamics AX

loadSegments() メソッドがコントローラーでのパラメーターを設定するために使用された場合、パラメーター メソッドへの呼び出しは、パラメーター メソッドのソースを変更することができるすべての場所に移動する必要があります。ほとんどの場合、これらの場所は対応するデータフィールドの modified() メソッドおよび/またはデータソースの active() メソッドです。たとえば、loadSegments() の移行したコードの一部は、左側で上書きをし、次のようになります。

dimAccountController.parmControl(this) -> No longer needed.

parmControl() 呼び出しに渡される SEC コントロールインスタンスをメモしておきます。コントローラー上で呼び出されていたメソッドは、そのインスタンスで呼び出される必要があります。

dimAccountController.parmJournalName(ledgerJournalTable.JournalName) ->
LedgerJournalTable data source,
JournalName field,
public void modified()
{
    .parmJournalName(ledgerJournalTable.JournalName);
}

LedgerJournalTable データソース

    public void active()
    {
        .parmJournalName(ledgerJournalTable.JournalName);
    }

メモ

loadSegments() メソッドからすべてのコードを削除したら、そのメソッドを削除できます。

ステップ 6

AX 2012

loadSegments() コントロールメソッドをオーバーライドします。場合によっては、loadSegments() メソッドは、テーブルバッファを使用してコントローラーでパラメーターを設定することがありますが、そのテーブルバッファはフォーム上のデータソースではありません。たとえば、LedgerJournalTransDaily フォームでは、loadSegments() の元の実装は次のようになります。

public void loadSegments()
{
    super();

    dimAccountController.parmControl(this);
    dimAccountController.parmJournalName(ledgerJournalTable.JournalName);
    dimAccountController.parmCurrency(ledgerJournalTrans.CurrencyCode);
    dimAccountController.parmDataAreaId(ledgerJournalTrans.Company ? ledgerJournalTrans.Company : curext());
    dimAccountController.parmDate(ledgerJournalTrans.TransDate);
    dimAccountController.parmTaxCode(ledgerJournalTrans.TaxCode);

    dimAccountController.loadSegments();

    currentMainAccountId = dimAccountController.getValue(DimensionAttribute::getMainAccountDimensionAttribute());
}

JournalName プロパティは、ledgerJournalTable バッファから設定されますが、LedgerJournalTable テーブルはフォームのデータソースではないことに注意してください。

Dynamics AX

このような場合、そのコードをデータソースの active() メソッド、またはデータフィールドの modified() メソッドに移動できません。代わりに、テーブルバッファが設定されている場所を特定する必要があります。たとえば、LedgerJournalTransDaily フォームの元の実装では、ledgerJournalTable バッファはフォームの initLedger() メソッドで設定されました。 parmJournalName() に渡される値は、バッファが initLedger() メソッドで再割り当てされる場合のみ変更できることを明らかにする必要があります。したがって、バッファを割り当てた後、コードを initLedger() メソッドに移動する必要があります。また、一般的なガイドラインに従って、コントロールインスタンスに対して parmJournalName() メソッドが呼び出されます。

void initLedger()
{
    TransDate   dateFrom   = dateNull();
    TransDate   dateTo     = systemDateGet();

    if (element.args().dataset() == tableNum(LedgerJournalTable))
    {
        ledgerJournalTable = element.args().record();
        LedgerJournalTrans_AccountNum.parmJournalName(ledgerJournalTable.JournalName);
        LedgerJournalTrans_AccountNum1.parmJournalName(ledgerJournalTable.JournalName);
        GridOffsetAccount.parmJournalName(ledgerJournalTable.JournalName);
        LedgerJournalTrans_OffsetAccount1.parmJournalName(ledgerJournalTable.JournalName);
        ...
    }
    ...
}

ステップ 7

AX 2012

segmentValueChanged() コントロールメソッドをオーバーライドします。

public void segmentValueChanged(SegmentValueChangedEventArgs _e)
{
    super(_e);
    ledgerDimensionDefaultAccountController.segmentValueChanged(_e);
}

Dynamics AX

segmentValueChanged() を実装した場合に、コントローラー上で super() と segmentValueChanged() メソッドを呼び出す以外何も起こらない場合は、メソッドを削除することができます。

ステップ 8

AX 2012

segmentValueChanged() コントロールメソッドをオーバーライドします。

public void segmentValueChanged(SegmentValueChangedEventArgs _e)
{
    super(_e);

    dimOffsetAccountController.segmentValueChanged(_e);
    currentOffsetMainAccountId = ledgerJournalEngine.onOffsetAccountSegmentChanged(dimOffsetAccountController, currentOffsetMainAccountId, ledgerJournalTrans);
}

Dynamics AX

segmentValueChanged() の実装に追加のロジックがある場合、次に示すように、メソッドを onSegmentChanged() メソッドに置き換える必要があります。

public void onSegmentChanged(DimensionControlSegment _segment)
{
    currentOffsetMainAccountId = ledgerJournalEngine.onOffsetAccountSegmentChanged(this, currentOffsetMainAccountId, ledgerJournalTrans);
}

メモ :

onSegmentChanged() メソッドを追加するには、次の手順を実行します。
1. メソッドを追加するには、セグメント化されたエントリコントロールを展開します。
2. メソッド ノードをクリックしてから、上書き>onSegmentChanged を選択します。
新しいメソッドは、super() またはコントロールまたはコントローラーのいずれかの他のメソッドを呼び出す必要はありません。

ステップ 9

AX 2012

validate() コントロールメソッドをオーバーライドします。

public boolean validate()
{
    boolean isValid;
    isValid = super();
    isValid = ledgerDimensionDefaultAccountController.validate() && isValid;

    return isValid;
}

Dynamics AX

追加の検証がある場合以外は、validate() メソッドを削除します。 super() 呼び出しは、このコードが行っていたすべてのことを行います。したがって、保持している新しいコードのみを残しておいてください。

ステップ 10

AX 2012

lookup() コントロールメソッドをオーバーライドします。

public void lookup()
{
    switch (emplParameters_RU.BankCloseACType)
    {
    case LedgerJournalACType::Bank:
        BankAccountTable::lookupBankAccount(this);
        break;
    case LedgerJournalACType::Cust:
        CustTable::lookupCustomer(this);
        break;
    case LedgerJournalACType::FixedAssets:
        AssetTable::lookupAccountNum(this);
        break;
    case LedgerJournalACType::Ledger:
        super();
        break;
    case LedgerJournalACType::Project:
        ProjTable::lookupProjId(this, emplParameters_RU);
        break;
    case LedgerJournalACType::Vend:
        VendTable::lookupVendor(this);
        break;
    default:
        super();
        break;
    }
}

Dynamics AX

lookup() メソッドをそのままにします。

ステップ 11

AX 2012

lookupReference() コントロールメソッドをオーバーライドします。

public Common lookupReference()
{
    Common ret;
    ret = super();
    return ret;
}

Dynamics AX

lookupReference() メソッドが既定の実装を使用している場合、それを削除することができます。

ステップ 12

AX 2012

modified() コントロールメソッドをオーバーライドします。

public boolean modified()
{
    boolean ret;

    ret = super();

    if (tmpCurrencyLedgerGainLossAccount.LedgerDimension)
    {
        tmpCurrencyLedgerGainLossAccount.AccountName =
        MainAccount::getLocalizedNameByMainAccountId(
        DimensionStorage::getMainAccountNumFromLedgerDimension(
        tmpCurrencyLedgerGainLossAccount.LedgerDimension), ledger.ChartOfAccounts);
    }
    else
    {
        tmpCurrencyLedgerGainLossAccount.AccountName = '';
    }

    return ret;
}

Dynamics AX

modified() メソッドをそのままにします。

ステップ 13

AX 2012

gotFocus() コントロールメソッドをオーバーライドします。

void gotFocus()
{
    super();
    if (ledgerJournalTable.FixedOffsetAccount)
    {
        ledgerJournalTrans_OffsetAccount.allowEdit(ledgerJournalTrans.OffsetAccountType == LedgerJournalACType::Ledger);
    }
    else if (!ledgerJournalTrans_OffsetAccount.allowEdit())
    {
        ledgerJournalTrans_OffsetAccount.allowEdit(true);
    }
}

Dynamics AX

このアプローチは、loadSegments() メソッドのアプローチに似ています。 parm メソッドのソースが変更できるすべての場所にコードを移動する必要があります。ほとんどの場合、これらの場所は対応するデータフィールドの modified() メソッドおよび/またはデータソースの active() メソッドです。たとえば、上記のコードでは、移行したコードはこのようになります。

LedgerJournalTable data source,
FixedOffsetAccount field
public void modified()
{
    if (ledgerJournalTable.FixedOffsetAccount)
    {
        ledgerJournalTrans_OffsetAccount.allowEdit(ledgerJournalTrans.OffsetAccountType == LedgerJournalACType::Ledger);
    }
    else if (!ledgerJournalTrans_OffsetAccount.allowEdit())
    {
        ledgerJournalTrans_OffsetAccount.allowEdit(true);
    }
}

LedgerJournalTrans data source,
OffsetAccountType field
public void modified()
{
    if (ledgerJournalTable.FixedOffsetAccount)
    {
        ledgerJournalTrans_OffsetAccount.allowEdit(ledgerJournalTrans.OffsetAccountType == LedgerJournalACType::Ledger);
    }
        else if (!ledgerJournalTrans_OffsetAccount.allowEdit())
    {
        ledgerJournalTrans_OffsetAccount.allowEdit(true);
    }
}

LedgerJournalTrans data source:
public void active()
{
    if (ledgerJournalTable.FixedOffsetAccount)
    {
        ledgerJournalTrans_OffsetAccount.allowEdit(ledgerJournalTrans.OffsetAccountType == LedgerJournalACType::Ledger);
    }
    else if (!ledgerJournalTrans_OffsetAccount.allowEdit())
    {
        ledgerJournalTrans_OffsetAccount.allowEdit(true);
    }
}

LedgerJournalTable data source:
public void active()
{
    if (ledgerJournalTable.FixedOffsetAccount)
    {
        ledgerJournalTrans_OffsetAccount.allowEdit(ledgerJournalTrans.OffsetAccountType == LedgerJournalACType::Ledger);
    }
    else if (!ledgerJournalTrans_OffsetAccount.allowEdit())
    {
        ledgerJournalTrans_OffsetAccount.allowEdit(true);
    }
}

メモ

gotFocus() メソッドからすべてのコードを削除したら、そのメソッドを削除できます。

ステップ 14

AX 2012

フォーム init() メソッド:

ledgerDimensionDefaultAccountController = LedgerDimensionDefaultAccountController::construct(vendParameters_ds, fieldStr(VendParameters, ClearingLedgerDimension));

Dynamics AX

コントロールで以下のプロパティを設定します。

データソース
参照フィールド
コントローラークラス

メモ

コントロールが機能するには、コントローラクラスが必要です。したがって、Controller Class プロパティが設定されていないと、ランタイムエラーがスローされます。

ステップ 15

AX 2012

ledgerDimensionAccountController.setValues(ledgerJournalTrans.DefaultDimension, false);

Dynamics AX

分析コードの指定子のマップを作成してから、セグメント化されたエントリコントロールの setDimensionSpecifiers メソッドに送信する必要があります。

Map defaultDimensionSpecifiers = LedgerDimensionDefaultingEngine::getDefaultDimensionSpecifiers(ledgerJournalTable.DefaultDimension);

TmpLedgerJournalSplitLines_LedgerAccount.setDimensionSpecifiers(defaultDimensionSpecifiers, false);

メモ

分析コードの指定子のマップに何かを追加してからコントロールに送ることができます。新しいマップをここで作成することもできます。 (同様のロジックに関しては、LedgerJournalEngine クラス内の onSegmentChangedForPrimaryAccount メソッドを参照してください。)

ステップ 16

AX 2012

parmControl() メソッド呼び出し:(これらは通常、フォームの init() メソッドまたはコントロールで上書きされたメソッドのうちの 1 つに存在します。)

ledgerDimensionDefaultAccountController.parmControl(clearingAccount);

Dynamics AX

必要がなくなったため、このコード行を削除します。ただし、最初にどのコントローラーがどのコントロールで使用されるかを記録します。たとえば、この場合、ledgerDimensionDefaultAccountController が ClearingAccount SEC で使用されています。マッピングは、コントロールでコントローラーオブジェクトのメソッド呼び出しを対応するメソッド呼び出しに置き換える場合、およびデザイン時にプロパティを設定する場合に必要です。

ステップ 17

AX 2012

フォーム init() メソッド:

ledgerDimensionDefaultAccountController.parmFilterLedgerPostingType(LedgerPostingType::VendSettlement);

Dynamics AX

これは、コントロールの転記タイププロパティです。 PostingType プロパティを設定する必要があるコントロールは、parmControl() 呼び出しを見て派生したマッピングの詳細から判別できます。

これらのプロパティは、コントロールインスタンスで parm メソッドを介してコードで設定することもできます。次に例を示します。

ClearingAccount.parmPostingType(LedgerPostingType::VendSettlement);

ステップ 18

AX 2012

元帳分析コードのデータソースフィールドで resolveReference() をオーバーライドします。

Dynamics AX

不要になったので、このコードを削除してください。コントロールこれを自動的に処理します。

ステップ 19

AX 2012

フォームは、parm メソッドを通じてコントローラーのプロパティを設定します。

Dynamics AX

一般に、コントローラークラスに以前設定されていたプロパティをコントロールに直接設定する必要があります。このプロパティを設定する必要があるコントロールは、parmControl() 呼び出しを見て派生したマッピングの詳細から判断できます。また、セグメント化エントリ コントロールの場合、Microsoft Visual Studio のプロパティ ダイアログボックスで使用できるプロパティは、コントロールインスタンスで対応する parm メソッドを使用して、コードで設定することもできます。

ステップ 20

AX 2012

フォームは、コントロールの currentSegmentIndex() メソッドを使用します。

dimOffetAssetController. getDimensionAttributeByControlIndex(currentSegmentIndex);

Dynamics AX

一般に、コントローラークラスに以前設定されていたプロパティをコントロールに直接設定する必要があります。このプロパティを設定する必要があるコントロールは、parmControl() 呼び出しを見て派生したマッピングの詳細から判断できます。また、セグメント化エントリ コントロールの場合、Visual Studio のプロパティ ダイアログボックスで使用できるプロパティは、コントロールインスタンスで対応する parm メソッドを使用して、コードで設定することもできます。

ステップ 21

AX 2012

このフォームは、コントローラーオブジェクトのメソッドを呼び出します。次に例を示します。

dimOffetAssetController. getDimensionAttributeByControlIndex(currentSegmentIndex);

Dynamics AX

コントローラー上のすべてのメソッド呼び出しはコントロール上のメソッド呼び出しに置き換える必要があります。この例では、代わりにコントロールで getDimensionAttributeByControlIndex() メソッドを使用します。

segmentedEntryControl. getDimensionAttributeByControlIndex();

ステップ 22

AX 2012

DimensionDynamicAccountController で、勘定タイプはコンストラクターを通して指定されます。

DimensionDynamicAccountController::construct(ledgerJournalTrans_ds, fieldStr(LedgerJournalTrans, LedgerDimension), fieldStr(LedgerJournalTrans, AccountType));

Dynamics AX

この機能を実装するには、2 つのメソッドがあります。これらのメソッドは相互に排他的なため、状況に応じてそれらのメソッドのうち 1 つのみを使用してください。

セグメント化されたエントリーコントロールについては、プロパティダイアログボックスで、勘定タイプフィールドプロパティを勘定タイプを提供するデータソースフィールドに設定します。これが推奨されるメソッドです。

メモ

super() 呼び出しが、口座タイプフィールド プロパティにバインドされているフィールドの modified() メソッドから削除されている場合、このメソッドは機能しません。 LedgerJournalTransDaily などのいくつかの仕訳帳フォームで、この問題が確認されました。このような場合、super() コールバックを modified() メソッドに追加するか、2 つ目のメソッドを使用します。
コントロールで parmAccountTypeEnumValue() メソッドを呼び出すことにより、勘定タイプを手動で設定します。次に例を示します。
```
LedgerJournalTrans_AccountNum.parmAccountTypeEnumValue(enum2int(ledgerJournalTrans.AccountType));
```
メモ

parmAccountTypeEnumValue() への呼び出しは、勘定タイプを提供するフィールドの、データソースの active() メソッド、および modified() メソッドの両方に入力する必要があります。

ステップ 23

AX 2012

フォームには定義されている変数があります。

LedgerDimensionDefaultAccountController ledgerDimensionDefaultAccountController;

Dynamics AX

コントローラーが必要なくなったため、これを削除します。

ステップ 24

AX 2012

parmCurrentLedgerCOA() メソッド呼び出し:(これらは通常、フォームの init() メソッドまたはコントロールで上書きされたメソッドのうちの 1 つに存在します。)

ledgerDimensionDefaultAccountController.parmCurrentLedgerCOA(LedgerCOA::current());

Dynamics AX

ほとんどの場合に必要がなくなったため、このコード行を削除します。この線を削除する前に、LedgerCOA 値がその情報から派生するため、データ領域 ID がパラメーターとしてコントローラーに正しく渡されていることを確認してください。データ領域 ID が渡されない場合は、parmCurrentLedgerCOA() を parmDataAreaId() で交換し、通常は curext() または会社のアカウント管理のために範囲を制御する別のテーブルフィールドである適切な SelectableDataArea 値を渡します。フォームにデータ領域のコンテキストはありませんが、現在の LedgerCOA 値のみがある場合、既定のアカウントコントローラーだけで動作する必要があります。企業には無関係ですが、特定の勘定科目表 (COA) (MainAccount および Allocations など) にスコープされているフォームがいくつかあります。そのような場合、parmCurrentLedgerCOA が、既定のアカウントコントローラータイプセットを持つセグメント化エントリ コントロールインスタンスで呼び出される必要があります。

ステップ 25

AX 2012

parmIncludeFinancialAccounts(NoYes) メソッド呼び出し:

LedgerDimensionDefaultAccountController.parmIncludeFinancialAccounts(NoYes::Yes);

Dynamics AX

このコード行は不要になり、セグメント化されたエントリコントロールのプロパティを使用して直接設定する必要があります。

メモ

フレームワークのバグのため、これを明示的に設定しないと、以前の動作では、構築中に暗黙的にはいが割り当てられていましたが、勘定分析コードの既定のアカウントコントローラーに いいえ が割り当てられます。この操作は、プロパティとして手動で設定する必要があります。または、ダイアログクラスへの、parm メソッドがまだ明示的に呼び出されるはずです。

ステップ 26

AX 2012

セグメント化エントリ コントロールのアカウントタイプを提供するデータフィールドの 変更済み メソッドのコードは、コントロールが動的アカウントコントロールとして使用されている場合、このようになります。

public void modified()
{
    super();

    // Lock the main account segment if "Fixed offset account" is selected in Journal Names
    if (ledgerJournalTable.OffsetAccountType == LedgerJournalACType::Ledger)
    {
        controller.parmLockMainAccountSegment(ledgerJournalTable.FixedOffsetAccount);
    }
}

Dynamics AX

このデータフィールドの modified メソッドは、参照フィールドとして セグメント化されたエントリ コントロールにバインドされた勘定分析コードフィールドをクリアしなければならなくなりました。たとえば、セグメント化されたエントリコントロールの名前が OffsetAccount である場合、このコントロールの参照フィールドプロパティが LedgerDimension に設定され、上記のコード内の変更メソッドが次のように変更される必要があります。

public void modified()
{
    super();

    OffsetAccount.LedgerDimension = 0;

    // Lock the main account segment if "Fixed offset account" is selected in Journal Names
    if (ledgerJournalTable.OffsetAccountType == LedgerJournalACType::Ledger)
    {
        OffsetAccount.parmLockMainAccountSegment(ledgerJournalTable.FixedOffsetAccount);
    }
}

追加の明細行は、勘定タイプが変更されたときにコントロールをクリアするために必要です。

ステップ 27

AX 2012

コントローラーで parmAccountStructure() メソッドを呼び出すことができます。

fromBudgetPlanningLedgerDimensionController.parmAccountStructureId(accountStructureIdLocal);

Dynamics AX

このメソッドは 2 つの異なるメソッドで置き換えられます。また、新しいメソッドの目的は、古いメソッドの逆です: 古いメソッドは検証を無効にしましたが、新しいメソッドはそれを有効にします。したがって、コードを移行するときは、新しいメソッドの Boolean パラメーターを逆にする必要があります。たとえば、上記のコードでメソッドの呼び出しについては、新しいメソッドはこのようになります。

ToBudgetTransactionLine_LedgerDimension.parmDoValueActiveDatesValidation(false);

ToBudgetTransactionLine_LedgerDimension.parmDoValueSuspendedValidation(false);

ステップ 28

AX 2012

以下のコントローラーで parmAccountStructure() メソッドを呼び出すことができます。

fromBudgetPlanningLedgerDimensionController.parmAccountStructureId(accountStructureIdLocal);

Dynamics AX

parmAccountStructureId() メソッドは、コントロール上に存在しません。代わりに、個別の getAccountStructure() および setAccountStructure() メソッドがあります。したがって、parmAccountStructureId() 呼び出しは、parm メソッドがどのように使用されていたかに応じて、get メソッドまたは set メソッドで置き換えられる必要があります。たとえば、上記のコードで parm メソッドはセッターとして呼び出されたので、呼び出しは設定メソッドへの呼び出しによって置換される必要があります。

ToBudgetPlanningTransactionLine_LedgerDimension.setAccountStructureId(accountStructureIdLocal);

ステップ 29

AX 2012

parmSkipSuspendedAndActiveDateValidation:

Dynamics AX

ToBudgetTransactionLine_LedgerDimension.parmDoValueActiveDatesValidation(false);

ToBudgetTransactionLine_LedgerDimension.parmDoValueSuspendedValidation(false);

ステップ 30

AX 2012

通常は loadSegments() メソッド内でコントローラーの loadFromId メソッドを呼び出します。

ledgerDimensionDefaultAccountControllerResourceIssueOffset.loadFromId(wrkCtrTable.ResourceIssueOffsetLedgerDimension);

Dynamics AX

このメソッドは推奨されておらず、使用しないでください。このメソッドに対するすべての呼び出しを削除する必要があります。

ダイアログ上のセグメント化エントリコントロールの移行

ダイアログ上の新しいセグメント化されたエントリ コントロールの取得パターンは Dynamics AX で変更されています。コントローラークラス API とのやり取りではなく、SegmentedEntryControlBuild クラスとやり取りしてダイアログと SEC をリンクする必要があります。このセクションでは、異なるコントローラータイプのダイアログで SEC を使用するためのコードパターンを示します。

メモ

Dynamics AX ではヘルプテキストが不要になるため、ダイアログフィールドにヘルプテキストを設定する必要はありません。

動的アカウント:

以前:

// Creating the dialog field for the SEC
dialogDynamicAccountType = _dialog.addFieldValue(enumStr(LedgerJournalACTypeForPaymProposal), defaultOffsetAccountType, "@SYS115164", "@SYS115165");
dialogDynamicAccount = _dialog.addFieldValue(extendedTypeStr(LedgerDimensionBase), defaultOffsetLedgerDimension, "@SYS115166", "@SYS115167");
dimensionDynamicAccountController = DimensionDynamicAccountController::constructForDialog(dialogDynamicAccount, dialogDynamicAccountType, enumStr(LedgerJournalACTypeForPaymProposal));
            dimensionDynamicAccountController.parmIsDefaultAccount(true);

public void dialogPostRun(DialogRunBase _dialog)
{
…

dialogDynamicAccountType.registerOverrideMethod('modified', 'accountType_Modified', this);

...
}

private boolean accountType_Modified(FormComboBoxControl _formComboBoxControl)
{
    boolean valueWasModified;

    valueWasModified = _formComboBoxControl.modified();
    if (valueWasModified)
    {
        dialogDynamicAccount.value(0);
    }

    return valueWasModified;
}

以後:

// Creating the dialog field for the SEC
protected Object dialog()
{
...        

// Create the account type dialog field
dialogDynamicAccountType = _dialog.addFieldValue(enumStr(LedgerJournalACTypeForPaymProposal), defaultOffsetAccountType, "@SYS115164", "@SYS115165");
// Create the SEC dialog field
dialogDynamicAccount = SegmentedEntryControlBuild::addToDialog(dialog, classstr(DimensionDynamicAccountControl), extendedTypeStr(LedgerDimensionBase), "@SYS115166", defaultOffsetLedgerDimension);

// Provide account type information for the SEC field
SegmentedEntryControlBuild::initDialogFieldAccountType(dialogDynamicAccount, enumStr(LedgerJournalACTypeForPaymProposal) , defaultOffsetAccountType);
// Set additional parameters on the SEC dialog field
SegmentedEntryControlBuild segmentedEntryControlBuild = dialogDynamicAccount.control(); 
segmentedEntryControlBuild.parmIsDefaultAccount(true);

…
}

// Override for modified method of the Account type checkbox to update the SEC when account type is changed
public int accountType_selectionChange(FormComboBoxControl _formComboBoxControl)
{
SegmentedEntryControl secDDAC = dialogDynamicAccount.control();
accountType = _formComboBoxControl.selection();

// This is the backing variable used to pack the account specified via the SEC
ledgerDimensionDynamicAccount = 0; 
// Clear the SEC value
secDDAC.clearReference();                     

// Specify the new account type to the SEC; this is an additional step needed for the AX SEC
secDDAC.parmAccountTypeEnumValue(enum2int(accountType));

return true;
}

// Set default account type based on value read from SysLastValue
public void dialogPostRun(DialogRunBase _dialog)
{
…
// Default any previously saved account type info
secDDAC = dialogDynamicAccount.control();
secDDAC.parmAccountTypeEnumValue(enum2int(accountType));
….
}

勘定科目:

以前:

dialogFeeLedgerDimension = dialog.addFieldValue(extendedtypestr(LedgerDimensionAccount),feeLedgerDimension,"@SYS119703", "@SYS85534");
ledgerDimensionAccountController = LedgerDimensionAccountController::constructForDialog(dialogFeeLedgerDimension);

以後:

DialogField dialogLedgerAccount = SegmentedEntryControlBuild::addToDialog(dialog, classstr(LedgerDimensionAccountControl), extendedTypeStr(LedgerDimensionAccount), "@SYS119703", feeLedgerDimension);

既定の勘定:

以前:

dialogInterCompanyLedgerDimension = dialog.addFieldValue(extendedTypeStr(LedgerDimensionDefaultAccount),interCompanyLedgerDimension, "@SYS21687", "@SYS85534");
ledgerDimensionDefaultAccountController = LedgerDimensionDefaultAccountController::constructForDialog(dialogInterCompanyLedgerDimension);

以後:

DialogField dialogDefaultAccount = SegmentedEntryControlBuild::addToDialog(dialog, classstr(LedgerDimensionDefaultAccountControl), extendedTypeStr(LedgerDimensionDefaultAccount), "@SYS21687", interCompanyLedgerDimension);

予算:
- 以前: 既存のプログラムソースコード内でダイアログシナリオの予算計画コントローラー (BudgetLedgerDimensionController) の取り込みは見つかりませんでした。
- 以後:
```
DialogField dialogBudget = SegmentedEntryControlBuild::addToDialog(dialog, classstr(BudgetLedgerDimensionControl), extendedTypeStr(LedgerDimensionBudget), 'Budget', ledgerDimensionBudget);
```
メモ :
- 新しい API を使用すると、ダイアログフィールドを設定しているときに、ラベル (前述の例では予算) を指定できます。
- コントロールのデフォルト値は、ledgerDimensionBudget 変数で指定します。
- 予算コントローラーを用いて、使用する勘定構造を指定する必要があります。 Dialog クラスは、ユーザーが勘定構造を選択し (SEC の外部で)、選択した勘定構造を SEC で設定する方法を実装する必要があります。
予算計画:
- 以前: 既存のプログラムソースコード内でダイアログシナリオの予算計画コントローラー (BudgetPlanningLedgerDimensionController) の取り込みは見つかりませんでした。
- 以後:
```
DialogField dialogBudgetPlanning = SegmentedEntryControlBuild::addToDialog(dialog, classstr(BudgetPlanningLedgerDimensionControl), extendedTypeStr(LedgerDimensionBudgetPlanning), 'Budget planning', ledgerDimensionBudgetPlanning);
```
メモ :
- 新しい API を使用すると、ダイアログフィールドを設定しているときに、ラベル (前述の例では 予算計画) を指定できます。
- コントロールのデフォルト値は、ledgerDimensionBudgetPlanning 変数で指定します。
- 予算計画 コントローラーを用いて、使用する勘定構造を指定する必要があります。 Dialog クラスは、ユーザーが勘定構造を選択し (SEC の外部で)、選択した勘定構造を SEC で設定する方法を実装する必要があります。

追加リソース

ダイアログのセグメント化されたエントリコントロールのサポート

セグメント化されたエントリコントロールのデザイン時メタデータ

セグメント化されたエントリコントロールの Parm メソッド

セグメント化されたエントリコントロールの移行

次の方法で共有

セグメント化されたエントリ コントロールの移行のガイダンス

プロパティ

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

移行ステップ

ステップ１

AX 2012

Dynamics AX

ステップ２

AX 2012

Dynamics AX

ステップ 3

AX 2012

Dynamics AX

ステップ 4

AX 2012

Dynamics AX

ステップ 5

AX 2012

Dynamics AX

ステップ 6

AX 2012

Dynamics AX

ステップ 7

AX 2012

Dynamics AX

ステップ 8

AX 2012

Dynamics AX

ステップ 9

AX 2012

Dynamics AX

ステップ 10

AX 2012

Dynamics AX

ステップ 11

AX 2012

Dynamics AX

ステップ 12

AX 2012

Dynamics AX

ステップ 13

AX 2012

Dynamics AX

ステップ 14

AX 2012

Dynamics AX

ステップ 15

AX 2012

Dynamics AX

ステップ 16

AX 2012

Dynamics AX

ステップ 17

AX 2012

Dynamics AX

ステップ 18

AX 2012

Dynamics AX

ステップ 19

AX 2012

Dynamics AX

ステップ 20

AX 2012

Dynamics AX

ステップ 21

AX 2012

Dynamics AX

ステップ 22

AX 2012

Dynamics AX

ステップ 23

AX 2012

Dynamics AX

ステップ 24

AX 2012

Dynamics AX

ステップ 25

AX 2012

Dynamics AX

セグメント化されたエントリコントロールの移行のガイダンス

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

ダイアログ上のセグメント化エントリコントロールの移行