Job GwStartOutOfOfficePeriod

Purpose

The GwStartOutOfOfficePeriod job activates or deactivates automatic out-of-office replies in the groupware mailbox based on non-productive absences from the TA system.

The job requires the TA and GW modules. In the supplied job descriptor, it is currently not active and cannot be configured via its own configuration form.

Prerequisites

• The person is valid, has a TA assignment, and has automatic out-of-office replies enabled in the groupware settings.
• The groupware and TA integration as well as the required default texts are set up for the client.
• Productive absence reasons are not used as an absence for the automatic reply.

Process

1. The job determines the eligible persons and groups them by client.
2. For each client, the productive absence reasons are loaded.
3. In the case of an open non-productive absence, out-of-office is activated without a planned end date.
4. Otherwise, a period of non-productive absence starting from the current check day is determined. If a period is found, the job activates out-of-office with a start and end time.
5. For persons returning from an open absence, out-of-office is deactivated.
6. Errors for an individual person are logged; processing of the remaining persons and clients continues.

Reply Texts and Placeholders

For external and internal replies, the job uses the personal texts. If a text is empty, the client-specific default text is used. If a personal text contains only HTML markup without visible text, it is also treated as empty. If the internal reply is configured accordingly, the external reply can be reused for it.

The texts are replaced via the scripting service with the following variables:

• absenceStartDate and absenceEndDate: start and end of the TA absence
• fromDate and toDate: start and end of the out-of-office period

For an open absence, the translation until_further_notice is used for the end.

The general job parameters such as trigger and email notification apply as defined in central job management.