Application update 10.0.17 での電子申告フレームワーク API の変更

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

この記事では、Microsoft Dynamics 365 Finance バージョン 10.0.17 で電子申告 (ER) フレームワークのアプリケーションプログラミングインターフェイス (API) がどのように変更されたかについて説明します。

アクションの依存先を実行するためユーザーアクションコードを提供する形式マッピングを実行する API

出荷ドキュメントを生成するには、ER 形式マッピングを実行する必用があります。 ER フレームワークの初期 API を使用して ER 形式マッピングを呼び出す場合、形式のコンポーネントに対して構成されている送信先はすべて常に実行されます。このタイプの呼び出しのサンプルコードを確認するには、レポートサービスクラスを追加するを参照してください。

// Call ER to generate the report.
ERIFormatMappingRun formatMappingRun = ERObjectsFactory::createFormatMappingRunByFormatMappingId(formatMappingId, DefaultExportedFileName);
if(formatMappingRun.parmShowPromptDialog(true))
{
    formatMappingRun.withParameter(parameters);
    formatMappingRun.withFileDestination(_contract.getFileDestination());
    formatMappingRun.run();
}

場合によっては、X++ コードの特定の場所から ER 形式マッピングが呼び出される場合、ER 形式を実行してユーザーが実行するアクションを指定して、その形式に対して構成されているすべての ER 送信先の代わりに、アクション依存先のみが実行されるようにする必要があります。

たとえば、印刷管理設定に基づくER 形式があるとします。生成されたドキュメントをプレビューするためこの ER 形式を呼び出す場合、画面送信先のみが実行されると想定されます。ただし、同じ ER 形式を呼び出して、生成されたドキュメントを電子メールの送信メッセージの添付ファイルとして送信する場合、電子メール送信先のみが実行されると想定されます。

これらの結果を得るには、ER 形式に対するアクション依存の ER 送信先を構成する必要があります。詳細については、アクション依存の ER 送信先を構成するを参照してください。

構成が完了すると、ER フレームワークの新しい API を使用して、指定されたアクション用に構成された送信先のみを実行するユーザーアクションコードを提供する ER 形式マッピングを呼び出すことができます。次の例は、前述のサンプルコードを変更してこの新しい API を使用し、表示アクションを提供する ER 形式を実行する方法を示しています。

// Call ER to generate the report.
ERIFormatMappingRun formatMappingRun = ERObjectsFactory::createFormatMappingRunByFormatMappingId(formatMappingId, DefaultExportedFileName);
if(formatMappingRun.parmShowPromptDialog(true))
{
    formatMappingRun.withParameter(parameters);
    formatMappingRun.withFileDestination(_contract.getFileDestination());

    var formatMappingRunWithAction = formatMappingRun as ERIFormatMappingRunWithDestinationAction;
    formatMappingRunWithAction.withDestinationAction(ERDestinationAction::View);
    formatMappingRun.run();
}

重要

アクション依存先を設定し、指定されたアクションコードを使用して ER フレームワークを強制するには、まず機能管理ワークスペースで、異なる PM アクションに対して使用する特定の ER 送信先を構成する機能を有効にする必要があります。