Name: Concatenate
Description: Concatenates the values of a collection data item into a delimited string.
Known Issue: The function's calculation is delayed by one activity. You will not see the concatenated result until the activity after the activity populating the values being concatenated is complete. |
BluespringExt.Concatenate(collection, element, delimiter)
Important: This syntax and function are only supported when used in a calculation data item.
You cannot use this function in an expression on the Data Item Assignments tab. |
collection: Name of the collection data item.
Note: The context of the data item matters:
You can concatenate values of process data item containing a collection of items within a process data item and you may concatenate values of a solution data item containing a collection of items within a solution data item. But you cannot concatenate from a process data item to a solution data item nor from a solution data item to a process data item.
element: Refers to the element in the collection you want to concatenate.
Note: Elements below groups in the collection cannot be concatenated. Only non-group elements under the root data model element can be concatenated.
delimiter: a comma, or the pipe, or any other character or set of characters |
Best Practice: the known issue occurs because BPM5 does not recognize anything changed relative to the function. By referencing the Collection in the Expression, we ensure that we evaluate the Expression as soon as the Collection is populated.
Modeled Data Item: Employees (Is Collection? Yes.)
Data Model Element: EmployeeName
Delimiter: comma
If(Not(IsNull(Process.DataItems.Employees)), BluespringExt.Concatenate("Employees","EmployeeName",",")
|
Name: Encode XML Characters
Description: Replace the XML reserved characters: quote ", apostrophe ', less than <, greater than >, and ampersand & so they can be used in an XML string within an Activity
Use Case: Use this function to build complex XML inputs for the Invoke Web Service Activity |
BluespringExt.XmlEncode (string) |
string: a single string, in which you wish to encode XML reserved characters for use within an Activity, such as Invoke Web Service |
String: Process.DataItems.XmlInput
BluespringExt.XmlEncode(Process.DataItems.XmlInput) |
Name: Decode XML Characters
Description: Return encoded values of the XML reserved characters: quote ", apostrophe ', less than <, greater than >, and ampersand & to their text values
Use Case: Use this function to decode complex XML outputs from the Invoke Web Service Activity |
BluespringExt.XmlDecode (string) |
string: a single string, from which you wish to decode XML reserved characters for use within BPM 5 |
String: Process.DataItems.XmlResponse
BluespringExt.XmlDecode(Process.DataItems.XmlResponse) |
