チュートリアル: カスタム連絡先ファセットの作成

Visual Studioで、次のプロジェクトを作成します。

次のNuGetパッケージへの参照を追加します。

取引先企業名を格納するための取引先担当者ファセットを作成するには、Visual Studioで次のクラスを追加します。

using Sitecore.XConnect;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Examples.Connect.Dynamics
{
    [FacetKey(DefaultFacetKey)]
    [Serializable]
    public class DynamicsAccountInformationFacet : Facet
    {
        public const string DefaultFacetKey = "DynamicsAccount";
        public string AccountName { get; set; }
        public DynamicsAccountInformationFacet()
        {
        }
    }
}

コレクション モデルを実装するには、Visual Studioで次のクラスを追加します。

using Sitecore.DataExchange.Tools.DynamicsConnect.Models;
using Sitecore.XConnect;
using Sitecore.XConnect.Schema;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Examples.Connect.Dynamics
{
    public class DynamicsConnectCollectionModelEx
    {
        public DynamicsConnectCollectionModelEx()
        {
        }
        static DynamicsConnectCollectionModelEx()
        {
            _model = BuildModel();
        }
        private static XdbModel _model = null;
        public static XdbModel Model { get { return _model; } }
        private static XdbModel BuildModel()
        {
            var builder = new XdbModelBuilder(typeof(DynamicsConnectCollectionModelEx).FullName, new XdbModelVersion(1, 0));
            builder.DefineFacet<Contact, DynamicsAccountInformationFacet>(DynamicsAccountInformationFacet.DefaultFacetKey);
            builder.ReferenceModel(DynamicsConnectCollectionModel.Model);
            return builder.BuildModel();
        }
    }
}

アセンブリをSitecoreサーバーに配置するには、Visual Studioプロジェクトをビルドし、生成されたExamples.Connect.Salesforce.dllファイルをSitecoreサーバーにコピーします。

Sitecoreの コンテンツ エディター で、Sitecore/System/Settings/Data Exchange/Providers/xConnect/Collection Modelsに移動します。

次の項目を追加します。

新しいコレクション モデル フォルダー アイテムに、次のアイテムを追加します。

新しいコンパイル済みコレクション モデル項目のContentタブのSettingsセクションで、次のフィールド値を設定します。

アイテムを保存します。

コレクションモデルをデプロイするには、カスタムコレクションモデルに移動します。リボンのData Exchangeタブで、Convert Model to Itemsをクリックします。次に、「 Convert Model to JSON」をクリックします。

モデル・ファイルを保存し、モデル・ファイルを次のサーバーにデプロイします。

コンテンツ エディターで、Sitecore/System/Data Exchangeに移動します。

コレクション モデルを使用するようにxConnectクライアント エンドポイントを設定するには、次の場所に移動します。 Sitecore/System/Data Exchange/<your dynamics tenant>/Endpoints/Providers/xConnect/xConnect Client Endpoint

次のフィールド値を設定します。

アイテムを保存します。

構成をテストするには、リボンのData ExchangeタブでRun Troubleshooterをクリックします。

xConnectコレクション サービスへの接続が確立されたことを知らせるメッセージが表示されます。

コンテンツ エディターで、Sitecore/System/Data Exchangeに移動します。

テナントを選択します。

Data Access/Value Accessor Sets/Providers/Dynamics/Dynamics Contactに移動します。

次の項目を追加します。

新しい項目のContentタブのAttributeセクションで、次のフィールド値を設定します。

アイテムを保存します。

コンテンツ エディターで、Sitecore/System/Data Exchangeに移動します。

テナントを選択します。

Data Access/Value Accessor Sets/Providers/xConnectに移動します。

次の項目を追加します。

新しいアイテムに、次のアイテムを追加します。

新しい項目のContentタブのSettingsセクションで、次のフィールド値を設定します。

アイテムを保存します。

コンテンツ エディタを開き、Sitecore/System/Data Exchangeに移動します。

テナントを選択します。

Value Mapping Sets/Dynamics to xConnect Contact Mappingsに移動します。

次の項目を追加します。

新しいアイテムに、次のアイテムを追加します。

新しい項目のContentタブで、次のフィールド値を設定します。

アイテムを保存します。

コンテンツ エディターで、Sitecore/System/Data Exchangeに移動します。

テナントを選択します。

Data Access/Value Accessor Sets/Providers/xConnect/xConnect Contactに移動します。

次の項目を追加します。

新しい項目のContentタブのSettingsセクションで、次のフィールド値を設定します。

アイテムを保存します。

テナントを選択します。

Value Mapping Sets/Dynamics to xConnect Contact Mappings/Dynamics Contact to Contact Modelに移動します。

次の項目を追加します。

新しい項目のContentタブで、次のフィールド値を設定します。

アイテムを保存します。

ファセットのフィールドをパイプライン ステップに追加するには、コンテンツ エディターでSitecore/System/Data Exchangeに移動します。

<your Dynamics tenant>/Pipelines/xConnect Contacts to Dynamics Sync Pipelines/Read Contacts from xConnect Pipeline/Read Contacts from xConnectに移動します。

ContentタブのContact SettingsセクションのContact facets to Readフィールドで、Selected列にxConnect Contact Dynamics Account Information Facetを追加します。パイプライン ステップを保存します。

ファセットをProcess Single Contact from Salesforceパイプライン ステップに追加するには、コンテンツ エディターで <your Dynamics tenant>/Pipelines/Dynamics Contacts to xConnect Sync Pipelines/Process Single Contact from Dynamics Pipeline/Resolve Contact Model by Dynamics Id from xConnectに移動します。

ContentタブのxConnect SettingsセクションのFacets to Readフィールドで、Collection Models/Custom Models/Custom Collection Model for Dynamics/Facets/Contact/DynamicsAccountを見つけます。 Selected列に追加します。パイプライン ステップを保存します。