Entry
Entries are the core object that represents an execution at a specific time. Besides the time it contains an attribute and up to six arguments used as dynamic values for the execution.
You can create, update or delete entries with all our clients expect the web app.
Add
While creating an entry, you have to specify the time and date of the execution. In the screenshot you can see the different options for entering this data - on the left you can configure the time, and on the right the date.
Absoluteis the most basic time specification. You provide a static time like 20:05:01- In the
Relativemode, you provide an offset to the current time in seconds, minutes or hours Nowis self-explanatory - you create the entry at the current time
Singleis the most basic date specification. You provide a date like 05.01.2024Multipleenables you to create multiple entries at once. You can select the weeks and days of the week for which an entry should be created.- Because the next 7 weeks may not be enough, you can input a custom offset of weeks to display in the mode
Multiple+. You can then select individual weeks and days of the week like in Multiple
The Expert mode is a bit more complex. You provide both the date and the time through a pattern containing an offset.
The offset can either be positive → +20, or negative → /20. This offset can occur in every time / date field of an ISO-8601 (without TZ) string.
2024-01-01T+20:00:00: The date is fixed to the 01.01.2024. When the current time is 19:00, the time of entry would be 15:00. But because the time "flows over" the day, the date would be 02.01.2024. This behaviour can be disabled with the fieldkeep_date_on_overflow.+0-+0-+1T/5:00:+20: The date is fixed to tomorrow. When the current time is 19:00, the time of the entry would be 14:00
The expert mode can also include a calendar week with two digits (DE and EN).
| Example | Description |
|---|---|
Mo+2T20:00:00 |
The offset from the view of the current week is applied (+0 = this week, +1 = next week). If no offset (Mo) is given, the next available weekday is selected. If the required weekday is today, it's today. |
2021-Mo2T20:00:00 |
The given calendar week matches the real calendar week of the year. When +0 is given, the week which is present on the 01.01 is applied → can eventually identical to +1. When no offset is given, the first appearing weekday in the year will be applied. |
2021-01-Mo2T20:00:00 |
This behaviour is identical how the year, but only on a monthly basis. |
Delete
You can delete entries by their attributes or parameter. You can also filter after the date and time of the entries by an offset.
As with adding entries, there is also an expert mode available, in which the same concepts of offsets can be used. In addition to that, wildcards like .* or (1|2) can also be used in the string to filter the entries with a regex: 202.-01-0(1|2)T.*.
Warning
You will always need the seperators of the time or date before using a wildcard.
2021-01-01T+0.* is not valid, because it doesn't contain a : before the wildcards are used → 2021-01-01T+0:.*