MuleSoft HTTP Connector への移行

Salesforce B2C Commerce Cloud Data Connector と Salesforce B2C Commerce Cloud Shop Connector は廃止され、MuleSoft HTTP Connector に置き換えられました。

現在 Salesforce B2C Commerce Cloud Connector を使用している既存の Mule アプリケーションがある場合は、次の手順をブループリントとして使用して MuleSoft HTTP Connector に移行します。

Salesforce B2C Commerce Cloud Data Connector には次の 2 つの主要な要素があります。この両方を MuleSoft HTTP Connector request 操作に移行する必要があります。

• B2C Commerce Cloud Data Connector のグローバル構成
• Salesforce B2C Commerce Cloud Data Connector 操作を含むメッセージフロー

am-oauth2-configuration を HTTP コネクタの mule-oauth-module 拡張機能に移行する必要があります。

詳細については、OAuth2 クライアントログイン情報許可種別認証を設定するを参照してください。

1. HTTP Connector がプロジェクトの依存関係であることを確認します。

2. mule-oauth-module 拡張機能 をプロジェクトに追加します。

3. HTTP Request configuration (HTTP リクエスト設定) をグローバル構成要素として作成します。これはすべてのフローで使用されます。

   

4. Authentication (認証) には、Client credentials grant type (クライアントログイン情報許可種別) を選択します。

   

5. Protocol (プロトコル) プロパティと Host (ホスト) プロパティを指定します。

   

6. 既存の am-oauth2-config の次の値を使用して、新しい http:request-config プロパティ を構成します。

これで、OAuth 認証を使用したグローバル HTTP リクエスト構成が完全に構成されました。

移行前:

移行後:

すべての commerce-cloud-dataapi 操作には、organizationId、config-ref、version_ property、および操作に対応するさまざまな追加プロパティがあります。たとえば、get-product には productId があります。

次の手順を使用して、アプリケーション内のすべてのフローを移行します。

1. 既存のフローをコピーします。
2. フローのコピーで、commerce-cloud-dataapi 操作を削除します。
3. フロー内の対応する場所に http 操作を追加します。
4. Mule Palette (Mule パレット) ビューで、HTTP > Request (HTTP > リクエスト) を選択します。
5. Request (リクエスト) を Studio キャンバスとフローにドラッグします。
6. 次の例に示すように、Connector configuration (コネクタ構成) フィールドの横にあるプラス記号 (+) を選択して、以前に作成したグローバル HTTP リクエスト構成を OAuth 認証で構成します。詳細については、mule-oauth-module extension を使用したグローバル構成への移行を参照してください。

7. 既存の commerce-cloud-dataapi 操作の次の値を使用して、新しい http プロパティ を構成します。操作の API 詳細は、SCAPI リファレンスドキュメント (例: getProduct) から取得できます。

8. メソッドとパスを、該当するドキュメントからプレースホルダー付きでコピーします (例: /product/products/v1/organizations/{organizationId}/products/{productId})。

9. URI パラメーター、クエリパラメーター、ボディ、およびヘッダーを、HTTP Connector リクエスト操作 に追加します。

詳細については、次のドキュメントを参照してください。

• URI パラメーターを設定する
• 動的パラメーターおよびヘッダーを設定する
• フォームパラメーターを送信する

10. 必要に応じて、HTTP Connector の機能に従って設定を追加します。

• HTTP Request 操作の設定
• HTTP 要求属性リファレンス
• Mule 4 スレッドプールとチューニングアプリケーション

Commerce Cloud Data Connector	HTTP Connector
リスナー Get Product (Commerce Cloud Data Connector 操作)	リスナー Get Product (HTTP Connector リクエスト操作)

移行前:

移行後:

Salesforce B2C Commerce Cloud Shop Connector のすべての要素を MuleSoft HTTP Connector request 操作に移行する必要があります。

shopper-token-config オブジェクト shopper-token-connection と customer-auth-config を HTTP Connector に移行する必要があります。

1. HTTP Connector がプロジェクトの依存関係であることを確認します。

2. すべてのフローで使用するグローバル構成要素として、HTTP Request Configuration (HTTP リクエスト設定) を作成します。

3. 既存の shopper-token-connection と customer-auth-config から次の値を使用して、新しい http:request-config プロパティを構成します。

すべての commerce-cloud-shopper-api 操作には、organizationId、config-ref、siteId、version_ property、および操作に対応するさまざまな追加プロパティがあります。たとえば、get-product には productId があります。

上記の手順と同様の方法で、これらを移行します。

登録済み買い物客の場合、次のような認可と認証を含む同様のフロー操作オブジェクトが存在する可能性があります。

Commerce Cloud Shop Connector	HTTP Connector
リスナー Get Access token (ゲスト/未登録顧客用) (Commerce Cloud Shop Connector 操作) jwt-token の変数を設定 Logger (オプション) Get Product (Commerce Cloud Shop Connector 操作)	リスナー Get Access token (ゲスト/未登録顧客用) (Commerce Cloud Shop Connector 操作) jwt-token の変数を設定 Logger (オプション) Get Product (HTTP Connector リクエスト操作)

アプリケーション内のすべてのフローを HTTP Connector を利用するフローに移行します。

1. 既存のフローをコピーします。
2. フローのコピーで、commerce-cloud-dataapi 操作を削除します。
3. フロー内の対応する場所に http:request 操作を追加します。
4. Mule Palette (Mule パレット) ビューで、HTTP > Request (HTTP > リクエスト) を選択します。
5. Request (リクエスト) を Studio キャンバスとフローにドラッグします。
6. Connector configuration (コネクタ構成) フィールドの横にあるプラス記号 (+) をクリックして、以前に作成したグローバル ** HTTP リクエスト構成** を構成します。詳細については、Shop_Connector_Customer_auth_config と Shop_Connector_Shopper_token_config を含むグローバル構成を参照してください。
7. 既存のcommerce-cloud-shopapi 操作 の次の値を使用して、新しい http プロパティ を構成します。

8. SCAPI ドキュメントから、次のような操作の API 詳細を取得します。

• getAccessToken

• getProduct

9. メソッドとパスをプレースホルダー付きで、該当するドキュメントからコピーします。たとえば、次のようになります。

• /shopper/auth/v1/organizations/{organizationId}/oauth2/token
• /product/products/v1/organizations/{organizationId}/products/{productId}

10. URI パラメーター、クエリパラメーター、ボディ、およびヘッダーを、HTTP Connector リクエスト操作に追加します。

Get Access token (アクセストークンの取得) (HTTP Connector リクエスト操作) の場合

Get Product (商品の取得) (HTTP Connector リクエスト操作) の場合

追加の詳細については、次のドキュメントを参照してください。

• URI パラメーターを設定する
• 動的パラメーターおよびヘッダーを設定する
• フォームパラメーターを送信する

11. 必要に応じて、HTTP Connector の機能に従って設定を追加します。詳細については、次のドキュメントを参照してください。

• HTTP Request 操作の設定
• HTTP 要求属性リファレンス
• Mule 4 スレッドプールとチューニングアプリケーション

移行前:

移行後: