Concatenation

Overview

Use the concatenation transform to join two or more string values into a combined output. The concatenation transform often joins elements such as first and last name into a full display name, but it has many other uses.

Transform structure

The concatenation transform requires an array list of values that need to be joined. These values can be static strings or the return values of other nested transforms.

{
  "attributes": {
    "values": ["John", " ", "Smith"]
  },
  "type": "concat",
  "name": "Concatenation transform"
}

Top-level properties (required)

• type string (required)
  Must be set to concat.

• name string (required)
  The name of the transform as it will appear in the UI's dropdown menus.

• requiresPeriodicRefresh boolean (optional)
  Whether the transform logic should be reevaluated every evening as part of the identity refresh process. Default is false.

Attributes

The concatenation transform uses the following structure:

{
  "type": "concat",
  "name": "Transform Name",
  "attributes": {
    "values": ["string1", "string2", ...]
  }
}

---

attributes (required)

The attributes object contains the values to concatenate.

Required

• values array (required)
  An array of items to join. Items can be static strings or the return values of other nested transforms.

Examples

This transform joins the user's first name from the "HR Source" with his/her last name, adds a space between them, and then adds a parenthetical note that the user is a contractor at the end.

Transform request body:

{
  "attributes": {
    "values": [
      {
        "attributes": {
          "sourceName": "HR Source",
          "attributeName": "FirstName"
        },
        "type": "accountAttribute"
      },
      " ",
      {
        "attributes": {
          "sourceName": "HR Source",
          "attributeName": "LastName"
        },
        "type": "accountAttribute"
      },
      " (Contractor)"
    ]
  },
  "type": "concat",
  "name": "Test Concat Transform"
}

---

 

This transform joins the user's job title with his/her job code value and adds a hyphen between those two pieces of data.

Transform request body:

{
  "attributes": {
    "values": [
      {
        "attributes": {
          "sourceName": "HR Source",
          "attributeName": "JobTitle"
        },
        "type": "accountAttribute"
      },
      "-",
      {
        "attributes": {
          "sourceName": "HR Source",
          "attributeName": "JobCode"
        },
        "type": "accountAttribute"
      }
    ]
  },
  "type": "concat",
  "name": "Test Concat Transform"
}