:: Version 3.2.0 ::
Send Calendar invitations
Features
-
Allow to send a calendar invitation (also known as meeting request) related to a Ticket or a Work Order.
-
For eg. this allow to book the slot in the email calendar of the agent, from the start date to the end date of a Work Order.
-
Later if the Ticket is modified,
-
The calendar invitation is updated with new dates and/or description
-
New people are automatically included in the invitation, as soon as additional contacts are added to the ticket
-
People primarily invited which are no more linked to the ticket, receive an invitation cancellation.
-
It is even possible to delete completely the calendar invitation from all recipients, for example if the Work Order was deleted or cancelled.
-
-
If no end date is provided, the default meeting duration is 1 hour.
-
Recipients are defined by an OQL query with placeholders as for any emails notification.
Usage
This extension is used to create a new type of “Action” to be associated with Trigger. To create such an action go to “Admin Tools / Notifications”, in the “Actions” tab, click “New…” and pick “Calendar Invitation” from the list.
The following form will be displayed:
| Field | Meaning | Sample Value |
|---|---|---|
| Name | Name of the action. Any value that is meaningful to distinguish this action | Invitation for implementing changes |
| Description | A longer explanation about the purpose of this action. for information only. | |
| Status | Whether or not the action is active (= In Production), Being tested or Inactive. | In Production |
| Test Recipient | An email address for testing the notification. used when the status is “Being tested”. | test@demo.com |
| From (address) | The email address used as the sender of the email. Depending on its security settings, your mail server may block the email if the sender is not a valid email address | itop@demo.com |
| From (label) | A human readable label for the above email address. Will be used in the description of the invitation. | ITop Change Management |
| Reply To | The email address to which the replies must be addressed, if different from the “From (address)”. | |
| To | An OQL query which returns the list of the
mandatory attendees to the meeting. Placeholders are supported,
prefixed with a colon (:) |
SELECT Person WHERE id=:this->agent_id |
| CC | An OQL query which returns the list of the
mandatory attendees to the meeting. Placeholders are supported,
prefixed with a colon (:) |
SELECT Person WHERE id=:this->changemanager_id |
| Subject | The subject of the email. Placeholders are
supported, surrounded by $. |
Invitation for implementing $this->ref$ |
| Start Date/Time | The start date and time of the meeting. The format
is YYYY-MM-DD hh:mm:ss. Placeholders are supported, surrounded by
$. |
$this->start_date$ |
| End Date/Time | The start date and time of the meeting. The format
is YYYY-MM-DD hh:mm:ss. Placeholders are supported, surrounded by
$. If this field is left blank, the meeting is assumed
to have a duration of one hour. |
|
| Meeting Subject | The subject of the meeting. Placeholders are
supported, surrounded by $. If this field is left
blank, the subject of the email will be used. |
|
| Meeting Description | A longer description for the meeting. Placeholders
are supported, surrounded by $. |
$this->hyperlink$ |
| Meeting Location | A location for the meeting. Placeholders are
supported, surrounded by $. |
|
| Reminder duration | Allow to specify in minutes, the reminder notice | 15 |
| Policy in case of previous invitations | No (always send a new invitation): does not update any previously sent invitations | past behavior |
| Update : will update the previously sent invitation | ||
| Cancel : will cancel the previously sent invitation |
Don't forget to associate
the action with a Trigger, otherwise it will never be
activated.
Limitations
-
The 15min reminder added to the invitation does not seem to be taken into account.
Configuration
There is no configuration parameter for this extension in the iTop configuration file.
This extension requires the
PHP parameter date.timezone to be set.
For instance date.timezone = Europe/Paris
3_2_0/products/icalendar_invitations.txt · Last
modified: 2024/09/10 10:25 by 127.0.0.1