Difference between revisions of "Trigger: Calendar Event"

 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<span style="color: #B22A2A; font-size: 24px; display: inline-block; margin-top: 15px; margin-bottom: 0px;"><strong>About</strong></span>
+
<pre class="header-style">
 
 
 
This trigger will fire when a specific calendar event starts/ends.
 
This trigger will fire when a specific calendar event starts/ends.
  
 
Note that this trigger normally only fires on 5 minute boundaries, so if you have an event that starts between the boundaries, it may fire a few minutes later.
 
Note that this trigger normally only fires on 5 minute boundaries, so if you have an event that starts between the boundaries, it may fire a few minutes later.
 +
</pre>
 +
 +
'''Magic Text'''<br/>
 +
When this trigger is used, you can access magic text via the [...] button where available.<br/>[https://macrodroidforum.com/wiki/index.php/Magic_text#Bluethooth_.28Device_connected_or_device_disconnected.29 Magic text]
  
* ''When this trigger is present, you can use more [...]'' ''[[magic text]]''
+
'''Configuration Options'''
  
==<p><b>Supported configurations</b></p>==
+
* '''Event starts / Event ends'''
* '''''Event starts / Event ends'''''
 
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 
 
Defines whether the event will start at the beginning of the event or at the end of the event.
 
Defines whether the event will start at the beginning of the event or at the end of the event.
</pre>
 
  
* '''''Calendar'''''
+
* '''Calendar'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
Choose the specific calendar that you want to monitor for events.
Choose the account where the event is located, you can also select the category, e.g. birthdays, family, holidays in mexico.
 
</pre>
 
  
* '''''Availability'''''
+
* '''Availability'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
You can choose to trigger only if the free/busy state is set or trigger on any state (default).
It starts only if you are free/busy or any.
 
</pre>
 
  
* '''''Title (Optional)'''''
+
* '''Title (Optional)'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
The event must match this title.
The event must have this title.
 
</pre>
 
  
* '''''Event detail (Optional)'''''
+
* '''Event detail (Optional)'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
The event must match the detail text.
The event must have these details/description.
 
</pre>
 
  
* '''''Enable regular expression matching'''''
+
* '''Enable regular expression matching'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 
 
Regular expression matching (or regex matching) is a technique for finding patterns within text using a specialized syntax known as regular expressions. It's a powerful tool for text processing and pattern recognition.
 
Regular expression matching (or regex matching) is a technique for finding patterns within text using a specialized syntax known as regular expressions. It's a powerful tool for text processing and pattern recognition.
</pre>
 
  
* '''''Case insensitive'''''
+
* '''Case insensitive'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
If enabled the text comparison will ignore any differences in upper and lower case text in the title and detail text.
It will ignore the use of upper and lower case in title and detail.
 
</pre>
 
  
* '''''Ignore all day events'''''
+
* '''Ignore all day events'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
When enabled, any events defined as full day will be ignored by the trigger.
Events defined as full day will be ignored by the trigger.
 
</pre>
 
  
* '''''Check in advance'''''
+
* '''Check in advance'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
Instead of triggering at the exact moment the calendar event triggers, it will check for events int he future (for example 2 hours in advance). This way, you can receive alerts in advance about a specific calendar event.
Instead of triggering at the exact moment the calendar event triggers, it will check for it (for example) 2 hours in advance. This way, you can receive alerts in advance about a specific calendar event
 
</pre>
 
  
'''''Use negative value'''''
+
* '''Use negative value'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
When using this option the trigger will fire at the specified time after the calendar event occurred (e.g. 2 hours after the calendar event).
Use negative value (trigger x time after the event)
 
</pre>
 
  
* '''''Use alarm'''''
+
* '''Use alarm'''
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
Use this option if the trigger time is not accurate (and you need it) e.g. for high importance events it is recommended to enable this option else the calendar checking will likely be very sporadic.
Use this option if the trigger time is not accurate (and you need it) e.g. for high importance events it is recommended to use alarm.
 
</pre>
 

Latest revision as of 22:06, 10 June 2024

This trigger will fire when a specific calendar event starts/ends.

Note that this trigger normally only fires on 5 minute boundaries, so if you have an event that starts between the boundaries, it may fire a few minutes later.

Magic Text
When this trigger is used, you can access magic text via the [...] button where available.
Magic text

Configuration Options

  • Event starts / Event ends

Defines whether the event will start at the beginning of the event or at the end of the event.

  • Calendar

Choose the specific calendar that you want to monitor for events.

  • Availability

You can choose to trigger only if the free/busy state is set or trigger on any state (default).

  • Title (Optional)

The event must match this title.

  • Event detail (Optional)

The event must match the detail text.

  • Enable regular expression matching

Regular expression matching (or regex matching) is a technique for finding patterns within text using a specialized syntax known as regular expressions. It's a powerful tool for text processing and pattern recognition.

  • Case insensitive

If enabled the text comparison will ignore any differences in upper and lower case text in the title and detail text.

  • Ignore all day events

When enabled, any events defined as full day will be ignored by the trigger.

  • Check in advance

Instead of triggering at the exact moment the calendar event triggers, it will check for events int he future (for example 2 hours in advance). This way, you can receive alerts in advance about a specific calendar event.

  • Use negative value

When using this option the trigger will fire at the specified time after the calendar event occurred (e.g. 2 hours after the calendar event).

  • Use alarm

Use this option if the trigger time is not accurate (and you need it) e.g. for high importance events it is recommended to enable this option else the calendar checking will likely be very sporadic.