Skip to content

Commit 9f335db

Browse files
committed
update usage guide to include info on batchable requests
1 parent c685297 commit 9f335db

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

docs/Usage_Guide.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ Once you have a connection, you can set up a rule using the `Add Rule` action. T
1515
- Method: The REST method to use.
1616
- URL Parameters: A map of URL parameters to use when sending the REST request. If you want to use the value, timestamp, or status of an update in the params, use the placeholders `%VALUE%`, `%TIMESTAMP%` and `%STATUS%`.
1717
- Body: The body of the REST request, if applicable. Once again, use `%VALUE%`, `%TIMESTAMP%` and `%STATUS%` as placeholders.
18+
- Note: If the REST API supports recieving multiple updates in one message, you can use `%STARTBLOCK%` and `%ENDBLOCK%` to denote the boundaries of a repeatable block. When needing to send many updates at once (in the case of having to catch up after a disconnect), the DSLink will repeat the block for each update and use commas to separate the blocks. Note that this will only work if all value, timestamp, and status placeholders are in the body and inside the repeatable block.
1819
- Minimum Refresh Rate: Optional, ensures that at least this many seconds elapse between updates. This means that the DSLink will suppress updates that are too close together. (Leave this parameter as 0 to not use this feature.)
1920
- Maximum Refresh Rate: Optional, ensures that an update gets sent every this many seconds. This means that if the DSA value updates too infrequently, the DSLink will send duplicate updates. (Leave this parameter as 0 to not use this feature.)
2021
## Add a Rule Table
@@ -40,10 +41,12 @@ If you want to set up multiple rules in bulk, create a table of Rules in Atrius
4041
},
4142
"data": {
4243
"<BuildingOS meter id>": [
44+
%STARTBLOCK%
4345
[
4446
"%TIMESTAMP%",
4547
%VALUE%
4648
]
49+
%ENDBLOCK%
4750
]
4851
}
4952
}
@@ -56,10 +59,12 @@ e.g:
5659
},
5760
"data": {
5861
"b9c7c0a03de611e895505254009e602c": [
62+
%STARTBLOCK%
5963
[
6064
"%TIMESTAMP%",
6165
%VALUE%
6266
]
67+
%ENDBLOCK%
6368
]
6469
}
6570
}

0 commit comments

Comments
 (0)