拡張機能によってモデル要素をカスタマイズする

メモ

コミュニティの関心グループが Yammer から Microsoft Viva Engage に移行されました。 Viva Engage コミュニティに参加し、最新のディスカッションに参加するには、「 Finance and Operations Viva Engage Community へのアクセスを要求する」フォームに入力し、参加するコミュニティを選択します。

このチュートリアルでは、フリート管理拡張機能モデルについて説明します。このモデルには、フリート管理アプリケーションの機能を拡張する要素が含まれています。 拡張機能 を作成することにより、モデル要素をカスタマイズすることができます。 Microsoft Dynamics AX 2012 のオーバーレイ機能とは異なり、拡張機能はベースラインモデル要素をオーバーレイしません。代わりに、拡張機能は、モデルと関連するビジネスロジックに追加またはカスタマイズする個別のアセンブリとしてコンパイルされます。テーブルにフィールドを追加したり、フォームにコントロールを追加したりするなど、メタデータを拡張できます。イベントハンドラーとプラグインクラスを定義することで、ビジネスロジックを拡張またはカスタマイズすることもできます。テーブル、フォーム、フォームデータソース、フォームコントロールなどの定義済みイベントに対してイベントハンドラーを作成できるようになりました。プラグインは、アプリケーションのビジネスロジックを交換または拡張するできるようにする新しい機能拡張の概念でもあります。

前提条件

このチュートリアルでは、リモートデスクトップを使用して環境にアクセスし、インスタンスの管理者としてプロビジョニングする必要があります。

フリート管理モデルを理解する

フリート管理アプリケーションは、車両、顧客、および車両予約を管理するためのシステムをレンタカー会社に提供します。アプリケーションは、フリート係とフリートマネージャの役割で使用されるよう設計されています。

フリート係

担当者は、顧客との対面または電話でのやり取りを処理する受付従業員です。担当者は主に、アプリケーションに顧客情報を入力する、顧客の車両予約を作成する、車両アクセサリをオファーすることで予約をアップセルする、車両レンタルの終了時に車両の返却を処理することに関心を持っています。担当者は、各自のニーズを予測し、楽しくて印象的なエクスペリエンスを提供しながら、顧客とやり取りすることにより、フリート管理ワークスペースを使用して顧客とのやり取りを準備することに大部分の時間を費やします。

車両管理者

マネージャーは、業務要件とプロセスの設定を処理するバックオフィス従業員です。マネージャーは、車両の情報を入力する、使用可能な車両アクセサを定義する、車両メンテナンス、価格を決定する、および収益、アップセルの成功などのビジネスパフォーマンス測定を分析することに主に関心を持っています。アプリケーションのビジネスロジックは、次の 3 つの主なエンティティとそれらの間の関係を中心に展開されます。

顧客

顧客は、車両の予約を行い、車両のアクセサリを選択し、車両をチェックアウトおよび返却をし、車両のレンタル料を支払うためにフリート係に連絡します。顧客関連の情報は、FMCustomer というテーブルに保管されています。

車両及び運搬具

車両は主として価格が異なり、車両のクラスに比例します。車両に関する情報を格納するテーブルの名前は、 FMVehicleで始まります。

予約とレンタル

予約は、顧客と車両間の関係を管理します。予約情報には、予約日、顧客情報、車両の選択と価格、そしてアクセサリや手数料などの追加料金が含まれます。 FMRental テーブルと FMRentalCharge テーブルには、予約とレンタル情報が格納されます。計算エンジンは、車両予約の価格決定に関連するトランザクションの情報を処理します。このデータモデルを使用することで、Fleet Management アプリケーションは基本的なレンタカー体験を提供します。

フリート管理モデルを拡張

レンタカー会社が割引を通じて顧客に価格インセンティブを提供できるようにする追加機能を使用して、基本的な Fleet Management アプリケーションをカスタマイズできます。これらの割引機能を有効にする追加のビジネスロジックとデータを Fleet Management Extension モデルに格納します。割引機能は、3 つの主要なカスタマイズを介してフリート管理アプリケーションに価値を追加します。

フリート管理拡張データモデル

割引関連の情報を格納する 2 つの新しいテーブルを追加します。 FEDiscounts には、すべての割引とその料金のリストが保存されています。 FERentalDiscountRelationTable は、割引が適用される予約を追跡します。価格スキームへの割引の追加を考慮して、既存のテーブルを拡張します。 FMRental という名前の特定の予約の車両料金を追跡するテーブルを拡張して、車両料金の割引に対応します。 FMRentalCharge という名前の予約のアクセサリを追跡するテーブルを拡張して、アクセサリに適用される割引に対応します。

フリートマネジメント拡張計算エンジン

基本計算エンジンをカスタマイズして、新しい割引によって定義されたさまざまな価格スキームを追加します。基本計算エンジンの機能をプラグインクラスに置き換えます。車両が 7 日を超える期間予約されている場合、車両フリート管理モデルでは、車両の 1 日あたりのレートと低い週単位のレートの差に基づいて節約額が計算されます。プラグインは、同じ動作を割引を使用して実現できるため、1 週間あたりの料金の計算を削除します。

フリート管理ユーザーインターフェース拡張機能

FMRental という名前のフォームに含まれるレンタルを拡張して、クラークが予約に割引を適用できるようにします。画面上の価格概要がリアルタイムで更新され、予約に関連する車両やアクセサリに適用できる割引に関連する割引情報が表示されます。次の手順では、フリート管理拡張機能モデルで行われるカスタマイズを確認し、カスタマイズの一部を自分用に再実装します。

セットアップ

前のチュートリアルでフリート管理ソリューションを開いていない場合は、次の手順に従います。フリート管理ソリューションファイルは Dynamics AX ダウンロード可能 VM で入手できます。

デスクトップで、Visual Studio ショートカットをダブルクリックして、開発環境を開きます。
FleetManagement ソリューションを開きます。 ファイル メニューで、開くをポイントし、プロジェクト/ソリューションを選択します。
デスクトップを参照し、FleetManagement フォルダーを開きます。ソリューションファイルがコンピュータにない場合、この作成手順は、フリート管理サンプルアプリケーションのエンドツーエンドシナリオ. に記載されています。
FleetManagement という名前のソリューションファイルを選択します。表示されるファイルタイプは Microsoft Visual Studio Solution です。
開くを選択します。ソリューションを開くには時間がかかる場合があります。

デモデータのインストール

デモデータを既にインストールしている場合は、次のセクションに進むことができます。

VM で Microsoft Edge を開き、アプリケーションのベース URL に移動します。
サインインします。
ダッシュボードでナビゲーションウィンドウを開き、[ フリート管理] > [セットアップ] > [フリートのセットアップ] に移動します。

$[モデル構成のカスタマイズ] の [Fleet Setup]$フリートのセットアップ$ メニューのスクリーンショット。$
[ デモデータのセットアップ] を選択します。
デモデータの再読み込みを促すメッセージが表示されたら、はいを選択します。
データの読み込みが完了したら、[ 閉じる] を選択します。
ダッシュボードでナビゲーションバーを開き、[ システム管理] > [共通] > [集計測定値の管理] に移動します。 (手順 7 から 9 は、新しいリリースには適用されません)。
FMAggregateMeasurements を選択し、アクションペインで今すぐ更新を選択します。
処理が完了するまで待機します。ページの上部にある一連の移動ドットは、進行中の処理を示します。インジケータが消えて、前回処理時刻 フィールドが更新されると、処理が完了します。

ワンボックス環境で FMRental フォームを開く

VM で Microsoft Edge を開き、Dynamics AX アプリケーションのベース URL に移動します。詳細については、トピック開発環境の配置とアクセスを参照してください。
求められた場合にログインします。
予約管理 タイルをクリックして予約管理ワークスペースを開きます。
予約管理ワークスペースが開いたら、現在のレンタルを選択します。
グリッドビューでレンタル フォームが開きます。
レンタル フォームを読み込んだら、オプション > ビューの変更 > ヘッダーを選択して、ヘッダーの表示を開きます。
ヘッダーの表示フォームを読み込んだら、下までスクロールし、割引タブを展開します。このタブはフリート管理モデルに含まれていません。これは、 FMRental フォームの拡張機能として Fleet Management Extension Model でモデル化されています。
割引を追加するために追加を選択します。
得意先割引を選択し、OK を選択します。選択した割引が割引グリッドに追加されます。
FactBox を開くには、ショートカットキー Alt+F2 を使用します。
右側のレンタル合計ファクトボックスを展開し、適用される割引を表示します。

フリート管理割引の拡張プロジェクトの概要

このチュートリアルでは、 FleetManagementDiscounts プロジェクトに Fleet Management Extension という名前のモデルに属するモデル要素が含まれています。ここでは、プロジェクト要素について調べて学習します。

ツリーデザイナーで FMRental.Extension に移動します。

Visual Studio の ソリューションエクスプローラーの FleetManagement Discounts プロジェクトで、[ ユーザーインターフェイス] > [フォーム拡張機能] を展開します。

FMRental.Extension 要素は、2 つの新しいデータソースと新しいタブコントロールを追加することによって FMRental フォームの機能を拡張する拡張要素です。
ソリューションエクスプローラーで、FMRental.Extension をダブルクリックしてデザイナーを開きます。次のイメージに示します。
- 斜体のテキストで示されているデータソースはベースラインフォームで定義されているデータソースです。
- 太字で示されているデータソースは現在の拡張子で定義されています。
デザイナーは、その拡張機能を含めて、モデル要素の統合ビューを表示します。読み取り専用ノードは斜体で表示さえｒますが、現在の拡張機能に属するノードはカスタマイズの種類を示す他の視覚的な記号と共に太字で表示されます。
デザイナーの検索ボックスに、次の図に示すように「 e: 」と入力します。このフィルターには、現在の拡張機能に属しているノードのみが表示されます。
e:LineViewDiscountsを入力してデザイナーをフィルター処理し、LineViewDiscounts という名前に一致し、現在の拡張機能に属するノードを表示することもできます。
内容を確認するには、LineViewDiscounts ノードを展開します。

FMRental.Extension XML ファイルを開いてメタデータを表示

ソリューションエクスプローラーで、FMRental.Extension フォーム拡張機能を右クリックし、[開く] を選択します。
[ ファイルを指定して開く ] ダイアログボックスで、[ XML (テキスト) エディター] を選択し、[ OK] を選択します。
メッセージが表示されたら、[ はい ] を選択してデザイナーを閉じます。
対応する負符号を選択して、 Controls ノードと DataSources ノードの子ノードを折りたたみます。正しい結果については次の図を参照してください。

XML ファイルには、FMRental.Extension 要素に関連付けられているメタデータが含まれます。このファイルに、拡張機能の一部である 1 つのみのタブページコントロールおよび 2 つのデータソースを説明するメタデータが含まれることがわかります。基本フォームからのメタデータが含まれていないことを確認することもできます。

フリート管理の割引拡張プロジェクトにおけるその他の要素を表示

FleetManagement Discounts プロジェクトには 2 つの新しいテーブル FEDiscount および FERentalDiscountRelationTable と、既存のフリート管理テーブル FMRental および FMRentalCharge への 2 つの拡張が含まれています。

ソリューションエクスプローラーの FleetManagement Discounts で、[データモデル] > [テーブル拡張機能] > FMRental.Extension をダブルクリックしてデザイナーを開きます。
フィールドノードを展開し、拡張子に追加されたフィールド FEVehicleRateDiscount がベース FMRental テーブルに含まれていることを確認します。
同様に、デザイナーで FMRentalChange.Extension 要素を開いて、その内容を調べます。

データイベントハンドラーの検査

ソリューションエクスプローラーの FleetManagement 割引プロジェクトで、コード > クラス > FMRentalCharge_Extension をダブルクリックしてコードエディターを開きます。

このクラスには、FMRentalCharge テーブルの更新および挿入イベントに登録するイベントハンドラーの実装が含まれています。 Microsoft Dynamics AX では、テーブルおよび他の種類で発生する可能性のあるデータイベントが導入されます。テーブルのデータイベントを登録することで、基本の X++ コードをオーバーレイせずに、アプリケーションがビジネスロジックを拡張できるようになります。このチュートリアルの後半では、テーブルイベントのサブスクライブがいかに簡単であるかを確認します。

メモ

このクラスは、_Extension サフィックスで示される拡張クラスです。イベントハンドラーは任意のクラスで記述でき、クラスは拡張クラスである必要はありません。拡張メソッドを作成するには、拡張クラスが必要です。詳細については、拡張メソッドの記事の「拡張メソッド」セクションを参照してください。

プラグインクラスの表示

前のセクションで示した FMRentalCharge_Extension クラスのイベントハンドラーコードでは、両方のイベントハンドラーが FMTotalsEngineBase::GetInstance を呼び出して、Fleet Management 計算エンジンの現在のインスタンスを取得します。計算エンジンは、プラグインクラスを使用して実装されます。クラスファクトリは、コンフィギュレーションまたはビジネスデータに基づくプラグインクラスの適切なインスタンスを作成します。

FMRentalCharge_Extension.xpp表示されるコードエディターウィンドウで、GetInstance を右クリックし、[定義へ移動] を選択します。コードエディターは抽象クラス FMTotalsEngineBase で開きます。この抽象クラスはプラグインポイントと呼ばれ、次の属性に関連付けられています: [Microsoft.Dynamics.AX.Platform.Extensibility.ExportInterfaceAttribute()]

プラグインクラスは、抽象クラスやインターフェイスの拡張機能または実装を表します。プラグインクラスは、メタデータとプラグインポイントを定義する属性に関連付けられます。この例では、2 つのプラグインクラスが FMTotalsEngineBase プラグインポイントに関連付けられています。基本計算エンジンは、プラグインクラス FMTotalsEngine によって定義されます。プロジェクト FleetManagement に移行された > コード > クラス で見つけることができます。

割引計算エンジンは、プラグインクラス FEDiscountEngine によって定義されます。プロジェクト FleetManagement Discounts > Code > Classes の中で見つけることができます。
GetInstance メソッドを確認します。このメソッドは、プラグインファクトリ SysPluginFactory::Instance を使用して、現在のプラグインメタデータに基づいて現在の計算エンジンのインスタンスを作成します。プラグインメタデータは、グローバル構成テーブルの FMParameters で指定されます。

また、財務アプリと運用アプリでは、構成可能なプラグインクラスもサポートされています。このクラスに関連付けられているプラグインメタデータは、開発時には認識されず、管理者が実行時に構成できます。このチュートリアルでは、その機能についてカバーしていません。

追加のフリート管理拡張機能を作成しなさい。

このセクションでは、Visual Studio ツールを使用して拡張機能を作成して操作する方法を示します。

FMVehicle テーブルを拡張する

ソリューションエクスプローラーで、FleetManagement 割引プロジェクトを選択します。
Visual Studio の アプリケーションエクスプローラーで、[ 表示>アプリケーションエクスプローラー] を選択し、FMVehicle という名前のテーブルを検索します。フィルターバーに FMVehicle type:Table と入力し、Enter を押します。
FMVehicle を右クリックしてから、拡張機能の作成を選択します。

FMVehicle.Extension という名前の FleetManagement Discounts プロジェクトで FMVehicle テーブルの拡張機能が作成されます。
ソリューションエクスプローラーで、FMVehicle.Extension を右クリックしてからプログラムから開くを選択します。ダイアログボックスで XML (テキスト) エディターを選択してから OK を選択します。注記: この拡張子ファイルは、データベースの FMVehicle テーブルのメタデータを含まない簡単なテンプレートです。拡張ファイルには、常に拡張を定義するメタデータのみが含まれており、基本モデル要素のメタデータは含まれていません。
XML エディターを閉じます。
ソリューションエクスプローラーで、FMVehicle.Extension をダブルクリックしてデザイナーを開きます。
フィールド を右クリックし、新しい整数型フィールドを追加します。フィールドの名前を NumberOfCylinders に変更します。
プロパティ ウィンドウで、新しいフィールドのラベル プロパティを NumberofCylinders に設定します。
NumberOfCylinders フィールドを AutoReport フィールドグループにドラッグアンドドロップして、ベーステーブルのフィールドグループを拡張します。
FMVehicle.Extension を保存します。
イベントノードを展開します。 イベント ノードには、テーブルが公開するすべてのイベントが一覧表示されます。この一覧には、フレームワークが定義するイベントと、アプリケーション開発者が定義するメソッドのデリゲートが含まれます。

メモ

テーブルのイベント、フォームイベント、フォームデータソースイベント、フォームコントロールイベントなど、異なるフレームワークイベントが、さまざまなタイプの要素とサブ要素のデザイナーに公開されています。
onValidatedWrite を右クリックし、イベントハンドラーメソッドをコピー を選択します。

このステップは、イベントハンドラーメソッドのシグネチャをクリップボードにコピーします。
FMVehicleEventHandlers という名前の新しいクラスを FleetManagement Discounts プロジェクトに追加します。
ソリューションエクスプローラーで、FEVehicleEventHandlers をダブルクリックしてコードエディターを開きます。

右クリックし、手順 12 にコピーしたイベントハンドラーメソッドを貼り付けます。

Class FMVehicleEventHandlers
{
    /// <summary>
    ///
    /// </summary>
    /// <param name="sender"></param>
    /// <param name="e"></param>
    [DataEventHandler(tableStr(FMVehicle), DataEventType::ValidatedWrite)]
    public static void FMVehicle_onValidatedWrite(Common sender, DataEventArgs e)
    {
    }
}

次のコードを FMVehicleonValidatedWrite イベントハンドラーに挿入します。このコードは、シリンダの数が 8 を超えることができないことを検証します。

[DataEventHandler(tableStr(FMVehicle), DataEventType::ValidatedWrite)]
public static void FMVehicle_onValidatedWrite(Common sender, DataEventArgs e)
    {
        ValidateEventArgs validateArgs = e as ValidateEventArgs;
        FMVehicle vehicle = sender as FMVehicle;
        boolean result = validateArgs.parmValidateResult();

        if (vehicle.NumberOfCylinders > 8)
        {
            result = checkFailed("Invalid number of cylinders.");
            validateArgs.parmValidateResult(result);
        }
    }

FMVehicleEventHandlers クラスを保存する

ヒント

モデルの任意のクラスにイベントハンドラーを貼り付けて定義することができます。クラス FMVehicleEventHandlers は、例としてのみ使用されます。

FMVehicle フォームを拡張する

次に、FleetManagement 割引プロジェクトの FMVehicle フォーム拡張機能を追加します。まず、 ソリューションエクスプローラーでこのプロジェクトを選択します。

アプリケーションエクスプローラーを使用して、FMVehicle という名前のフォームを見つけます。 アプリケーションエクスプローラーのフィルターバーに、「FMVehicle type:form」と入力します。
フォームを右クリックし、[ 拡張機能の作成] を選択します。
次の図に示すように、 NumberOfCylinders という名前の新しい整数コントロールを Attributes2 グループコントロールに追加します。このコントロールは、デザイン> タブ > TabPageDetails > TabHeader > DetailsDetails > Attributes2 を展開すると見つけることができます。
次のように新しいコントロールをプロパティウィンドウの NumberOfCylinders データフィールドにバインドします。
FMVehicle.Extension を保存し、プロジェクトをビルドします。

拡張機能をテスト

ソリューションエクスプローラーで、FleetManagement 割引を右クリックしてから、StartUp プロジェクトとして設定をクリックします。
同様に、 FleetManagement Discounts で、 FMVehicle.Extension フォームをスタートアップオブジェクトとして設定します。
Ctrl+F5 キーを押してデバッグなしで開始するか、デバッグ メニューを使用します。
車両フォームが開いた後、車両を選択して詳細を表示します。
詳細タブを展開し、新しいシリンダの数フィールドを確認します。
アクションウィンドウで、編集をクリックしてシリンダの数フィールドの値を 12 に変更します。
アクションウィンドウで、保存をクリックします。
検証エラーを確認します。
有効なシリンダ数を 9 より小さく入力し、次に新しい値を保存します。

フォームコントロールでのイベントハンドラーを試す

既存のコントロールにイベントハンドラーメソッドを追加できます。

FMRental フォームデザイナーで AddLine コマンドボタンコントロールを検索し、OnClicked イベントを右クリックし、次に選択イベントハンドラーのメソッドをコピーを選択します。

フリート管理拡張モデルのクラスでイベントハンドラーメソッドを貼り付け、X++ コードを追加して実装します。

/// <summary>
///
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
[FormControlEventHandler(formControlStr(FMRental, AddLine), FormControlEventType::Clicked)]
public static void AddLine_OnClicked(FormControl sender, FormControlEventArgs e)
{
}

AddLine_OnClicked イベントハンドラーを実装する場合は、 sender パラメーターを使用してボタンコントロールインスタンスにアクセスできます。

FormButtonControl button = sender as FormButtonControl;

親フォームや、変数のいずれかにアクセスする場合は、この例では、FormRun インスタンスとデータソースのいずれかにアクセスする方法が示されています。

FormRun fr;
fr = sender.formRun();
var frDs = fr.dataSource("FMRental");

フォームデータソースでのイベントハンドラーを試す

テーブル、フォームコントロール、その他の要素型と同様に、フォームデータソースフィールドとフォームデータソースフィールドはフレームワークレベルのイベントを提供します。次の例は、フォームデータソースの ValidatingWrite イベントまたはフォームデータソースの検証イベントを使用して FMRental フォームのユーザー入力を検証する方法を示しています。この機能は、Platform Update 7 以降で利用できます。

/// <summary>
/// When saving a new rental, prevent setting the start mileage on the FMRental form to a value that is equal to 1
/// </summary>
[FormDataSourceEventHandler(formDataSourceStr(FMRental, FMRental), FormDataSourceEventType::ValidatingWrite)]
public static void FMRental_OnValidatingWrite(FormDataSource sender, FormDataSourceEventArgs e)
{
    var datasource = sender as FormDataSource;
    var args = e as FormDataSourceCancelEventArgs;
    if (args != null && datasource != null)
    {
        FMRental record = datasource.cursor() as FMRental;
        if (record.recId == 0)
        {
            if(record.startmileage == 1)
            {
                boolean doCancel = !checkFailed("Start Mileage = 1 is not allowed");
                args.cancel(doCancel);
            }
        }
    }
}

/// <summary>
/// Prevent changing the start mileage field on the FMRental form to a value that is equal to 1
/// </summary>
[FormDataFieldEventHandler(formDataFieldStr(FMRental, FMRental, StartMileage), FormDataFieldEventType::Validating)]
public static void StartMileage_OnValidating(FormDataObject sender, FormDataFieldEventArgs e)
{
    var dataObject = sender as FormDataObject;
    var args = e as FormDataFieldCancelEventArgs;
    if (args != null && dataObject != null)
    {
        var datasource = dataObject.datasource() as FormDataSource;
        if (datasource != null)
        {
            FMRental record = datasource.cursor() as FMRental;
            if (record.RecId > 0)
            {
                if (record.StartMileage == 1 )
                {
                    boolean doCancel = !checkFailed("Start Mileage = 1 is not allowed");
                    args.cancel(doCancel);
                }
            }
        }
    }
}

テーブル拡張子ディスプレイを試し、メソッドを編集

拡張メソッドを使用すると、X++ コードを重ねて作成することなく、これらのテーブルに新しい表示および編集メソッドを作成することで、テーブルを拡張できます。拡張メソッドは、_Extension サフィックスを持つ名前のクラスに属している必要があります。たとえば、このクラスは、CupHoldersDisplay と呼ばれる拡張表示メソッドを使用して、FMVehicle テーブルを拡張する方法を表示します。

public static class FMVehicle_Extension
{
    public static display int CupHoldersDisplay(FMVehicle vehicle)
    {
        return 7;
    }
}

フォームまたはフォーム拡張機能では、次の図に示すように、Data Source = FMVehicle メソッドと Data メソッドを設定することで = FMVehicle_Extension::CupHoldersDisplayコントロールをこの表示メソッドにバインドできます。

フォームプロパティの拡張表示メソッドバインドのスクリーンショット。

展開用のフリート拡張パッケージを作成する

テスト、実稼働前、運用環境などの別の環境に拡張機能をデプロイするには、デプロイパッケージを作成する必要があります。

Visual Studio の Dynamics AX メニューで、配置をポイントしてから、配置パッケージの作成を選択します。
フリート管理拡張 チェックボックスをオンにします。
[ パッケージファイルの場所 ] テキストボックスに「 c:\FMLab」と入力します。
作成を選択します。フリート管理拡張パッケージを含む配置パッケージが作成されます。

追加リソース

FMLab サンプルコードをダウンロードする

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-03-27