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"
}
Attributes
- Required Attributes
- type - This must always be set to
concat
. - name - This is a required attribute for all transforms. It represents the name of the transform as it will appear in the UI's dropdown menus.
- values - This is the array of items to join.
- type - This must always be set to
- Optional Attributes
- requiresPeriodicRefresh - This
true
orfalse
value indicates whether the transform logic should be reevaluated every evening as part of the identity refresh process.
- requiresPeriodicRefresh - This
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"
}