連絡先を操作する

連絡先を追加する

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

client.AddContact()方法を使用して、新しい連絡先を追加します。連絡先は、識別子の有無にかかわらず追加できます。匿名のエイリアス識別子がすべての新しい連絡先に追加され、連絡先IDはxConnectサービスレイヤーによって順番に生成されます。

連絡先を1つ追加する

次の例では、識別子やファセットのない1つのコンタクトが作成され、xConnectに送信されます。

using Sitecore.XConnect;
using Sitecore.XConnect.Client;

namespace Documentation
{
    public class AddContact
    {
        public async void ExampleAsync()
        {
            using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {
                try
                {
                    var firstContact = new Sitecore.XConnect.Contact();
                    client.AddContact(firstContact); // Extension found in Sitecore.XConnect.Operations

                    // Submits the batch, which contains two operations
                    await client.SubmitAsync();
                }
                catch (XdbExecutionException ex)
                {
                    // Manage exception
                }
            }
        }

        public void Example()
        {
            using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {
                try
                {
                    var firstContact = new Sitecore.XConnect.Contact();
                    client.AddContact(firstContact); // Extension found in Sitecore.XConnect.Operations

                    // Submits the batch, which contains two operations
                    client.Submit();
                }
                catch (XdbExecutionException ex)
                {
                    // Manage exception
                }
            }
        }
    }
}

複数の連絡先を追加する

次の例では、ファセットまたは識別子のない2つのコンタクトが作成され、1つのバッチとして送信されます。

using Sitecore.XConnect;
using Sitecore.XConnect.Client;

namespace Documentation
{
    public class AddMultipleContact
    {
        public async void ExampleAsync()
        {
            using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {
                try
                {
                    var firstContact = new Sitecore.XConnect.Contact();
                    client.AddContact(firstContact); // Extension found in Sitecore.XConnect.Operations

                    var secondContact = new Sitecore.XConnect.Contact();
                    client.AddContact(secondContact); // Extension found in Sitecore.XConnect.Operations

                    // Submits the batch, which contains two operations
                    await client.SubmitAsync();
                }
                catch (XdbExecutionException ex)
                {
                    // Manage exception
                }
            }
        }

        public void Example()
        {
            using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {
                try
                {
                    var firstContact = new Sitecore.XConnect.Contact();
                    client.AddContact(firstContact); // Extension found in Sitecore.XConnect.Operations

                    var secondContact = new Sitecore.XConnect.Contact();
                    client.AddContact(secondContact); // Extension found in Sitecore.XConnect.Operations

                    // Submits the batch, which contains two operations
                    client.Submit();
                }
                catch (XdbExecutionException ex)
                {
                    // Manage exception
                }
            }
        }
    }
}

多数の連絡先を送信する

多数の連絡先は、より小さなバッチで送信する必要があります。バッチ処理の詳細については、次のドキュメントを参照してください。

この記事を改善するための提案がある場合は、お知らせください!