Writing a Mapping Rule File - RapidIdentity Platform Documentation

RapidIdentity Platform Documentation

Solution
Application
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US

A mapping rule file defines how the provisioning system transfers source attributes to target attributes during provisioning. Each file identifies the rule, declares the entity type, and lists one or more assignment rules.

Requirements
  • The identifier of the adapter the rule is associated with
  • The source system field names and the target RapidIdentity attribute names to map
  1. In ID Hub, select an adapter.
  2. In the Mappings tab, select the mapping you want to write the mapping rule for.
  3. Define the rule identifier with the ruleID keyword. For example:
    ruleID = ed917774-05d6-440f-b07f-7b7808e7aa24
  4. Declare the entity type with the ruleType keyword. For example:
    ruleType = person
  5. Add an assignment rule for each attribute to map, using the let keyword.

    Each assignment rule sets a target attribute to a source value. The following rule assigns the target field idautoPersonStuID the value from the source field sourcedId:

    let idautoPersonStuID = sourcedId

    For conditional mappings, string operations, and built-in functions, see Mapping Rule Expressions.

  6. Verify that the completed file contains the rule identifier, the entity type, and all required assignment rules. For example:
    ruleID = ed917774-05d6-440f-b07f-7b7808e7aa24
    ruleType = person
    let employeeType = role
    let givenName = givenName
    let mail = email
    let idautoPersonMiddleName = middleName
    let idautoPersonStuID = sourcedId
    let idautoPersonSchoolCodes = orgSourcedIds
    let sn = familyName

The mapping rule file defines how the provisioning system maps source attributes to the RapidIdentity Cloud Schema for the specified entity type.