On Demand Migration Current - Active Directory - Directory Sync Advanced Mapping Guide

Action

• Purpose: Action - returns action currently to be taken for this object ("create", "update", or "delete")

• Syntax: Action = "create"

• Example: Although action could be used within other functions such as case or if, its typical use will be for a condition. In this case we will set the UPN only on create

  Target Attribute    : userPrincipalName

  Value        : userPrincipalName

  Condition    : action = "Create"

result

• Purpose: Returns the calculated mapped value of the given attributeName (must be a string)

• Syntax: result("attributeName")

• Example: Result is used to gather the value of a mapping which contains a function. This example gathers the results of what the function of the "mail" attribute will be the default value/function for the mail attribute is if(GetObjectClass()="group", ReplaceDomain(WindowsEmailAddress, Profile.TargetDomain), WindowsEmailAddress). The alternative for using result("mail") would be to use the entire function which is present in the mail attribute mapping. The result command allows you to link more complex functions.

  Target Attribute    : proxyAddresses

  Value        :
  
  GetProxyAddresses(result("mail"), LegacyExchangeDN, result("legacyExchangeDN"))

  Condition    : Null

Target.HasCreateStamp

• Purpose    : This value is an internal value which determines if Directory Sync created the object being synchronized. This value verifies the "created by Dirsync" text is present on the correct attribute for the target object type.  

• Syntax    :  Target.HasCreateStamp

• Example: You want to set the UserAccountControl value for only objects created by Directory Sync.

  Target Attribute    : userAccountControl

  Value        : GetUserAccountControl()

  Condition    : Action = "create" or (Action = "update" and Target.HasCreateStamp)

ConvertValue("base64STR", objectGUID)

• Purpose: This function is used for syncing ms-DS-ConsistencyGuid, which is an attribute that cannot be directly migrated with a standard mapping. This function can also be used to set the ImmutableID on a cloud object when merging with a local AD object as part of a B2B user conversion process.

• Syntax: ConvertValue("stringtype",objectGUID)

• The only string type currently available is base64STR

• Example: ConvertValue("base64STR", objectGUID)