コンタクトを手に入れましょう

IDで連絡先を取得

以下の例は、IDで単一の連絡先を取得する方法を示しています:

using Sitecore.XConnect.Operations; using System; using System.Threading.Tasks; using Sitecore.XConnect; using Sitecore.XConnect.Client;

namespace Documentation { public class GetContact { // Async example public async void ExampleAsync() { using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient()) { try { var reference = new Sitecore.XConnect.ContactReference(Guid.Parse("B9814105-1F45-E611-82E6-34E6D7117DCB"));

Task<Sitecore.XConnect.Contact> contactTask = client.GetAsync<Sitecore.XConnect.Contact>(reference, new ContactExecutionOptions(new ContactExpandOptions() { });

Contact contact = await contactTask; } catch (XdbExecutionException ex) { // Manage exceptions } } }

// Sync example public void Example() { using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient()) { try { var reference = new Sitecore.XConnect.ContactReference(Guid.Parse("B9814105-1F45-E611-82E6-34E6D7117DCB"));

Contact contact = client.Get(reference, new ContactExecutionOptions(new ContactExpandOptions() { }); } catch (XdbExecutionException ex) { // Manage exceptions } } } } }

識別子による連絡先取得

以下の例は識別子による連絡先取得方法を示しています。既知の識別子と匿名識別子の両方に対して同じ方法を用いてください。識別子の詳細については「連絡先概要」トピックを参照してください

!注出典と識別子はどちらも大文字を区別しています。

using Sitecore.XConnect; using System.Threading.Tasks; using Sitecore.XConnect.Client;

namespace Documentation { public class GetContactByIdentifier { // Async example public async void ExampleAsync() { using (XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient()) { try { var reference = new IdentifiedContactReference("twitter", "myrtlesitecore");

Task contactTask = client.GetAsync(reference, new ContactExecutionOptions(new ContactExpandOptions() { }));

Contact contact = await contactTask; } catch (XdbExecutionException ex) { // Manage exceptions } } }

// Sync example public void Example() { using (XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient()) { try { var reference = new IdentifiedContactReference("twitter", "myrtlesitecore");

Contact contact = client.Get(reference, new ContactExecutionOptions(new ContactExpandOptions() { })); } catch (XdbExecutionException ex) { // Manage exceptions } } } } }

複数の連絡先を取る

.GetAsync()および.Get()メソッドを用いて、複数の接点を参照配列を渡すことで複数の接点を取得することができます。接点は単一のバッチとして返されます。以下の例で示すように、IDと識別子の混合を使って接点を取得することが可能です。

using Sitecore.XConnect.Operations; using System; using System.Collections.Generic; using Sitecore.XConnect; using Sitecore.XConnect.Client.Configuration; using Sitecore.XConnect.Client;

namespace Documentation { public class GetMultipleContacts { // Async example public async void AsyncExample() { using (XConnectClient client = SitecoreXConnectClientConfiguration.GetClient()) { try { var references = new List<IEntityReference>() { // Contact ID new ContactReference(new Guid("{A2814105-1F45-E611-52E6-34E6D7117DCB}")), // Known identifier new IdentifiedContactReference("twitter", "myrtlesitecore"), // Anonymous identifier new IdentifiedContactReference("adnetwork", "AB973934540244") };

var contactsTask = client.GetAsync(references, new ContactExecutionOptions(new ContactExpandOptions() { }));

IReadOnlyCollection<IEntityLookupResult> contactsResult = await contactsTask;

foreach (var result in contactsResult) { if (result.Exists) { Contact contact = result.Entity; } }

} catch (XdbExecutionException ex) { // Manage exceptions } } }

// Sync example public void Example() { using (XConnectClient client = SitecoreXConnectClientConfiguration.GetClient()) { try { var references = new List<IEntityReference>() { // Contact ID new ContactReference(new Guid("{A2814105-1F45-E611-52E6-34E6D7117DCB}")), // Known identifier new IdentifiedContactReference("twitter", "myrtlesitecore"), // Anonymous identifier new IdentifiedContactReference("adnetwork", "AB973934540244") };

IReadOnlyCollection<IEntityLookupResult> contacts = client.Get(references, new ContactExecutionOptions(new ContactExpandOptions() { }));

foreach (var result in contacts) { if (result.Exists) { Contact contact = result.Entity; } }

} catch (XdbExecutionException ex) { // Manage exceptions } } } } }

xConnectは、接点が見つからなくても各操作ごとにIEntityLookupResult を返します。接点が存在する場合、Existsプロパティはtrueに設定され、Entityプロパティから接触にアクセスできます。接点が存在するが取得できない場合は、Exceptionプロパティを詳細に確認してください。

!注複数の連絡先参照が同じ連絡先を参照している場合、xConnectはリストを統合できず、連絡先を複数回返します。

連絡先や関連するやり取りを得ましょう

デフォルトでは、接触はファセットや関連する相互作用なしで返されます。展開オプションを使って、どのファセスやどの範囲の関連するインタラクションを返すべきかを判断してください。

• 連絡先の側面を入手してください
• 連絡先の交流を得てください