---
title: "ウォークスルー:カスタムコンタクトのファセット作成"
slug: "walkthrough--creating-a-custom-contact-facet"
abstract: "Salesforce CRMとSitecore間の連絡先データを同期するためのカスタムコンタクトファセットの作成方法。"
---
# ウォークスルー:カスタムコンタクトのファセット作成

Sitecore Experience Platformでは、連絡先のファセットを使って連絡先のデータを保存します。このウォークスルーでは、カスタムコンタクトのファセットを作成し、Salesforce CRMのデータでファセットに入力する同期プロセスの設定手順を案内します。カスタムコンタクトファセットは、その連絡先に関連付けられたアカウント名を保存します。

このウォークスルーでは、以下の方法を説明します:

-   カスタムコンタクトファセットアセンブリを作成・展開する
-   コレクションモデルを定義する
-   コレクションモデルの展開と設定
-   Salesforceの連絡先からの読み方を指定してください
-   コンタクトの側面に書き込む方法を指定してください
-   Salesforceデータをコンタクトの側面にマッピングする
-   コンタクトのファセットをコンタクトにマッピングします
-   パイプラインに新しい側面を追加

## カスタムコンタクトファセットアセンブリを作成・展開する

連絡先にカスタムデータを保存するには、連絡先のファセットが必要です。MicrososftのVisual Studioプロジェクトでコンタクトのファセットを実装します。

カスタムコンタクトのファセットを作成・展開するには:

1.  Visual Studioで以下のプロジェクトを作成します:
    
    **プロジェクトタイプ**
    
    *Class Library (.NET Framework)*
    
    **.NETバージョン**
    
    *.NET フレームワーク 4.6.2*
    
    **プロジェクト名**
    
    *例。Connect。Salesforce*
    
2.  以下のNuGetパッケージへの参照を追加してください:
    
    -   Sitecore.DataExchange.Tools.SalesforceConnect.NoReferences
    -   Sitecore.XConnect.NoReferences
    
    > !注Sitecoreの公開NuGetフィードは[https://nuget.sitecore.com/resources/v3/index.json](https://nuget.sitecore.com/resources/v3/index.json)で視聴可能です。
    
3.  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()
     {
     }
     }
    }
    
4.  利用可能な接触面を定義する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();
     }
     }
    }
    
5.  アセンブリをSitecoreサーバーにデプロイするには、Visual Studioプロジェクトを構築し、得られたExamples.Connect.Salesforce.dllファイルをSitecoreサーバーにコピーします。
    

## コレクションモデルを定義する

カスタムデータプロバイダーは、コレクションモデルで定義されたファセットを公開します。これにより、xConnectエンティティを含むデータマッピングの設定が容易になり、ユーザーに利用可能なものを表示し、誤って無効な値を入力する変更を減らすことができます。

カスタムコレクションモデルを登録してからは使用できません。

コレクションモデルを定義するために:

1.  Sitecoreでコンテンツエディターを開き、*Sitecore/System/Settings/Data Exchange/Providers/xConnect/Collection Models*に移動します。
    
2.  以下の項目を追加してください:
    
    **テンプレート**
    
    *Collection Model Folder*
    
    **アイテム名**
    
    *Custom Models*
    
3.  新しい*Custom Models*項目には以下の項目を追加してください:
    
    **テンプレート**
    
    *Compiled Collection Model*
    
    **アイテム名**
    
    *Salesforce向けカスタムコレクションモデル*
    
4.  *Salesforceアイテム用の新しいカスタムコレクションモデル*を選択します。右側のペイン、**コンテンツ**タブの**設定**セクションで、以下のフィールド値を設定します:
    
    フィールド
    
    価値
    
    **コレクションモデルタイプ**
    
    *例。Connect。Salesforce。SalesforceConnectCollectionModelEx、例。Connect。Salesforce*
    
5.  アイテムを保存してください。
    

## コレクションモデルの展開と設定

収集モデルを展開するには:

1.  モデルをxConnectにデプロイするには、カスタムコレクションモデルに移動してください。リボンの **「データ交換** 」タブで「 **モデルをアイテムに変換**」をクリックします。次に **「モデルをJSONに変換**」をクリックします。
    
    ![Convert model to JSON button](<https://doc.sitecore.com/api/markdown-image/xp/ja/developers/salesforce-connect/80/sitecore-connect-for-salesforce-crm/images/convert%20model%20to%20json%20button.png>)
    
2.  モデルファイルを保存し、以下のサーバーに展開します:
    
    -   xConnectコレクション
    -   xConnect インデックス
3.  xConnectクライアントエンドポイントをコレクションモデルを使用するように設定するには、コンテンツエディターで*Sitecore/System/Data Exchange//Endpoints/Providers/xConnect/xConnect Client Endpoint*に移動します。
    
4.  右側のペイン、**コンテンツ** タブの **コレクションサービス** セクションで、以下のフィールド値を設定します:
    
    フィールド
    
    価値
    
    **コレクションモデル**
    
    *コレクションモデル/カスタムモデル/Salesforce向けカスタムコレクションモデル*
    
5.  アイテムを保存してください。
    
6.  設定をテストするには、リボンの **「データ交換** 」タブで **「トラブルシューティング**を実行する」をクリックしてください。
    
    ![Run Troubleshooter button](<https://doc.sitecore.com/api/markdown-image/xp/ja/developers/salesforce-connect/80/sitecore-connect-for-salesforce-crm/images/run%20troubleshooter%20button.png>)
    
    xConnect収集サービスへの接続が確立されたことを知らせるメッセージがあります:
    
    ![Connection successfully established message](<https://doc.sitecore.com/api/markdown-image/xp/ja/developers/salesforce-connect/80/sitecore-connect-for-salesforce-crm/images/connection%20established%20message.png>)
    

## Salesforceの連絡先からの読み方を指定してください

テナントがSalesforceの連絡先データを読み取るように設定する必要があります。そのためには、Salesforceのデータ構造を表すために値のアクセルと値リーダーを使用します。

Salesforceの連絡先からの読み方を指定するには:

SalesforceからSitecoreへのデータのマッピングを設定する際には、値インビサーを使ってSalesforceの連絡先からどの値を読み取るかを指定します。

連絡先にアカウント名を含めると指定すると、Salesforceはアカウントオブジェクトを返します。このアカウントオブジェクトにはアカウント名を表すフィールドがあります。アカウントオブジェクトの名前にアクセスするには値アクセスツールを作成する必要があります。この値アクセスツールは決して直接使用されません。価値アクセスツールを使ってアカウント名を読み取る価値リーダーを作成しなければなりません。

Salesforceの連絡先からの読み方を指定するには:

1.  連絡先のアカウントの価値アクセルを追加するには、コンテンツエディターで*/Data Access/Value Accessor セット/プロバイダー/Salesforce/Salesforce Contact Fields*へ移動してください。以下の項目を追加してください:
    
    **テンプレート**
    
    *Salesforce オブジェクトフィールド 値 インセリサー*
    
    **アイテム名**
    
    *Salesforce連絡先のアカウント*
    
2.  *Salesforceの新しいアカウント*連絡先項目を選択してください。右側のペイン、**コンテンツ**タブの**フィールド**セクションで、以下のフィールド値を設定します:
    
    フィールド
    
    価値
    
    **フィールド名**
    
    *Account*
    
    **セレクトのフィールド名**
    
    *Account.Name*
    
3.  アイテムを保存してください。
    
4.  アカウント名にアクセスする価値アクセスツールを作成するには、コンテンツエディターで */Data Access/Value Accessor Sets/Providers/Salesforce*へ移動してください。以下の項目を追加してください:
    
    **テンプレート**
    
    *Salesforce Object Value Accessor Set*
    
    **アイテム名**
    
    *Salesforce Account Fields*
    
5.  新しい*Salesforce Account Fields*項目には以下の項目を追加してください:
    
    **テンプレート**
    
    *Salesforce オブジェクトフィールド 値 インセリサー*
    
    **アイテム名**
    
    *Salesforceアカウントの名前*
    
6.  新しい *「Salesforceアカウントの名前」* 項目の右側ペイン、**コンテンツ** タブの **フィールド** セクションで、以下のフィールド値を設定します。
    
    フィールド
    
    価値
    
    **フィールド名**
    
    *Name*
    
7.  アイテムを保存してください。
    
8.  バリューリーダーを作成するには、コンテンツエディターで */Data Access/Value Readers/Providers/Salesforce*へ移動してください。以下の項目を追加してください:
    
    **テンプレート**
    
    *Value Accessor Value Reader*
    
    **アイテム名**
    
    *アカウント名バリューアクセス用のバリューリーダー*
    
9.  新しい *アカウント名の価値アクセス項目の価値リーダー* の右側ペイン、**コンテンツ** タブの **設定** セクションで、以下のフィールド値を設定します。
    
    フィールド
    
    価値
    
    **バリューアクセサ**
    
    *価値アクセスセット/プロバイダー/Salesforce/Salesforceアカウントフィールド/Salesforceアカウント名*
    
10.  アイテムを保存してください。
     

## コンタクトの側面に書き込む方法を指定してください

値アクセスセットを設定するには:

1.  コンテンツエディターで */data access/value accessor set/providers/xConnect*に移動してください。
    
2.  以下の項目を追加してください:
    
    **テンプレート**
    
    *xConnect エンティティ ファセット 値 アクセサセット*
    
    **アイテム名**
    
    *xConnect Contact:Salesforceアカウント情報ファセット*
    
3.  新しい*xConnectの「Contact」Salesforceアカウント情報のファセット* 項目に、以下の項目を追加してください:
    
    **テンプレート**
    
    *xConnect エンティティ ファセットプロパティ バリュー アクセサ*
    
    **アイテム名**
    
    *Salesforceのアカウント名、アカウント情報のファセット、xConnect 連絡先*
    
4.  *xConnect Contact項目のSalesforceアカウント情報ファセットの新しいアカウント名*で、右側の**ペ**インのコンテンツタブの**設定**セクションで、以下のフィールド値を設定します。
    
    フィールド
    
    価値
    
    **ファセット特性**
    
    *コレクションモデル/カスタムモデル/Salesforce/Facets/Contact/SalesforceAccount/AccountName 用のカスタムコレクションモデル*
    
5.  アイテムを保存してください。
    

## Salesforceデータをコンタクトの側面にマッピングする

データをコンタクト面にマッピングするには:

1.  コンテンツエディターで、*/value mapping set/Salesforce から xConnect Contact Mappings へ*移動します。
    
2.  以下の項目を追加してください:
    
    **テンプレート**
    
    *Value Mapping Set*
    
    **アイテム名**
    
    *Salesforce連絡先:xConnectへ Salesforceアカウント情報のファセット*
    
3.  新しい*Salesforce Contact to xConnect Contact Salesforce Account Information Sidet*項目には、以下の項目を追加してください:
    
    **テンプレート**
    
    *Value Mapping*
    
    **アイテム名**
    
    *Account Name*
    
4.  新しい*Account Name*項目の右側ペインの **「Content** 」タブで、以下のフィールド値を設定します。
    
    セクション
    
    フィールド
    
    価値
    
    **出典**
    
    **ソースアクセサル**
    
    *データアクセス/価値アクセスセット/プロバイダー/Salesforce/Salesforceの連絡先フィールド/Salesforce Contactのアカウント*
    
    **ターゲット**
    
    **ターゲットアクセサ**
    
    *データアクセス/価値アクセスセット/プロバイダー/xConnect/xConnect ContactのSalesforceアカウント情報ファセット/Salesforceアカウント情報のファセットのファセット、xConnectの連絡先*
    
    **ルール**
    
    **ソースバリュートランスフォーマー**
    
    *アカウント名のバリューアクセスツール/プロバイダー/Salesforce/バリューリーダー*
    
    > !注「 [Salesforceの連絡先から読み方を指定する」セクション](https://doc.sitecore.com/xp/ja/developers/salesforce-connect/80/sitecore-connect-for-salesforce-crm/walkthrough--creating-a-custom-contact-facet.html#UUID-8c16592b-cc49-eabb-6aca-10c607a83a67_N1527254567757 "Specify how to read from the Salesforce contact")で、アカウント名の値リーダーを作成しました。この値リーダーは、値マッピング上のソース値変換器として設定されています。ソース値変換器は、ソース値アクセルが読み取ったオブジェクトから値を読み取るバリューリーダーです。この場合、ソース値アクセサルはSalesforceの連絡先からアカウントオブジェクトを読み取ります。ただし、アカウント名を使い、アカウントオブジェクト自体を読み取るわけではありません。つまり、ソース値トランスフォーマーはアカウントオブジェクトから名前を読み取るのです。
    
5.  アイテムを保存してください。
    

## コンタクトのファセットをコンタクトにマッピングします

ファセットをマッピングするには:

1.  コンテンツエディターで*/Data Access/Value Accessor セット/プロバイダー/xConnect/xConnect Contact*に移動してください。
    
2.  以下の項目を追加してください:
    
    **テンプレート**
    
    *xConnect エンティティ ファセットバリュー アクセサ*
    
    **アイテム名**
    
    *xConnect 連絡先のSalesforceアカウント情報ファセット*
    
3.  xConnect Contact項目 *の新しいSalesforceアカウント情報ファセット* の右側ペイン、**コンテンツ** タブの **設定** セクションで、以下のフィールド値を設定します。
    
    フィールド
    
    価値
    
    **面の定義**
    
    *コレクションモデル/カスタムモデル/Salesforce/Facets/Contact/SalesforceAccount 用のカスタムコレクションモデル*
    
    **マッピングセット**
    
    *価値マッピングセット/SalesforceからxConnectへの連絡マッピング/Salesforceへの連絡 Salesforceアカウント情報ファセット*
    
4.  アイテムを保存してください。
    
5.  入居者を選びましょう。
    
6.  */value mapping sets/Salesforce to xConnect Contact Mappings/Salesforce Contact to Contact モデル*へ移動します。
    
7.  以下の項目を追加してください:
    
    **テンプレート**
    
    *Value Mapping*
    
    **アイテム名**
    
    *Salesforce Account Information Facet*
    
8.  新しい*Salesforce Account Information Facet*項目の右側ペインの **「Content** 」タブで、以下の値を設定します:
    
    セクション
    
    フィールド
    
    価値
    
    **出典**
    
    **ソースアクセサル**
    
    *データアクセス/値アクセス/共通/価値アクセス器(生値リーダーセット付き)*
    
    **ターゲット**
    
    **ターゲットアクセサ**
    
    *データアクセス/価値アクセスセット/プロバイダー/xConnect/xConnect 連絡先/salesforceアカウント情報ファセット xConnect Contact*
    
9.  アイテムを保存してください。
    

## パイプラインに新しい側面を追加

新しい側面の情報を処理するには、*Salesforceからの連絡を読み取り* 、*Salesforceの単一接触* 処理のパイプラインステップに追加する必要があります。

パイプラインのステップにファセットを追加するには:

1.  パイプラインのファセットのフィールドを追加するには、コンテンツエディターで */Pipelines/Salesforce Contactsに移動し、xConnect Sync Pipelines/Read Contacts from Salesforce Pipeline/Read Contacts from Salesforce*。
2.  右側のペインの**「コンテンツ**」タブの「**オブジェクト設定**」セクションの「**読むべきフィールド**」欄で、「**選択**済み」列に*Salesforce Account Fields*を追加します。パイプラインのステップを保存します。
3.  *Salesforceパイプラインから単一接触*を処理するステップに追加するには、コンテンツエディターで*/Pipelines/Salesforce Contactsに移動し、xConnect Sync Pipelines/Process Single Contact/Resolve Contact ModelをIDでxConnectから選*びます。
4.  右側のペイン、 **コンテンツ** タブの **xConnect 設定** セクションの「 **読み取る面** 」欄で、「 *Collection Models/Custom Models/Custom Collection Model for Salesforce/Facets/Contact/SalesforceAccount」*を見つけてください。 **それを「Selected** 」列に追加してください。
5.  パイプラインのステップを保存しましょう。