Merge contacts

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

namespace Documentation
{
    public class GetTargetContacts
    {
        // Async example
        public async void ExampleAsync()
        {
            using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {
                try
                {
                    var sourceContactId = Guid.Parse("77f75056-5d96-4155-93e5-d206214d6a40");

                    // Get source contact - this is an obsolete contact that has been used
                    // in a merge operation
                    Task<Contact> contactTask = client.GetAsync<Contact>(new ContactReference(sourceContactId), new ContactExpandOptions());

                    Contact contact = await contactTask;

                    // Get the merge facet - you do not need to request this facet as part of the expand options
                    var mergeFacet = contact.GetFacet<MergeInfo>(MergeInfo.DefaultFacetKey);

                    if (mergeFacet != null)
                    {
                        // If the merge facet exists, use the SuccessorContactId to retrieve the target contact that
                        // the source contact was merged into
                        var targetContactTask = client.GetAsync<Contact>(new ContactReference(mergeFacet.SuccessorContactId), new ContactExpandOptions());

                        var targetContact = await targetContactTask;
                    }
                }
                catch (XdbExecutionException ex)
                {
                    // Manage exceptions
                }
            }
        }

        // Sync example
        public void ExampleSync()
        {
            using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {
                try
                {
                    var sourceContactId = Guid.Parse("77f75056-5d96-4155-93e5-d206214d6a40");

                    // Get source contact - this is an obsolete contact that has been used
                    // in a merge operation
                    Contact contact = client.Get<Contact>(new ContactReference(sourceContactId), new ContactExpandOptions());

                    // Get the merge facet - you do not need to request this facet as part of the expand options
                    var mergeFacet = contact.GetFacet<MergeInfo>(MergeInfo.DefaultFacetKey);

                    if (mergeFacet != null)
                    {
                        // If the merge facet exists, use the SuccessorContactId to retrieve the target contact that
                        // the source contact was merged into
                        var targetContact = client.GetAsync<Contact>(new ContactReference(mergeFacet.SuccessorContactId), new ContactExpandOptions());
                    }
                }
                catch (XdbExecutionException ex)
                {
                    // Manage exceptions
                }
            }
        }
    }
}

using Sitecore.XConnect.Collection.Model;
using Sitecore.XConnect.Operations;
using System;
using System.Threading.Tasks;
using Sitecore.XConnect;
using Sitecore.XConnect.Client;
using System.Linq;
using System.Collections.Generic;

namespace Documentation
{
    public class GetMergedContacts
    {
        // Async example
        public async void ExampleAsync()
        {
            using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {
                try
                {
                    // Get contact
                    Task<Contact> contactTask = client.GetAsync<Contact>(new IdentifiedContactReference("twitter", "myrtlesitecore"), new ContactExpandOptions());

                    Contact contact = await contactTask;

                    // Get all identifiers pointing to source contacts that were merged into this contact
                    var mergeIdentifiers = contact.Identifiers.Where(x => x.Source == Sitecore.XConnect.Constants.MergeIdentifierSource);

                    if (mergeIdentifiers.Any())
                    {
                        // Build a list of ContactReference objects from the merge identifiers - the identifier
                        // string is the ID of a source contact
                        var mergedContactReferences = new List<ContactReference>();

                        foreach (var mergeIdentifier in mergeIdentifiers)
                        {
                            Guid id = Guid.Empty;

                            if (Guid.TryParse(mergeIdentifier.Identifier, out id))
                            {
                                ContactReference reference = new ContactReference(id);

                                mergedContactReferences.Add(reference);
                            }
                        }

                        // Get all contacts that were previously merged into this contact
                        var contactsTask = client.GetAsync<Contact>(mergedContactReferences.ToArray(), new ContactExpandOptions());

                        var contacts = await contactsTask;
                    }

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

        // Sync example
        public void ExampleSync()
        {
            using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {

                try
                {
                    // Get contact
                    Contact contact = client.Get<Contact>(new IdentifiedContactReference("twitter", "myrtlesitecore"), new ContactExpandOptions());

                    // Get all identifiers pointing to source contacts that were merged into this contact
                    var mergeIdentifiers = contact.Identifiers.Where(x => x.Source == Sitecore.XConnect.Constants.MergeIdentifierSource);

                    if (mergeIdentifiers.Any())
                    {
                        // Build a list of ContactReference objects from the merge identifiers - the identifier
                        // string is the ID of a source contact
                        var mergedContactReferences = new List<ContactReference>();

                        foreach (var mergeIdentifier in mergeIdentifiers)
                        {
                            Guid id = Guid.Empty;

                            if (Guid.TryParse(mergeIdentifier.Identifier, out id))
                            {
                                ContactReference reference = new ContactReference(id);

                                mergedContactReferences.Add(reference);
                            }
                        }

                        // Get all contacts that were previously merged into this contact
                        var contacts = client.Get<Contact>(mergedContactReferences.ToArray(), new ContactExpandOptions());
                    }

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