Repository navigation
BLL Coding
Home · Flow actions · App settings
Better Logic Library (BLL) can evaluate expressions embedded in supported text fields. It is optional: ordinary text and Homey Flow tokens work without BLL.
- The Message fields on the app's logging and Timeline Flow actions marked
* BLL supported. - The App/group fields on the grouped logging and Timeline-and-log actions.
- The Message and optional App/group fields on the Syslog client device action.
- The Excel, CSV and JSON export filename fields in the settings panel.
The App/group filter on the A log is generated trigger is not BLL-supported. Other text fields are not automatically decoded unless they are marked as BLL-supported.
Put an expression between {[ and ]}. BLL evaluates the expression when the
Flow action runs or the export is requested, then inserts its result into the
surrounding text.
For example, enter this in a supported message field:
Door opened on {[date("dddd")]}.
The date expression is replaced with the current weekday; the rest of the message stays as written.
The grouped logging actions and Syslog client action can also generate a group or application name dynamically:
Sensor-{[date('yyyy-MM-dd')]}
In the Syslog client action, this value is used as the Syslog application name.
Export filenames can use the same format. For example:
Homey-log_{[date('yyyy-MM-dd_HH-mm-ss')]}.csv
This adds a timestamp to the filename. Simple (Sys) Log uses this date-based pattern for its default Excel, CSV and JSON export filenames.
You can also insert Homey Flow tokens in supported message fields using Homey's token picker. BLL expressions can be part of the same text as those tokens.
BLL also supplies the full settings interface and temporary download support used by this app. These are separate from evaluating message expressions. See app settings for the limited view without BLL, and BLL's file-server settings when a supported export offers a download link.
BLL must be installed and available to Homey for expressions to be evaluated.
If it is unavailable, the app leaves the expression text unchanged; a coded
filename, message or group may therefore retain the {[...]} text. Plain text
and Flow tokens continue to work without BLL.
If an expression is not evaluated:
- Confirm that BLL is installed and running.
- Confirm that the field is marked
* BLL supported. - Check the expression syntax and that the function is available in BLL.
See the BLL user guide for more about its expressions and available functions.
Support development - If Simple (Sys) Log is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!