- 2 minutes to read

convert Formula function

Easily convert string encodings in your integration data using the Nodinite convert Formula plugin. This page shows you how to transform data between different character encodings, ensuring your business systems communicate seamlessly.

✅ Instantly convert data between encodings for accurate integration
✅ Use simple expressions to transform message Content or Context values
✅ See clear, real-world examples with input, formula, and result


What does the convert Formula do?

The convert('source encoding', 'target encoding', Content) Formula function transforms any string from a specified source encoding to a target encoding. This is essential when integrating systems that use different character sets, ensuring your data is always readable and accurate.


Example: Fixing Garbled Characters

Suppose you receive a message with incorrectly displayed characters due to encoding issues. Here’s how you can fix it:

Input

Skellefteå

Formula Expression

convert('iso-8859-1', 'UTF-8', body)

Result

Skellefteå

Example: Convert Context Value Encoding

Input

Malmö

Formula Expression

convert('UTF-8', 'iso-8859-1', context('CityName'))

Result

Malmö

Features

  • Convert any string from a source encoding to a target encoding
  • Works with message body, context, or results from other Formula functions
  • Ensures data integrity across integrated systems

Important

The convert plugin loads the entire message into RAM. Only use this function on small messages to avoid performance issues.


How to use the convert Formula

  1. Select Formula as the expression type plugin.
  2. Enter your convert expression in the 'Expression' text area.
  3. Provide a string-based Content parameter (e.g., message body, context value, or another formula result).

Syntax

  • Convert from message body:
    convert('source encoding', 'target encoding', body)
  • Convert from message context:
    convert('source encoding', 'target encoding', context('MessageContextKey'))
  • Convert result from another formula:
    convert('source encoding', 'target encoding', SomeOtherNestedFormulaFunction(Content))

Next Step

Learn more about related features:
How to Add or manage Search Fields
How to Add or manage Log Views