財務と運用の展開のための Commerce 支払パッケージの作成

この記事では、Microsoft Dynamics 365 Commerce の財務と運用の展開に支払コネクタをパッケージ化する方法について説明します。

10.0.10 より前のリリースでは、Commerce ソフトウェア開発キット (SDK) を使用して支払いコネクタパッケージを作成します。 (以前は Commerce SDK は Retail SDK と呼ばれていました。) 10.0.10 リリース以降では、Visual Studio のみを使用して Application Object Server (AOS) 支払コネクタパッケージを作成できます。作成したパッケージは、以前のデプロイとセルフサービスデプロイの両方に対して、オールインワンパッケージを使用してこのアプローチを使用してデプロイできます。

メモ

10.0.10 より前のリリースでは、1 つの支払いパッケージを作成し、Application Explorer とコマースチャネルとクラウドコンポーネント (コマーススケールユニット) の両方に使用できます。 10.0.10 リリースでは、2 つのパッケージを作成する必要があります。 1 つのパッケージはアプリケーションエクスプローラー用で、Dynamics 365 パッケージングモデルを使用して作成します。もう 1 つのパッケージは、コマースチャネルとクラウドコンポーネント用で、コマース SDK を使用して作成します。コマース SDK を使用してアプリケーションエクスプローラー支払パッケージを作成した以前の方法は、10.0.10 リリースの時点で廃止 (非推奨) となります。

配置できる支払パッケージを作成するには、次のセクションの手順に従います。

メモ

コマースチャネルとクラウドコンポーネント用パッケージを作成するため、コマース SDK を使用する手順は変更されていません。詳細については、「コネクタの作成と配置」を参照してください。

10.0.10 リリースでの AOS 支払パッケージの作成

Visual Studio の、Dynamics 365 メニューで、モデル管理 > モデルの作成をクリックします。
モデル名、モデル発行元、およびその他の必要な詳細を入力します。その後、次へを選択します。

モデル名は、プレフィックス RetailPaymentConnectors で始まる必要があります。この接頭語の後に、カスタムモデル名に関する情報を追加します。たとえば、作成するモデルには RetailPaymentConnectorsCustomConnector という名前が付けられます。 RetailPaymentConnectors プレフィックスで始まるモデル名のみが、コマース支払コネクタオプションに表示されます。
新しいパッケージの作成オプションを選択し、次へを選択します。
必要な参照パッケージを選択し、次へを選択します。
完了を選択して、モデルの作成を終了します。
ソリューションエクスプローラーで、プロジェクトを選択し、参照を右クリックしてから、参照の追加を選択します。
すべての支払コネクタアセンブリとその依存関係を、プロジェクトに参照として追加します。

メモ

すべての支払いコネクタ DLL は移植可能である必要があります。移植可能な支払いコネクタ DLL と移植不可能な支払いコネクタ DLL の両方を使用すると、コネクタの読み込み時に問題が発生します。
拡張機能で実装に HTML ファイルと CSS ファイルが必要な場合は、それらをリソースファイルとしてプロジェクトに追加します。デプロイ時に、HTML ファイルが AosService\WebRoot\Resources\Html フォルダーにコピーされます。 CSS ファイルは、 AosService\WebRoot\Resources\Styles フォルダーにコピーされます。アクセスには、次の URL 形式を使用します。

例: 必要に応じて、この URL を返すように GetPaymentAcceptPoint 実装を更新します。
```
https://AOSUrl/resources/html/Myhtml.html
https://AOSUrl/resources/styles/Mycss.css
```
メモ

プロジェクトにリソースとして追加された HTML ファイル形式と CSS ファイル形式のみが AosService\WebRoot\にコピーされます。その他のファイル形式は、 AosService\WebRoot\にコピーされません。 AosService\WebRoot\ フォルダーにファイルが必要な場合は、HTML ファイル形式に移行するか、サポートされていないファイル形式を外部でホストします。外部でホストされている場合、ホスティングは顧客またはパートナーが管理する必要があります。
支払コネクタに関連付けられているその他の支払 X++ 拡張機能がない場合、ソリューションをビルドします。

メモ

他の拡張機能パッケージがない場合は、次の手順に進みます。追加の拡張機能パッケージがある場合は、それらを 1 つのオールインワン展開可能パッケージに結合します。これらを組み合わせない場合、このパッケージは他のパッケージをオーバーライドします。詳細については、「オールインワン配置可能パッケージ」を参照してください。
配備可能なパッケージを作成するには、Dynamics 365 メニューで、配置 > 配置パッケージの作成を選択します。
以前に作成したモデルを選択し、パッケージファイルの場所を指定してから、作成を選択します。

Visual Studio はモデルをビルドし、配置可能なパッケージを作成します。
展開可能なパッケージが作成されたら、Microsoft Dynamics Lifecycle Services (LCS) にサインインし、LCS プロジェクトで [ アセットライブラリ ] タイルを選択します。
作成した展開可能なパッケージをアップロードします。