Provisioning of Email, Phone, and Username Attributes

The SuccessFactors source can provision the following attributes:

  • Business Phone

  • BusinessExtension

  • BusinessPhoneCountryCode

  • Username

  • PrimaryEmailAddress

The SuccessFactors source considers the user's primary email address and business phone number as primary modes of communication.

Configure the Connector to Provision Email, Phone, and Username Attributes

Provisioning the email address and phone number is based on the OData Queries that use the Picklist Option ID as an input.

Note

The picklist mapping is for the attribute update only. For multiple entries, press Enter to separate them. For example:

PrimaryEmailAddress=<Associated Picklist optionID>

BusinessPhone=<Associated Picklist optionID>

To enter picklist mappings of these attributes for provisioning:

  1. In the IdentityNow source configuration, go to Advanced Settings.

  2. In the Picklist Mapping field, enter the picklist mapping of attribute.

Attribute Configuration in the SuccessFactors Source

If you want to change the Picklist Option ID, update the picklistMapping attribute using the IdentityNow REST API:

POST <url>/sources/<sourceID>

Where:

  • <url> – The URL for the customer's IdentityNow instance

  • <sourceID> – The Source ID (number) obtained through the UI

In the body of the POST, use form-data as follows:

  • Key – connector_picklistMapping

  • Value – ["PrimaryEmailAddress=optionID","BusinessPhone=optionID"]

For example,

["PrimaryEmailAddress=8448","BusinessPhone=10605"]

Note
For more information on IdentityNow APIs, refer to Best Practices: IdentityNow REST API Authentication and IdentityNow REST API - Update Source (Partial) in the SailPoint Developer Community.

Attribute Synchronization and Target Mapping

You must get the source ID before synchronizing attributes. The source ID is displayed at the end of the URL in your browser address. The source ID is also known as the front-end ID for a source.

For more information, refer to Best Practices: Attribute Sync.

You can add the user name, phone numbers, and email attributes and map these source attributes to identity attributes.

Note
This API does not apply to flat file sources.

Then you can map those identity attributes to the SuccessFactors target system attributes using IdentityNow REST API:

POST <url>/sources/<sourceID>

Where: 

  • <url> – The URL for the customer's IdentityNow instance
  • <sourceID> – The Source ID (number) obtained through the UI

In the body of the POST, use form-data as follows:

  • Key – connector_featureString
  • Value – SEARCH, PROVISIONING, SYNC_ PROVISIONING, MANAGER_LOOKUP

Note
For more information on IdentityNow APIs, refer to Best Practices: IdentityNow REST API Authentication and IdentityNow REST API - Update Source (Partial) in the SailPoint Developer Community.

To get and set the attribute synchronization mapping:

  1. Make a GET request with the following command:

    GET <url>/sources/<source_ID>/attribute-sync-config

  2. Set the target value with the following command:

    PUT <url>/sources/<sourceID>/attribute=sync-config

To set up the PrimaryEmailAddress, BusinessPhone, and Username as target attributes, use the following command in the body :

Copy 
{

            "attributes": [

            {
            
            "name": "email",
            
            "displayName": "att_email",

            "enabled": true,

            "target": "PrimaryEmailAddress"

            },
            
            {
            
            "name": "workPhone",
            
            "displayName": "Work Phone Number",

            "enabled": true,

            "target": "BusinessPhone"

            },
            
            {
            
            "name": "uid",
            
            "displayName": "uid",

            "enabled": true,

            "target": "Username"

            },
            
            {
            
            "name": "PhoneCountryCode",
            
            "displayName": "PhoneCountryCode",

            "enabled": true,

            "target": "BusinessPhoneCountryCode"

            },
            
            {
            
            "name": "PhoneExtension",
            
            "displayName": "PhoneExtension",

            "enabled": true,

            "target": "BusinessExtension"

            };


            ]

        }