支払コネクタの配置

重要

このトピックは、Dynamics 365 for Retail および Dynamics 365 for Finance and Operations に適用されます。

概要

このトピックでガイドretail ITプロフェッショナルまたは支払コネクタを適切なコンポーネントに展開するプロセスを通じて付加価値再販業者 (Var)。このトピックでは、小売 IT プロフェッショナルまたは付加価値再販業者 (VARs) が支払コネクタを適切なコンポーネントに展開するプロセスについて説明します。 支払コネクタが支払プロバイダーまたは支払独立系ソフトウェア ベンダー (ISV) によって実装されてテスト済みであり、また顧客環境での検証とそれに続く実稼働配置の準備ができていると仮定します。

このトピックには、Retail ソフトウェア開発キット (SDK) を使用して支払コネクタをパッケージ化する方法に関する情報は含まれていません。 SDK をダウンロードする方法については、Retail SDK 概要を参照してください。 支払コネクタをパッケージ化する方法のガイドラインについては、ダウンロードした SDK の Retail SDK パッケージ ドキュメントを参照してください。

このトピックには、支払 Web アプリケーション、支払フロントエンド プロセッサ、または支払バックエンド プロセッサの配置方法に関する情報も含まれています。それは、これらのアプリケーションが支払プロバイダーまたは支払 ISV によって管理されているためです。 Microsoft Dynamics AX 7.0 (2016 年 2 月) を使用している場合は、配置可能小売パッケージを作成する前に KB 3183058 を適用する必要があります。

支払パッケージ フォルダ

支払プロバイダーまたは支払 ISV は、支払コネクタを作成します。 支払コネクターには、次のフォルダーの一部または全部が含まれます。

注意

これらのフォルダーは \RetailSDK\PaymentExternals で検索することができます。

  • IPaymentProcessor Assemblies – このフォルダーには、IPaymentProcessor インターフェイスを実装するアセンブリとその依存アセンブリが含まれています。
  • 支払 Web ファイル – このフォルダには、支払受け入れページを有効にするために必要なコールバック HTML、JavaScript、または CSS ファイルが含まれています。 支払い受付ページで求められる場合、支払コネクタ開発者がこれらの Web ファイルを提供します。
  • IPaymentDevice Assemblies – このフォルダーには、IPaymentDevice インターフェイスを実装するアセンブリと支払要求ハンドラー、およびインターフェイス依存アセンブリが含まれています。 これらのアセンブリは、VeriFone MX925 などの決済端末デバイスと通信するために、Retail ハードウェア ステーションおよび Retail Modern 販売時点管理 (Modern POS) で使用されます。 支払のターミナル デバイスがない場合は、これらのファイルは必要ありません。

支払コネクタ ファイルをパッケージ化するには、支払プロバイダーまたは支払 ISV は \RetailSDK\PaymentExternals の正しいフォルダーへ支払アセンブリをコピーする必要があります。 支払アセンブリがコピーされた後、Retail SDK フォルダーのルートから msbuild を使用し、配置可能なパッケージを生成します。 MsBuild 工程が完了後、\RetailSDK\パッケージ\RetailDeployablePackage で以下の配置可能パッケージを検索できます。 AX 7.0 より前のバージョンでは、配置可能パッケージは \RetailSDK\Packages\ になります。

  • Application Object Server (AOS) 支払パッケージAOS 支払パッケージは廃止され、サポートされなくなりました。AOS 支払パッケージを Microsoft Dynamics Lifecycle Service (LCS) にアップロードする場合、サポートされていないパッケージのエラーが表示されます。代わりに新しい Retail 配置可能パッケージを使用してください。 AX 7.0 を使用している場合は、パッケージを生成する前に最新のバイナリ修正プログラムを適用します。

    注意

    新しいバージョンでは、AOS 支払パッケージは生成されません。

  • 配置可能小売パッケージ – このパッケージには、支払とその他のすべてのチャネル コンポーネントが含まれています。 このパッケージは、すべての小売拡張子コンポーネントの結合されたパッケージです。

開始する前に、次の品目が必要です。

  • 支払コネクタ ファイル
  • Retail SDK を使用して作成された小売展開可能パッケージ (このトピックの前のリストを参照)
  • LCS のクラウド ホスト環境にアクセス

小売配置可能パッケージ (自動展開)

Retail デプロイ可能なパッケージは、LCS デプロイメント サービスで利用可能なアセットです。 支払コネクタおよびその他の拡張機能を配置可能なパッケージとして作成するときは、支払コネクタを既存のソリューションにカスタマイズとしていずれかをインストール、または新しい配置の一部としてスリップ ストリームすることができます。 次のタイプのパッケージには、支払コネクタが含まれています。

  • AOSPaymentPackage - このタイプのパッケージは、AOS に 1 つ以上の支払コネクタを配置します。 (AOS 支払パッケージは廃止され、サポートされなくなりました。)

  • RetailDeployablePackage – このタイプのパッケージは、以下のコンポーネントに 1 つまたは複数の支払いコネクタを配置します。

    • Retail サーバー、Commerce Runtime、およびデータベース スクリプト

    • クラウド POS

    • 次のインストールを可能にするセルフ サービス インストーラー:

      • ハードウェア ステーション
      • Modern POS

展開可能なパッケージのアップロードと展開

  1. LCS プロジェクト ページを開きます。

  2. 追加ツール セクションで、アセット ライブラリをクリックします。

  3. ソフトウェア パッケージ を選択し、プラス記号をクリックします (+)。

  4. 名前と説明を入力し、次の表に示すように、適切なパッケージ タイプを選択します。

    配置可能パッケージ LCS の配置可能パッケージ タイプ
    AOSPaymentPackage (サポートされていない) バイナリ修正プログラム
    RetailDeployablePackage 結合された小売パッケージ
  5. アップロード をクリックします。

  6. 圧縮済みのパッケージを選択してアップロードし、確定 をクリックします。

配置可能パッケージを LCS 資産ライブラリにアップロードした後、LCS ポータルを通じて環境に配置することができます。 サンドボックス環境内の配置を検証した後は、実稼働環境を配置するサービス要求を作成できます。 詳細については、配置可能パッケージの適用 を参照してください。

クライアント コンピューターでインストーラーをダウンロードして実行

セルフサービス パッケージには、ハードウェア ステーションと Modern POS の両方のインストーラーが含まれています。 配置可能パッケージが環境に適用された後、更新されたハードウェア ステーションと Modern POS インストーラーをダウンロードすることができます。 ハードウェア ステーションおよび Modern POS をダウンロードし、クライアント コンピューターにインストールする方法については、Retail Modern POS のコンフィギュレーションとインストールを参照してください。

手動での配置

このセクションでは、支払コネクタを手動で展開する方法について説明します。 手動による展開を使用して、開発環境でローカルにテストすることができます。 この開発環境は、クラウドホスト型でも、ダウンロード可能な仮想ハード ディスク (VHD) 上でも構いません。

支払コネクタ アセンブリとファイルを正しい場所に配置

支払コネクタはプラグ可能です。 開発環境では、サーバーの適切な場所に適切なファイルを配置できます。 次のテーブルは、どのファイルをどの場所に置くべきかを示しています。

IPaymentProcessor Assemblies フォルダーのコンテンツ 支払い Web ファイル フォルダーのコンテンツ IPaymentDevice Assemblies フォルダーのコンテンツ
Application Object Server (AOS) <Aos.PackageDirectory>/bin/Connectors/ <Aos.WebRoot>/bin/ <Aos.WebRoot>/Connectors/ 該当なし
Retail サーバー <RS.WebRoot>/bin/ 該当なし 該当なし
クラウド POS 該当なし <CPOS.WebRoot>/Connectors/ 該当なし
リモート ハードウェア ステーション (インターネット インフォメーション サービス [IIS]) <HWS.WebRoot>/bin/ 該当なし <HWS.WebRoot>/bin/
Modern POS のローカルのハード ステーション (情報の保護とコントロール [IPC]) <MPOS.AppRoot>/ClientBroker/ 該当なし <MPOS.AppRoot>/ClientBroker/
E コマース 該当なし <ECOM.WebRoot>/Connectors/ 該当なし

上記のテーブルへのキーを次に示します。

  • <Aos.PackageDirectory> は AOS のパッケージ ディレクトリです。 パスは AOS の web.config ファイルから見つけることができます (key = Aos.PackageDirectory)。
  • <Aos.WebRoot> は AOS の Web アプリケーション ルートです。
  • <RS.WebRoot> は Retail サーバーの Web アプリケーション ルートです。
  • <HWS.WebRoot> はリモート ハードウェア ステーションの Web アプリケーション ルートです。
  • <MPOS.AppRoot> は Modern POS (例えば、C:\Program Files (x86)\Microsoft Dynamics AX70\Retail Modern POS など) のアプリ インストール フォルダーです。
  • <ECOM.WebRoot> は電子商取引 Web サイト の Web アプリケーション ルートです。

支払 Web ファイル フォルダーには通常、サブフォルダーが含まれます。 サブフォルダー全体をターゲットの場所にコピーしてください。

電子商取引サイトで支払コネクタを使用

E コマース サイトは、LCS の管理された環境では配置されていません。 パートナーと連携して、電子商取引サイトをホストする方法を決定する必要があります。 支払コネクタに支払 Web ファイルが必要とされる場合は、電子商取引にこれらの Web ファイルを配置する必要があります。 支払コネクタが、支払 Web ファイルを必要としない場合、追加の手順は必要ありません。 支払 Web ファイルを電子商取引サイトに配置する方法については、このトピックの前半にある支払コネクタ アセンブリとファイルを正しい場所に配置するを参照してください。

その他のリソース

支払コネクタと支払デバイスの実装ガイド

Retail SDK 小売パッケージ