1. Contacts

Addresses facet

Version:

Format in Sitecore 8.x

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.

Format in Sitecore 9

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

Facet NameAddresses
Facet TypeSitecore.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 PropertyDescription
PreferredEmailObject that represents the preferred address
PreferredKeyKey for the preferred address
OthersDictionary that contains all other addresses associated with the contact

Mapping address properties

Source objectMember of the dictionary located at Addresses.Entries on the contact document
Target objectSitecore.XConnect.Collection.Model.Address
Mapping definitionMongoDB to xConnect Contact Mappings > MongoDB Address to xConnect Contact Address
Value to write to target objectProperty on target object
City from source objectCity
Country from source objectCountryCode
PostalCode from source objectPostalCode
StateProvince from source objectStateOrProvince
StreetLine1 from source objectAddressLine1
StreetLine2 from source objectAddressLine2
StreetLine3 from source objectAddressLine3
StreetLine4 from source objectAddressLine4
If you have suggestions for improving this article, let us know!