Transform

Maps input json using JUST.Net library.

Task version: 1.1.0

Required Frends version: 5.7+

Required .NET version: 8.0

Compatible Agents: Crossplatform

Source code: https://github.com/FrendsPlatform/Frends.CrossplatformJSON/tree/main/Frends.JSON.Transform

Task Parameters

Input

Name	Description
InputJson : Object	Map input json in String or JToken type Default: {"name":"veijo"} Example: {"name":"veijo"}
JsonMap : String	JUST json map. See: https://github.com/WorkMaze/JUST.net#just Default: {"firstName":"#valueof($.name)"} Example: {"firstName":"#valueof($.name)"}

Options

Name	Description
ThrowErrorOnFailure : Boolean	If true, an exception is thrown on failure. If false, the error details are returned in the Result instead. Default: True Example: true
ErrorMessageOnFailure : String	Custom error message to include when a failure occurs. Leave empty to use the original exception message. Default: - Example: Transform failed due to invalid input

Task Result

Name	Description
Success : Boolean	Indicates whether the task completed successfully. Example: true
Transformation : String	Transformation result as string Example: "{"firstName":"veijo"}"
JToken : Object	Transformation result as JToken Example: {"firstName": "veijo"}
Error : Error	Error details when the task fails and ThrowErrorOnFailure is false. Null on success. Example: { Message = "Json transformation failed: ...", AdditionalInfo = System.Exception }
Error.Message : String	Human-readable error message describing what went wrong. Example: Json transformation failed: ...
Error.AdditionalInfo : Exception	The original exception that caused the failure. Example: System.FormatException: Input Json is not valid: ...

Task Changelog

Changelog for Task Frends.JSON.Transform.

[1.1.0] - 2026-07-20

Changed

• The task now targets .NET 8.
• Added an Options parameter that lets you control error handling: set Throw error on failure to false to receive errors as a result value instead of an exception. The result now includes Success and Error fields.
• Added cancellation support so the task can be stopped when running in a Frends process.

[1.0.2] - 2022-11-2

Fixed

• Updated dependency Newtonsoft.Json from 13.0.1 to 12.0.1
• Change JUST.NETcore to JUST.NET version 4.2.0

[1.0.1] - 2022-10-31

Fixed

• Changed the Result JToken to be dynamic to enable dot notation
• Changed input parameter field default DataFormatString to Json
• Updated documentation
• Fixed tests

[1.0.0] - 2022-04-06

Added

• Initial implementation