Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This plugin was created to solve use cases where we need to perform post-processing of the JSON response of a JSON API call in before storing the data into a form or workflow variable. 

The configurations are exactly similar to the default bundled JSON Tool in Joget, just with an additional optional property to write bean shell a BeanShell script to format/modify the JSON response. The post-processed/formatted response is also returned at the end of the the execute() method for further integration use case.

This plugin works just like the default bundled JSON Tool in Joget, but with the following added abilities:-

  • with GET, PATCH, PUT, and POST methods.
  • Send files in POST method.
  • Receive file and store into a Joget form file upload.

...

Note
iconfalse

To learn how to configure the JSON Tool plugin, do see the KB page for for JSON API Tool.

This plugin's configuration is identical, only with the additional configurable properties below.

...

NameDescription
Enable Response FormattingWhen checked, you can start writing bean shell a BeanShell script to format/post-process the JSON response.
Script

The "Enable Response Formatting" property must be enabled in order to write bean shell the BeanShell script here.

Injected Variables:

  • data - This is a Map object of the JSON response from the JSON API call.

Expected Return Object:

It is expected to return a Map object that would later on be processed as configured to store to form and/or workflow variables.

Example:

Return the response only for the first item in a JSON array with the object name of "apps".

Code Block
languagejava
return data.get("apps")[0];

...

  • This sample app already includes the Enhanced JSON Tool plugin. So just import it into your Joget server and start using it.
  • The API Domain Whitelist / API IP Whitelist setting in General Settings needs to be configured to allow JSON API requests, in order for this sample app to work.

...