ウォークスルー

Content HubからSitecore Commerceコネクタへの設定

Create an Azure Service Bus action

Content HubでAzureサービスバスへの接続性を確立するための接続パラメータを定義するアクションを作成します。

アクションを作成するには:

1. Content Hubの 管理 タブの Search ボックスで「 Actions 」と入力し、 アクションタイルをクリックします 。
2. アクションページで「新しいアクション」をクリックします。
3. 新しいアクションダイアログボックスで、以下のパラメータを定義してください:

   • Name - アクション名を提供する。

   • Label - ラベルを定義する。

   • Type - ドロップダウンリストで「 Azure Service Bus」をクリックします。

   • Connection string - サービスバス接続文字列を入力します。例えば 、Endpoint=sb://msb-xc-ch-integration。

     !注 接続文字列を取得する手順については、このMicrosoft Azureサービスバスドキュメントを参照してください。

   • Destination Type- ドロップダウンリストでトピックをクリックします。

   • Destination - サービスバストピックの名前を入力します。

4. 「保存」をクリックします。
5. Azureサービスバスへの接続が成功しているか確認するために 、接続のテスト をクリックしてください。

トリガーを作成する

トリガーは、トリガーが反応する条件やユーザーの行動を定義します。この場合、ユーザーが既存の製品プロパティを更新した際にエンティティの変更イベントに反応するようにトリガーを設定します。

トリガーを作成するには:

1. Content Hubの**「管理**」タブでトリガータイルをクリックします。

2. トリガーページで「新しいトリガー」をクリックしてください。

3. 一般タブで、以下のトリガー設定を定義します:

   • 名前 - トリガーの名前を指定してください。
   • 説明 - トリガーの簡単な説明を提供してください。
   • 目的 - トリガーが反応するイベント(条件が満たされた場合)を指定します。ドロップダウンリストで「 エンティティ作成 」チェックボックスと「 エンティティ修正 」チェックボックスを選択します。
   • 実行タイプ - ドロップダウンリストで「 **背景で」**をクリックします。これはアクションが非同期的に行われることを示します。

4. 条件タブのマッチドロップダウンで、論理演算子Anyをクリックして(定義された3つのエンティティ定義と条件のいずれかでマッチングします)。

5. 「 定義を追加 」をクリックし、検索欄で 「product」と入力し、「 Product (M.PCM.)」を選択します。「Product)」

   !注203年2月3 Sitecore Content Hubでは、Product (M.PCM.Product) 法人はSitecore XCの商SellableItem事業体にマッピングされています。

   以下を繰り返して、以下のエンティティタイプの定義を追加してください:

   • アセット(M.Asset)

     !注アセットエンティティの定義は、製品に関連する画像アセットのAlternateTextプロパティの変更を同期させるために必要です。

   • パブリックリンク(M.PublicLink)

6. 製品(M.PCM.製品)エンティティに対して、対応する条件を追加してください。 Product (M.PCM.Product)定義領域で、以下の各条件に対して条件 を追加 をクリックします。

   • 名称(ProductName)が変更されました

   • Long Description(ProductLongDescription)が変更されました

   • マスターアセット(PCMProductToMasterAsset)が変更されました

   !注オプションリストからOR論理演算子を使わなければなりません。

   製品(M.PCM.製品)エンティティの条件設定は、以下のようになります。

   

7. Asset (M.Asset) エンティティタイプの条件を追加してください。 Asset (M.Asset) 定義領域でADD CONDITIONをクリックし、次の条件を追加します: AlternateText has changed。

8. 条件サブグループを追加してください。「 AlternateText has changed」の行末で、+ の記号をクリックして、以下の条件をそれぞれ追加してサブグループを形成します。

   • Product (PCMProdcutToAsset)に追加されたアイテムは空ではありません

   • Product (PCMProdcutToAsset) 削除されたアイテムは空ではありません

   • 製品(PCMProductToAsset)が変更されました

   !注オプションリストのOR論理演算子を必ず使う必要があります。

   構成は以下のようになります。

   

9. パブリックリンク(M.PublicLink)エンティティタイプに対してマッチする条件を追加してください。 パブリックリンク(M.PublicLink) 定義領域で、次の条件を追加するために条件 を追加 してください: 相対的なURL(RelativeUrl)が変更されました 。

10. 行末尾の 「Relativeurl(RelativeUrl)」が変更された場合は、+ 記号をクリックして以下の条件を追加してサブグループを形成します。

    • 追加されたアセットリンク(AssetToPublicLink)が空ではありません

    • アセットリンク(AssetToPublicLink)削除された項目は空ではありません

    • アセットリンク(AssetToPublicLink)が変更されました

    !注オプションリストからOR論理演算子を使わなければなりません。

    構成は以下のようになります。

    

Azure Service Busへの接続設定

Plugin.Sample.ContentHub.AzureServiceBusPolicyポリシーには、Azureサービスバスとの接続を確立するために必要な構成プロパティが含まれています。

Azure Service Busへの接続性を設定するには:

• Plugin.Sample.ContentHub.AzureServiceBusPolicyセクションで*「PlaceholderFor...」*で始まる値を、あなたのデプロイメントに関連する値に置き換えてください:

  { "$type": "Plugin.Sample.ContentHub.AzureServiceBusPolicy, Plugin.Sample.ContentHub", "ConnectionString": "PlaceholderForASBPrimaryConnectionString", "TopicName": "PlaceholderForASBTopicName", "SubscriptionName": "PlaceholderForASBSubscriptionName" },

同期ポリシーの設定

同期ポリシー("Sitecore.Commerce.Plugin.ContentHub.SynchronizationPolicy")は、同期の元となるContent Hubエンティティを定義します。構成では、これはProductEntityType値で表されます。コマースエンジンでは、このプロパティはSellableItemエンティティタイプに対応します。

Content HubとSitecore XC間のデータの同期は、Content HubのエンティティキーとSitecore XCの一意なSellable item IDキーとの1対1の関係に依存しています。これは以下のコードサンプルで表現されています "EntityForeighKey"。

"DefaultCulture"属性は製品プロパティのローカライズをサポートします。"DefaultCulture"の値は、Commerce Engineのデフォルト言語にマッピングされたContent Hubの文化に対応します。

!重要不整合な挙動を避けるために、非ローカライズ可能なContent HubプロパティをCommerce Engine内のローカライズされた販売可能なアイテムプロパティにマッピングしないでください。

同期ポリシーの設定を変更するには:

• SynchronizationPolicyセクションでは、以下のサンプルで示されているデフォルトのプロパティ値を、Content Hub実装の実際の値に置き換えてください:

{ "$type": "Sitecore.Commerce.Plugin.ContentHub.SynchronizationPolicy, Sitecore.Commerce.Plugin.ContentHub", "DefaultCulture": "en-US", "EntityForeignKey": "ProductNumber", "ProductEntityType": "M.PCM.Product", "AssetEntityType": "M.Asset", "PublicLinkEntityType":"M.PublicLink" },

Commerce Engine上でContent Hubクライアントサービスを設定する

Sitecore Content HubとCommerce Engine間の接続を確立するには、Commerce Engine上でContent Hubのクライアントサービスを設定する必要があります。

Content Hubクライアントの設定:

• ContentHubClientPolicyセクションで、"PlaceholderFor..."で始まるプロパティ値を、Content Hubデプロイメントで使用した値に置き換えてください。

  { "$type": "Sitecore.Commerce.Plugin.ContentHub.ContentHubClientPolicy, Sitecore.Commerce.Plugin.ContentHub", "EndpointUrl": "PlaceholderForContentHubEndpointUrl", "UserName": "PlaceholderForContentHubUserName", "Password": "PlaceholderForContentHubPassword", "ClientId": "PlaceholderForContentHubClientId", "ClientSecret": "PlaceholderForContentHubClientSecret", "KnownSSORedirects": "PlaceholderForContentHubKnownSSORedirects", "TimeoutInSeconds": 90, "RetryCount": 3 },

Content HubのプロダクトエンティティプロパティをXC販売可能なアイテムプロパティマッピングに定義する

ProductSynchronizationPolicyポリシーは、同期プロセスがどのPCMエンティティプロパティがどの販売可能なアイテムプロパティにマッピングするかを決定するために使うマッピング("PropertyMapping"セクションで)を定義XC。

デフォルトの製品プロパティを販売可能なアイテムプロパティマッピングに変更するには:

• "FromProperty"プロパティを使ってContent Hubデプロイメントで使うPCM製品プロパティを指定し、"ToProperty"プロパティを使って同期するXC販売可能なアイテムプロパティを指定します。同期したいプロパティ値に基づいて、必要なだけマッピングを追加できます。以下の例はデフォルトのプロパティマッピングを示しています:

  { "$type": "Sitecore.Commerce.Plugin.ContentHub.ProductSynchronizationPolicy, Sitecore.Commerce.Plugin.ContentHub","PropertyMapping":{ "$type": "System.Collections.Generic.List`1Sitecore.Commerce.Plugin.ContentHub.PropertyMap, Sitecore.Commerce.Plugin.ContentHub, mscorlib", "$values": { "type": "Sitecore.Commerce.Plugin.ContentHub.PropertyMap, Sitecore.Commerce.Plugin.ContentHub", "FromProperty": "ProductName", "ToProperty": "Name" }, { "$type": "Sitecore.Commerce.Plugin.ContentHub.PropertyMap, Sitecore.Commerce.Plugin.ContentHub", "FromProperty": "ProductName", "ToProperty": "DisplayName" }, { "$type": "Sitecore.Commerce.Plugin.ContentHub.PropertyMap, Sitecore.Commerce.Plugin.ContentHub", "FromProperty": "ProductLongDescription", "ToProperty": "Description" }

  } },