Skip to content

Commit

Permalink
Update overview.md (#5)
Browse files Browse the repository at this point in the history
  • Loading branch information
richturner authored Aug 28, 2024
1 parent 4842dd2 commit f98f170
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion docs/user-guide/agents-protocols/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Regular assets are connected to agents by adding an `Agent Link` configuration i
Dynamic injection of the written or current attribute value is supported in generic protocols by using the dynamic value placeholder `%VALUE[:FORMAT]%`, this can be used in the `writeValue` of the `AgentLink` as well as in other supported places depending on the protocol, for example the HTTP protocol supports using this in the headers, query parameters and/or path. The `:FORMAT` is optional and uses the [java.util.Formatter](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Formatter.html), if not specified then built in value conversion is used to convert the value into a JSON string representation. e.g. `%VALUE:%.2f%`, `%VALUE%`

### Dynamic Time Injection
Dynamic injection of the current time is supported in generic protocols by using the dynamic time placeholder `%TIME[+/-PnDTnHnMn.nS][:FORMAT]%`, this can be used in the `writeValue` of the `AgentLink` as well as in other supported places depending on the protocol, for example the HTTP protocol supports using this in the headers, query parameters and/or path. The `+/-PnDTnHnMn.nS` and `:FORMAT` are optional where `+/-PnDTnHnMn.nS` uses [java.time.Durtion.parse()]([https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Formatter.html](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/Duration.html#parse(java.lang.CharSequence))) and `:FORMAT` uses [DateTimeFormatter](https://docs.oracle.com/en%2Fjava%2Fjavase%2F22%2Fdocs%2Fapi%2F%2F/java.base/java/time/format/DateTimeFormatter.html) with added support for `EPOCH_MILLIS` and `EPOCH_SECONDS` if `:FORMAT` is not specified then [ISO_INSTANT](https://docs.oracle.com/en%2Fjava%2Fjavase%2F22%2Fdocs%2Fapi%2F%2F/java.base/java/time/format/DateTimeFormatter.html#ISO_INSTANT) is asssumed. e.g. `%TIME%`, `%TIME-PT1H%`, `%TIME+P20D:yyyy-dd-mm%`, `%TIME:EPOCH_MILLIS%`
Dynamic injection of the current time is supported in generic protocols by using the dynamic time placeholder `%TIME[+/-PnDTnHnMn.nS][:FORMAT]%`, this can be used in the `writeValue` of the `AgentLink` as well as in other supported places depending on the protocol, for example the HTTP protocol supports using this in the headers, query parameters and/or path. The `+/-PnDTnHnMn.nS` and `:FORMAT` are optional where `+/-PnDTnHnMn.nS` uses [java.time.Durtion.parse()](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/Duration.html#parse(java.lang.CharSequence)) and `:FORMAT` uses [DateTimeFormatter](https://docs.oracle.com/en%2Fjava%2Fjavase%2F22%2Fdocs%2Fapi%2F%2F/java.base/java/time/format/DateTimeFormatter.html) with added support for `EPOCH_MILLIS` and `EPOCH_SECONDS` if `:FORMAT` is not specified then [ISO_INSTANT](https://docs.oracle.com/en%2Fjava%2Fjavase%2F22%2Fdocs%2Fapi%2F%2F/java.base/java/time/format/DateTimeFormatter.html#ISO_INSTANT) is asssumed. e.g. `%TIME%`, `%TIME-PT1H%`, `%TIME+P20D:yyyy-dd-mm%`, `%TIME:EPOCH_MILLIS%`

### Value filter known types

Expand Down

0 comments on commit f98f170

Please sign in to comment.