Contents
Identification Key
Purpose
Describes the Identification Key Resource.
Description
The Identification Key is a combination of attributes used to identify a customer. These attributes (one or more) belong to the Customer Profile or to its extensions. Your application is responsible for creating the identification keys that are alter use to identify customers. See Create Identification Key for further details.
Some identification key samples:
- An identification key consisting of attributes "name" and "birthdate" in the Profile.
- A key based on attribute "pin" of a single-valued extension used to hold customer pass codes.
- A key based on attribute "number" of a multi-valued extension used to record the phone numbers we have seen a customer call from.
When the UCS receives a new customer profile and the associated extension data, it builds the indexing structures based on the specified identification keys, in order to ensure efficient customer identification.
Resource
Field | Type | Mandatory | Description |
---|---|---|---|
name | string | yes | The unique, case-insensitive name of the key. The name must start with a letter, and can be followed with letters, numbers, or underscores. The name is restricted to a maximum of 26 characters. (Maximum RDBMS shared limit on creation of index.) |
source | string | no | Can take on one of the following values:
|
attributes | string[] | yes | The array names of one or more attributes of the extension or of the profile. |
unique | bool | no |
|
Example
The following identification key is a phone number.
{ "name": "idPhone", "attributes": ["phone_number"]}
The following sample defines "FirstName" and "LastName" as a "primary key" instead of "indexed key".
{"name":"idFirstNameLastName", "unique":true, "attributes":["FirstName","LastName"]}
The combination of both parameters is unique. If your application tries to insert twice the same values, the operation will return an error.