Konfiguration der Absence- und Vacation-Funktionen in der config.js
Konfiguration Server Einstellungen
Die config.json enthält globale, kundenspezifische Einstellungen für die jeweilige Can Do Instanz.
Die nachfolgend beschriebenen Parameter betreffen die Bereiche:
- Urlaub und Abwesenheiten
- Feiertage
- Urlaubsjahresplanung
- Genehmigungen
- Dokumente und SharePoint
- Skills
Die Einstellungen gelten grundsätzlich für die gesamte Kundeninstanz.
Working-Contract-Parameter sind nicht Bestandteil dieser Dokumentation. Diese sind separat dokumentiert und können zusätzliche mitarbeiterspezifische Regeln für Urlaub, Abwesenheiten und Arbeitszeit enthalten.
Nach einer Änderung der config.json muss die Anwendung neu geladen werden. Abhängig vom Browser-Cache kann ein Hard Refresh erforderlich sein.
_______________________________________________________________________________
Standardarbeitszeit pro Tag
Parameter: general.defaultWorkingHoursPerDay
Typ: Number
Standardwert: 8
Definiert die Standardlänge eines Arbeitstags in Stunden.
Der Wert wird verwendet, wenn für eine Person keine entsprechende Arbeitszeit über den Working Contract zur Verfügung steht.
Er wird unter anderem verwendet für:
- die Umrechnung von Abwesenheitstagen in Stunden,
- die erwartete Arbeitszeit in der Zeiterfassung,
- das Work Time Model.
Beispiel:
Wert 8 → Ein Standardarbeitstag entspricht 8 Stunden.
_______________________________________________________________________________
Verfügbare Länder für Feiertage
Parameter: general.loadOnlyAvailableCountries
Typ: Boolean
Standardwert: true
Steuert, welche Länder in Admin → Holidays zur Auswahl stehen.
true
Es werden nur Länder angezeigt, für die Feiertagsdaten verfügbar sind.
false
Alle Länder stehen zur Auswahl.
Aktualisierungsintervall für offene Genehmigungen
Parameter: general.pendingApprovalsCheckIntervalSeconds
Typ: Number
Standardwert: 600
Definiert, in welchem Zeitintervall die Anwendung prüft, ob neue Genehmigungsanfragen vorliegen.
Der Wert wird in Sekunden angegeben.
Beispiel:
Wert 600 → Die Prüfung erfolgt alle 10 Minuten.
Nach einer Genehmigung oder Ablehnung wird die Anzeige zusätzlich direkt aktualisiert.
Feiertage Zeitraum der geladenen Feiertage
Parameter: holidays.rangeOfYearsToFetch
Typ: Number
Standardwert: 5
Definiert, für wie viele Jahre vor und nach dem aktuellen Jahr Feiertage in der Feiertagsverwaltung geladen werden.
Beispiel:
Wert 5 → Es werden Feiertage für das aktuelle Jahr sowie für fünf Jahre davor und fünf Jahre danach geladen.
Ein größerer Zeitraum stellt mehr historische und zukünftige Feiertage zur Verfügung, kann jedoch die Ladezeit erhöhen.
Abwesenheiten – GrundeinstellungenSick Leave Type
Parameter: absences.sickLeaveTypeID
Typ: ID
Standardwert: 3
Definiert, welcher Abwesenheitstyp von der Anwendung als Sick Leave / Krankheit behandelt wird.
Dieser Typ erhält die spezifische Sick-Leave-Logik, beispielsweise für Gründe und Dokumente.
Die ID muss mit dem entsprechenden Abwesenheitstyp im Backend übereinstimmen.
Special Leave Type
Parameter: absences.specialLeaveTypeID
Typ: ID
Standardwert: 4
Definiert, welcher Abwesenheitstyp als Special Leave / Sonderurlaub behandelt wird.
Für diesen Typ werden die speziellen Regeln für Sonderurlaub, beispielsweise für Gründe, Dokumente und Genehmigungen, verwendet.
Die ID muss mit dem entsprechenden Abwesenheitstyp im Backend übereinstimmen.
Verfügbare Jahre in der Abwesenheitsübersicht
Parameter: absences.yearsDropdownRangeFromCurrent
Typ: Number
Standardwert: 5
Definiert, wie viele Jahre vor und nach dem aktuellen Jahr in der Abwesenheitsübersicht ausgewählt werden können.
Beispiel:
Wert 5 → Das aktuelle Jahr sowie fünf vergangene und fünf zukünftige Jahre stehen zur Auswahl.
Bei einem Wert von 0 bzw. wenn der Parameter nicht vorhanden ist, wird nur das aktuelle Jahr angeboten.
Tageshälfte bei halbtägiger Abwesenheit
Parameter: absences.halfDayTimeMandatory
Typ: Boolean
Standardwert: true
Steuert, ob bei einer halbtägigen Abwesenheit zusätzlich die Tageshälfte ausgewählt werden muss.
true
Der Benutzer muss zwischen Vormittag und Nachmittag wählen. Standardmäßig ist Vormittag vorausgewählt. Die gewählte Tageshälfte wird auch in der Genehmigung angezeigt.
false
Die Abwesenheit wird als halber Tag ohne Angabe einer Tageshälfte erfasst.
Abwesenheitsmodul im Lesemodus
Parameter: absences.interfaceMode
Typ: Boolean
Standardwert: false
Steuert, ob im Absence-Modul Abwesenheiten beantragt und storniert werden können.
false
Das Modul kann entsprechend der vorhandenen Berechtigungen vollständig verwendet werden.
true
Das Modul befindet sich im Lesemodus. Abwesenheiten können angezeigt werden, die Funktionen zur Beantragung und Stornierung sind jedoch deaktiviert.
Zugriff auf Abwesenheiten anderer Mitarbeiter - Auswahl anderer Mitarbeiter
Parameter: absences.allowSpecialGroupsToSeeAllAbsences
Typ: Boolean
Standardwert: true
Steuert, welche Benutzer andere Mitarbeiter in der Abwesenheitsübersicht auswählen können.
true
Mitglieder der HR-Gruppe sowie Abteilungsleiter und Stellvertreter können andere Mitarbeiter für die verschiedenen Abwesenheitstypen auswählen. Für andere Benutzer steht diese Auswahl nicht zur Verfügung.
false
Die Auswahl anderer Mitarbeiter steht nur in der Sick-Leave-Ansicht zur Verfügung.
Dieser Parameter steuert die Anzeige bzw. Auswahl anderer Mitarbeiter. Die Berechtigung, tatsächlich eine Abwesenheit für eine andere Person anzulegen oder zu stornieren, wird separat geregelt.
Spezielle HR-Berechtigungen
Parameter: absences.HRGroupSpecialPermissions
Typ: Boolean
Standardwert: true
Steuert spezielle Berechtigungen für Mitglieder der HR-Gruppe.
trueNur Mitglieder der HR-Gruppe dürfen Abwesenheiten für andere Personen erfassen oder stornieren.
Abteilungsleiter und Stellvertreter verlieren diese Berechtigung auch dann, wenn sie aufgrund des Working Contracts des Mitarbeiters grundsätzlich dazu berechtigt wären.
Zusätzlich sind Mitglieder der HR-Gruppe von der Einschränkung für Abwesenheiten in der Vergangenheit ausgenommen.
falseEs gelten keine speziellen HR-Berechtigungen.
Die regulären Berechtigungsregeln, einschließlich der Regeln aus dem jeweiligen Working Contract, werden angewendet.
Einschränkung für vergangene Abwesenheiten
Parameter: absences.limitDepartmentLeadersToFutureOnly
Typ: Boolean
Standardwert: true
Steuert, ob Abwesenheiten für vergangene Tage beantragt oder storniert werden können.
true
Abwesenheiten können nur für den aktuellen Tag oder für zukünftige Tage beantragt bzw. storniert werden.
Bei einem Datum in der Vergangenheit wird eine entsprechende Meldung angezeigt und die Beantragung ist nicht möglich.
false
Die Einschränkung ist deaktiviert.
Hinweis:
Trotz des Parameternamens gilt die Einschränkung aktuell für alle Benutzer und nicht ausschließlich für Abteilungsleiter.
Ist HRGroupSpecialPermissions = true, sind Mitglieder der HR-Gruppe von dieser Einschränkung ausgenommen.
Überbuchung von Urlaub und Sonderurlaub
Die Config entscheidet nicht, ob eine Überbuchung grundsätzlich erlaubt ist. Diese Regel wird über den jeweiligen Working Contract festgelegt.
Die folgenden Parameter steuern ausschließlich, ob bei einer zulässigen Überbuchung zusätzlich eine Bestätigung durch den Benutzer erforderlich ist.
Bestätigung bei Urlaubsüberbuchung
Parameter: absences.vacationOverbookingConfirmationMandatory
Typ: Boolean
Standardwert: true
Steuert, ob eine Überbuchung des Urlaubskontingents vom Benutzer ausdrücklich bestätigt werden muss.
true
Überschreitet der Antrag das verbleibende Urlaubskontingent und ist eine Überbuchung laut Working Contract erlaubt, erscheint vor dem Absenden ein Bestätigungsdialog.
false
Der Antrag kann ohne zusätzliche Bestätigung abgesendet werden.
Bestätigung bei Überbuchung von Sonderurlaub
Parameter: absences.specialLeaveOverbookingConfirmationMandatory
Typ: Boolean
Standardwert: false
Entsprechende Bestätigungslogik für Special Leave.
true
Eine zulässige Überbuchung muss zusätzlich bestätigt werden.
false
Es ist keine zusätzliche Bestätigung erforderlich.
Spezielle Urlaubsphasen
Diese Einstellungen sind für Urlaubsmodelle relevant, die mit mehreren Urlaubskontingenten bzw. speziellen Phasen arbeiten.
Automatische Optimierung der speziellen Phasen
Parameter: absences.optimizeSpecialPhasesAutomatically
Typ: Boolean
Standardwert: false
Steuert, ob die Zuordnung eines Urlaubs zu den vorhandenen speziellen Urlaubsphasen automatisch optimiert wird.
true
Nach Genehmigung bzw. automatischer Genehmigung einer Abwesenheit wird die Verteilung auf die verfügbaren Phasen für das betreffende Jahr automatisch neu optimiert.
Die Verarbeitung erfolgt im Hintergrund.
false
Es erfolgt keine automatische Optimierung.
Urlaubsjahresplanung - Verfügbare Jahre
Parameter: vacation-year-planning.yearsDropdownRangeFromCurrent
Typ: Number
Standardwert: 5
Definiert, welche Jahre in der Vacation Year Planning ausgewählt werden können.
Beispiel:
Wert 5 → Fünf vergangene Jahre, das aktuelle Jahr und fünf zukünftige Jahre stehen zur Verfügung.
Manuelle Optimierung spezieller Urlaubsphasen
Parameter: vacation-year-planning.showSpecialPhasesOptimizeButton
Typ: Boolean
Standardwert: false
Steuert die Anzeige des Optimize-Buttons in der Vacation Year Planning.
true
Der Optimize-Button wird angezeigt. Damit kann die Zuordnung des Urlaubs zu den vorhandenen speziellen Urlaubsphasen manuell neu optimiert werden.
Der Button ist für Mitarbeiter mit mehr als einer Phase verfügbar.
false
Der Optimize-Button wird nicht angezeigt.
Dokumente bei Abwesenheiten - SharePoint-Upload verwenden
Parameter: absences.useSharePointUpload
Typ: Boolean
Standardwert: true
Definiert grundsätzlich, wie Dokumente zu Abwesenheiten bereitgestellt werden.
true
Dokumente werden über die SharePoint-Upload-Funktion hochgeladen.
false
Anstelle eines Uploads wird ein Link zum Dokument hinterlegt.
Bei Kunden ohne konfigurierte SharePoint-Integration muss dieser Parameter entsprechend deaktiviert werden.
SharePoint-Upload für Sick Leave
Parameter: absences.useSharePointUploadForSickLeave
Typ: Boolean
Standardwert: true
Steuert die SharePoint-Nutzung speziell für Sick Leave.
Der Parameter wird nur berücksichtigt, wenn
absences.useSharePointUpload = true
gesetzt ist.
true → SharePoint-Upload wird verwendet.false → Für Sick Leave wird die linkbasierte Eingabe verwendet.
SharePoint-Upload für Special Leave
Parameter: absences.useSharePointUploadForSpecialLeave
Typ: Boolean
Standardwert: true
Steuert die SharePoint-Nutzung speziell für Special Leave.
Der Parameter wird nur berücksichtigt, wenn
absences.useSharePointUpload = true
gesetzt ist.
true → SharePoint-Upload wird verwendet.false → Für Special Leave wird die linkbasierte Eingabe verwendet.
Zuordnung von Dokumentkategorien
Über das documentCategoryMapping wird festgelegt, welcher SharePoint-Dokumentkategorie hochgeladene Dokumente zugeordnet werden.
Sick Leave
Parameter: documentCategoryMapping.absence["3"]
Standardwert: 2
Dokumente des Abwesenheitstyps 3 werden der Dokumentkategorie Absences zugeordnet.
Die verwendete ID muss mit absences.sickLeaveTypeID übereinstimmen.
Special Leave
Parameter: documentCategoryMapping.absence["4"]
Standardwert: 2
Dokumente des Abwesenheitstyps 4 werden ebenfalls der Dokumentkategorie Absences zugeordnet.
Die verwendete ID muss mit absences.specialLeaveTypeID übereinstimmen.
Skill-Dokumente
Parameter: documentCategoryMapping.skill.default
Standardwert: 1
Definiert die Standard-Dokumentkategorie für Dokumente, die im Zusammenhang mit Skills hochgeladen werden.
Standardmäßig werden diese der Kategorie Skills zugeordnet.
SharePoint-Konfiguration - Erlaubte Dateitypen
Parameter: sharepoint-config.allowedFileExtensions
Definiert, welche Dateitypen ein Administrator bei der Konfiguration einer Dokumentkategorie zulassen kann.
Standardmäßig stehen folgende Dateitypen zur Verfügung:
pdf, jpg, jpeg, png, docx
Dateiendungen, die hier nicht hinterlegt sind, können für eine Dokumentkategorie nicht ausgewählt werden.
Can Do Dokumentkategorien
Parameter: sharepoint-config.candoCategoryTypes
Definiert die Dokumentkategorien, die in der SharePoint-Konfiguration zur Verfügung stehen.
Standardmäßig:
0– Other1– Skills2– Absences
Die Kategorien werden unter anderem vom documentCategoryMapping verwendet.
Maximale Dateigröße
Parameter: sharepoint-config.maxFileSizeMbDefault
Typ: Number
Standardwert: 25
Definiert die standardmäßig vorbelegte maximale Dateigröße beim Anlegen einer neuen Dokumentkategorie.
Der Wert stellt gleichzeitig die höchste Dateigröße dar, die für eine Dokumentkategorie konfiguriert werden kann.
Der Wert wird in MB angegeben.
Genehmigungsansicht – Abwesenheiten
Die folgenden Parameter bestimmen, welche zusätzlichen Informationen in der Genehmigungsansicht für Abwesenheiten angezeigt werden.
Sie verändern nicht die Genehmigungslogik, sondern ausschließlich die dargestellten Informationen.
| Parameter | Funktion | Standard |
|---|---|---|
approve-requests.absences.showConflict |
Konflikt-/Risikoinformation anzeigen | true |
approve-requests.absences.showDaysApplied |
Ursprünglich beantragte Tage anzeigen | true |
approve-requests.absences.showDaysEffective |
Effektiv berechnete Abwesenheitstage anzeigen | true |
approve-requests.absences.showDocuments |
Dokumente bzw. Dokumentlinks anzeigen | true |
approve-requests.absences.showReason |
Abwesenheitsgrund anzeigen | true |
approve-requests.absences.showRemainingDaysForSickLeave |
Verbleibendes Sick-Leave-Kontingent anzeigen | true |
approve-requests.absences.showRemainingDaysForSpecialLeave |
Verbleibendes Special-Leave-Kontingent anzeigen | false |
Genehmigungsansicht – Skills
Die folgenden Parameter steuern die Darstellung von Informationen bei Skill-Genehmigungen.
| Parameter | Funktion | Standard |
|---|---|---|
approve-requests.skills.showCertificate |
Hinterlegtes Zertifikat anzeigen | true |
approve-requests.skills.showDisapprovalReason |
Feld bzw. Information zum Ablehnungsgrund anzeigen | true |
approve-requests.skills.showDocuments |
Zugeordnete Dokumente anzeigen | true |
approve-requests.skills.showFavourite |
Kennzeichnung als Favourite Skill anzeigen | true |
approve-requests.skills.showLevel |
Numerisches Skill-Level anzeigen | true |
approve-requests.skills.showLevelName |
Bezeichnung des Skill-Levels anzeigen | true |
approve-requests.skills.showPath |
Anzeige in welchem Pfad der Skill hinterlegt ist | true |
approve-requests.skills.showCategoryName |
Anzeige der übergeordneten Kategorie | true |
Diese Einstellungen betreffen ausschließlich die Darstellung der Skill-Anfragen in der Genehmigungsansicht.
Wichtige Abhängigkeiten
Sick Leave Type und Dokumentkategorie
absences.sickLeaveTypeID
und der entsprechende Schlüssel unter
documentCategoryMapping.absence
müssen dieselbe Abwesenheitstyp-ID verwenden.
Bei der Standardkonfiguration ist dies die ID 3.
Special Leave Type und Dokumentkategorie
absences.specialLeaveTypeID
und der entsprechende Schlüssel unter
documentCategoryMapping.absence
müssen ebenfalls übereinstimmen.
Bei der Standardkonfiguration ist dies die ID 4.
SharePoint
Die drei Parameter
absences.useSharePointUpload
absences.useSharePointUploadForSickLeave
absences.useSharePointUploadForSpecialLeave
müssen entsprechend der vorhandenen SharePoint-Integration konfiguriert werden.
Die beiden typbezogenen Parameter greifen nur, wenn der allgemeine SharePoint-Upload aktiviert ist.
Überbuchung
Die Config-Parameter
vacationOverbookingConfirmationMandatory
und
specialLeaveOverbookingConfirmationMandatory
entscheiden ausschließlich darüber, ob eine bereits zulässige Überbuchung zusätzlich bestätigt werden muss.
Ob eine Überbuchung grundsätzlich zulässig ist, wird nicht in diesen Config-Parametern definiert, sondern über den Working Contract.
Spezielle Urlaubsphasen
absences.optimizeSpecialPhasesAutomatically
steuert die automatische Optimierung.
vacation-year-planning.showSpecialPhasesOptimizeButton
stellt zusätzlich eine manuelle Optimierung in der Urlaubsjahresplanung zur Verfügung.
Beide Einstellungen sind insbesondere für Urlaubskonzepte mit mehreren gleichzeitig verfügbaren Urlaubskontingenten bzw. speziellen Phasen relevant.