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

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

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

Salesforceの連絡先アカウント名を保存する連絡先ファセットを作成するには、次のクラスをプロジェクトに追加します。

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

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

使用可能なコンタクト ファセットを定義するxConnectコレクション モデルを作成するには、次のクラスをプロジェクトに追加します。

using Sitecore.DataExchange.Tools.SalesforceConnect.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.Salesforce
{
    public class SalesforceConnectCollectionModelEx
    {
        public SalesforceConnectCollectionModelEx()
        {
        }
        static SalesforceConnectCollectionModelEx()
        {
            _model = BuildModel();
        }
        private static XdbModel _model = null;
        public static XdbModel Model { get { return _model; } }
        private static XdbModel BuildModel()
        {
            var builder = new XdbModelBuilder(typeof(SalesforceConnectCollectionModelEx).FullName, new XdbModelVersion(1, 0));
            builder.DefineFacet<Contact, SalesforceAccountInformationFacet>(SalesforceAccountInformationFacet.DefaultFacetKey);
            builder.ReferenceModel(SalesforceConnectCollectionModel.Model);
            return builder.BuildModel();
        }
    }
}

アセンブリをSitecoreサーバーにデプロイするには、Visual Studioプロジェクトをビルドし、結果のExamples.Connect.Salesforce.dllファイルをSitecoreサーバーにコピーします。

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

次の項目を追加します。

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

新しいCustom Collection Model for Salesforceアイテムを選択します。右側のペインのContentタブのSettingsセクションで、次のフィールド値を設定します。

アイテムを保存します。

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

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

コレクション モデルを使用するようにxConnectクライアント エンドポイントを設定するには、コンテンツ エディターでSitecore/System/Data Exchange/<your Salesforce tenant>/Endpoints/Providers/xConnect/xConnect Client Endpointに移動します。

右側のペインのContentタブのCollection Serviceセクションで、次のフィールド値を設定します。

アイテムを保存します。

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

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

取引先企業の値アクセッサを取引先責任者に追加するには、コンテンツ エディタで <your Salesforce tenant>/Data Access/Value Accessor Sets/Providers/Salesforce/Salesforce Contact Fieldsに移動します。次の項目を追加します。

新しいAccount on Salesforce Contactアイテムを選択します。右側のペインのContentタブのFieldセクションで、次のフィールド値を設定します。

アイテムを保存します。

アカウント名にアクセスするための値アクセサを作成するには、コンテンツ エディタで<your Salesforce tenant>/Data Access/Value Accessor Sets/Providers/Salesforceに移動します。次の項目を追加します。

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

新しいName on Salesforce Account項目の右側のペインのContentタブのFieldセクションで、次のフィールド値を設定します。

アイテムを保存します。

値リーダーを作成するには、コンテンツ エディターで <your Salesforce tenant>/Data Access/Value Readers/Providers/Salesforceに移動します。次の項目を追加します。

新しいValue Reader for Account Name Value Accessor項目の右側のペインのContentタブのSettingsセクションで、次のフィールド値を設定します。

アイテムを保存します。

コンテンツ エディターで、<your Salesforce tenant>/Data Access/Value Accessor Sets/Providers/xConnectに移動します。

次の項目を追加します。

新しいxConnect Contact Salesforce Account Information Facetアイテムに、次のアイテムを追加します。

新しいAccount Name on Salesforce Account Information Facet on xConnect Contact項目の右側のペインのContentタブのSettingsセクションで、次のフィールド値を設定します。

アイテムを保存します。

コンテンツ エディターで、<your Salesforce tenant>/Value Mapping Sets/Salesforce to xConnect Contact Mappingsに移動します。

次の項目を追加します。

新しいSalesforce Contact to xConnect Contact Salesforce Account Information Facetアイテムに、次のアイテムを追加します。

新しいAccount Name  項目の右側のペインのContentタブで、次のフィールド値を設定します。

アイテムを保存します。

コンテンツ エディターで、<your Salesforce tenant>/Data Access/Value Accessor Sets/Providers/xConnect/xConnect Contactに移動します。

次の項目を追加します。

新しいSalesforce Account Information Facet on xConnect Contactアイテムの右側のペイン、Contentタブ、Settingsセクションで、次のフィールド値を設定します。

アイテムを保存します。

テナントを選択します。

<your Salesforce tenant>/Value Mapping Sets/Salesforce to xConnect Contact Mappings/Salesforce Contact to Contact Modelに移動します。

次の項目を追加します。

新しいSalesforce Account Information Facet項目の右側のペインのContentタブで、次の値を設定します。

アイテムを保存します。

ファセットのフィールドをパイプライン ステップに追加するには、コンテンツ エディターで <your Salesforce tenant>/Pipelines/Salesforce Contacts to xConnect Sync Pipelines/Read Contacts from Salesforce Pipeline/Read Contacts from Salesforceに移動します。

右側のペインのContentタブ、Object SettingsセクションのFields to Readフィールドで、Selected列にSalesforce Account Fieldsを追加します。パイプライン ステップを保存します。

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

右側のペインのContentタブのxConnect SettingsセクションのFacets to Readフィールドで、Collection Models/Custom Models/Custom Collection Model for Salesforce/Facets/Contact/SalesforceAccountを見つけます。 Selected列に追加します。

パイプライン ステップを保存します。