Data Rules Reference to Customize and Transform Identity ...

Quoted on this wiki

Every place a page here uses this source, in the order the words come in it.

1. Authoritative Source Identity Object Attributes for Outbound Transformation “You can modify or alter the outbound data by applying data transformation rules to the data available or provisioned into the Orchestrated system.” Syntax to Fetch Identity Attributes for Outbound Data

   In CRM data standardization

2. Transformation Utilities for Inbound Data Transformation “Apply utility methods to perform transformation tasks such as validating values, retrieving users, checking attribute availability, and working with lookup mappings. Available only for Authoritative Sources.” Usecase Utility Method Get a target lookup code value lookupTarget.getLookup('jobCode', user.getJobCode()) Get a target lookup code object. Used when user.getJobCode() returns a code such as IC0002. lookupTarget.getLookupObject('jobCode', user.getJobCode()) Get a target lookup decode object. Used when user.getJobCode() returns a descriptive value such as 'Software Developer'. lookupTarget.getLookupObjectByName('jobCode', user.getJobCode()); Get a global lookup code value lookupGlobal.getLookup('country', 'US'); Get a global lookup code object. lookupGlobal.getLookupObject('country', 'US'); Check whether a specific value is available for an attribute name. Returns true if the value isn't associated with the specified attribute. checkValue.IsAvailable('attributeName', 'value') For example, check whether the value '[email protected]' is already associated with the attribute primaryEmail. Returns true if the value isn't currently associated with the specified attribute. checkValue.isAvailable('primaryEmail','[email protected]') Checks whether the user's primary email is available for the primaryEmail attribute and returns the primary email if available, otherwise returns the display name. if(checkValue.isAvailable('primaryEmail', user.getPrimaryEmail())) { user.getPrimaryEmail() } else { user.getDisplayName() } Check whether a value is null or empty. Returns true if user.getDisplayName() is null or contains an empty value. fn.isEmpty(user.getDisplayName()) Fetch a user object based on a specific attribute name and value. Returns a User Object. var tempUser = transformationUtil.getUser('attributeName', 'value'); For example: var tempUser = transformationUtil.getUser('username', user.getDisplayName()); The returned object attributes can be accessed using Get methods, such as tempUser.getDisplayName(), tempUser.getEmail().

   In Enrichment APIs and integrations

3. Here are a few mapping rule expressions along with input value or output value for the account object attributes. “primaryEmail DEFAULTS String Concatenate userLogin & "@myexample.com" and set in primaryEmail. account.getUserLogin().concat('@myexample.com') userLogin = mark.hill [email protected]”

   In Lead enrichment workflows

4. Objects “Attribute values for an outbound data transformation can be derived from the following objects:” Object Name Purpose Example requestAttributes Provisioning request Attribute Object. These attributes are available when provisioning is via policy based, access bundle request, role based, or direct methods. requestAttributes.get('name') user User Object. Use required getter on this to access any member. user.getName().getGivenName(), user.getUserName() application Resource Object. Use required getter on this to access any member. application.getDisplayName()

   In Outbound CRM data model