Skip to content

Data Operations ​

Converts or transforms a value between formats — including JSON, XML, Base64, URL encoding, dates, numbers, and HTML — and stores the result in a named output variable.

Purpose ​

Use Data Operations whenever a workflow needs to change the shape or encoding of a value without writing custom logic. Typical scenarios include serialising an object to JSON before sending it in a web request, decoding a Base64 payload received from an API, reformatting a date string to match a downstream system's expected format, or converting an XML response to an object the workflow can navigate.

Inputs ​

FieldTypeRequiredDescription
OperationDropdownYesThe conversion to perform. See the Operations table below.
Input ArrayTextNoThe array of strings to join. Visible when Operation is JoinStringArray.
DelimiterTextNoThe separator character used when joining or splitting. Visible when Operation is JoinStringArray or SplitString.
Input StringTextNoThe text value to encode, decode, split, or convert. Visible when Operation is SplitString, Base64Encode, Base64Decode, UrlEncode, UrlDecode, StringToDate, StringToNumber, HtmlEncode, or HtmlDecode.
Input JSONTextNoThe JSON string to deserialise or convert. Visible when Operation is JsonToObject, JsonToXml, or JsonToDynamic.
Input XMLTextNoThe XML string to convert. Visible when Operation is XmlToJson.
Input ObjectTextNoA variable reference to the object to serialise. Visible when Operation is ObjectToJson.
Input DateDate / TimeNoThe date value to format as a string. Visible when Operation is DateToString.
Date FormatTextNoA .NET date format string (e.g. yyyy-MM-dd, o). Visible when Operation is DateToString or StringToDate.
Input NumberTextNoThe numeric value to convert. Visible when Operation is NumberToString.
Target TypeTextNoThe .NET type name to deserialise into (e.g. Dictionary<string,object>). Visible when Operation is JsonToObject.
Output Variable NameTextYesThe name of the workflow variable that will hold the result.

Visibility Rules ​

Input Array and Delimiter are visible when Operation is JoinStringArray. Delimiter is also visible when Operation is SplitString. Input String is visible when Operation is SplitString, Base64Encode, Base64Decode, UrlEncode, UrlDecode, StringToDate, StringToNumber, HtmlEncode, or HtmlDecode. Input JSON is visible when Operation is JsonToObject, JsonToXml, or JsonToDynamic. Input XML is visible when Operation is XmlToJson. Input Object is visible when Operation is ObjectToJson. Input Date is visible when Operation is DateToString. Date Format is visible when Operation is DateToString or StringToDate. Input Number is visible when Operation is NumberToString. Target Type is visible when Operation is JsonToObject.

Operations ​

OperationDescription
JoinStringArrayJoins an array of strings into a single string using the specified delimiter.
SplitStringSplits a string by the specified delimiter into an array of strings.
ObjectToJsonSerialises an object into its JSON representation.
JsonToObjectDeserialises a JSON string into an object. Optionally accepts a Target Type for strongly typed deserialisation.
JsonToDynamicDeserialises a JSON string into a native dictionary or list structure without requiring a target type.
Base64EncodeEncodes a UTF-8 string to Base64.
Base64DecodeDecodes a Base64 string back to UTF-8 text.
UrlEncodeApplies percent-encoding to a string for safe use in a URL.
UrlDecodeDecodes a percent-encoded URL string.
XmlToJsonParses an XML string and converts it to a JSON-compatible object.
JsonToXmlConverts a JSON string to an XML document string.
DateToStringFormats a DateTime value using the specified Date Format string.
StringToDateParses a string into a DateTime using the specified Date Format string.
NumberToStringConverts a numeric value to its string representation.
StringToNumberParses a numeric string into a number.
HtmlEncodeEncodes special characters in a string as HTML entities.
HtmlDecodeDecodes HTML entities in a string back to their literal characters.

Outputs ​

The result is stored under the name provided in Output Variable Name. The type of the stored value depends on the operation: a string for encoding/decoding operations, an object or dictionary for JSON/XML conversions, an array for SplitString and JoinStringArray, a number for StringToNumber, and a DateTime for StringToDate.

Examples ​

Join an array into a delimited string
FieldValue
OperationJoinStringArray
Input ArrayStringOps1
Delimiter,
Output Variable NameJoinedNames
Resultalice, bob, carol
Encode a string to Base64
FieldValue
OperationBase64Encode
Input StringHello
Output Variable NameEncodedValue
ResultSGVsbG8=
Format a date for display
FieldValue
OperationDateToString
Input Date2025-06-02T15:04:05Z
Date Formatyyyy-MM-dd HH:mm:ss
Output Variable NameFormattedDate
Result2025-06-02 15:04:05

Tentech