Veränderungen des Inhalts
Klicken Sie für eine detaillierte Beschreibung auf die geänderten Stellen:
Benutzen sie die linke oder die rechte Maustaste, um zur jeweils vorherigen bzw. nachfolgenden Änderung zu gelangen.
Job SyncCalendarDates
Zweck
Der Job synchronisiert Abwesenheiten und untertägige Zeitintervalle aus dem TA-System unidirektional in den Groupware-Kalender. Er schreibt oder löscht Kalendertermine in Groupware, verändert aber keine TA-Daten.
Der Job ist im Jobkatalog standardmäßig inaktiv und setzt die Module TA und Groupware voraus.
Personenkreis
-
Ohne Mandant und ohne Gruppe werden die für die Groupware-Synchronisierung vorgesehenen Personen verarbeitet.
-
Mit Mandant und ohne Gruppen werden die aktuell gültigen Personen des Mandanten verarbeitet.
-
Mit Gruppen werden die aktuell gültigen Personen aller gewählten Gruppen zusammengeführt.
-
Personen, die laut Groupware-Konfiguration nicht geprüft werden sollen, werden entfernt.
Jobkonfiguration
Synchronisationstyp: 0 synchronisiert genehmigte und ungenehmigte Fehlgründe; 1 nur genehmigte Fehlgründe. Fehlt der Wert, verwendet der Code standardmäßig nur genehmigte Einträge.
Monate in Vergangenheit und Monate in Zukunft: Zeitraum der Synchronisierung. Fehlen die XML-Werte, verwendet der Code standardmäßig jeweils einen Monat.
Kürzel für exportierte Termine: Prefix der erzeugten Betrefftexte; Fallback ist die Job-Standardeinstellung oder wd3_.
Kürzel genehmigte Fehlzeiten und Kürzel ungenehmigte Fehlzeiten: Postfixe für genehmigte bzw. nicht genehmigte Einträge. Wenn beide gleich sind, wird am zweiten ein Unterstrich ergänzt.
Mandant und Gruppen: Einschränkung des Personenkreises.
Universal-Layer verwenden: Steuert die im Formular angebundene Synchronisationsvariante.
Fehlgründe zum Synchronisieren: Liste aus TA-Fehlgrund und optionalem individuellen Betreff. Ohne explizite Liste werden die Default-Fehlgründe des Jobs verwendet; fehlen auch diese, bricht der Job mit einem Fehler ab.
Halbtägige Abwesenheiten synchronisieren: Schaltet die Synchronisierung halbtägiger Einträge ein.
Untertägige Abwesenheiten synchronisieren: Schaltet die Synchronisierung von Journal-/Buchungsintervallen ein. Für Lotus Notes wird diese Variante derzeit nicht unterstützt.
Expression für Kalendereintrag-Betreff: Optionale Expression. Im Kontext stehen unter anderem
Purpose
The job synchronizes absences and intraday time intervals from the TA system unidirectionally into the groupware calendar. It writes or deletes calendar appointments in groupware, but does not change any TA data.
The job is inactive by default in the job catalog and requires the TA and Groupware modules.
Population of persons
-
Without a client and without a group, the persons designated for groupware synchronization are processed.
-
With a client and without groups, the currently valid persons of the client are processed.
-
With groups, the currently valid persons of all selected groups are merged.
-
Persons who, according to the groupware configuration, should not be checked are removed.
Job configuration
-
Synchronization type:
0 synchronizes approved and unapproved absence reasons; 1 only approved absence reasons. If the value is missing, the code uses only approved entries by default.
-
Months in the past and Months in the future: The synchronization period. If the XML values are missing, the code defaults to one month each.
-
Prefix for exported appointments: Prefix of the generated subject texts; the fallback is the job default setting or
wd3_.
-
Suffix for approved absences and Suffix for unapproved absences: Postfixes for approved and unapproved entries respectively. If both are identical, an underscore is appended to the second one.
-
Client and Groups: Restriction of the population of persons.
-
Use universal layer: Controls the synchronization variant connected in the form.
-
Absence reasons to synchronize: List of TA absence reason and optional custom subject. Without an explicit list, the job's default absence reasons are used; if these are also missing, the job aborts with an error.
-
Synchronize half-day absences: Enables synchronization of half-day entries.
-
Synchronize intraday absences: Enables synchronization of journal/booking intervals. This variant is currently not supported for Lotus Notes.
-
Expression for calendar entry subject: Optional expression. Among others,
$person, $calendarTimeRangeEvent, $wdPrefix, $wdPostfix, $approvalPostfix, $nonApprovalPostfix, $absenceReason, $requestComment und $dateFormatter zur Verfügung.
Synchronisationsverhalten
-
Für jeden geprüften Personenkontext werden TA-Einträge und Groupware-Termine über Vergleichsschlüssel abgeglichen.
-
Fehlende Termine werden in Groupware angelegt oder aktualisiert.
-
Termine, die nicht mehr im TA-System vorhanden sind, werden nur gelöscht, wenn sie ursprünglich von Webdesk angelegt wurden. Dazu wird ein gespeicherter Webdesk-Markierungswert verwendet.
-
Vor der Verarbeitung prüft der Job die Groupware-Synchronisationsbereitschaft. Fehlende Berechtigungen oder personenspezifische Fehler werden protokolliert und übersprungen; ein Fehler einer Person beendet nicht automatisch die Verarbeitung aller übrigen Personen.
-
Eine Unterbrechung beendet die weitere Verarbeitung nach dem aktuellen Personenschritt.
Prüfen Sie bei einer Aktivierung insbesondere den Zeitbereich, die zu synchronisierenden Fehlgründe und die Markierung der von Webdesk erzeugten Termine
-
and
$dateFormatter are available in the context.
Synchronization behavior
-
For each checked person context, TA entries and groupware appointments are matched via comparison keys.
-
Missing appointments are created or updated in groupware.
-
Appointments that no longer exist in the TA system are only deleted if they were originally created by Webdesk. A stored Webdesk marker value is used for this.
-
Before processing, the job checks groupware synchronization readiness. Missing permissions or person-specific errors are logged and skipped; an error for one person does not automatically end processing for all other persons.
-
An interruption ends further processing after the current person step.
When activating, check in particular the time range, the absence reasons to be synchronized, and the marking of appointments created by Webdesk.