Jump to: navigation, search

Profile Attribute Schema

Prerequisites: You need to enable profiles in UCS.
Purpose: Describes a Profile Attribute schema.


Describes a Profile Attribute. Each attribute field of the profile corresponds to a recorded schema which details the attribute name, type, and content. Select in "Tenant" the item specific configuration, and under "Business Attributes" 'Contact Attributes'. Then, create a new Business Attribute Value. By default the new Attribute is of type string. To assign another type to the schema, in Annex, create a section "settings", and a key "type" with value "string" or "date".

Predefined Attributes Schema

Default Attributes visible in the Configuration Server are the following:

  • First Name (string)
  • Last Name (string)
  • Phone Number (string)
  • E-mail Address (string)
  • Title (string)

Default 'internal' Attributes (not visible in the Configuration Server) are the following:

  • LastCalledAgent_EmployeeID (string)
  • LastCalledAgent_TimeStamp (date)
  • PreferredAgent_EmployeeID (string)

Additional attributes are available for each active media defined in the Business Attribute "Media Type" of the Configuration Manager:

  • LCA_EmplID_<media> (string)
  • LCA_TimeStamp_<media> (date)
  • Pref_EmplID_<media> (string)

Attributes of type date/time are formatted in UTC ISO 8601: "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"
Example: "1981-03-17T02:00:00.000Z"


Field Type Mandatory Description
name string yes The name is unique for each attribute within the given profile.
  • Starts with a letter, and can be followed with letters, numbers, or underscores.
  • Is restricted to a maximum of 30 characters (Maximum RDBMS shared limit)
In profile attribute schemas, the name is not case-sensitive.
type token yes The attribute type, which can be one of the following types:
  • Boolean
  • String
  • Integer
  • Long
  • Double
  • Date
  • DateTime
  • Currency


  1. The constraints on these types (the minimum and maximum values supported for the integer type) vary with the RDBMS.
  2. Customer profiles are built on top of UCS' Contact Attributes, and support only String and DateTime attribute types. However, all attribute types are supported for profile extensions.
default numeric or string no Provides a default value for the attribute.
For numeric attributes, you do not need quotation marks. Quotation marks are for string, date, and datetime attributes. By default, the date/time format is ISO 8601 UTC:[YYYY]-[MM]-[DD]T[HH]:[mm]:[ss].[SSS]Z.
length integer no Reserved to attributes of type String. Defines the maximum number of characters for the string.
  • Default length is 256;
  • Maximum length is 4000.
encrypt Boolean no
  • false by default.
  • true if the server must encrypt the attribute value before saving it to the UCS database.
mandatory Boolean no
  • false by default;
  • true if the attribute is mandatory when inserting a new Profile Extension record.

Related Operation

This page was last edited on September 7, 2018, at 10:34.
Comments or questions about this documentation? Contact us for support!