Addresses facet

Abstract

Guide to the Addresses facet and its properties in xDB Data Migration Tool.

In Sitecore 8.x, addresses are associated with a contact through a property on the contact. The name of the property is Addresses.

The following is an example the Addresses property on the contact:

"Addresses" : {
    "Preferred" : "home",
    "Entries" : {
        "home" : {
            "Country" : "United Kingdom",
            "City" : "Birmingham",
            "PostalCode" : "B45 8GW",
            "StreetLine1" : "10 Foundry Road",
            "Location" : {
                "Longitude" : -0.118092000484467,
                "Latitude" : 51.5098648071289
            }
        },
        "work" : {
            "Country" : "United Kingdom",
            "City" : "London",
            "PostalCode" : "W1T 4JE",
            "StreetLine1" : "15 Kingshire Abbey"
        }
    }
}

The Entries property is a dictionary. Each member of the dictionary has a key and a value. The key describes the address. The value is an object that contains the details of the address.

In addition to the Entries property, the Addresses object has another property named Preferred. The value is the key for one of the addresses.

In Sitecore 9, addresses are associated with a contact through a contact facet:

Facet Name

Addresses

Facet Type

Sitecore.XConnect.Collection.Model.AddressList

In Sitecore 9, the preferred address is stored separate from the other addresses, unlike in Sitecore 8.x where all addresses are stored in a single dictionary.

Facet Property

Description

PreferredEmail

Object that represents the preferred address

PreferredKey

Key for the preferred address

Others

Dictionary that contains all other addresses associated with the contact

Source object

Member of the dictionary located at Addresses.Entries on the contact document

Target object

Sitecore.XConnect.Collection.Model.Address

Mapping definition

MongoDB to xConnect Contact Mappings > MongoDB Address to xConnect Contact Address

Value to write to target object

Property on target object

City from source object

City

Country from source object

CountryCode

PostalCode from source object

PostalCode

StateProvince from source object

StateOrProvince

StreetLine1 from source object

AddressLine1

StreetLine2 from source object

AddressLine2

StreetLine3 from source object

AddressLine3

StreetLine4 from source object

AddressLine4