財務と運用へのコードの移行の準備

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

この記事では、Lifecycle Services のコードアップグレードサービスと Visual Studio ツールを使用して、コードとメタデータを Dynamics AX 2012 R3 から財務と運用に移行する方法について説明します。これらの手順のほとんどは、財務と運用の 2 つのメジャーバージョンの間でのコードの移行にも適用されます。

必要条件

リモートデスクトップを使用して財務と運用開発環境にアクセスし、このインスタンスの管理者としてプロビジョニングされる必要があります。コードをアップグレードする前に、Finance and Operations の開発、カスタマイズ、およびユーザーインターフェイスの概念の幾つかをよく理解しておくことをお勧めします。次にいくつかの参照を挙げます。

コード移行プロセスの概要

分割されたモデル

財務と運用アプリは、次のいくつかのパッケージ、またはアセンブリに分割されます:

プラットフォームパッケージ

アプリケーションプラットフォーム
アプリケーション基準
Test Essentials

アプリケーションパッケージ

Application Suite
他のアプリケーションパッケージ

ISV および Dynamics AX 2012 R3 から移行された顧客コードは、正しいパッケージに再ベースラインされます。

LCS コードのアップグレードサービスを使用して自動移行

LCS コードのアップグレードサービスは、Dynamics AX 2012 R3 モデルストアを入力として受け取り、次の作業を完了します。

メタデータを最新の形式に変換します。
適切なモデルに移動およびマージすることで、メタデータのベースラインを再度設定します。
ソリューションのアップグレードに必要な作業を理解する見積を提供します。
ソリューションの一部を自動移行する移行ルールを実行します。
TODO を使って手動で修正する内容を開発者に知らせる移行ルールを実行します。
アップグレードされたソリューションを Azure DevOps プロジェクトに自動的にチェックインします。

コードアップグレードサービスを設定および実行する方法については、[Lifecycle Services (LCS) でコードアップグレードサービスを構成および実行する] を参照してください。

手動での移行の手順

LCS コードアップグレードサービス構成のコードをアップグレードした後、開発者の VM と Azure DevOps にアップグレードされたコードブランチに接続します。

コードのアップグレードサービスは、コードをコンパイルするために開くことができる Visual Studio ソリューションを提供します。競合を含むすべての要素向けのコードマージソリューションと、すべてのアップグレードされた要素向けのアップグレードソリューション。通常、以下の順序でコンパイルエラーを修正して、アプリケーションをコンパイルできます。順序はパッケージの依存関係のグラフに基づいて決定され、グラフの中で最も低いパッケージから開始されます。パッケージの依存関係を調べるには、モデルおよびパッケージを参照してください。標準的な注文は、Application Platform、Application Foundation、Directory など、Application Suite です。各アップグレードされたモデル対象:

マージの競合を修正します。
モデルの分割 (パッケージ全体の参照) に関連するコンパイルエラーを修正します。
- 一般的なエラーメッセージは次のとおりです。
  - <要素タイプ> X は、存在しない<要素タイプ> Y を参照します。
  - 名前 <Name> はクラス、テーブル、または拡張データ型を示すものではありません。
- たとえば、オーバーレイされたカスタマイズは、パッケージの依存関係グラフの上位にある要素またはコードを参照している場合があります。
  - ディレクトリモデル内のメソッドは、アプリケーションスイートパッケージ内のテーブルを参照しています。
  - ディレクトリパッケージ内のフォームは、アプリケーションスイートパッケージ内のデータソースを参照しています。
- モデル要素またはビジネスロジックを上位のパッケージに移動することによって、これらの依存関係に対応するようにコードをリファクターする必要があります。
- コードの移行中にデリゲートを使用してモデル間の依存関係を解決するは、これらの問題を解決する方法について説明します。
コンパイルエラーを修正します。

すべてのコンパイルエラーを解決した後は、すべてのパッケージがコンパイルされます。次に、次のタスクを完了する必要があります。

ガイド付きコードアップグレード TODO とコードアップグレード固有のベストプラクティス警告に対処します。いくつかの例と詳細を以下のセクションに示します。
たとえば、ActiveX や代替の検索など、非推奨のコントロールを置き換えます。
すべてのフォームにフォームパターンとサブパターンを適用します。
すべてのシナリオが、カスタムパターンに対して異なるサイズで、複数のブラウザーで動作することを検証します。
記述してテストを実行します。

ベストプラクティスの設定

ベストプラクティスフレームワークには、移行を完了するために解決する必要があるベストプラクティス警告のサブセットがあります。これは、Dynamics AX 2012 R3 またはそれ以前から移行する場合に適用されます。

Visual Studio で、Dynamics 365 > オプション > ベストプラクティスをクリックします。
モデル ドロップダウンメニューで、アプリケーションスイートを選択します (作業しているすべてのモデルで繰り返します)

これらのルールは、ソリューションの移行中に「オン」に設定する必要があります。この設定は、AxRuleSet フォルダー内の XML ファイルによって実行されます。たとえば、C:\Packages\ApplicationSuite\Foundation\AxRuleSet の下にある、アプリケーションスイート xml ファイル、BPRules.xml を参照してください。

移行を完了するには、すべての移行固有のベストプラクティスルールを修正する必要があります。エラーは警告としてエラーリストに表示されます。エラー一覧には、コンパイラの警告やベストプラクティスのエラーが表示されます。ベストプラクティスのエラーには接頭語として BP のテキストが付けられます。たとえば、BPErrorFormControlPatternUnspecified。

デバッグ

既定では、財務と運用は作業中のファイルのデバッグ環境を最適化します。結果として、プロジェクトに含まれていないファイル (F11) にステップインすると、 PDB が読み込まれず、コードをデバッグできなくなります。この問題を回避するには、Dynamics 365**>**オプション>デバッグ をクリックしてプロジェクトのデバッグ設定を変更します。 ソリューション内の項目に対してのみシンボルを読み込む チェックボックスが選択されていないことを確認します。このオプションは、デバッガの速度を大幅に向上させるため、既定で選択されています。 Intellitrace をオフにしたい場合、別のデバッグ設定をします。 Intellitrace はアプリケーションの完全な実行履歴を収集します。デバッグ時に IDE で多くのノイズが作成されます。 Intellitrace をオフにするには、オプション>IntelliTrace>IntelliTrace を有効にするをクリックしてチェックボックスをオフにし、OK をクリックします。 Intellitrace は Visual Studio の Enterprise 版でのみ使用できることに注意してください。

アドレスコード移行タスク

メタデータを財務と運用アプリに移行するとき、複数の自動アップグレードスクリプトが実行されます。開発者が手動で移行タスクを完了する必要がある場合、行う内容とベストプラクティス (BP) が追加されました。

TO DO には /* TODO: (Code Upgrade) の接頭語が付いており、コード移行の一部として修正する必要があります。
BP 移行固有のルールはコード移行の一環として修正される必要があります。

以下のこの例では、PurchCommitment_PSN フォームを使用して、ナビゲーションを修正する移行タスクについて説明します。具体的には、重複するボタンおよびアクションウィンドウ TODO などの例が表示されます。

セットアップ

Visual Studio で、Application Explorer を開き、PurchCommitment_PSN というフォームを検索します。
OK をクリックします。
プロジェクトを右クリックし、プロパティ を選択します。
モデルプロパティでアプリケーションスイートを選択します。
会社プロパティで、FRSI を選択します。
注記: このフォームは、フランスのデモデータ会社 FRSI に配置されます。
Ctrl+F5 キーを押してフォームを表示します。

フォームは完成しているように見えますが、移行を完了するために必要なコード移行タスクがあります。

Visual Studio で、プロジェクトをビルドし、ツールバーで、表示>タスク一覧をクリックします。
コメント ドロップダウンリストをクリックして、TO DO: (コードアップグレード) タスクを表示します。
一覧で、ActionPane TODO を検索します。

コードアップグレードルール - アクションウィンドウ

財務と運用アプリでは、次の主要なアクションはシステム定義ボタンとして提供されます:

新規
消去
編集
輸出

自動移行の一環として、アクションペインルールは冗長ボタンを識別するために実行されます。この移行の部分を完了するには、手動で行う必要があります。

コードを削除するか移動します。
アプリケーションコード内の冗長なコントロールを削除します。

メモ

以下のセクションでは、システム定義ボタンを複製するモデル化されたボタンのコードを移行および変更する方法の例を示します。ただし、実際には、この記事で行われたのと同様の変更を加える前に、シナリオに関してコードをまず評価して、それがまだ必要かどうかを決定する必要があります。最初に、システム定義の削除ボタンと重複する、DeleteCmdButton に対する TODO を修正します。

Visual Studio では、次に示す TODO を検索して、TODO をダブルクリックします。
以下に示すように、TODO とコード行を置き換えます。
- システム定義の削除ボタンの状態は、firstmaster データソースの AllowDelete プロパティによって制御されます。 AllowDelete を false に設定することにより、キーボードショートカットが使用されている場合に削除タスクは実行されません。
```
// Delete button
/* TODO: (Code Upgrade) [Action Pane Rule] Please consider moving all references to the form task override method and remove the control: DeleteCmdButton */
deleteCmdButton.enabled(purchCommitmentHeader && purchCommitmentHeader.canDelete());
PurchCommitmentHeader_DS.allowDelete(purchCommitmentHeader && purchCommitmentHeader.canDelete());
```
エディターで、DeleteCmdButton を探してフォームデザインから削除します。
Ctrl+S キーを押してフォームを保存します。
- 次に、システム編集ボタンと重複する EditCmdButton に焦点を当てて、このボタンに関連付けられた 2 つの "仕事" の処理とこのボタンの削除を行います。
Visual Studio では、次に示す TODO を検索して、TODO をダブルクリックします。

編集ボタンの表示はフォームの表示/編集モードで制御されるため、このコードを変更してプロパティを設定する必要があります。次の図に示すように、TODO とコード行を置き換えます。

/* TODO: (Code Upgrade) [Action Pane Rule] Please consider moving all references to the form task override method and remove the control: EditCmdButton */
editCmdButton.enabled(purchCommitmentHeader && isInDraftOrUnderRevisionStatus && !isInWorkFlowReviewState && !isLineReferenced);

if(purchCommitmentHeader && isInDraftOrUnderRevisionStatus && !isInWorkFlowReviewState && !isLineReferenced)
{
    element.design().ViewEditMode(ViewEditMode::Auto);
}
else
{
    element.design().ViewEditMode(ViewEditMode::View);

}

このボタンのその他の TODO をダブルクリックします。

モデル化された編集ボタンでコードを検査します。このロジックは、フォームの task() メソッドに移動する必要があります。

[Control("CommandButton")]
class EditCmdButton
{
    /* TODO: (Code Upgrade) [Action Pane Rule] Please consider moving this button code to the task override method and remove the control EditCmdButton. */
    void clicked()
    {
        if (purchCommitmentHeader.WorkflowApprovalState ==     
            PurchCommitmentWorkflowApprovalState_PSN::Approved)
        {
            if (Box::yesNo(strFmt("@SPS2140", purchCommitmentHeader.CommitmentNumber), 
                DialogButton::No) == DialogButton::Yes)
            {
                super();

                PurchCommitmentHeader_PSN::setWorkflowState(purchCommitmentHeader.RecId, 
                    PurchCommitmentWorkflowApprovalState_PSN::NotSubmitted);
            }
        }
        else
        {
            super();
        }
    }
}

Visual Studio デザイナーの左側で、メソッド>上書きを右クリックし、タスクを選択して、フォームのタスク・メソッドの上書きを追加します。

システム定義の編集ボタンをクリックしたときに上記のコードがトリガーされるように、以下に示すようにタスクメソッドを更新します。

/// 
    ///
    /// 
    /// 
    /// 
    public int task(int _taskId)
    {
        #Task
        int ret;

        switch (_taskId)
        {
            case #taskEditRecord:

                if (purchCommitmentHeader.WorkflowApprovalState == PurchCommitmentWorkflowApprovalState_PSN::Approved)
                {
                    if (Box::yesNo(strFmt("@SPS2140", purchCommitmentHeader.CommitmentNumber), DialogButton::No) == DialogButton::Yes)
                    {
                        ret = super(_taskId);

                        PurchCommitmentHeader_PSN::setWorkflowState(purchCommitmentHeader.RecId, PurchCommitmentWorkflowApprovalState_PSN::NotSubmitted);
                    }
                }
                else
                {
                    ret = super(_taskId);
                }

                break;

            default:
                ret = super(_taskId);
                break;
        }

        return ret;
    }

エディターで、EditCmdButton を探してフォームデザインから削除します。
Ctrl+S キーを押してフォームを保存します。
Ctrl+F5 キーを押してフォームを表示します。確約タブの削除および編集ボタンが削除されたことを確認します。

キャスト例外を解決

財務と運用アプリでは、X++ は完全に中間言語 (IL) ベースであるため、解釈された Dynamics AX 2012 よりも厳密なランタイムタイプ動作を行います。この厳しいランタイムタイプの動作により、移行された Dynamics AX 2012 R3 メタデータの例外を生成できます。移行中にこれらの例外が発生することがあります。キャスト例外は、ダウンキャスト、タイムオブジェクトを設計するためのキャストランタイム、サイドキャストなど、さまざまな実行時シナリオで発生させることができます。以下のセクションで、フォーム CosJournalName が実行時にコントロールを生成し、強い型付けのために .NET 例外を発生させる型の不一致がある例について説明します。

例: サイドキャストの例外

Visual Studio で、プロジェクトプロパティを選択して右クリックし、USMF が既定の会社であることを確認します。
表示メニュー項目に CosJournalName を追加し、スタートアップオブジェクトとしてメニュー項目を設定します。
プロジェクトに CosJournalName フォームを追加します。
プロジェクトに cosDimCheckBoxController クラスを追加します。
プロジェクトのリビルドします。
Ctrl+F5 キーを押してフォームを実行します。
フォームを実行するときに、次のような例外が発生することに注意してください。
cosDimCheckBoxController クラスを右クリックし、コードの表示 を選択します。
cosDimCheckBoxController::getBuildControl() にブレークポイントを設定します。
F5 キーを押します。
- ブレークポイントをヒットします。これがキャスティングエラーが発生する場所です。キャストエラーの理由は、型のコントロールを返そうとしているためです。FormBuildCheckboxControl とオブジェクトは FormBuildStringControl を想定しています。
buildcontrol をポイントしてタイプを表示し、相違点に注目します。
F10 キーを押して例外をヒットします。
デバッグを停止します。
例外を修正するには、メソッド宣言を FormBuildStringControl から FormBuildCheckBoxControl に変更します。
```
protected FormBuildStringControl getBuildControl()
protected FormBuildCheckBoxControl getBuildControl()
```
プロジェクトをリビルドして、Ctrl+F5 を押します。キャストエラーが解決されたため、フォームが正常に開きます。

コンテキストメニューとマウスダブルクリックコードの移行

コンテキストメニューとマウスのダブルクリックアクションを処理する Dynamics AX 2012 コードを移行するには、このトピックを参照してください。

次の方法で共有

財務と運用へのコードの移行の準備

必要条件

コード移行プロセスの概要

分割されたモデル

LCS コードのアップグレードサービスを使用して自動移行

手動での移行の手順

ベストプラクティスの設定

デバッグ

アドレスコード移行タスク

セットアップ

ナビゲーション移行タスク

コードアップグレードルール - アクションウィンドウ

キャスト例外を解決

例: サイドキャストの例外

コンテキストメニューとマウスダブルクリックコードの移行

フィードバック

その他のリソース

次の方法で共有

財務と運用へのコードの移行の準備

必要条件

コード移行プロセスの概要

分割されたモデル

LCS コードのアップグレード サービスを使用して自動移行

手動での移行の手順

ベスト プラクティスの設定

デバッグ

アドレス コード移行タスク

セットアップ

ナビゲーション移行タスク

コード アップグレード ルール - アクション ウィンドウ

キャスト例外を解決

例: サイドキャストの例外

コンテキスト メニューとマウス ダブルクリック コードの移行

フィードバック

その他のリソース

LCS コードのアップグレードサービスを使用して自動移行

ベストプラクティスの設定

アドレスコード移行タスク

コードアップグレードルール - アクションウィンドウ

コンテキストメニューとマウスダブルクリックコードの移行