コードを変更して、ユーザーが名前付き送信先を構成して使用可能にする

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

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

ER 形式のアクション依存の ER 送信先を構成することもできます。次に、ER フレームワークの拡張 API を使用して、ユーザーアクションコードを提供する ER 形式のマッピングを呼び出すこともできます。アクションコードは、設定されているアクション用に構成された送信先に対して実行されます。

場合によっては、印刷管理を構成し、異なる印刷管理レコードに対して同じ ER 形式を選択して、その形式を実行するときに生成されたドキュメントに異なる ER 送信先を適用できるようにする必要があります。たとえば、元のドキュメントを電子メールで送信したり、ドキュメントのコピーをネットワークプリンターで印刷するために、同じ ER 形式を実行できるように印刷管理を構成できます。この目的で、 API のERフレームワーク Microsoft Dynamics 365 Finance バージョン10.0.21) を使用できます。

ユーザーが印刷管理レコード固有の ER 送信先を構成できるようにする API

現在、ビジネスドキュメントの種類ごとに印刷管理設定ページを開いて、ビジネスドキュメントの生成方法と配信方法を指定できます。印刷管理ツリーの使用可能なすべてのレコードに対して、次のアクションを実行できます。

レポート形式フィールドを使用して、実行する SQL Server Reporting Services (SSRS) レポートまたは ER 形式のいずれかを選択します。
送信先ボタンを使用して送信先設定ダイアログボックスを開き、生成されたレポートの送信先を変更できるようにします。
定義された送信先を示す送信先フィールドを確認します。

重要

レポート形式フィールドで ER 形式が選択されている場合、構成された SSRS 送信先は生成されたレポートに適用されません。

この動作を変更し、印刷管理レコードに固有の ER 送信先を構成できます。一般的な ER 送信先とは異なり、これらの送信先には名前が付けられます。複数の印刷管理レコードに対して、1 つの名前付き送信先を選択できます。詳細については、印刷管理レコード固有の ER 送信先の構成を参照してください。

まず、機能管理ワークスペースで、印刷管理品目ごとの ER 送信先設定を許可する機能を有効にする必要があります。

次に、この機能が既定で有効になっていない場合は、ユーザーが特定タイプのビジネスドキュメントの印刷管理レコード固有の ER 送信先を構成できるようにする必要があります。 Finance バージョン 10.0.21 では、提供されているすべての PrintMgmtDocumentType ドキュメントタイプに対して ERNamedDestinationReportEnabler クラスの isNamedDestinationEnabledByDocumentType メソッドが false を返すため、すべてのビジネスドキュメントに対して機能が有効になっているわけではありません。

/// <summary>Class for enabling NamedDestinationFeature for current document type.</summary>
/// <remarks>To enable the document type you should wrap a <c>isNamedDestinationEnabledByDocumentType</c> method.</remarks>
public class ERNamedDestinationReportEnabler
{
    /// <summary>Checks that feature enabled for current document type. Make extension for this method.</summary>
    /// <param name = "_typeId">Print mgmt document type</param>
    /// <returns>True if feature enabled.</returns>
    [Wrappable(true), SuppressBPWarning('BPParameterNotUsed', 'Required by signature')]
    public static boolean isNamedDestinationEnabledByDocumentType(PrintMgmtDocumentType _typeId)
    {
        return false;
    }
}

ユーザーがそのタイプのドキュメントの印刷管理レコード固有の ER 送信先を構成できるようにするには、特定のドキュメントタイプの isNamedDestinationEnabledByDocumentType メソッドをラップする必要があります。次の例は、自由書式の請求書機能を有効にする方法を示しています。

[ExtensionOf(classStr(ERNamedDestinationReportEnabler))]
final class ERNamedDestinationReportEnablerContoso_Extension
{
    public static boolean isNamedDestinationEnabledByDocumentType(PrintMgmtDocumentType _typeId)
    {
        var ret = next isNamedDestinationEnabledByDocumentType(_typeid);
        if(_typeId == PrintMgmtDocumentType::SalesFreeTextInvoice)
        {
            return true;
        }
        else
        {
            return ret;
        }
    }
}

提供される送信先が印刷管理レコード固有である形式マッピングを実行するための API

ユーザーが印刷管理レコード固有の送信先を構成できるようにする場合、名前付きの送信先が印刷管理レコード用に構成されていることが期待されます。印刷管理レコードを使用して ER 形式を実行し、送信ドキュメントを生成する場合は、その名前付き送信先を ER フレームワークに渡して、実行中の ER 形式用に構成されている可能性のある他の送信先ではなく、ER が強制的にその送信先のみを実行するようにする必要があります。

ERPrintMgmtReportFormatSubscriber クラスの次のコードは、自由書式の請求書を生成するために ER フレームワークが現在どのように呼び出されているかを示しています。

/// <summary>
/// Runs a format mapping based on incoming arguments.
/// </summary>
/// <param name = "_args">Event arguments object.</param>
public static void runFreeTextInvoiceReport(NonSSRSPrintMgmtAdapterReportExecutedEventArgs _args)
{
    ERIFormatMappingRun formatMappingRun = ERPrintMgmtReportFormatSubscriber::buildFreeTextInvoiceReportMappingRun(_args);

    if (_args.parmArgs() && _args.parmArgs().parmEnumType() == enumNum(PrintCopyOriginal))
    {
        Args args = _args.parmArgs();
        boolean doUsePrintManagement = true;

        if (args.caller() is SalesFormLetter)
        {
            SalesFormLetter caller = args.caller();
            doUsePrintManagement = caller.usePrintManagement();
        }

        ERDestinationAction action;
        if (doUsePrintManagement || !isFlightEnabled(LocalizationFlights::ForcePrintJobSettings))
        {
            action = ReportDestinationContract::getPrintDestinationAction(args.parmEnum());
        }
        else
        {
            action = ERDestinationAction::View;
        }

        ERIFormatMappingRunWithDestinationAction mappingRunWithAction = formatMappingRun as ERIFormatMappingRunWithDestinationAction;

        if (mappingRunWithAction && action != ERDestinationAction::NoAction)
        {
            mappingRunWithAction.withDestinationAction(action);
        }
    }

    formatMappingRun.withCreatingObjectParameter(
        CustomersInvoicingModelName,
        classStr(PrintMgmtPrintSettingDetail),
        _args.parmSettingDetail());
    formatMappingRun.run();
}

次の例では、サンプルコードを変更して新しい API を使用して ER 形式を実行し、印刷管理レコード固有の名前付き ER の送信先を指定する方法を示します。

/// <summary>
/// Runs a format mapping based on incoming arguments.
/// </summary>
/// <param name = "_args">Event arguments object.</param>
public static void runFreeTextInvoiceReport(NonSSRSPrintMgmtAdapterReportExecutedEventArgs _args)
{
    ERIFormatMappingRun formatMappingRun = ERPrintMgmtReportFormatSubscriber::buildFreeTextInvoiceReportMappingRun(_args);

    if (_args.parmArgs() && _args.parmArgs().parmEnumType() == enumNum(PrintCopyOriginal))
    {
        Args args = _args.parmArgs();
        boolean doUsePrintManagement = true;

        if (args.caller() is SalesFormLetter)
        {
            SalesFormLetter caller = args.caller();
            doUsePrintManagement = caller.usePrintManagement();
        }

        ERDestinationAction action;
        if (doUsePrintManagement || !isFlightEnabled(LocalizationFlights::ForcePrintJobSettings))
        {
            action = ReportDestinationContract::getPrintDestinationAction(args.parmEnum());
        }
        else
        {
            action = ERDestinationAction::View;
        }

        ERIFormatMappingRunWithDestinationAction mappingRunWithAction = formatMappingRun as ERIFormatMappingRunWithDestinationAction;

        if (mappingRunWithAction && action != ERDestinationAction::NoAction)
        {
            mappingRunWithAction.withDestinationAction(action);
        }

        // Check whether a named destination is provided.
        // If so, pass it to ER to specify a single destination for a generated document

        RefRecId NamedDestination;
        if (doUsePrintManagement || !isFlightEnabled(LocalizationFlights::ForcePrintJobSettings))
        {
            NamedDestination = ReportDestinationContract::getNamedDestination(args.parmEnum());
        }
        else
        {
            NamedDestination = 0;
        }

        ERIFormatMappingRunWithNamedDestination RunWithNamedDestination = formatMappingRun as ERIFormatMappingRunWithNamedDestination;

        if (RunWithNamedDestination && NamedDestination)
        {
            RunWithNamedDestination.withDestinationNamed(NamedDestination);
        }
    }

    formatMappingRun.withCreatingObjectParameter(
        CustomersInvoicingModelName,
        classStr(PrintMgmtPrintSettingDetail),
         _args.parmSettingDetail());
    formatMappingRun.run();
}

名前付き送信先への参照は、PrintMgmtSettings テーブルの NamedDestination フィールドで提供されます。この参照を、ReportDestinationContract を拡張する処理済みの印刷管理レコードから、runFreeTextInvoiceReport メソッドに渡す必要があります。

適用性

名前付きの送信先を設定し、提供された名前付き送信先を ER フレームワークに使用させるには、最初に機能管理ワークスペースで、印刷管理品目ごとの ER 送信先設定を許可する機能を有効にする必要があります。

ER フレームワークを使用して Finance で生成できるすべてのタイプのビジネスドキュメントの名前付き ER の送信先が有効になります。詳細については、2021 リリースウェーブ 2 用 Dynamics 365 と業界クラウドリリースプランで、「Dynamics 365 Finance」アプリケーション用「グローバリゼーション」にてコンフィギュレーション可能なビジネスドキュメント – レポートの印刷管理設定を介した特定の送信先機能を参照してください。

追加リソース

電子申告10.0.21用のフレームワークAPI変更の更新

次の方法で共有

コードを変更して、ユーザーが名前付き送信先を構成して使用可能にする

ユーザーが印刷管理レコード固有の ER 送信先を構成できるようにする API

提供される送信先が印刷管理レコード固有である形式マッピングを実行するための API

適用性

追加リソース

フィードバック

その他のリソース