IdentityNow Transforms - Reference

IdentityNow Transforms - Reference

Overview

The reference transform allows you to re-use a transform that has already been written within another transform. This can come in handy when you have the same logic that you would like to repeat multiple times within other transforms; it allows you to maintain only one transform and have that propagate through to other implementations of that logic.

Other Considerations

  • N/A

 

Transform Structure

The structure of a reference transform requires the id of the transform that you want to reference, in addition to the standard type and name attributes that are required for all transforms:

Example

{
  "attributes": {
    "id": "Build Display Name"
  },
  "type": "reference",
  "name": "Test Reference Transform"
}

Attributes

  • Required Attributes

    • type - This must always be set to reference
    • name - This is a required attribute for all transforms, and represents the name of the transform as it will appear in the UI's dropdowns
    • id - This ID specifies the name of the pre-existing transform which you want to use within your current transform
  • Optional Attributes

    • requiresPeriodicRefresh - A true or false value that indicates whether the transform logic should be re-evaluated every evening as part of the identity refresh process.
    • input - This is an optional attribute that can explicitly define the input data which will be fed into the transform logic. If input is not provided, the transform will take its input from the source and attribute combination configured via the UI.

 

Examples

Example 1

{
  "attributes": {
    "id": "Get Worker Type"
  },
  "type": "reference",
  "name": "Test Reference Transform"
}

Supposing you had a "Get Worker Type" transform that evaluated multiple pieces of data to determine whether a user were an employee or a contractor, this transform would output the result of that transform just as if the logic were contained directly within this transform.

Example 2

{
  "attributes": {
    "values": [
      {
        "attributes": {
          "id": "Get Display Name"
        },
        "type": "reference"
      },
      " - ",
      {
        "attributes": {
          "id": "Get Worker Type"
        },
        "type": "reference"
      }
    ]
  },
  "type": "concat",
  "name": "Test Reference Transform"
}

The above transform builds the user's display name, adds a hyphen to the end, and then adds the evaluated worker type from our previous example to build a string that might look like, "John Smith - Employee."

 

References

  • N/A
Version history
Revision #:
3 of 3
Last update:
‎Dec 09, 2021 05:15 PM
Updated by:
 
Contributors