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
- Select Formula as the expression type plugin.
- Enter your convert expression in the 'Expression' text area.
- 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
Related Topics
- Expression Type Plugins are used in Search Fields
- What are Search Fields?
- What are Search Field Expressions?
- What are Message Types?
- What are Log Views?