- 20 Dec 2023
-
DarkLight
-
PDF
concat (string)
- Updated on 20 Dec 2023
-
DarkLight
-
PDF
Task Purpose
The string concat task is used to combine strings. Essentially, this task can concatenate strings or an array of strings that may consist of one or more values. This task does not provide you with the ability to reorganize the array, or iterate through the array.
Potential Use Case
Use this task if you need to append one or more string values to the end of another string. The concatenated result will return a new string that contains the combined strings. For example, if you need to append some data records, you could potentially use concat to lay the groundwork to compile the results. Let's say you have a notification message that needs to be appended, the concat method could potentially be used to generate the new combined message.
Note: The concat task does not change the value of the original string.
Task Properties
Incoming | Type | Description |
---|---|---|
str |
String | Required. The first string to concatenate (add to). |
stringN |
Array or String | Required. A string or array of strings to concatenate (add to) to the str value. |
Outgoing | Type | Description |
---|---|---|
combinedStrings |
String | The combined string that results from adding the value of stringN to str (in order as presented in the array). |
How to Configure the Task
Example 1
In this IAP example:
- The
str
variable has been statically set toHello World
. - The
stringN
array has been populated with a single item:you will have high success today
.- Notice the enclosure of the
stringN
value within square brackets to indicate an array. - Also notice the comma that follows the first double quote. The comma is not required, but is used for the mere purpose of sentence structure. It is important to know that the concatenation process does not add spaces or other characters between the two variables.
- Notice the enclosure of the
- The outgoing
combinedStrings
variable will have the value ofHello World, you will have high success today
.
Figure 1: Input String
Figure 2: Input Array
Figure 3: Output
Example 2
In this second example:
- The
str
variable has been statically set toHello World
. - The
stringN
array has been populated with two items enclosed within square brackets:you will have high success today
andgo forth and prosper
.- Notice that both items in the
stringN
value are enclosed within square brackets to indicate an array. - Again, the punctuation is not required but used in this example for purposes of sentence structure in the outgoing result. The concatenation process does not add spaces or other characters between variables.
- Notice that both items in the
- The outgoing
combinedStrings
variable will have the value ofHello World, you will have high success today, go forth and prosper
.
Figure 4: Input Array Items
Figure 5: Output Variable
Related Information
For more related information on the concat (string) task, see the concat (string) API reference.