ユーザー インターフェイスのカスタマイズ

プロセス自動化フレームワークは、一部のユーザー インターフェース (UI) のカスタマイズをサポートしています。 フレーム ワークがすべての既定値を提供しているので、この記事の大部分は省略可能です。 唯一の例外は、ProcessScheduleSeries フォームです。 特定の製品区分に対して ProcessScheduleSeries フォームを表示する場合、、フレーム ワークがその製品区分に固有のデータを表示できるように、カスタマイズする必要があります。

週ごとのカレンダー表示

ProcessScheduleIBuildOccurrenceCard のインターフェース

ProcessScheduleIBuildOccurrenceCard のインターフェースを使用すると、週ごとのカレンダー表示のオカレンス カードの概観をカスタマイズできます。 インターフェイスには、スケジュール、待機、実行、成功、失敗、および無効の各ステータスに対応する静的メソッドがあります。 ステータス値ごとにカスタマイズされたオカレンス カードを作成できます。 これらの各メソッドは、ProcessScheduleOccurrenceCard のインスタンスを返します。

プロセス自動化フレームワークでは、ProcessScheduleOccurrenceCardBuilder クラスの既定の実装が提供されます。 このクラスから継承して、必要に応じて機能を上書きします。 次に、特定のタイプの SysPlugin を介して派生クラスを登録します。 登録プロセスは、フレームワーク ドキュメントに含まれる多くのプラグインのプロセスに似ています。

ProcessScheduleOccurrenceCardBuilderContract のインスタンスが各メソッドに渡され、そのオカレンスに関する情報を取得するために使用できます。 派生クラスでは、ProcessScheduleOccurrenceCard インスタンスを返す各静的メソッドの既定の実装を呼び出し、必要な変更を加えて、それを返すことができます。

ProcessScheduleOccurrenceCard クラス

ProcessScheduleOccurrenceCard クラスを使用すると、カレンダー表示に表示されるオカレンス カードの外観をカスタマイズできます。 最初の 2 行はプロセス自動化フレームワークによって制御されており、変更することはできません。 次の図では、サブヘッダーは完了したフェーズで、ステータス メッセージは完了という言葉の背景が青色であることを示しています。

ProcessScheduleIShowOccurrenceCalendarView インターフェイス

ProcessScheduleIShowOccurrenceCalendarView インターフェースは、週単位のカレンダー表示を表示するフォームで実装する必要があります。 ProcessScheduleSeries フォームは、このインターフェイスを実装するフォームの一例です。

ProcessScheduleOccurrenceCalendarViewContract クラス

ProcessScheduleOccurrenceCalendarViewContract クラスを使用して、週ごとのカレンダー表示に表示するシリーズを制限します。 例については、アプリケーション オブジェクト ツリー (AOT) の ProcessScheduleSeries.getProcessScheduleOccurrenceCalendarViewcontract を参照してください。

ProcessScheduleOccurrenceCalendarViewRenderer クラス

ProcessScheduleOccurrenceCalendarViewRenderer クラスを使用して、週ごとのカレンダー表示を既存のフォームに表示します。 フォーム パーツが作成され、正しく初期化されます。 このクラスの例は、ProcessScheduleSeries フォームで使用されます。

インターフェースのレンダリング

さまざまなインターフェイスを使用して、カレンダー表示で発生プロセスを表示する方法をカスタマイズできます。 プロセスが保持できる状態ごとに、次のようなインターフェイスが用意されています。

• ProcessScheduleIRenderDisabledOccurrenceCard
• ProcessScheduleIRenderFailedOccurrenceCard
• ProcessScheduleIRenderRunningOccurrenceCard
• ProcessScheduleIRenderScheduledOccurrenceCard
• ProcessScheduleIRenderSuccessfulOccurrenceCard
• ProcessScheduleIRenderWaitingOccurrenceCard

これらのインターフェイスはすべて同じパターンに従います。 ProcessScheduleOccurrenceCardRendering のインスタンスがそれらに送信されます。 このインスタンスは、オカレンス カードの表示方法を制御するために使用されます。

例については、AOTの CustVendPaymProposalAutomationOccurrenceCardRenderer クラスを参照してください。

ProcessScheduleOccurrenceCardRendering クラス

リスト ページのシリーズ

ProcessScheduleISeriesFormController インターフェイス

シリーズ リスト ページでは、ProcessScheduleISeriesFormController コントローラーを使用して、ProcessScheduleSeries リスト ページに表示するタイプのシリーズを決定します。 このクラスは SysPlugin クラスを使用します。 ProcessScheduleSeries フォームを開くために使用するメニュー項目は、指定されたプラグインを呼び出すためのキーとして使用されます。 このキーを使用すると、このフォームを使用して、表示するタイプをカスタマイズできます。

// Implementation of the ProcessScheduleISeriesFormController for the admin view of the process schedule Series form.
// This implementation will show series for all process types, both scheduled and polled, on the Series form.
[Export(identifierStr(Dynamics.AX.Application.ProcessScheduleISeriesFormController))]
[ExportMetadata(classStr(ProcessScheduleISeriesFormController), menuItemDisplayStr(ProcessScheduleSeriesAdmin))]
internal class ProcessScheduleSeriesFormAdminController implements ProcessScheduleISeriesFormController
{
    [Hookable(false)]
    public ProcessScheduleSeriesFormContract getSeriesFormContract()
    {
        return ProcessScheduleSeriesFormContract::newForAllScheduleTypes();
    }
}

ProcessScheduleSeriesFormContract クラス

ProcessScheduleSeriesFormContract クラスは、シリーズ リスト ページで ProcessScheduleType の表示を決定するために使用される契約です。 このクラスは、ワークスペースで、そのワークスペースに関連付けられている特定のタイプについてのみシリーズを表示するために使用できます。

結果とメッセージ

ProcessExecutionIResultsController インターフェイス

ProcessExecutionIResultsController インターフェイスを使用すると、プロセスに従って結果ダイアログ ボックスをカスタマイズできます。 これにより、結果グリッドでヘッダー フィールドの列ヘッダー ラベルを設定して、ヘッダー列の値をハイパーリンクにすることができます。 このインターフェイスは、プラグインであるクラスによって実装する必要があります。 サンプル プラグインを次に示します。

using System.ComponentModel.Composition;

[Export(identifierStr(Dynamics.AX.Application.ProcessExecutionIResultsController))]
[ExportMetadata(classStr(ProcessExecutionIResultsController), 'TestScheduledType')]
public final class ProcessExecutionSampleUptakeExecutionResultsController implements ProcessExecutionIResultsController
{
    [Hookable(false)]
    public ProcessExecutionResultsDialogContract getResultsDialogContract()
    {
        ProcessExecutionResultsDialogContract contract = ProcessExecutionResultsDialogContract::construct();
        contract.parmSourceLinkHeaderLabel('Sample Header');
        contract.parmShouldSourceLinkHeaderBeLinkToSourceLinkDetails(true);
        return contract;
    }

    [Hookable(false)]
    public void openSourceLinkDetails(RefTableId _refTableId, RefRecId
    _refRecId)
    {
        if (_refTableId == tableNum(SystemParameters))
        {
            Args args = new Args();
            MenuFunction systemParametersMenuFunction = new MenuFunction(menuItemDisplayStr(SystemParameters), MenuItemType::Display);
            systemParametersMenuFunction.run(args);
        }
    }
}

ProcessExecutionResultsDialogContract クラス

ProcessExecutionResultsDialogContract クラスを使用すると、ヘッダー列ラベルをカスタマイズして、ヘッダー列のデータをハイパーリンクとして表示するかどうかを指定できます。

ProcessExecutionMessageLogDialog クラス

ProcessExecutionMessageLogDialog インターフェイスを使用すると、メッセージ ログを移行元ドメインの内容のコンテキストで開くことができます。 たとえば、転記済仕入先請求書ページからメッセージ ログを開いて、プロセス自動化フレームワークに対して有効になっているプロセスによって仕入先請求書が転記されている間にログに記録されたメッセージを表示することができます。 この例では、転記済仕入先請求書ページで ProcessExecutionMessageLogDialog インターフェースを実装する必要があります。 このインターフェイスを使用することにより、独自のプライベート結果/メッセージング サブシステムを作成する必要はありません。

ProcessExecutionMessageLogContract クラス

ProcessExecutionMessageLogContract 契約を使用すると、メッセージ ログを移行元ドメインの特定の項目に制限できます。 ProcessExecutionSourceLink テーブルには、RefRecIdおよびRefTableId 値が契約によって送られる値と一致しているレコードが必要です。