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 field on Simple (Sys) Log's log and Timeline Flow actions
marked
* BLL supported. - The Excel, CSV and JSON export filename fields in the settings panel.
Other text fields are not automatically decoded. In particular, use plain text or Flow tokens in the Syslog client device action unless its field is explicitly 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.
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 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 or message 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!