拡張機能を介したカスタム Commerce Data Exchange 同期の有効化

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

この記事では、Commerce 初期化クラスを拡張して、カスタムの Commerce Data Exchange (CDX) 同期をサポートする方法について説明します。この拡張機能では、Microsoft Dynamics 365 Finance プラットフォーム更新プログラム 8 Microsoft Dynamics 365 Retail プラットフォーム更新プログラム 8 で追加された新しい拡張ポイントを使用します。

CDX は、コマースバックオフィス (HQ) と、オンラインストアまたは従来型の店舗などのチャネルの間でデータを転送するシステムです。 HQ とチャネルデータベース間のデータ転送は、スケジューラジョブによって制御されます。各スケジューラジョブには、スケジューラサブジョブの一覧が含まれています。スケジューラサブジョブには、ソーステーブルと出力先テーブルの名前と、それらのテーブルの転送フィールドマッピングが含まれています。 HQ とチャネルデータベース間のデータ同期をコンフィグレーションするには、2 つの方法があります。

CDX のコンフィギュレーションユーザーインターフェイス (UI) を使用して、すべてのカスタムジョブとサブジョブをコンフィギュレーションします。
プッシュおよびプルの両方のカスタムジョブとサブジョブをサポートするために用意されている拡張ポイントを使用して、コマース初期化クラスを拡張します。

コマース初期化クラスを使用する利点は、さまざまな環境 (開発、テスト、および運用) でカスタムジョブを構成する必要がないことです。代わりに、Retail と Commerce > バックオフィスの設定 > コマーススケジューラ > コマーススケジューラの初期化からコマーススケジューラの初期化ダイアログボックスを使用して、CDX 初期化を実行できます。データの同期のためのカスタムジョブに関する情報は CDX で自動的に作成されます。

HQ とチャネルデータベース間のデータ転送には、さまざまなシナリオがあります。

ダウンロードジョブを使用して新しい HQ テーブルから新しいチャンネルデータベーステーブルにデータを送信します。
プッシュジョブを使用して新しい HQ テーブルに新しいチャンネルデータベーステーブルからのデータを取り込みます。

ダウンロードジョブを使用して新しい HQ テーブルから新しいチャンネルデータベーステーブルにデータを送信

データをプッシュまたはプルする前に、XML リソースファイルのさまざまなメタデータ定義を理解する必要があります。リソースファイルには、データのプッシュやプルを実行する環境で初期化されるカスタムジョブ情報が含まれています。コンフィギュレーションする必要があるリソースファイルの一覧を次に示します。

ChannelDBSchema - チャンネルデータベースで作成した拡張スキーマです。
TargetTableSchema – カスタムテーブルを追加するチャンネルデータベースで作成した拡張スキーマ。
AxTableName - テーブル名。
IsUpload – ジョブがプッシュジョブかプルジョブかを判断するフラグ。 (つまり、フラグは、HQ からチャンネルデータベースにデータを送信するか、チャンネルデータベースから HQ にデータをプルするかを示します)。既定値は false で、HQ からチャネルデータベースにデータを送信していることを示します。
ScheduledByJob – このリソースファイルには、1 つ以上のサブジョブが含まれています。
サブジョブ – 各テーブルは、サブジョブとして追加され、各サブジョブは 1 つまたは複数のスケジューラジョブによってスケジュールされています。
TargetTable – チャンネルデータベーステーブルの名前です。このテーブルは、プッシュジョブまたはプルジョブのデータの送り先となるターゲットテーブルです。値が指定されていない場合、ターゲットテーブルの名前とソーステーブルの名前が同じになります。

新しい HQ テーブルと新しいチャンネルデータベーステーブルを作成した場合は、2 つのテーブル間でデータをプッシュするためのこれらの手順に従います。

カスタムプロジェクトを作成し、アプリケーションオブジェクトツリー (AOT) を使用してカスタムテーブルを追加します。
すべてのカスタムジョブ情報を追加する新しいリソースファイルを作成します。リソースファイルのテンプレートを次に示します。

    <RetailCdxSeedData ChannelDBMajorVersion="7" ChannelDBSchema="ext" Name="AX7">
        <Jobs>
        </jobs>
        <Subjobs>
            <Subjob Id="" TargetTableSchema="" TargetTableName="">
        </Subjobs>
     </RetailCdxSeedData>

メモ

DataAreaId の列名は、フィールドマッピングには明示的に含まれません。これは、 Commerce Data Exchange (CDX) によって自動的に生成されます。追加された場合、小売用スケジューラの初期化中にエラーが発生します。

AOT を使用して新しい XML リソースを作成します。リソースの XML ファイルで、次の例に示すように新しいテーブルと新しいジョブの詳細を指定します。
メモ

新規テーブルを既存のジョブの一部として追加するか、または新しいジョブを作成してからこのテーブルを追加するかのいずれかを実行できます。この場合、ジョブ ID が 7000 で、カスタムのテーブルに ContosoRetailSeatingArrangementData と名前が付けられている場合、新しいジョブを作成しています。
```
<RetailCdxSeedData ChannelDBMajorVersion="7" ChannelDBSchema="ext" Name="AX7">
   <Jobs>
       <Job DescriptionLabelId="REX4520710" Description="Custom job" Id="7000"/>
   </Jobs>
   <Subjobs>
       <Subjob Id="ContosoRetailSeatingArrangementData" TargetTableSchema="ext" AxTableName="ContosoRetailSeatingArrangementData">
           <ScheduledByJobs>
               <ScheduledByJob>7000</ScheduledByJob>
           </ScheduledByJobs>
           <AxFields>
               <Field Name="seatNumber"/>
               <Field Name="capacity"/>
               <Field Name="channelRecId"/>
               <Field Name="RecId"/>
            </AxFields>
       </Subjob>
   </Subjobs>
</RetailCdxSeedData>
```
既定では、ターゲットテーブルの名前がここでは指定されていません。システムでは、チャネル側のターゲットテーブルの名前がコマース側のソーステーブルの名前 (AXTableName) と同じであることが前提です。ただし、チャンネル側のターゲットテーブルの名前は、時にソーステーブルの名前とは異なる場合があります。この場合、<サブジョブ> ノードで <TargetTableName> 属性を使用してチャネル側でターゲットテーブルの名前を設定できます。

同様に、マッピングセクションでは、コマース側にあるフィールドの名前だけが指定されています (AxFields)。既定では、同じフィールド名がチャネル側でも使用されていると想定します。ただし、対応するチャンネルテーブルのフィールド名は、時にコマース側にあるフィールド名とは異なる場合があります。この場合、マッピングで <フィールド> ノードの ToName 属性を使用してチャネル側でフィールドの名前を設定できます。
プロジェクトを右クリックし、追加>新しい項目を追加します。
新しい項目の追加ダイアログボックスで、リソースを選択し、リソースファイルに RetailCDXSeedDataAX7_Custom と名前を付けてから、追加を選択します。
リソースファイルの選択ダイアログボックスで、手順 2 で作成したリソースファイルを検索し、開くを選択します。
registerCDXSeedDataExtension イベントを処理するために使用する新しいクラスを追加します。 RetailCDXSeedDataBase クラスを検索し、デザイナーで開きます。 registerCDXSeedDataExtension デリゲートを右クリックし、イベントハンドラーをコピー を選択します。
作成したイベントハンドラークラスに移動して、次のイベントハンドラーコードを貼り付けます。
```
if (originalCDXSeedDataResource == resourceStr(RetailCDXSeedDataAX7))
{
    resources.addEnd(resourceStr(RetailCDXSeedDataAX7_Custom));
}
```
メモ

システムの CDX シードデータに対して 2 つの定義があるため、生成する CDX シードデータが拡張の対象のバージョンである場合にのみ、拡張 CDX データが追加されるように指定する必要があります。 if 条件が削除されている場合、拡張 CDX シードデータが N-1 CDX シードデータの上にも適用され、意図しない結果が生じる可能性があります。ベストプラクティスとして、X++ の CDX/Retail スケジューラ同期フレームワーククラスのその他のカスタマイズを回避することをお勧めします。追加の処理が実行される場合、これによりデータフローが影響を受けることがあります。提案されるパターンは、別のクラスおよびバッチジョブによりアップロードされたデータを処理させることです。

後で言及されるさまざまなシナリオの個別のリソースファイルを作成する必要はありません。 1 つのファイルにすべてのカスタムジョブ情報を含め、拡張機能クラスからそのファイルを登録することができます。

初期化クラスが実行される場合、このクラスはこのハンドラーを実装する拡張機能を検索します。拡張子が見つかった場合、ランタイムはリソースファイルに含まれるカスタム情報も初期化します。
Retail と Commerce > バックオフィスの設定 > コマーススケジューラ >コマーススケジューラの初期化に移動します。
コマーススケジューラの初期化ダイアログの OK ボタンをクリックして CDX の初期化を実行します。

プルジョブを使用して新しいチャンネルデータベーステーブルから HQ テーブルにデータをプルする

新しいチャネルテーブルから HQ にデータをプルするには、次の 2 つの方法があります。

ここに示すように、新しいリソースファイルを作成し、新しいリソースを 2 行目のイベントハンドラーに追加します。

if (originalCDXSeedDataResource == resourceStr(RetailCDXSeedDataAX7))
{
    resources.addEnd(resourceStr(RetailCDXSeedDataAX7\_Custom));
    resources.addEnd(resourceStr(RetailCDXSeedDataAX7\_Custom1));
}

新しい行を追加しなくて済むように、新しい情報を含む既存のリソースファイルを更新します。アップロードするには、次の例に示すように、リソースファイルの IsUpload 属性を true に設定し、カスタムプルジョブに関する情報を追加します。
```
<Subjob Id="ContosoRetailSeatReservationTrans" TargetTableSchema="ext" IsUpload="true"
ReplicationCounterFieldName="ReplicationCounterFromOrigin" AxTableName="ContosoRetailSeatReservationTrans">
    <ScheduledByJobs>
        <ScheduledByJob>P-1000</ScheduledByJob>
    </ScheduledByJobs>
    <AxFields>
        <Field Name="transactionId"/>
        <Field Name="storeId"/>
        <Field Name="terminalId"/>
        <Field Name="contactPhoneNo"/>
        <Field Name="numberOfCustomers"/>
        <Field Name="customerName"/>
        <Field Name="reservationDate"/>
        <Field Name="reservationTime"/>
        <Field Name="replicationCounterFromOrigin"/>
    </AxFields>
</Subjob>
```
メモ

拡張テーブルを作成している場合にデータを HQ に同期するには、テーブルの主キーおよびクラスター化されたインデックスが拡張テーブルの HQ テーブルと同じである必要があります。そうでない場合 CDX 同期は失敗します。拡張テーブルから HQ にデータをプルする必要がある場合は、拡張テーブルに REPLICATIONCOUNTERFROMORIGIN ID 列 ([REPLICATIONCOUNTERFROMORIGIN] [int] IDENTITY(1,1) NOT NULL,) が含まれている必要があります。

この新規テーブルを既存のプルジョブ (P-0001) の一部として追加するか、または新しいプルジョブを作成するかのいずれかを実行できます。

その他のシナリオ

残りのプッシュとプルシナリオでは、サンプルリソースファイルの情報のみが記載されます。それは前のセクションの説明にあるように、初期化が同じであるためです。

CDX コンフィギュレーションに含まれていないチャネルデータベースに既存の Headquarters テーブルをプッシュする

この場合、拡張機能では、コアテーブルと同じ名前を持つ新しいサブジョブを作成し、それと同じテーブルをチャネルデータベースの ext スキーマに作成して、マップする必要があります。 CDX は同じテーブルに対する複数のサブジョブをサポートしていないので、サブジョブ名はコアテーブル名と一致させておき、将来の競合を回避する必要があります。将来的には、Headquarters テーブルが、コアテーブルと同じサブジョブ名で、アウト・オブ・バンド (OOB) 製品による CDX プッシュ/プル配信に追加される可能性があります。 CDX フレームワークは、重複するサブジョブ名がある場合は、自動的にマージされます。

任意のサブジョブの一部としてマップされていない既存の列をプッシュ

次の例で示すように、マッピングされていない既存の列を、新しい拡張列またはチャンルデータベース内の既存の列のいずれかにプッシュすることができます。

<Subjob Id="RetailChannelTable" TargetTableSchema="ext">
    <AxFields>
        <Field Name="Payment"/>
        <!-- Existing column which was not pushed to channel db-->
        <Field Name="PaymMode"/>
        <!-- Existing column which was not pushed to channel db-->
        <Field Name="ContosoRetailWallPostMessage"/>
        <!-- New column from the extended table -->
    </AxFields>
</Subjob>

テーブルに RecId ではない主キーがある場合、次の例に示されるように、チャンネル側の拡張子テーブルに非 RecId 主キーも含まれる必要があります。

    <Subjob Id="RetailCustTable" TargetTableSchema="ext">
        <AxFields>
            <Field Name="ReturnTaxGroup_W"/>
            <!-- Existing column which was not pushed to channel db-->
            <Field Name="SSNNumber"/>
            <!-- New column from the extended table-->
        </AxFields>
    </Subjob>
</Subjobs>

新しい列を既存のテーブルにプルする

新しい列を追加して既存のテーブルの一部を取得する場合は、次のコードを使用します。

<Subjob Id="RetailTransactionTable" TargetTableName="CONTOSORETAILTRANSACTIONTABLE" TargetTableSchema="ext"  OverrideTarget="false">
    <AxFields>
        <Field Name="ContosoRetailSeatNumber"/>
        <Field Name="ContosoRetailServerStaffId"/>
    </AxFields>
</Subjob>

別のサブジョブへの既存のサブジョブの移動

既存のサブジョブを別のジョブに移動するには、リソースファイルの ScheduledByJob 属性を変更することができます。この属性はイベントハンドラの一部として実行されます。

<Subjob Id="DirPartyTable">
    <ScheduledByJobs>
        <ScheduledByJob>1000</ScheduledByJob>
        <!--add existing subjob to another job-->
    </ScheduledByJobs>

CDX サンプル - 新しい列を既存のテーブルにプルする

Microsoft Dynamics 365 Retail アプリケーション更新プログラム 5 では、RetailSDK\Documents\SampleExtensionsInstructions\ExtensionTables に新しいサンプルが追加され、そこにすべてのサンプル SQL スクリプト、さまざまな CDX 拡張機能シナリオの ax プロジェクトファイルがありますが、さまざまな CDX 拡張機能シナリオの参照として使用してください。

次のセクションでは、拡張テーブルを使用してトランザクションテーブルをカスタマイズする手順とベストプラクティスについて説明します。他のセクションでは、CDX をカスタマイズしてチャネル側のカスタマイズされた (拡張子) テーブルをコマースにアップロードする方法を示します。また、カスタマイズのテスト方法を説明するセクションも含めました。

設定手順

変更していない Retail ソフトウェア開発キット (SDK) にこれらの変更を実装することをお勧めします。または、SDK を Microsoft Azure DevOps などのソース管理下で配置することにより、どのステップでも変更を簡単に元に戻すことができます。まず、SDK にある *.axpp パッケージをインポートします。次に、チャンネルデータベースで、SQL 更新スクリプトを実行します。

カスタマイズコードを含むコマース側にパッケージをインポートします。
1. ExtensionTablesAndCDXCustomization.axpp ファイルをRetailSDK\Documents\SampleExtensionsInstructions\ExtensionTables フォルダーからコピーし、拡張プロジェクトフォルダーに貼り付けます。
2. Microsoft Visual Studio を起動します。
3. Dynamics 365>インポートプロジェクト を選択します。
4. プロジェクトのインポート ダイアログボックスで、手順 1 でコピーした .axpp ファイルのパスを指定します。
5. 必要に応じて、現在のソリューション または 新しいソリューション を選択します。
6. OK を選択してパッケージのインポートを開始します。
  
  インポートが完了した後、ソリューションエクスプローラーにファイルがあります。
7. ソリューションをビルドします。
8. プロジェクトを右クリックし、データベースの同期 を選択します。
SQL 更新スクリプトを実行します。
1. Retail SDK フォルダーから ContosoRetailExtensionTablesUpdate.sql ファイルをコピーします。同様の仕方で他のサンプルファイルを実行することができます。
2. Microsoft SQL Server ブラウザーでスクリプトを開いて、チャネルデータベースに対してスクリプトを実行します。
  
  このステップでは、トランザクションテーブルをカスタマイズするために必要な拡張テーブルを作成します。スクリプトはその他のサンプルシナリオに使用されるその他のテーブルも作成することに注意してください。

サンプルでデータを拡張する

コマース側のテーブル拡張は、サンプルですでに作成されています。手動で作成するには、次の手順を実行します。

Visual Studio を起動します。
メニューで、表示>アプリケーションエクスプローラーを選択します。
データモデル>テーブル>RetailTransactionTable を選択し、RetailTransactionTable を右クリックして 拡張機能を作成 を選択します。

ベストプラクティスは、デフォルトの名前を次のように変更する必要があります RetailTransactionTable.ContosoRetailExtension。常に一意の接頭語を追加します。このサンプルでは、ContosoRetail が一意の接頭語として使用されます。一意の接頭語を使用することにより、複数の独立系ソフトウェアベンダー (ISV) によってテーブルが拡張されている場合、名前の競合を防ぐことができます。
新しい RetailTransactionTable.ContosoRetailExtension テーブルで、2 つの新しいフィールドを作成します。

タイプ = 文字列、名前 =ContosoRetailServerStaffId: 拡張データ型プロパティを RetailStaffId に設定します。 タイプ = 整数、名前 =ContosoRetailSeatNumber: 拡張データ型プロパティを ContosoRetailSeatNumber に設定します。
変更を保存し、プロジェクトをビルドします。
プロジェクトを右クリックし、データベースの同期 を選択します。

メモ

ベストプラクティスとして、今後の名前の競合を回避するために新しい列名に固有の接頭語が追加されます。別の ISV が同じ名前を持つ列を作成する場合、または Microsoft が同じ名前を持つ列を使用する更新プログラムをリリースする場合、名前付けの競合が発生する可能性があります。拡張テーブルでは異なる AOT 資産に作成されますが、新しい列は SQL の元のテーブルに追加されます。

チャンネル側にあるデータベースを拡張

Retail SDK フォルダーから SQL Server ContosoRetailExtensionTablesUpdate.sql スクリプトを開いて実行します。複数の品目が作成され、コンフィギュレーションされています。

外部キーとカスタム (拡張子) フィールドを含む [ext].ContosoRetailTransactionTable テーブルが作成されます。テーブルに追加した拡張列に加えて、チャネル側の拡張テーブルにはチャネル側にある元のテーブルと同じ主キー列が必要です。したがって、[ext].RetailTransactionTable_ContosoRetailExtension には、[ax].RetailTransactionTable で使用される 4 つの主キー列があります。ベストプラクティスは、チャンネル側の拡張子テーブルに主キー列を追加するときに、列の名前を元のテーブルの主キー列の名前と同じにしておきます。
CDX は、チャネル拡張テーブルからカスタム列をアップロードしてコマースに戻すように構成されています。 RetailCDXSeedDataAX7 リソースには、コマースからチャネルデータベースへのテーブルマッピングの情報が含まれています。 CDX はこの情報を使用して、必要なデータ転送スケジューラのジョブとサブジョブを作成します。データ転送に新しい拡張テーブルまたは列を含めるには、CDX データ転送のカスタマイズを指定するリソースファイルを提供する必要があります。ベストプラクティスは、競合を防ぐため次のような名前付け規則を使用します。 RetailCDXSeedDataAX7_ContosoRetailExtension。 (ここでは、ContosoRetail は、固有の拡張機能です。)

Retail SDK のサンプル CDX リソースファイルには、追加のカスタマイズが含まれています。ただし、RetailTransactionTable 拡張子の例の場合、次のコードのセクションはチャンネル側から HQ にデータをプルするために必要な唯一のセクションです。

<RetailCdxSeedData Name="AX7" ChannelDBSchema="ext" ChannelDBMajorVersion="7">
    <Subjobs>
        <!--Adding additional columns to (existing) RetailTransactionTable and wants to pull it back to HQ.For upload subjobs, set the OverrideTarget property to  "false", as ilustrated below. This will tell CDX to use the table defined by TargetTableName and TargetTableSchema as extension table on this subjob.-->
        <Subjob Id="RetailTransactionTable" TargetTableName ="CONTOSORETAILTRANSACTIONTABLE" TargetTableSchema="ext" OverrideTarget="false">
            <!--Notice that there is no mention of the <ScheduledByJobs></ScheduledByJobs> because the subjob is already part of an upload job. -->
            <AxFields>
                <!--If you notice the existing columns are not listed here in the <Field> tag, it's because the existing fields are already mapped in the main RetailCdxSeedData resource file, we only add the delta here. -->
                <Field Name="ContosoRetailSeatNumber" />
                <Field Name="ContosoRetailServerStaffId" />
            </AxFields>
        </Subjob>
    </Subjobs>
</RetailCdxSeedData>

このリソースファイルで使用されるフィールドの説明:

ChannelDBSchema ='ext' - リソースがチャンネルデータベース内の拡張スキーマから読み取るように、このフィールドが含まれています。

サブジョブ ID ="RetailTransactionTable" – SubJob ID がそのテーブルの元のサブジョブ ID と同じであることを確認する必要があります。そうすると、拡張性フレームワークはユーザーが既存のサブジョブをカスタマイズすることを判断することができます。新しいサブジョブIDを使用すると、同じテーブルに対して重複するサブジョブエラーが発生します。

TargetTableName = "CONTOSORETAILTRANSACTIONTABLE" - チャンネル拡張子のテーブル名。

TargetTableSchema="拡張" - チャンネル拡張子スキーマ。現在のところ、拡張子スキーマ名は外部としてのみサポートします。

OverrideTarget ="false" - アップロードサブジョブ (チャンネルから本社にデータを取り込むもの) の場合、OverrideTarget が false に設定されていると、TargetTableName で定義されたテーブルが拡張テーブルであり、サブジョブで既に定義されているプライマリテーブルに沿ってデータがアップロードされることが CDX に通知されます。

OverrideTarget が "true" に設定されている場合、TargetTableName で定義されたテーブルはサブジョブのプライマリテーブルをオーバーライドします (プルジョブでは既定値フィールドが省略され、拡張フィールドのみが考慮されます)。たとえば、このサンプルでは、この値を true に設定する場合は、これは ax.RetailTransactionTable からデータをアップロードするのではなく、CDX は ext.CONTOSORETAILTRANSACTIONTABLE からのデータのみをアップロードすることを意味します。

指定されたサブジョブがシンクとして使用する AxTableName 値をフレームワークが既に判断できるので、AxTableName 属性は指定されません。 RetailCDXSeedDataAX7 リソースをカスタマイズする場合は、相違点を指定するだけで済みます。フレームワークが推定できるすべてのデータは、拡張機能により追加する必要はありません。同様に、<AXFields></AXFields? セクションでは、カスタムフィールドまたは新しいフィールドのみ指定されているのがわかります。拡張フレームワークにより、指定されたサブジョブ ID から残りのフィールドのリストが決まるためです。

CDX カスタマイズリソースを持つ CDX モジュールが更新されます。 RetailCDXSeedDataAX7_ContosoRetailExtensionで指定されているカスタマイズを適用するには、registerCDXSeedDataExtension デリゲートを購読する必要があります。このイベントをサブスクライブすることで、CDX シードデータの初期化が実行されるときにカスタマイズが適用されることを保証できます。

表示>アプリケーションエクスプローラーを選択します。
RetailCDXSeedDataBase クラスを検索します。
クラスを右クリックし、デザイナーで開く を選択します。
デザイナーのデリゲートおよびメソッドの一覧で、registerCDXSeedDataExtension デリゲートを選択します。
右クリックし、イベントハンドラーのコピー を選択します。実装する必要があるメソッドシグネチャがコピーされるため、CDX は CDX シードデータのカスタマイズされたリソースを取得します。
新しいクラスを作成し、ContosoRetailCDXSeedDataAX7EventHandler などの名前を付けます。任意の名前を指定することができます。ただし、ベストプラクティスとしては、接頭語をクラス名の前に付けてください。

手順 5 でコピーしたコードを貼り付けます。

class ContosoRetailCDXSeedDataAX7EventHandler
{
    /// <summary>
    /// Registers the extension CDX seed data resource to be used during CDX seed data generation.
    /// </summary>
    /// <param name="result">The result object which is used to return the resource name.</param>
    [SubscribesTo(classStr(RetailCDXSeedDataBase), delegateStr(RetailCDXSeedDataBase, registerCDXSeedDataExtension))]
    public static void RetailCDXSeedDataBase_registerCDXSeedDataExtension(str originalCDXSeedDataResource, List resources)
    {
    }
}

CDX 機能拡張フレームワークは、コマースの初期化を選択するとこのメソッドを呼び出します。 CDX 拡張モジュールが CDX カスタマイズを使用するようにするためには、上記のメソッドに次のコードを貼り付けます。
```
if (originalCDXSeedDataResource == resourceStr(RetailCDXSeedDataAX7))
{
    resources.addEnd(resourceStr(RetailCDXSeedDataAX7_ContosoRetailExtension));
}
```
カスタムリソースをリストに追加する前に、処理中の originalCDXSeedDataResource リソースが RetailCDXSeedDataAX7 であることを確認する必要があります。そうしないと、予期しない結果が生じる場合があります。
カスタマイズした構成で CDX モジュールを初期化または再初期化するには、次の手順を実行します。
1. Retail と Commerce>バックオフィスの設定>コマーススケジューラ>スケジューラジョブ>コマーススケジューラの初期化に移動します。
2. 表示されるダイアログボックスで、既存のコンフィギュレーションの削除を選択します。
3. OK を選択して、初期化を開始します。
  
  初期化が完了したとき、CDX スケジューラジョブ、サブジョブの定義、および配布スケジュールは、元の RetailCDXSeedDataAX7 リソースとカスタマイズされた RetailCDXSeedDataAX7_ContosoRetailExtension リソースを使用して更新されます。

カスタマイズの検証

カスタマイズが正しく動作することを確認します。
1. 初期化が完了した後、Retail と Commerce>バックオフィスの設定>コマーススケジューラに移動し、スケジューラサブジョブ リンクを選択します。
2. サブジョブテーブルで、RetailTransactionTable サブジョブ ID を検索します。
3. 詳細領域のチャネルフィールドマッピング セクションで、新しいカスタム (拡張) 列がマッピングに表示されていることを確認します。
CDX ジョブのアップロード、およびチャネル側の元のテーブルと拡張テーブルからのプルをテストします (元のテーブルと拡張可能なテーブルを組み合わせたビューが、CDX フレームワークによって生成されます)。
1. Store Commerce アプリでトランザクションをいくつか作成します。
2. 拡張テーブルは Commerce Runtime (CRT) や Store Commerce アプリでは使用しないため、手動で拡張テーブルにデータを挿入する必要があります。必要な値を変更した後、次のスクリプトを実行します。
```
INSERT INTO [ext].[CONTOSORETAILTRANSACTIONTABLE] (
[CONTOSORETAILSEATNUMBER],
[CONTOSORETAILSERVERSTAFFID],
[TRANSACTIONID],
[STORE],
[CHANNEL],
[TERMINAL],
[DATAAREAID])
VALUES (
1, /*normally this needs to be an existing seat number from ContosoRetailSeatingData table, but for this test add any number*/
'000160' /*add any staff ID here*/,
'HOUSTON-HOUSTON-11-101',/\*add the transaction id you just created */
'HOUSTON', /*add the store used to create the transaction */
5637144592, /*add the channel RecId of the store used to create the transaction*/
'HOUSTON-11', /*add the terminalId used to create the transaction*/
'USRT' /*add the dataareaId used by the store*/)
GO
```
  他のトランザクションにもこの手順を繰り返します。 Store Commerce アプリで作成したトランザクションの一部 [ext].[CONTOSORETAILTRANSACTIONTABLE] に対応するデータを追加しないでください。この方法で、拡張テーブルに対応するデータがない場合でも、[ax].RetailTransactionTable からデータを取得してアップロードすることを確認できます。
3. Dynamics 365>Retail と Commerce>Retail とコマース IT に移動し, 配送スケジュールを選択します。
4. 配送スケジュールの一覧で、P-0001 を選択します。この配布スケジュールには、カスタマイズした RetailTransactionTable のサブジョブが含まれています。
5. アクションウィンドウで、実行を選択します。確認メッセージが表示されたら、はいを選択します。
6. アクションウィンドウで、履歴を選択し履歴ページを開き、アップロードされたセッションが正常に完了したことを確認できます。
7. 履歴ページで、新しいアップロードセッションレコードがあることを確認します。レコードのステータスが申請済に設定され、さらに影響を受けた行値は0 (ゼロ) でないことを確認してください。
アップロードセッションが正常に適用されたら、Retail と Commerce>照会やレポート>店舗のトランザクションに移動し、アップロードした新しいトランザクションを検索します。トランザクション、シート番号、およびサーバースタッフ ID の各カスタム列に期待された値が入っていることを確認します。

また、チャネル側の [ext].ContosoRetailTransactionTable 拡張テーブルに対応するレコードを持たないトランザクションもアップロードされていることを確認します。これらのトランザクションにシート番号とサーバースタッフ ID の既定値が含まれていることを確認します。シート番号は 0 (ゼロ) に設定し、サーバースタッフ ID は 000160 に設定する必要があります。

Store Commerce アプリオフライントランザクション同期

Store Commerce アプリをオフラインモードに切り替えて、トランザクションを実行します。オンラインに切り替えて、データがオフラインデータベースからチャネルデータベースに、次いでバックオフィスに正しく同期されていることを確認します。

次の方法で共有

拡張機能を介したカスタム Commerce Data Exchange 同期の有効化

ダウンロードジョブを使用して新しい HQ テーブルから新しいチャンネルデータベーステーブルにデータを送信

プルジョブを使用して新しいチャンネルデータベーステーブルから HQ テーブルにデータをプルする

その他のシナリオ

CDX コンフィギュレーションに含まれていないチャネルデータベースに既存の Headquarters テーブルをプッシュする

任意のサブジョブの一部としてマップされていない既存の列をプッシュ

新しい列を既存のテーブルにプルする

別のサブジョブへの既存のサブジョブの移動

CDX サンプル - 新しい列を既存のテーブルにプルする

設定手順

サンプルでデータを拡張する

チャンネル側にあるデータベースを拡張

カスタマイズの検証

Store Commerce アプリオフライントランザクション同期

フィードバック

その他のリソース

次の方法で共有

拡張機能を介したカスタム Commerce Data Exchange 同期の有効化

ダウンロード ジョブを使用して新しい HQ テーブルから新しいチャンネル データベース テーブルにデータを送信

プル ジョブを使用して新しいチャンネル データベース テーブルから HQ テーブルにデータをプルする

その他のシナリオ

CDX コンフィギュレーションに含まれていないチャネル データベースに既存の Headquarters テーブルをプッシュする

任意のサブジョブの一部としてマップされていない既存の列をプッシュ

新しい列を既存のテーブルにプルする

別のサブジョブへの既存のサブジョブの移動

CDX サンプル - 新しい列を既存のテーブルにプルする

設定手順

サンプルでデータを拡張する

チャンネル側にあるデータベースを拡張

registerCDXSeedDataExtension デリゲートにサブスクライブ

カスタマイズの検証

Store Commerce アプリ オフライン トランザクション同期

フィードバック

その他のリソース

ダウンロードジョブを使用して新しい HQ テーブルから新しいチャンネルデータベーステーブルにデータを送信

プルジョブを使用して新しいチャンネルデータベーステーブルから HQ テーブルにデータをプルする

CDX コンフィギュレーションに含まれていないチャネルデータベースに既存の Headquarters テーブルをプッシュする

Store Commerce アプリオフライントランザクション同期