We often got the feedback that the difference between using a JSON Path and a Converter was not quite clear. This is because they essentially do the same thing: unpacking the result of a REST Query. The difference being that Converters a much more powerful, flexible, and intuitive than the not so well known JSON Path syntax. Everything that can be done with a JSON Path can also be done with a Converter, but not the other way around. For this reason, we decided to deprecate the JSON Path and make Converters the clear choice.

So, how does one migrate from a JSON path to a Converter? It's actually quite simple. Given the following JSON path:


You can just use this Converter code instead:

function convert(json) {
    var $ = JSON.parse(json);
    return $.results[0].something;

This does exactly the same as the JSON Path, while giving you the ability to easily extend your Converter with more logic in the future, which wouldn't be possible with a JSON Path.

If you have any problems with this, please raise a ticket at our ServiceDesk.