Sitecore 8 EXM 从 listmanager 添加联系人到列表答案

【问题标题】：Sitecore 8 EXM add a contact to list from listmanagerSitecore 8 EXM 从 listmanager 添加联系人到列表
【发布时间】：2015-03-20 12:57:17
【问题描述】：

我正在使用 Sitecore 8 和新的电子邮件体验管理器模块。我已将列表管理器中的空列表配置为时事通讯电子邮件作为收件人。

通过自制表格订阅时事通讯时，我会收到一个电子邮件地址和一个姓名。现在我想用这个邮件和名字建立一个新的联系人，并通过代码将它添加到我的列表管理器中的列表中。

有没有办法通过api调用这个列表并添加联系人？

【问题讨论】：

标签： sitecore sitecore8 sitecore-ecm sitecore-exm

【解决方案1】：

创建联系人，可以使用下面的示例代码，联系人姓名通常是域名加用户名，例如域\用户名。

public static Contact CreateContact([NotNull] string contactName, [NotNull] string contactEmail, [NotNull] string contactLanguage)
{
  Assert.ArgumentNotNullOrEmpty(contactName, "contactName");
  Assert.ArgumentNotNullOrEmpty(contactEmail, "contactEmail");
  Assert.ArgumentNotNullOrEmpty(contactLanguage, "contactLanguage");

  var contactRepository = new ContactRepository();

  var contact = contactRepository.LoadContactReadOnly(contactName);
  if (contact != null)
  {
    return contact;
  }
  contact = contactRepository.CreateContact(ID.NewID);
  contact.Identifiers.AuthenticationLevel = AuthenticationLevel.None;
  contact.System.Classification = 0;
  contact.ContactSaveMode = ContactSaveMode.AlwaysSave;
  contact.Identifiers.Identifier = contactName;
  contact.System.OverrideClassification = 0;
  contact.System.Value = 0;
  contact.System.VisitCount = 0;

  var contactPreferences = contact.GetFacet<IContactPreferences>("Preferences");
  contactPreferences.Language = contactLanguage;

  var contactEmailAddresses = contact.GetFacet<IContactEmailAddresses>("Emails");
  contactEmailAddresses.Entries.Create("test").SmtpAddress = contactEmail;
  contactEmailAddresses.Preferred = "test";

  var contactPersonalInfo = contact.GetFacet<IContactPersonalInfo>("Personal");
  contactPersonalInfo.FirstName = contactName;
  contactPersonalInfo.Surname = "recipient";

  contactRepository.SaveContact(contact, new ContactSaveOptions(true, null));

  return contact;
}

创建联系人后，使用以下示例代码将联系人添加到收件人列表中。

  var repository = new ListManagerCollectionRepository();
  var recipientList = repository.GetEditableRecipientCollection(recipientListId);
  if (recipientList != null)
  {
    var xdbContact = new XdbContactId(contactId);
    if (!recipientList.Contains(xdbContact, true).Value)
    {
      recipientList.AddRecipient(xdbContact);
    }
  }

【讨论】：

创建联系人正在工作，但是当我尝试从列表管理器将其添加到列表时，它仍然显示零个收件人。

【解决方案2】：

基本上你可以按照这个例子进行

<%@ Page Language="c#" %>
<%@ Import Namespace="Sitecore.Analytics" %>
<%@ Import Namespace="Testing.ContactFacets.Model" %>
<!DOCTYPE html>
<html>
  <head>
    <title>Add Employee Data</title>
  </head>
  <body>
    <%
      var contact = Tracker.Current.Contact;
      var data = contact.GetFacet<IEmployeeData>("Employee Data");
      data.EmployeeId = "ABC123";
    %>
    <p>Employee data contact facet updated.</p>
    <p>Contact ID: <b><%=contact.ContactId.ToString()%></b></p>
    <p>Employee #: <b><%=data.EmployeeId%></b></p>
  </body>
</html>

然后在放弃会话时写入更改，就像这样

<%@ Page language="c#" %>
<script runat="server">
  void Page_Load(object sender, System.EventArgs e) {
      Session.Abandon();
  }
</script> 
<!DOCTYPE html>
<html>
  <head>
    <title>Session Abandon</title>
  </head>
  <body>
  </body>
</html>

【讨论】：

【解决方案3】：

我遇到了完全相同的问题，即列表管理器在将联系人添加到收件人列表后报告了 0 个联系人。

我仔细调查了这个问题，发现将联系人添加到收件人列表实际上只是在“sitecore_analytics_index”索引中的联系人上设置了一个字段（假设您使用 Mongo/XDB 作为底层存储）。具体而言，Sitecore 应使用值“ContactLists:{recipientListGuid}”更新联系人文档上的“contact.tags”字段。我尝试使用Luke 打开索引，以验证该字段确实没有在索引中设置。该索引位于 C:\inetpub\wwwroot[Sitename]\Data\indexes\sitecore_analytics_index。

这使我得出结论，您必须在将联系人添加到收件人列表后保存该联系人。

总结一下，以下代码对我有用：

var ecm = EcmFactory.GetDefaultFactory();
XdbContactId contactId = /* some valid contact id */;
LeaseOwner leaseOwner = new LeaseOwner("UpdateContact-" + Guid.NewGuid().ToString(), LeaseOwnerType.OutOfRequestWorker);
Sitecore.Analytics.Tracking.Contact contact;
string webClusterName;
var status = ecm.Gateways.AnalyticsGateway.TryGetContactForUpdate(contactId.Value,
    leaseOwner,
    TimeSpan.FromSeconds(5),
     TimeSpan.FromSeconds(5),
     out contact, out webClusterName);

var recipientList = ecm.Bl.RecipientCollectionRepository.GetEditableRecipientCollection(recipientListId);
  if (recipientList != null)
  {
    if (!recipientList.Contains(contactId, true).Value)
    {
      recipientList.AddRecipient(contactId);
    }
  }

contact.ContactSaveMode = ContactSaveMode.AlwaysSave;
var contactRepository = new ContactRepository();
var success = contactRepository.SaveContact(contact, new ContactSaveOptions(true, leaseOwner));

注意，以上代码用于更新场景。在你的情况下，我猜你只需要移动这段代码：

contactRepository.SaveContact(contact, new ContactSaveOptions(true, null));

之后：

var recipientList = EcmFactory.GetDefaultFactory().Bl.RecipientCollectionRepository.GetEditableRecipientCollection(recipientListId);
  if (recipientList != null)
  {
    var xdbContact = new XdbContactId(contactId);
    if (!recipientList.Contains(xdbContact, true).Value)
    {
      recipientList.AddRecipient(xdbContact);
    }
  }

更新：实际上，仅当保存的联系人是 Sitecore Analytics 当前跟踪的联系人时，上述方法才有效。

【讨论】：

这对我帮助很大！谢谢。
此代码在 Email Experience Manager 3.2 Update-1 中不起作用。 `ecm.Bl.RecipientCollectionRepository.GetEditableRecipientCollection(recipientListId);' RecipientCollectionRepository 现在是内部的

【解决方案4】：

如果您有可用的跟踪器并且您不需要立即更新，以下应该可以工作（请注意，联系人会在会话到期时添加到列表中）：

//private const string ContactListTagName = "ContactLists";

var contact = Tracker.Current.Contact;

// Identify
if (contact.Identifiers.IdentificationLevel < ContactIdentificationLevel.Known)
{
    Tracker.Current.Session.Identify(email);
}

// Set Email
var contactEmail = contact.GetFacet<IContactEmailAddresses>("Emails");

// Create an email address if not already present

// This can be named anything, but must be the same as "Preferred" if you want
// this email to show in the Experience Profiles backend. 
if (!contactEmail.Entries.Contains("Preferred"))
    contactEmail.Entries.Create("Preferred");

// set the email
var emailEntry = contactEmail.Entries["Preferred"];
emailEntry.SmtpAddress = email;
contactEmail.Preferred = "Preferred";

// set FirstName and Surname (required for List Manager, "N/A" might not be ideal but I don't know how Sitecore behaves with empty strings)
var personal = contact.GetFacet<IContactPersonalInfo>("Personal");
personal.FirstName = personal.FirstName ?? "N/A";
personal.Surname = personal.Surname ?? "N/A";

// Add preferred language
var preferences = contact.GetFacet<IContactPreferences>("Preferences");
preferences.Language = Context.Language.Name;

// Here is the actual adding to the list by adding tags
using (new SecurityDisabler())
{
    var id = ID.Parse("CONTACTLISTID");
    contact.Tags.Set(ContactListTagName, id.ToString().ToUpperInvariant());
}

问候，马库斯

【讨论】：