openhab-addons/bundles/org.openhab.transform.jinja/README.md
Kai Kreuzer 6df6783b60 added migrated 2.x add-ons
Signed-off-by: Kai Kreuzer <kai@openhab.org>
2020-09-21 03:37:19 +02:00

38 lines
1.1 KiB
Markdown

# Jinja Transformation Service
Transforms a value using a jinja template.
The main purpose of this transformer is the use in the home assistant discovery. Therfore not all features of the home assistant templating are supported.
Basically on [Processing incoming data](https://www.home-assistant.io/docs/configuration/templating/#processing-incoming-data)
## Available variables
| Variable | Description |
|------------|------------------------------------|
| value | The incoming value. |
| value_json | The incoming value parsed as JSON. |
## Examples
### Basic Example
Given the value
```
{"Time":"2019-01-05T22:45:12","AM2301":{"Temperature":4.7,"Humidity":93.7},"TempUnit":"C"}
```
the template
::: v-pre
`{{value_json['AM2301'].Temperature}}`
:::
extracts the string `4.7`.
## Further Reading
* Wikipedia on [Jinja](https://en.wikipedia.org/wiki/Jinja_(template_engine).
* Home assistant [discovery](https://www.home-assistant.io/docs/mqtt/discovery/).
* Home assistant [templating](https://www.home-assistant.io/docs/configuration/templating/).