# Render Formatted Data
This is a data presentation log filter - meaning that this filter doesn’t alter the log output from the job step it’s applied to; instead, it adds some metadata to the logs allowing Rundeck to render it in sanitized HTML by use of Content Converter Plugins. This is particularly useful to display the return values of scripts and API calls.
Output will be an HTML table with the data formatted appropriately.
First, ensure that the job step is returning output that is able to be parsed by one of the filter datatypes. If the job output will be entirely the expected datatype, then set the Data Type field in the log filter to the appropriate type. Otherwise, Rundeck expects a prefix and suffix to the parsable data. To mark a section of output with a datatype, echo this marker defining it:
<datatype> with one of the supported data types.
You can mark the section as ending by echoing the line below. Otherwise, when the step ends the plugin will treat it as ended.
application/x-java-propertiesJava Properties (synonyms:
# Use for all output
You can also choose a value for the
Data Type property, to preset
a datatype to use for the entire output log data. If this is set, then
no "BEGIN" marker is looked for.
The data can then be rendered in the Rundeck Log output GUI. The specific renderer for the data type is determined by available ViewConverter plugins.
For example, you can emit JSON data, and prefix it with:
Then emit json data (only)
Then END the datatype:
The log output will then capture all of the JSON data in a single
log event, and mark it as
application/json data type.