mono/packages/osrl/examples/google-sheets.md
2025-12-30 16:33:03 +01:00

54 lines
1.3 KiB
Markdown

# Support for Google - Sheets
Reading values from Google sheets can be done as follows
```liquid
{% googlesheet 'MY_DATASOURCE', id: '1oVEiGH4o3SV-mAA3Mb-WNVJMyYl4VMxLjWjrSw_ipJY', range: 'Parts!B4:B5', path:'$', assign:'TEST_VAR' %}
{% for item in TEST_VAR %}
{{item}}
{% endfor %}
```
**Parameters**
- 'MY_DATASOURCE' : is just a name, currently used to cache the connection for later usage
- ```'id'``` : the Google Sheet ID (see browser address bar)
- ```'range'``` : the range in the sheet, eg: 'NamedField', or a particular range on a specific sheet : 'Parts!B4:B5'
- ```'path'``` : optional, a jsonpath query (check [jsonpath online editor](https://jsonpath.com/))
- ```'assign'``` : optional, assign the result to a new variable. in this case, the tag returns nothing !
**Example** [see source in './google-sheet-source.md'](./google-sheet-source.md)
**Output**
```markdown
Template Start
JS Expression Result : 4
JS Result : cool ! my_number = 2
JS Expression Result : { "Some Invalid Expression" | jsexp }
JS Expression Result 1Kg to lb : 2.2046244201837775
JS Expression Result : Uh
JS Expression Result : 3
## Custom tags
### Google - Sheet - Range with iterator
120x60 x 3
120x60
### Google - Sheet - single value
Google Sheet Named Value: 479
Template End
```