Differences

This shows you the differences between two versions of the page.

--- ezeio2:userinterface:manage:messagetemplates [2023-02-17 23:56] – andreh
+++ ezeio2:userinterface:manage:messagetemplates [2025-06-30 22:27] (current) – [Message Templates Tags] andreh
@@ Line 1: / Line 1: @@
-==== Message Templates Tags ====
+==== Message Templates ====
 {{indexmenu_n>745}}
+Message templates controls the content of messages sent as Alarms/Restores or periodic exports.
+A template can include static text as well as dynamic data using the 'tags' defined below.
+Every //destination type// (email, SMS etc..) comes with a default message template.
+For example, the default template for emails looks like this:
+<code>
+[ACTIONMESSAGE]
+Message generated [ISODATE] [ISOTIME]
+</code>
+The default template for SMS messages looks like this:
+<code>
+[ACTIONMESSAGE] @ [ISOTIME]
+</code>
+Because SMS messages are typically limited in size, the default template contains less text and no additional line breaks.
+When an alarm is generated, and the action is to send a message, the system will fetch the "Message" of the alarm action, and insert this in place of the [ACTIONMESSAGE] tag in the default template. Any tags in the Action Message are also substituted.
+For example, the alarm's action message may look like this:
+<code>
+It is [FV<TEMPERATURE>] [FU<TEMPERATURE>] now!
+</code>
+When this is sent as an email using the default template, the result will be something like:
+<code>
+It is 25.6 °C now!
+Message generated 2022-12-31 15:00:02
+</code>
+The templates for each destination can be changed directly under Destination List settings.
+==== Message Templates Tags ====
 The following tags are available in message templates:
@@ Line 18: / Line 54: @@
 | ''[EZEID]'' | ezeio serial number | //ABC-987// |
 | ''[EZENAME]'' | ezeio name | From Configure->System->Name |
+| ''[EZENAME#]'' | ezeio partial name, #=1-5 | From Configure->System->Name, split by comma, semicolon or pipe |
 | ''[EZENOTE]'' | ezeio note | From Configure->System->Note |
+| ''[EZENOTE#]'' | ezeio note line, #=1-5 | From Configure->System->Note, split by line |
 | ''[TYPE]'' | Message type | //ALARM, REALARM, RESTORE, INFO, EXPORT// |
 | ''[SOURCE]'' | Message source | //SEND, LOG, SCRIPT// |
 | ''[GROUPNAME]'' | Name of the group where the ezeio is assigned | From Group Settings->Group Name |
+| ''[GROUPNAME#]'' | Partial name of the group, #=1-5 | From Group Settings->Group Name, split by comma, semicolon or pipe |
 | ''[SOURCENAME]'' | Name of the source alarm | From Configure->Alarms->Name |
+| ''[SOURCENAME#]'' | Partial name of the source alarm, #=1-5 | From Configure->Alarms->Name, split by comma, semicolon or pipe |
 | ''[ACTIONNAME]'' | Name of the action source action | From Configure->Alarms->Alarm action->Name |
+| ''[ACTIONNAME#]'' | Partial name of the action source action, #=1-5 | From Configure->Alarms->Alarm action->Name, split by comma, semicolon or pipe |
 | ''[GPS]'' | GPS coordinates (if available) | //Lat:38.671447, Lng-121.152385:, Ele:105.2// |
 | ''[GPSLINK]'' | GPS coordinates Google maps link | https://maps.google.com/maps?q=... |
 | ''[GPSSIGNAL]'' | Signal quality of the GPS receiver | //14// |
 | ''[RSSI]'' | Cellular signal RSSI | //0// (no signal) .. //31// (full signal) |
+| ''[CSV]'' | Attach a CSV file with all field statuses (applies only to email destinations) |  |
 | ''[P#]'' | Message (#=1-4) parameters as integers (see script command "Event") | |
 | ''[PD#]'' | Message (#=1-4) parameters as floats (see script command "Event") | |
@@ Line 36: / Line 78: @@
 | ''[FT#]'' | Field asset tag (first only), #=1-90 | //PRESSURE// |
 | ''[F#]'' | Field status, #=1-90, as "Field name: Value Unit", same as [FN#]: [FV#] [FU#] | //Pressure: 318.2 psi// |
+| ''[FL<//AssetTag//>]'' | Field list by asset tag. Lists all fields having the given asset tag, as "Field name: Value Unit" | //Pressure: 318.2 psi//, multiple lines |
 | ''<//AssetTag//>'' | Can be used in place of the Field number, Example: [FV<outsidetemp>] |
 | ''<//AssetTag//:SUM>'' | Works with FV and FR. Returns the sum of all field values with the given AssetTag, Example: [FV<outsidetemp:SUM>] | //172.2// |
@@ Line 48: / Line 91: @@
 | ''[DESTINATION]'' | The address of the destination (from Destination->Address) | |
 | ''[DESTINATIONTOKEN]'' | The token of the destination (from Destination->Token) | |
+| ''[DVC#NAME]'' | Device name, #=1-40 | Name from Configure->Devices->Device->Name |
 | ''[DVC#COMMSTAT]'' | Device communication status, #=1-40 | //n/a, ERROR, WARNING, WARNING2, WARNING3, OK, OK2, OK3// |
 | ''[DVC#OPSTAT]'' | Device operational status, #=1-40 | //n/a, ERROR, WARNING, OK// |