メモ
Dynamics 365 Commerce の小売関連グループは、Yammer から Viva Engage に移行しました。 新しいViva Engage コミュニティにアクセスできない場合は、追加するフォーム (https://aka.ms/JoinD365commerceVivaEngageCommunity) に入力し、最新のディスカッションに参加してください。
この記事では、IT プロフェッショナルまたは付加価値再販業者 (VAR) が支払コネクタを適切なコンポーネントに展開するプロセスについて説明します。 支払いプロバイダーまたは支払い独立系ソフトウェア ベンダー (ISV) が支払いコネクタを実装してテストし、顧客環境での検証とその後の運用展開の準備ができていることを前提としています。
この記事には、Retail ソフトウェア開発キット (SDK) を使用して支払コネクタをパッケージ化する方法に関する情報は含まれていません。 SDK のダウンロード方法に関する詳細は、 Retail ソフトウエア開発キット (SDK) アーキテクチャ を参照してください。 支払コネクタをパッケージ化する方法のガイドラインについては、ダウンロードした SDK の Retail SDK パッケージ ドキュメントを参照してください。
この記事では、支払いプロバイダーまたは支払い ISV がこれらのアプリケーションを管理するため、支払い Web アプリケーション、支払いフロントエンド プロセッサ、または支払いバックエンド プロセッサを展開する方法に関する情報も含まれません。 Microsoft Dynamics AX 7.0 (2016 年 2 月) を使用している場合は、Commerce 展開可能パッケージを作成する前に KB 3183058を適用する必要があります。
支払いパッケージフォルダ
支払プロバイダーまたは支払 ISV は、支払コネクタを作成します。 支払いコネクタには、次のフォルダーの一部またはすべてが含まれています。
メモ
これらのフォルダーは \RetailSDK\PaymentExternals で検索することができます。
- IPaymentProcessor Assemblies – このフォルダーには、IPaymentProcessor インターフェイスを実装するアセンブリとその依存アセンブリが含まれています。
- Payment Web Files – このフォルダーには、支払い受け入れページを有効にするために必要なコールバック HTML、JavaScript、または CSS ファイルが含まれています。 支払いコネクタの開発者は、支払い受け入れページで必要な場合に、これらの Web ファイルを提供します。
- IPaymentDevice Assemblies – このフォルダーには、IPaymentDevice インターフェイスを実装するアセンブリと支払要求ハンドラー、およびインターフェイス依存アセンブリが含まれています。 ハードウェア ステーションと Store Commerce アプリは、これらのアセンブリを使用して、VeriFone MX925 などの支払いターミナル デバイスと通信します。 支払のターミナル デバイスがない場合は、これらのファイルは必要ありません。
支払コネクタ ファイルをパッケージ化するには、\RetailSDK\ PaymentExternals のフォルダへ支払アセンブリをコピーする必要があります。 支払いアセンブリをコピーした後、Retail SDK フォルダーのルートから msbuild を使用して、配置可能なパッケージを生成します。 msbuild 操作が完了すると、\RetailSDK\Packages\RetailDeployablePackage に配置可能なパッケージが表示されます。
配置可能小売パッケージ – このパッケージには、支払およびその他のすべてのチャネル拡張コンポーネントが含まれています。 この組み合わせパッケージは、すべての拡張機能コンポーネント用です。 RetailDeployablePackage には、次のコンポーネントの支払コネクタが含まれています。
- 商業スケールユニット (CSU)
- セルフサービス インストーラー。これにより、次のコンポーネントをインストールできます。
- ハードウェア ステーション
- Store Commerce アプリ
- Commerce Scale Unit (自己ホスト)
メモ
10.0.10 より前のリリースでは、RetailDeployablePackage をアプリケーション オブジェクト サーバー (AOS) と CSU の両方に展開できます。 以降のリリースでは、RetailDeployablePackage を CSU にのみデプロイできます。 支払コネクタを AOS アプリケーション バージョン 10.0.10 以降に配置するには、セルフサービス配置のアプリケーション エクスプローラー用支払パッケージの作成 の情報に従ってください。
展開可能なパッケージのアップロードと展開
LCS プロジェクト ページを開きます。
[ その他のツール ] セクションで、[ アセット ライブラリ] を選択します。
[ ソフトウェア パッケージ] を選択し、プラス記号 () を選択します。
名前と説明を入力し、次の表に示すように、適切なパッケージ タイプを選択します。
配置可能パッケージ LCS の配置可能パッケージ タイプ RetailDeployablePackage.zip 結合されたコマース パッケージ [アップロード] を選択します。
zip 形式のパッケージを選択してアップロードし、[ 確認] を選択します。
展開可能なパッケージを Microsoft Dynamics Lifecycle Services (LCS) アセット ライブラリにアップロードした後、LCS ポータルを使用して環境に展開できます。 サンドボックス環境でのデプロイを検証したら、運用環境にデプロイするサービス要求を作成できます。 詳細については、配置可能パッケージの適用 を参照してください。
クライアント コンピューターでインストーラーをダウンロードして実行
セルフサービス パッケージには、ハードウェア ステーションと Store Commerce アプリの両方のインストーラーが含まれています。 展開可能なパッケージを環境に適用したら、更新されたハードウェア ステーションと Store Commerce アプリインストーラーをダウンロードできます。
手動での配置
このセクションでは、支払コネクタを手動で展開する方法について説明します。 手動デプロイを使用して、開発環境でローカルでテストします。 この開発環境は、クラウドホスト型でも、ダウンロード可能な仮想ハード ディスク (VHD) 上でも構いません。 これらの手順は、サンドボックス環境または運用環境には適用されません。
支払コネクタ アセンブリとファイルを正しい場所に配置
支払コネクタはプラグ可能です。 開発環境では、サーバーの適切な場所に適切なファイルを配置できます。 次の表は、どのファイルがどの場所に移動するかを示しています。
| コネクタ | IPaymentProcessor Assemblies フォルダーのコンテンツ | 支払い Web ファイル フォルダーのコンテンツ | IPaymentDevice Assemblies フォルダーのコンテンツ |
|---|---|---|---|
| コマース スケール ユニット | RS。WebRoot/bin/ | 該当なし | 該当なし |
| Web 向け Store Commerce | 該当なし | CPOS.WebRoot/Connectors/ | 該当なし |
| リモート ハードウェア ステーション (インターネット インフォメーション サービス [IIS]) | HWS。WebRoot/bin/ | 該当なし | HWS。WebRoot/bin/ |
| ストア コマース アプリ ローカル ハード ステーション (情報保護と制御 [IPC]) | MPOS。AppRoot/ClientBroker/ | 該当なし | MPOS。AppRoot/ClientBroker/ |
| E コマース | 該当なし | ECOM。WebRoot/Connectors/ | 該当なし |
上記のテーブルへのキーを次に示します。
- RS.WebRoot は Commerce Scale Unit の Web アプリケーション ルートです。
- HWS.WebRoot はリモート ハードウェア ステーションの Web アプリケーション ルートです。
- < MPOS。AppRoot> は、Modern POS (C:\Program Files\Microsoft Dynamics 365\Store Commerce など) のアプリ インストール フォルダーです。
- ECOM.WebRoot は電子商取引 Web サイト の Web アプリケーション ルートです。
支払 Web ファイル フォルダーには通常、サブフォルダーが含まれます。 サブフォルダー全体をターゲットの場所にコピーしてください。
電子商取引サイトで支払コネクタを使用
LCS で管理される環境に e コマース サイトを展開しません。 パートナーと協力して、eコマース サイトをホストする方法を決定します。 支払コネクタに支払 Web ファイルが必要とされる場合は、電子商取引にこれらの Web ファイルを配置する必要があります。 支払いコネクタで支払い Web ファイルが必要ない場合は、これ以上の手順は必要ありません。 支払 Web ファイルを電子商取引サイトに配置する方法については、この記事の前半にある支払コネクタ アセンブリとファイルを正しい場所に配置するを参照してください。
追加リソース
支払コネクタと支払デバイスの実装ガイド
配置可能パッケージの作成