Finance and Operations, Enterprise Edition 7.3 の拡張機能の変更

この記事では、Dynamics 365 for Finance and Operations Enterprise Edition 7.3 にリリースされた拡張機能について解説します。 拡張性をサポートする変更のスケジュールの詳細については、「アプリケーション機能拡張計画」を参照してください。

ソフト シールされたアプリケーション モデル

このリリースは、すべてのモデルがハードシールになる前の最後のリリースとなり、このためのすべてのアプリケーション モデルはソフトシールされています。 ソフト シールされたモデルでもオーバーレイヤーされたコードを作成できますが、オーバーレイヤーされたコードをコンパイルするときに警告が生成されます。

次のテーブルに、今回のリリースで現在ソフト シールされているモデルの一覧が含まれています。

ハード シールされたアプリケーション モデル

このリリースでは、ほとんどすべてのアプリケーションの主要なモデルはハード シールされています。 これらのモデルのオーバーレイ コードは、現在コンパイル エラーを発生します。 カスタマイズ モデルは拡張機能によってのみサポートされます。 拡張機能によってこれらのモデルをカスタマイズできない場合は、標準のアプリケーションを変更して拡張機能を有効にするよう、Microsoft に要求する必要があります。

次の表に、今回のリリースで現在ハード シールされているモデルの一覧が含まれています。

拡張可能になった列挙型

列挙の拡張をサポートするために以下の変更が行われました。

• 標準アプリケーションの多くの列挙が拡張可能になりました。 列挙を拡張可能にするには、列挙に関する 2 つのプロパティを設定します。 IsExtensible プロパティは はい に、UseEnumValue プロパティは いいえ に設定されます。
• 一部の列挙型は状態を表します。 拡張機能によって列挙値の追加を可能にする新しいファサード メソッドが追加されました。 列挙型を拡張する方法については、 拡張機能を使用した列挙値の追加を参照してください。
• 拡張機能をサポートするために、列挙を使用する一部のアプリケーション コードが変更されました。 一般的な変更の内容は以下の通りです。
  • ポストイベント サブスクリプションを許可するための、switch の default ケースの throw 例外ステートメントの削除。
  • 拡張機能の SysExtension サポートの追加。
  • 明示的なデリゲートを追加します。

拡張可能な列挙型のサポートを改善するために、Foundation の変更が行われました。 IsExtensible が はい に設定されている列挙型については、SysPlugin フレームワークが使用可能になりました。 列挙型の新しい名前に基づく構文で、ビューが使用可能になりました。

DataEvents または欠落している insert、update、delete プリおよびポストデータ イベントを生成しないデータ操作メソッド

一般なプラクティスとして、テーブルのデータ メソッドを使用して、アプリケーションの拡張に使用できるイベントを発生させます。 コード ベースは、必ずしもこのプラクティスに従っていませんでした。 たとえば、doInsert、doUpdate、および doDelete データ メソッドと特定のテーブルの実装では、データ メソッドで super() の呼び出しは行われませんでした。

タイプ クラスの insert、update、および delete メソッドはリファクターされました。 データ メソッドで super() が確実に呼び出されるように変更が行われました。 これらの変更により、これらのメソッドへの拡張機能の追加が可能になり、その結果、プリイベントとポストイベントが拡張機能で使用できるようになりました。 次の表に、insert、update、および delete イベントが拡張機能に対して有効になったテーブルを表示します。

クラス メンバーの公開

アクセス修飾子と新しい parm メソッドの変更の結果、追加のプライベート メンバーをカスタマイズに使用できるようになりました。 コマンド プラットフォームのチェーン機能により、保護されたメソッドやメンバーへの拡張クラスのアクセスが可能になります。 コマンド チェーンの詳細については、「拡張可能な X++: コマンド チェーン」を参照してください。

throw ステートメントを使用した construct メソッド

特定の型の実装が欠落していた場合、いくつかの construct メソッドが throw ステートメントで実装されました。 これは拡張性に対してはうまく機能しません。この問題を軽減するため、例外をスローしないように、construct メソッドが変更されました。 以下のメソッドは、クラス拡張、またはポストイベント サブスクリプションによって、拡張性に対して使用できるようになりました。

throw ステートメントのメソッドを検索します

特定の型の実装が欠落していた場合、いくつかの find メソッドが throw ステートメントで実装されました。 これは拡張性に対してはうまく機能しません。この問題を軽減するため、例外をスローしないように、find メソッドが変更されました。 以下のメソッドは、クラス拡張、またはポストイベント サブスクリプションによって、拡張性に対して使用できるようになりました。

クラス拡張子を開くための抽出されたメソッド

コマンドのチェーン機能では、拡張クラスを作成できます。 拡張子クラスは、保護されたメソッドとパブリック メソッドおよびメンバーの両方にアクセスできるため、他のオプションよりも強力な拡張方法を提供します。 これにより、デリゲートやプレイベントまたはポスト イベントによって拡張するよりも柔軟性が向上します。

変更のこのグループでは、長いメソッドが小さいメソッドに抽出されます。 新しいメソッドには、より具体的なフォーカスがあり、拡張機能の範囲をより詳細に制御できます。

指揮命令系統機能が導入された後、デリゲートを追加する代わりにメソッドを抽出して拡張性を使用することをお勧めします。このアプローチにより、より柔軟なソリューションを提供する事ができるからです。

次のテーブルに、拡張クラスをビルドするために抽出されて開かれた新しいメソッドを示します。

拡張性をサポートするための他の方法を使用した変更

このセクションの変更のグループには、いくつかの異なる拡張機能のアプローチが含まれており、コマンド チェーン が導入される前の行われた拡張機能の変更を表しています。 使用されるアプローチの一部は、メソッドの抽出、"スタブ" メソッドの追加、デリゲートの追加、メソッドでのアクセス修飾子の変更、SysExtension フレームワークの使用を行います。 実行したアプローチがカスタマイズで機能するかどうかを判断するには、カスタマイズに必要な所定の場所の実装を参照してください。 今後のリリースで、主にコマンド チェーンを使用するため、このグループは小さくなります。

フック可能なメソッド

公開されずフック不可能な一部のメソッドでは、拡張性サポートが強化されています。 以下のメソッドはフック可能な動作で明示的に修飾されています。

インライン デリゲート

インライン デリゲートを使用できるようになりました。 インライン デリゲートの最も一般的な使用方法は、メソッドをより粒度の細かいメソッドに分割して、より小規模なメソッドで拡張イベントを使用できるようにすることです。

拡張可能になった SQL 操作

埋め込み SQL ステートメントを使用するアプリケーション コードは拡張機能を通じて変更できません。 次の表に示す方法で拡張性を有効にするために、標準のアプリケーションに変更が加えられました。 これは、一般に、埋め込み SQL ステートメントを、これらのメソッドで SQL ステートメントの構築方法を拡張をサポートするクエリ オブジェクトに変換すると有効になります。

拡張性に対して使用可能なマップ

拡張機能によるフィールドとメソッドの追加を可能にするマップ実装に対して、新しいパターンが導入されました。 これの実行方法の詳細は、インターフェイスとして使用されるマップが含まれるドキュメントとバージョン管理実装のためのドキュメントの両方にあります。

次のテーブルに、拡張性を有効にするために変更が適用されたマップとその関連テーブルを一覧表示します。

在庫分析コード

このリリースでは、在庫分析コードを追加するための新しいモデルが導入されました。 以前のリリースでは、在庫分析コードが含まれているすべての SQL ステートメントの拡張が必要な場合、新しい在庫分析コードのカスタマイズをサポートすることは実用的ではありませんでした。 代わりに、特定の指定された用途のない 10 個の在庫分析コードを追加しました。 パートナー ソリューションは、そのコードを保持している間接モデルを通じてコード化し、パートナー ソリューションでの使用に向けた作成済みの在庫分析コード 1 つ以上を配置する個々の実装プロジェクトのために他のモデルが作成されます。 このモデルで在庫分析コードを実装する方法および新しいモデルについて学ぶのに役立つフレーバーの分析コード アプリをリリースする方法については、ドキュメントを利用できます。 新しい在庫分析コードは、製品分析コードまたは追跡用分析コードとして自由に配置して使用できます。

この変更により、アプリケーション全体で、次のリストに示されている内容を含む複数の場所が変更されました。

拡張機能を有効にするメタデータの変更

次のテーブルに、これらのオブジェクトの特定のメタデータの拡張機能を有効にするために加えられた変更を示します。 これらの変更はインスタンスごとに異なります。変更を確認するには、特定の実装を参照してください。

その他の変更

次のテーブルに、拡張機能に対して行われた追加の変更を一覧表示します。

バグ

次のテーブルは、拡張機能のために要求されたが、バグとして認識され、標準アプリケーションで修正された変更を一覧表示したものです。