Adding Profile Properties (Pre-Sitecore 9)

The properties should be defined by adding the following element to the properties section:

<add type="System.String" name="<property_name>" customProviderData="S4S|[contact_attribute_schema_name]|[propertyType]"/>

Or to add lead properties:

<add type="System.String" name="<property_name>" customProviderData="S4S|[lead_attribute_schema_name]|[propertyType]"/>

The table below explains each attribute of this definition:

Attribute

Description

Name

The unique name of a property.

Type

The .NET type of a property. This is the type a property will have in the ASP.NET environment.

Typically all S4S properties will have “System.String” as the type to correctly display in the Sitecore Edit User Profile screen.

customProviderData

Any data required for the provider serving this property. In this case, S4S means that this property is to be handled by the S4S provider. The contact_attribute_schema_name  or lead_attribute_schema_name  specifies the name of the corresponding Salesforce contact or lead entity attribute. The propertyType defines the type of the contact or lead property. The S4S provider expects the pipe separator (|) between the attribute parts.

readOnly[Optional]
Set to "true" to prevent changes for this property being written back to Salesforce. Defaults to "false".
This property is useful if the corresponding Salesforce data can't be updated, such as a Person Accounts AccountId 

The S4S profile provider expects the following values for the propertyType attribute:

  • String; represents the ‘string’ Salesforce type
  • Boolean; represents the ‘boolean’ Salesforce type
  • DateTime; represents the ‘dateTime’ Salesforce type
  • Float; represents the ‘float’ Salesforce type
  • Number; represents the ‘int’ Salesforce type
  • Money; represents the ‘currency’ Salesforce type

Note: This list of Salesforce types is a full list of supported types; no more types are expected to be supported in the current module version. See the full list of Primitive Data Types at http://www.salesforce.com/us/developer/docs/api/Content/primitive_data_types.htm

Next Step

Extending the Sitecore Profile Item Template (Pre-Sitecore 9)

Steps