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"
}