TOML–JSON Converter – Documentation

Overview

The TOML–JSON Converter is an Integration Studio component for OutSystems that provides utilities to convert:

• TOML → JSON

• JSON → TOML

• Also supports file-based TOML input using binary files.

Built using C# and embedded into OutSystems through an extension, this utility simplifies data conversion across formats used in configuration files and data pipelines.

Installation

1. Download & Install the Component:

   • Download and install the component from Outsystems Forge

2. Reference the Module

   • In Service Studio, add a reference to the published component module.

   • Expose the required public actions in your logic.

Exposed Server Actions

1. ConvertTOMLToJSON(tomlString: Text): Text

Converts a TOML string to a JSON string.

2. ConvertJSONToTOML(jsonString: Text): Text

Converts a JSON string to TOML.

3. ConvertTOMLFileToJSON(tomlBinaryData: BinaryData): Text

Takes a binary TOML file and returns the converted JSON.

Dependencies

• No external dependencies required.

• Uses the open-source Tomlyn C# library internally.

Limitations

• Handles valid TOML 1.0 formats.

• Large files may require buffer adjustments in integration studio for memory handling.

Support

For issues, raise a question in the Forge component’s support tab or contact me via OutSystems community.