demus/openhab-addons
1
0
Fork 0
mirror of https://github.com/openhab/openhab-addons.git synced 2025-01-10 15:11:59 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md (#12168)

Browse Source 
Added outgoing data section
This commit is contained in:
digitlength 2022-02-05 19:44:45 +00:00 committed by GitHub
parent b76551f4d7
commit e872e14894
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 35 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
bundles/org.openhab.transform.jinja/README.md
View File

@ -14,22 +14,52 @@ Basically on [Processing incoming data](https://www.home-assistant.io/docs/confi
## Examples
### Basic Example
### Basic Examples
#### Incoming data
Given the value
```
```json
{"Time":"2019-01-05T22:45:12","AM2301":{"Temperature":4.7,"Humidity":93.7},"TempUnit":"C"}
```
the template
::: v-pre
`{{value_json['AM2301'].Temperature}}`
:::
```
{{value_json['AM2301'].Temperature}}`
```
extracts the string `4.7`.
#### Outgoing data
The JINJA transformation can be used to publish simple JSON strings through, for example, the HTTP Binding's `commandTransformation` parameter.
Say we have an String Item which holds the following value:
```
This is my string
```
Adding the following into the `commandTransformation` parameter of your HTTP Thing Channel
```
JINJA:{"msgtype":"m.text", "body":"{{value}}"}
```
will send the following string out of openHAB
```json
{"msgtype":"m.text", "body":"This is my string"}
```
`{{value}}` will be replaced by whatever the value of your Item is.
Note that if using \*.things files you must escape quotation marks, for example:
```
commandTransformation = "JINJA:{\"msgtype\":\"m.text\", \"body\":\"{{value}}\"}"
```
## Further Reading
* Wikipedia on [Jinja](https://en.wikipedia.org/wiki/Jinja_(template_engine).