| Änderungen von: | |
| bis: | |
| Typ: | |
 erste | letzte  |
Diese Seite beschreibt alle Einstellungen, mit denen das Verhalten von This page describes all settings that control the behavior of HR-Expert gesteuert wird: die Systemparameter der Bean : the system parameters of the bean HrOptions (Modul module hr) und die Mandanteneinstellungen im Reiter "Personalwesen" der Aktion "Mandant". Viele Einstellungen gibt es auf beiden Ebenen: Der Systemparameter ist dann nur der systemweite Standardwert, ein Wert beim Mandanten hat Vorrang. Die Seite richtet sich an Administratoren und Consultants. Systemparameter wirken systemweit und sollten nur mit genauer Kenntnis der Auswirkung geändert werden (siehe Systemparameter Portal & Organisation für die allgemeine Vorgehensweise). Zur Rolleneinrichtung für den Zugriff auf HR-Expert siehe auch Administrator.
and the client settings on the "Human resources" tab of the "Client" action (German: "Mandant", tab "Personalwesen"). Many settings exist on both levels: the system parameter is then only the system-wide default, and a value set on the client takes precedence. The page is intended for administrators and consultants. System parameters take effect system-wide and should only be changed if the impact is fully understood (see System parameters Portal & Organization for the general procedure). For setting up the roles that grant access to HR-Expert, see also Administrator.
hr in der Bean HrOptions bearbeitet. Die Werte stehen in der Spring-Konfiguration des Moduls
The system parameters are edited in the "System parameters" mask under module hr in the bean HrOptions. The values are defined in the Spring configuration of the module (hr.applicationContext.xml); die hier als Standard genannten Werte sind die dort ausgelieferten Werte. Die Bean HrOptions enthält auch Eigenschaften, die es nur auf Systemebene gibt.
Die Mandanteneinstellungen werden in der Aktion "Mandant" the defaults named on this page are the values delivered there. The bean HrOptions also contains properties that exist on the system level only.
The client settings are maintained in the "Client" action (po_editClient) im Reiter "Personalwesen" gepflegt (Beschriftung des Reiters: on the "Human resources" tab (German "Personalwesen"; tab label key hr_editClientHrData_tabLabel; die Beschriftungen der Felder stammen aus den i18n-Schlüsseln mit dem Präfix the field captions come from the i18n keys with the prefix hr_editClientHrData_). Gespeichert werden sie je Mandant in der Tabelle HrClientData. Die Maske zeigt automatisch jedes Feld von HrClientData an. Ja/Nein-Felder haben die Auswahl "leer", "Nein" und "Ja"; "leer" bedeutet: Es gilt der Systemparameter. Texte, Zahlen und Listen werden als Text eingegeben (mehrere Werte durch Beistrich getrennt); ein leeres Feld bedeutet ebenfalls, dass der Systemparameter gilt. Das Feld für das Velocity-Skript des Personenkopfes ist ein mehrzeiliger Editor mit der Schaltfläche "Standard Skript in den Editor hinzufügen".
Für Einstellungen, die es auf beiden Ebenen gibt, gilt (HrOptionsService):
HrOptions.
Ebene
Einstellungen
They are stored per client in the table HrClientData. The mask automatically shows every field of HrClientData. Yes/No fields offer the choices "empty", "No" and "Yes"; "empty" means: the system parameter applies. Texts, numbers and lists are entered as text (several values separated by commas); an empty field also means that the system parameter applies. The field for the Velocity script of the person header is a multi-line editor with the button "Add default script into editor".
For settings that exist on both levels, the following applies (HrOptionsService):
HrOptions applies.
|
Level |
Settings |
|
|---|---|---|
|
System and client (client takes precedence) |
usePositionPlan, useOfLocationsMandatory, useOfCostCentersMandatory, useOfJobLevelsMandatory, terminatedOrgUnitShortName, terminatedPositionShortName, terminatedCostCenterShortName, terminatedLocationShortName, allowLockingOfPositionHours, ignoreHistoricInfoMessages, ignoreHistoricWarnings, ignoreHistoricExceptions, showJobsAndPositions, acknowledgeableMessagesSupportEnabled, maximumUploadSizeInMB, personHeaderVelocityScript, activeReasonCodesToDisplayInPositionPlan, reEntryActionVisible, immediateResignationActionVisible, socialSecurityRegistrationActionVisible, allowRelativeSelectionFromAllClients, automaticEntryDateCorrection, defaultSalaryCode, hrPersonCustomQuery, hrPersonCustomSelectClause, hrPersonAdditionalSelectClause, enableTaIntegration, documentSigningSupported, documentSigningProcessDefinitionName, hiringEmployeesOrgUnitShortName sowie die Eigenschaften von Mutterschutz und Karenz | Nur System
, and the properties for maternity protection and parental leave |
|
System only (HrOptions) |
userRoles, userRolesReadOnly, positionShortNameGeneratorBeanName, jobShortNameGeneratorBeanName, tasksSharedAcrossJobs, multipleJobsAssignedToPosition, phoneNumberExtensionDynamicFieldName, shouldCorrectPersonTaskTimeShares, shouldStartTimeDistributionProcess, hideHrxPersonCreationWizard |
|
|
Nur Mandant Client only (HrClientData) |
hideDashboardAndReportsAndSystemMaintenanceForNonClientWideHRXUsers, ignorePayGradeChangesForSalaryReportDateCalculation |
Achtung: Die Schalter Warning: According to the code, the switches usePositionPlan, useOfLocationsMandatory, useOfCostCentersMandatory und useOfJobLevelsMandatory sind laut Code Schalter für die Installation und sollen nicht in einem laufenden System geändert werden. Beim Einschalten werden bestehende Personen und Planstellen beim Speichern gegen die neue Regel geprüft und müssen gegebenenfalls zuerst angepasst werden.
Diese Einstellungen legen fest, wie Personen, Planstellen, Standorte, Kostenstellen und Karriere-Level zusammenhängen müssen und welche Stellen-Funktionen in HR-Expert sichtbar sind. Alle Werte der Tabelle außer den letzten vier Zeilen gibt es auf System- und Mandantenebene.
Eigenschaft
Erklärung
mögliche Wert(e)
usePositionPlan
Mandantenfeld: "Zuordnung einer primären Planstelle ist Pflicht". false: Eine Person kann zu jedem Zeitpunkt mit 0 bis 1 primären Planstelle verbunden sein. true: In der Vergangenheit 0 bis 1 primäre Planstelle, in Gegenwart und Zukunft muss jede Person mit genau 1 primären Planstelle verbunden sein. Schalter für die Installation, nicht für ein laufendes System: Eine Änderung wirkt nur auf neu angelegte Zeitverläufe, bestehende bleiben unverändert. Bei true ist die Stellen-Zuordnung der Person (Feld personJobs) im Personeneditor nicht bearbeitbar.
true/false (Standard: false)
useOfLocationsMandatory
Mandantenfeld: "Zuordnung eines Standorts isf Pflicht" (Schreibweise wie in der Maske). false: Planstellen und Personen können zu jedem Zeitpunkt mit 0 bis 1 Standort verbunden sein. true: In Gegenwart und Zukunft muss jede Planstelle und jede Person mit genau 1 Standort verbunden sein. Beim Einschalten müssen bestehende Planstellen und Personen ohne Standort beim Speichern zuerst für ihre gesamte Gültigkeit einen Standort erhalten.
true/false (Standard: false)
useOfCostCentersMandatory
Mandantenfeld: "Zuordnung einer Kostenstelle ist Pflicht". false: Eine Planstelle kann mit beliebig vielen Kostenstellen verbunden sein, die bis zu 100 Prozent der Kosten abdecken; eine Person mit 0 bis 1 Kostenstelle. true: In Gegenwart und Zukunft muss jede Planstelle mit mindestens 1 Kostenstelle verbunden sein, und die Kostenstellen müssen die Kosten zu genau 100 Prozent abdecken; jede Person muss mit genau 1 Kostenstelle verbunden sein. Beim Einschalten müssen bestehende Planstellen und Personen ohne bzw. mit nicht deckender Kostenstellenzuordnung beim Speichern zuerst vollständig zugeordnet werden.
true/false (Standard: false)
useOfJobLevelsMandatory
Mandantenfeld: "Zuordnung eines Karriere-Levels ist Pflicht". Bei true muss jede Planstelle mit einem Karriere-Level (HrJobLevel) verbunden sein.
true/false (Standard: false)
allowLockingOfPositionHours
Mandantenfeld: "Sperren von Wochenstunden der Planstellen erlauben". Bei true kann bei den Arbeitszeitklassifizierungen einer Planstelle (HrPositionLaborClassification) ein Wert 0 < lockedHoursPerWeek < hoursPerWeek definiert werden. Personen können nur hoursPerWeek minus lockedHoursPerWeek zugewiesen werden; eine Überbuchung (die gleichzeitig vergebenen Wochenstunden aller Personen übersteigen hoursPerWeek minus lockedHoursPerWeek) ist nicht erlaubt und führt zu einem Fehler. Bei false werden die Felder lockedHoursPerWeek und lockingComment der Arbeitszeitklassifizierung ausgeblendet. Beim Einschalten müssen bestehende Planstellen und Personen unter Umständen angepasst werden.
true/false (Standard: false)
showJobsAndPositions
and useOfJobLevelsMandatory are installation switches and are not meant to be changed on a running system. When switching them on, existing persons and positions are checked against the new rule on save and may have to be adjusted first.
These settings define how persons, positions, locations, cost centers and career levels must be connected and which job and position functions are visible in HR-Expert. All values in the table, except the last four rows, exist on the system and the client level.
|
Property |
Description |
Possible value(s) |
|---|---|---|
|
usePositionPlan |
Client field: "Primary position assignment is mandatory". false: a person can be connected to 0 to 1 primary position at any point in time. true: in the past 0 to 1 primary position; in the present and future every person must be connected to exactly 1 primary position. This is an installation switch, not meant for a running system: a change only affects newly created timelines, existing ones remain unchanged. If true, the job assignment of the person (field personJobs) cannot be edited in the person editor. |
true/false (default: false) |
|
useOfLocationsMandatory |
Client field: "Location assignment is mandatory". false: positions and persons can be connected to 0 to 1 location at any point in time. true: in the present and future every position and every person must be connected to exactly 1 location. When switching on, existing positions and persons without a location must first be assigned a location for their entire validity when they are saved. |
true/false (default: false) |
|
useOfCostCentersMandatory |
Client field: "Cost center assignment is mandatory". false: a position can be connected to any number of cost centers covering up to 100 percent of the costs; a person to 0 to 1 cost center. true: in the present and future every position must be connected to at least 1 cost center and the cost centers must cover the costs by exactly 100 percent; every person must be connected to exactly 1 cost center. When switching on, existing positions and persons without or with non-covering cost center assignments must first be fully assigned when they are saved. |
true/false (default: false) |
|
useOfJobLevelsMandatory |
Client field: "Career level assignment is mandatory". If true, every position must be linked to a career level (HrJobLevel). |
true/false (default: false) |
|
allowLockingOfPositionHours |
Client field: "Allow locking of position hours". If true, a value 0 < lockedHoursPerWeek < hoursPerWeek can be defined for the labor classifications of a position (HrPositionLaborClassification). Only hoursPerWeek minus lockedHoursPerWeek can be assigned to persons; overbooking (the hours per week assigned concurrently to all persons exceed hoursPerWeek minus lockedHoursPerWeek) is not allowed and raises an error. If false, the fields lockedHoursPerWeek and lockingComment of the labor classification are hidden. When switching on, existing positions and persons may have to be adjusted. |
true/false (default: false) |
|
showJobsAndPositions |
Client field: "Show UIs related to jobs and positions". If false, the menu entries for jobs and positions (actions jobchooser, job, positionchooser, position, positionplan, jobfamilychooser, joblevelchooser sowie der Bericht Stellenplan) und die Planstellen-Zuordnung in der Personenmaske ausgeblendet. Ohne Mandantenbezug (z.B. Ansicht über alle Mandanten) bleiben die Menüeinträge sichtbar, and the position plan report) and the position assignment in the person mask are hidden. Without a client context (for example a view across all clients) the menu entries remain visible. |
true/false (Standarddefault: false) |
|
activeReasonCodesToDisplayInPositionPlan |
MandantenfeldClient field: "Gründe, die für aktiven Beschäftigungszustand im Stellenplan anzuzeigen sind, getrennt mit Beistrich." Durch Beistrich getrennte Namen von Beschäftigungs-Gründen (reasonCode, unübersetzt) von "aktiv" beschäftigten Personen, für die im Stellenplan auch Eintrittsdatum, Austrittsdatum und Beschäftigungsgrund angezeigt werden. Beim Mandanten wird die Liste als Text mit Beistrich-getrennten Werten eingegeben; ist sie leer, gilt der Systemparameter. |
Liste bzw. Text mit Beistrich (Standard: leer) |
|
multipleJobsAssignedToPosition |
Nur System. Bei true darf eine Planstelle zu einem Zeitpunkt auf mehrere Stellen verweisen (Beziehung Planstelle - Stelle wird m:n); bei false nur auf eine. |
true/false (Standard: false) |
|
positionShortNameGeneratorBeanName |
Nur System. Name einer Bean, die den Kurznamen neuer Planstellen automatisch erzeugt. Ist der Wert leer oder gibt es keine Bean dieses Namens, wird kein Kurzname vorgeschlagen. Mitgeliefert ist die Bean |
Bean-Name, z.B. HrPositionShortNameGenerator (Standard: leer) |
|
jobShortNameGeneratorBeanName |
Nur System. Wie positionShortNameGeneratorBeanName, aber für den Kurznamen neuer Stellen. Mitgeliefert ist die Bean |
Bean-Name, z.B. HrJobShortNameGenerator (Standard: leer) |
Ausgetretene Personen werden einer festgelegten Organisationseinheit, Planstelle, Kostenstelle und einem Standort zugeordnet. Personen im Einstellungsprozess (Beschäftigungszustand "hiring") können einer eigenen Organisationseinheit zugeordnet werden. Alle Eigenschaften dieser Gruppe gibt es auf System- und Mandantenebene; ein nicht leerer Mandantenwert hat Vorrang.
|
Eigenschaft |
Erklärung |
mögliche Wert(e) |
|---|---|---|
|
terminatedOrgUnitShortName |
Mandantenfeld: "Kurzname der Gruppe für ausgetretene Mitarbeiter". Der Kurzname der Organisationseinheit, zu der jede ausgetretene Person zugeordnet wird. Muss immer angegeben werden. Hat der Mandant in seinen Stammdaten Kurznamen für Gruppen ausgetretener Mitarbeiter hinterlegt (terminatedEmploymentGroupsShortNames) und ist dieses Feld beim Mandanten leer, wird beim Speichern der erste dieser Kurznamen übernommen. |
Kurzname (Standard: leer) |
|
terminatedPositionShortName |
Mandantenfeld: "Kurzname der Planstelle für ausgetretene Mitarbeiter". Der Kurzname der Planstelle, zu der jede ausgetretene Person (mit 0 Stunden) zugeordnet wird. Muss angegeben werden, wenn usePositionPlan true ist, andernfalls wird er ignoriert. |
Kurzname (Standard: leer) |
|
terminatedCostCenterShortName |
Mandantenfeld: "Kurzname der Kostenstelle für ausgetretene Mitarbeiter". Der Kurzname der Kostenstelle, zu der jede ausgetretene Person zugeordnet wird. Muss angegeben werden, wenn useOfCostCentersMandatory true ist, andernfalls wird er ignoriert. |
Kurzname (Standard: leer) |
|
terminatedLocationShortName |
Mandantenfeld: "Kurzname des Standorts für ausgetretene Mitarbeiter". Der Kurzname des Standorts, zu dem jede ausgetretene Person zugeordnet wird. Muss angegeben werden, wenn useOfLocationsMandatory true ist, andernfalls wird er ignoriert. |
Kurzname (Standard: leer) |
|
hiringEmployeesOrgUnitShortName |
Mandantenfeld: "Orgeinheit Kurzname für Gruppe mit zuküntigen Mitarbeitern" (Schreibweise wie in der Maske). Kurzname der Organisationseinheit, der Personen für die Dauer des Beschäftigungszustands "hiring" zugeordnet werden (Personen im Einstellungsprozess, noch nicht beschäftigt). Ist der Wert leer oder gibt es keine Organisationseinheit mit diesem Kurznamen, erfolgt keine Zuordnung. |
Kurzname (Standard: leer) |
Der Zugriff auf HR-Expert wird über Webdesk-Rollen gesteuert. Die Rollennamen werden ausschließlich als Systemparameter festgelegt. Die Kompetenz der Rollenzuordnung (Mandanten, Gruppen, Personen) bestimmt, welche Daten der Benutzer sieht. Der Systemadministrator hat immer Zugriff.
|
Eigenschaft |
Erklärung |
mögliche Wert(e) |
|---|---|---|
|
userRoles |
Nur System. Liste der Namen der Rollen mit Lese- und Schreibzugriff auf HR-Expert. Die Namen müssen mit tatsächlich angelegten Webdesk-Rollen übereinstimmen (inklusive des führenden $ im Rollennamen). |
Liste von Rollennamen (Standard: $HRX_User) |
|
userRolesReadOnly |
Nur System. Liste der Namen der Rollen mit reinem Lesezugriff auf HR-Expert. Ein Benutzer gilt als "nur lesend", wenn er eine dieser Rollen hat und keine Rolle aus userRoles. |
Liste von Rollennamen (Standard: $HRX_User_ReadOnly) |
|
hideDashboardAndReportsAndSystemMaintenanceForNonClientWideHRXUsers |
Nur Mandant. Mandantenfeld: "Dashboard, Berichte und Systemwartung anzeigen". Trotz des Eigenschaftsnamens bedeutet true "anzeigen": Bei true oder leer werden Dashboard, Berichte und Systemwartung im HR-Expert-Menü angezeigt (sofern der Benutzer für mindestens einen Mandanten zuständig ist), bei false werden sie für Personen dieses Mandanten ausgeblendet. Es gibt keinen Systemparameter; ohne Wert gilt "anzeigen". |
true/false oder leer (Standard: leer, wirkt wie true) |
Ein Mandant gilt im Sinn von HR-Expert als "HR-Mandant" (isClientUsingHr), wenn für ihn, für seine Gruppen oder für seine Personen eine Rolle aus userRoles oder userRolesReadOnly zugewiesen ist; sind keine Rollen konfiguriert, gilt kein Mandant als HR-Mandant.
|
Eigenschaft |
Erklärung |
mögliche Wert(e) |
|---|---|---|
|
personHeaderVelocityScript |
System und Mandant. Mandantenfeld: "Velocity script für Kopfteil im Personeneditor". Velocity-Skript für den Kopfteil des Personeneditors. Mögliche Variablen: Eigenschaften von Reason codes of active employment state to be shown in position plan, separated with comma." Comma-separated names of employment reasons (reasonCode, untranslated) of "actively" employed persons for which the position plan also shows start day, end day and employment reason. On the client the list is entered as text with comma-separated values; if it is empty, the system parameter applies. |
List or comma-separated text (default: empty) |
|
multipleJobsAssignedToPosition |
System only. If true, a position may refer to several jobs at a certain time (the position - job relation becomes m:n); if false, to only one. |
true/false (default: false) |
|
positionShortNameGeneratorBeanName |
System only. Name of a bean that automatically generates the short name of new positions. If the value is empty or no bean of this name exists, no short name is suggested. The bean |
Bean name, e.g. HrPositionShortNameGenerator (default: empty) |
|
jobShortNameGeneratorBeanName |
System only. Like positionShortNameGeneratorBeanName, but for the short name of new jobs. The bean |
Bean name, e.g. HrJobShortNameGenerator (default: empty) |
Terminated persons are assigned to a defined organization unit, position, cost center and location. Persons in the hiring process (employment state "hiring") can be assigned to a separate organization unit. All properties of this group exist on the system and the client level; a non-empty client value takes precedence.
|
Property |
Description |
Possible value(s) |
|---|---|---|
|
terminatedOrgUnitShortName |
Client field: "Short name of organisation unit for persons with terminated employment". The short name of the organization unit to which every terminated person is assigned. It must always be specified. If the client has short names of groups for terminated employees in its master data (terminatedEmploymentGroupsShortNames) and this field is empty on the client, the first of these short names is taken over on save. |
Short name (default: empty) |
|
terminatedPositionShortName |
Client field: "Short name of position for persons with terminated employment". The short name of the position to which every terminated person is assigned (with 0 hours). It must be specified if usePositionPlan is true, otherwise it is ignored. |
Short name (default: empty) |
|
terminatedCostCenterShortName |
Client field: "Short name of cost center for persons with terminated employment". The short name of the cost center to which every terminated person is assigned. It must be specified if useOfCostCentersMandatory is true, otherwise it is ignored. |
Short name (default: empty) |
|
terminatedLocationShortName |
Client field: "Short name of location for persons with terminated employment". The short name of the location to which every terminated person is assigned. It must be specified if useOfLocationsMandatory is true, otherwise it is ignored. |
Short name (default: empty) |
|
hiringEmployeesOrgUnitShortName |
Client field: "Orgunit shortname for group with currently hiring employees". Short name of the organization unit to which persons are assigned for the duration of the employment state "hiring" (persons in the hiring process, not yet employed). If the value is empty or no organization unit with this short name exists, no assignment is made. |
Short name (default: empty) |
Access to HR-Expert is controlled by Webdesk roles. The role names are defined exclusively as system parameters. The competence of the role assignment (clients, groups, persons) determines which data the user sees. The system administrator always has access.
|
Property |
Description |
Possible value(s) |
|---|---|---|
|
userRoles |
System only. List of the names of the roles with read and write access to HR-Expert. The names must match roles that actually exist in Webdesk (including the leading $ of the role name). |
List of role names (default: $HRX_User) |
|
userRolesReadOnly |
System only. List of the names of the roles with read-only access to HR-Expert. A user is treated as "read only" if he has one of these roles and no role from userRoles. |
List of role names (default: $HRX_User_ReadOnly) |
|
hideDashboardAndReportsAndSystemMaintenanceForNonClientWideHRXUsers |
Client only. Client field: "Show Dashboard, reports, and system maintenance". Despite the property name, true means "show": if true or empty, dashboard, reports and system maintenance are shown in the HR-Expert menu (provided the user is responsible for at least one client); if false, they are hidden for persons of this client. There is no system parameter; without a value "show" applies. |
true/false or empty (default: empty, acts like true) |
A client counts as an HR client in the sense of HR-Expert (isClientUsingHr) if a role from userRoles or userRolesReadOnly is assigned for the client, for its groups or for its persons; if no roles are configured, no client counts as an HR client.
|
Property |
Description |
Possible value(s) |
|---|---|---|
|
personHeaderVelocityScript |
System and client. Client field: "Velocity script for header in person editor". Velocity script for the header part of the person editor. Possible variables: properties of $primaryPosition (HrPosition), $hierarchicalGroup (PoGroup) und and $employmentState (HrPersonEmploymentState); die übersetzten bzw. konvertierten Personen-Werte $birthday und $gender; jede Eigenschaft von HrPerson und der mit ihr verbundenen Objekte, etwa $person.lastName. Ist weder beim Mandanten noch im Systemparameter ein Text gesetzt, wird das mitgelieferte Standardskript (Datei the translated/converted person values $birthday and $gender; every property of HrPerson and its related objects, such as $person.lastName. If neither the client nor the system parameter contains a text, the delivered default script (file |
Velocity-Text (Standard: leer, es gilt das Standardskript) |
|
reEntryActionVisible |
System und Mandant. Mandantenfeld: "Person Wiedereintritt Aktion sichtbar". Bei true ist die Aktion "Wiedereintritt" im Personeneditor sichtbar. |
true/false (Standard: true) |
|
immediateResignationActionVisible |
System und Mandant. Mandantenfeld: "Person sofortiger Austritt Aktion sichtbar". Bei true ist die Aktion für den sofortigen Austritt ("Resignation") im Personeneditor sichtbar. |
true/false (Standard: true) |
|
socialSecurityRegistrationActionVisible |
System und Mandant. Mandantenfeld: "Person Sozialversicherung Anmeldung Aktion sichtbar". Legt fest, ob die Aktionen zur Sozialversicherungs-Anmeldung für Personen in HR-Expert sichtbar sind. |
true/false (Standard: true) |
|
acknowledgeableMessagesSupportEnabled |
System und Mandant. Mandantenfeld: "Nachrichten zur Kenntnisnahme erlauben". Legt fest, ob Nachrichten zur Kenntnisnahme (acknowledgeable messages) über das HR-Expert-Menü bzw. direkt über die URL erreichbar sind. Bei false wird der Menüeintrag ausgeblendet. |
true/false (Standard: false) |
|
hideHrxPersonCreationWizard |
Nur System. Bei true wird der Assistent zum Anlegen von Personen ausgeblendet; "Neu" in der Personenauswahl öffnet dann direkt den vollständigen Personeneditor. Gedacht für Sonderfälle, in denen der Assistent wegen angepasster Masken nicht verwendbar ist. |
true/false (Standard: false) |
|
Eigenschaft |
Erklärung |
mögliche Wert(e) |
|---|---|---|
|
ignoreHistoricInfoMessages |
System und Mandant. Mandantenfeld: "Historische Meldungen ignorieren". Bei true werden Info-Meldungen der Geschäftslogik-Prüfungen (BusinessLogicAudits) für Zustände unterdrückt, die in der Vergangenheit enden. |
true/false (Standard: true) |
|
ignoreHistoricWarnings |
System und Mandant. Mandantenfeld: "Historische Warnungen ignorieren". Wie ignoreHistoricInfoMessages, aber für Warnungen. |
true/false (Standard: true) |
|
ignoreHistoricExceptions |
System und Mandant. Mandantenfeld: "Historische Fehlermeldungen ignorieren". Bei true werden Fehler (BusinessLogicExceptions) der Geschäftslogik-Prüfungen für Zustände unterdrückt, die in der Vergangenheit enden. |
true/false (Standard: false) |
|
automaticEntryDateCorrection |
System und Mandant. Mandantenfeld: "Eintrittsdatum wird für jeden Beschäftigungszustand automatisch korregiert." (Schreibweise wie in der Maske). Wenn aktiviert, wird beim Speichern einer Person in HR-Expert das Eintrittsdatum für jeden Beschäftigungszustand automatisch korrigiert. |
true/false (Standard: true) |
|
is used. The button "Add default script into editor" appends the default script after the existing content; the original content is retained, and nothing happens if the default script was already added and not changed. |
Velocity text (default: empty, the default script applies) |
|
|
reEntryActionVisible |
System and client. Client field: "Person re-entry action visible". If true, the action "Re-Entry" is visible in the person editor. |
true/false (default: true) |
|
immediateResignationActionVisible |
System and client. Client field: "Person immediate resignation action visible". If true, the action for immediate resignation ("Resignation") is visible in the person editor. |
true/false (default: true) |
|
socialSecurityRegistrationActionVisible |
System and client. Client field: "Person social security registration action visible". Defines whether the social security registration actions are visible for persons in HR-Expert. |
true/false (default: true) |
|
acknowledgeableMessagesSupportEnabled |
System and client. Client field: "Allow using acknowledgeable messages". Defines whether acknowledgeable messages are accessible through the HR-Expert menu or directly through the URL. If false, the menu entry is hidden. |
true/false (default: false) |
|
hideHrxPersonCreationWizard |
System only. If true, the wizard for creating persons is hidden; "New" in the person chooser then opens the full person editor directly. Intended for special cases in which the wizard cannot be used because of customized masks. |
true/false (default: false) |
|
Property |
Description |
Possible value(s) |
|---|---|---|
|
ignoreHistoricInfoMessages |
System and client. Client field: "Ignore historic info messages". If true, info messages generated by the business logic audits (BusinessLogicAudits) are suppressed for states that ended in the past. |
true/false (default: true) |
|
ignoreHistoricWarnings |
System and client. Client field: "Ignore historic warnings". Like ignoreHistoricInfoMessages, but for warnings. |
true/false (default: true) |
|
ignoreHistoricExceptions |
System and client. Client field: "Ignore historic exceptions". If true, errors (BusinessLogicExceptions) raised by the business logic audits are suppressed for states that ended in the past. |
true/false (default: false) |
|
automaticEntryDateCorrection |
System and client. Client field: "Entry date for every employment state will be automatically corrected." If enabled, the entry date of every employment state is corrected automatically when a person is saved in HR-Expert. |
true/false (default: true) |
These three settings allow the query of the person chooser (HrPersonReader) to be customized. They exist on the system and the client level; if nothing is set on the client, the system parameter applies. Custom queries must use the aliases of the default query: PoPerson = p, HrPerson = hrp, HrPersonEmployment = emp, HrPersonEmploymentState = st, PoGroup = g, PoPersonGroup = pg, PoClient = c.
|
Eigenschaft |
Erklärung |
mögliche Wert(e Property |
Description |
Possible value(s) |
|---|---|---|---|---|
|
hrPersonCustomQuery |
MandantenfeldClient field: "Benutzerdefinierte Abfrage für die PersonenauswahlCustom query for person chooser". Die vollständige The complete (HQL-)Abfrage der Personenauswahl. Sie überschreibt jede vom System kommende Abfrage; ist sie gesetzt, werden hrPersonCustomSelectClause und hrPersonAdditionalSelectClause ignoriert. |
HQL-Abfrage (Standard: leer) |
||
|
hrPersonCustomSelectClause |
Mandantenfeld: "Benutzerdefinierte Auswahl für Personenauswahl-Abfrage". Eine eigene "select"-Klausel (durch Beistrich getrennte Eigenschaften), die die Klausel der Standardabfrage ersetzt. Sie bestimmt die Spalten, die in der Personenauswahl angezeigt werden. Wird ignoriert, wenn hrPersonCustomQuery gesetzt ist, und überschreibt hrPersonAdditionalSelectClause. |
Eigenschaftsliste (Standard: leer) |
||
|
hrPersonAdditionalSelectClause |
Mandantenfeld: "Zusätzliche "select" für die Personenauswahl-Abfrage". Zusätzliche Eigenschaften, die an die "select"-Klausel der Standardabfrage angehängt werden und als zusätzliche Spalten in der Personenauswahl erscheinen. Wird ignoriert, wenn hrPersonCustomQuery oder hrPersonCustomSelectClause gesetzt ist. |
Eigenschaftsliste (Standard: leer) |
|
Eigenschaft |
Erklärung |
mögliche Wert(e) |
|---|---|---|
|
enableTaIntegration |
System und Mandant. Mandantenfeld: "Aktiviere Synchronisation mit Zeiterfassung". Schaltet die Synchronisation zwischen HR und Zeiterfassung ein: die Zeiterfassungs-Konfiguration der Personen und das automatische Anlegen von Abwesenheitseinträgen aufgrund der Beschäftigungszustände in HR-Expert. Ist der Systemparameter false (Standard), wird die Synchronisation nur für Mandanten durchgeführt, bei denen true eingetragen ist. Ist der Systemparameter true, wird sie für alle Mandanten durchgeführt, bei denen der Wert leer oder true ist (ein Mandant mit false wird ausgenommen). |
true/false (Standard: false) |
|
Eigenschaft |
Erklärung |
mögliche Wert(e) |
|---|---|---|
|
maximumUploadSizeInMB |
System und Mandant. Maximale Größe von hochgeladenen Dateien innerhalb von HR-Expert in MB (Personendokumente). Maßgeblich ist der Mandant des angemeldeten Benutzers. Im Reiter "Personalwesen" gibt es ein Feld gleichen Namens. |
Zahl in MB (Standard: 5) |
|
documentSigningSupported |
System und Mandant. Mandantenfeld: "Unterstützung Dokumenten-Signatur-Prozess". Legt fest, ob das Signieren von Personendokumenten unterstützt wird. Gestartet wird dabei ein Workflow-Prozess (siehe documentSigningProcessDefinitionName), dem das Dokument als PDF angehängt wird. Dokumente müssen im Format Docx oder PDF vorliegen; Docx wird in PDF umgewandelt, andere Formate führen zu einem Fehler. |
true/false (Standard: false) |
|
documentSigningProcessDefinitionName |
System und Mandant. Mandantenfeld: "Prozessdefinition für digitale Signaturen". Name der Prozessdefinition, die für den Signaturprozess gestartet wird. Ist beim Start des Signaturprozesses weder beim Mandanten noch im Systemparameter ein Name eingetragen, bricht der Start mit einer Fehlermeldung ab. |
Name der Prozessdefinition (Standard: leer) |
Diese Einstellungen betreffen die Zuordnung von Aufgaben (HrTask) zu Stellen (HrJob) und Personen. Sie gelten nur systemweit, nicht je Mandant.
|
Eigenschaft |
Erklärung |
mögliche Wert(e) |
|---|---|---|
|
tasksSharedAcrossJobs |
Nur System, laut Code ausdrücklich nicht mandantenspezifisch. Bei false wird die m:n-Beziehung zwischen Aufgabe und Stelle zu einer 1:n-Beziehung: Eine Aufgabe kann dann höchstens Teil einer Stelle sein. |
true/false (Standard: true) |
|
shouldCorrectPersonTaskTimeShares |
Nur System. Wird eine Stelle oder Aufgabe gelöscht oder eine Aufgabe von einer Stelle entfernt, werden die Zuordnungen von Personen zu den betroffenen Aufgaben (HrPersonTask) historisiert. Bei true werden die Aufgaben-Zuordnungen der betroffenen Personen anschließend so korrigiert, dass die Summe der Zeitanteile in jedem Intervall 100 % beträgt. |
true/false (Standard: false) |
|
shouldStartTimeDistributionProcess |
Nur System. Bei true wird nach dem Historisieren von Personen-Aufgaben-Zuordnungen für jede betroffene Person ein Benachrichtigungsprozess gestartet, der auf die Aktion |
true/false (Standard: false) |
|
Eigenschaft |
Erklärung |
mögliche Wert(e) |
|---|---|---|
|
allowRelativeSelectionFromAllClients |
System und Mandant. Mandantenfeld: "Erlaube alle Mandanten bei Bestimmung interner Verwandter". Bei true können Angehörige einer Person aus den Personen aller Mandanten gewählt werden, nicht nur aus dem Mandanten der Person (Personenmaske, Reiter "Familie", Unter-Reiter "Angehörige im Unternehmen"). |
true/false (Standard: false) |
|
defaultSalaryCode |
System und Mandant. Mandantenfeld: "Standardgehaltscode für neue Gehälter". Der Gehaltscode, der beim Anlegen eines neuen Gehalts einer Person vorbelegt wird. Im Mandantenfeld wird der Code aus einer Auswahlliste gewählt. |
Gehaltscode (Standard: BASE) |
|
phoneNumberExtensionDynamicFieldName |
Nur System. Name eines dynamischen Feldes, in dem die Durchwahl der Büro-Telefonnummer einer Person gespeichert ist. Ist ein Name eingetragen, überschreibt der Wert dieses Feldes die Durchwahl aus den Personendaten (PoPerson.officePhoneNumberExtension) bei der Ausgabe der Büro-Telefonnummer in den Personenlisten-Berichten. |
Feldname (Standard: leer) |
|
ignorePayGradeChangesForSalaryReportDateCalculation |
Nur Mandant. Mandantenfeld: "Gehaltsstufen für Datums berechnung in Auswertung ignorieren". Sonderfall für Kunden, die Gehaltserhöhungen als Höherstufung vergeben, den Zeitpunkt der nächsten regulären Vorrückung dadurch aber nicht verschieben: Bei true werden bei der Datumsberechnung in der Gehaltsauswertung nur Kollektivvertrag und Gehaltsgruppe verglichen, eine geänderte Gehaltsstufe zählt nicht als Änderung. Ohne Wert gilt false. |
true/false (Standard: leer, wirkt wie false) |
Die Regeln für Mutterschutz und Karenz stammen aus der Bean HrMaternityRestrictionOptions (Systemparameter, Modul hr) und können beim Mandanten im Reiter "Personalwesen" mit denselben Eigenschaftsnamen überschrieben werden; auch hier gilt: leerer Mandantenwert = Systemparameter. Die folgende Tabelle ist nur eine Übersicht der Namen; die Bedeutung ergibt sich aus der Beschriftung.
|
Eigenschaft |
Erklärung |
mögliche Wert(e) |
|---|---|---|
|
protectionFromDayBeforeExpectedBirthDayWeeks |
Wochen vor dem erwarteten Geburtstermin, ab denen der Mutterschutz beginnt. |
Zahl (Standard: 8) |
|
expectedProtectionToDayAfterExpectedBirthDayWeeks |
Wochen nach dem erwarteten Geburtstermin, nach denen der Mutterschutz endet. |
Zahl (Standard: 8) |
|
protectionToDayAfterActualPrematureBirthDayWeeks |
Wochen nach einer Frühgeburt, nach denen der Mutterschutz endet. |
Zahl (Standard: 12) |
|
protectionToDayAfterActualMultiplesBirthDayWeeks |
Wochen nach einer Mehrlingsgeburt, nach denen der Mutterschutz endet. |
Zahl (Standard: 12) |
|
protectionToDayAfterActualCesareanBirthDayWeeks |
Wochen nach einem Kaiserschnitt, nach denen der Mutterschutz endet. |
Zahl (Standard: 12) |
|
maximumPeriodOfMaternityProtectionAfterBirthInWeeks |
Dauer des Mutterschutzes nach der Geburt in Wochen (relevant, wenn die Geburt vor dem erwarteten Termin erfolgt). |
Zahl (Standard: 16) |
|
parentalLeaveMaximumEndDayAfterActualBirthDayMonths |
Monate nach der Geburt, nach denen die Karenz spätestens endet. |
Zahl (Standard: 24) |
|
employmentStateToBeSetForProtection |
Beschäftigungsstatus während des Mutterschutzes (ACTIVE, INACTIVE oder TERMINATED). |
Status (Standard: INACTIVE) |
|
reasonCodeToBeSetForProtection |
Grund (Schlüsselwert-Typ HrEmploymentStateReasonCode) während des Mutterschutzes. |
Schlüssel (Standard: MATERNITYPROTECTION) |
|
reasonCodeToBeSetAfterProtection |
Grund für die Rückkehr nach dem Ende des Mutterschutzes. |
Schlüssel (Standard: MATERNITYPROTECTION_END) |
|
zeroHoursPerWeekDuringProtection |
Ob die Wochenstunden im Beschäftigungsstatus und in den Zuordnungen zu Planstellen während des Mutterschutzes auf 0 gesetzt werden. |
true/false (Standard: false) |
|
employmentStateToBeSetForParentalLeave |
Beschäftigungsstatus während der Karenz (ACTIVE, INACTIVE oder TERMINATED). |
Status (Standard: INACTIVE) |
|
reasonCodeToBeSetForParentalLeave |
Grund während der Karenz. |
Schlüssel (Standard: PATERNALLEAVE) |
|
reasonCodeToBeSetAfterParentalLeave |
Grund für die Rückkehr nach der Karenz. |
Schlüssel (Standard: PATERNALLEAVE_END) |
|
zeroHoursPerWeekDuringParentalLeave |
Ob die Wochenstunden im Beschäftigungsstatus und in den Zuordnungen zu Planstellen während der Karenz auf 0 gesetzt werden. |
true/false (Standard: false) |
userRoles und userRolesReadOnly (Listen). Die früher genannten Eigenschaften userRole und userRoleReadOnly gibt es in der Bean HrOptions nicht mehr.
|
) query of the person chooser. It overrides any query coming from the system; if it is set, hrPersonCustomSelectClause and hrPersonAdditionalSelectClause are ignored. |
HQL query (default: empty) |
|
|
hrPersonCustomSelectClause |
Client field: "Custom select for person chooser query". A custom "select" clause (comma-separated properties) that replaces the clause of the default query. It determines the columns shown in the person chooser. It is ignored if hrPersonCustomQuery is set, and it overrides hrPersonAdditionalSelectClause. |
List of properties (default: empty) |
|
hrPersonAdditionalSelectClause |
Client field: "Additional "select" for person chooser query". Additional properties that are appended to the "select" clause of the default query and appear as additional columns in the person chooser. It is ignored if hrPersonCustomQuery or hrPersonCustomSelectClause is set. |
List of properties (default: empty) |
|
Property |
Description |
Possible value(s) |
|---|---|---|
|
enableTaIntegration |
System and client. Client field: "Enable synchronisation with Time&Attendance". Switches on the synchronization between HR and Time & Attendance: the Time & Attendance configuration of persons and the automatic creation of absence entries based on the employment states in HR-Expert. If the system parameter is false (default), the synchronization is performed only for clients where true is set. If the system parameter is true, it is performed for all clients where the value is empty or true (a client with false is excluded). |
true/false (default: false) |
|
Property |
Description |
Possible value(s) |
|---|---|---|
|
maximumUploadSizeInMB |
System and client. Maximum size of uploaded files within HR-Expert in MB (person documents). The client of the logged-in user is decisive. The "Human resources" tab has a field of the same name. |
Number in MB (default: 5) |
|
documentSigningSupported |
System and client. Client field: "Support document sigining process" (spelling as in the mask). Defines whether signing of person documents is supported. A workflow process is started (see documentSigningProcessDefinitionName) to which the document is attached as a PDF. Documents must be in Docx or PDF format; Docx is converted to PDF, other formats lead to an error. |
true/false (default: false) |
|
documentSigningProcessDefinitionName |
System and client. Client field: "Processdefinition for digital signatures". Name of the process definition that is started for the signing process. If neither the client nor the system parameter contains a name when the signing process is started, the start is aborted with an error message. |
Process definition name (default: empty) |
These settings concern the assignment of tasks (HrTask) to jobs (HrJob) and persons. They apply system-wide only, not per client.
|
Property |
Description |
Possible value(s) |
|---|---|---|
|
tasksSharedAcrossJobs |
System only; according to the code explicitly not client-specific. If false, the m:n relation between task and job becomes a 1:n relation: a task can then be part of at most one job. |
true/false (default: true) |
|
shouldCorrectPersonTaskTimeShares |
System only. When a job or a task is deleted, or a task is removed from a job, the assignments of persons to the affected tasks (HrPersonTask) are historized. If true, the task assignments of the affected persons are then corrected so that the sum of the time shares in every interval is 100 %. |
true/false (default: false) |
|
shouldStartTimeDistributionProcess |
System only. If true, after person-task assignments have been historized, a notification process pointing to the action |
true/false (default: false) |
|
Property |
Description |
Possible value(s) |
|---|---|---|
|
allowRelativeSelectionFromAllClients |
System and client. Client field: "Allow all clients on internal relatives assignment". If true, relatives of a person can be selected from the persons of all clients, not only from the person's own client (person mask, tab "Familie" (family), sub-tab "Angehörige im Unternehmen" (relatives in the company)). |
true/false (default: false) |
|
defaultSalaryCode |
System and client. Client field: "Default salary code for new salaries". The salary code that is pre-filled when a new salary is created for a person. In the client field the code is selected from a selection list. |
Salary code (default: BASE) |
|
phoneNumberExtensionDynamicFieldName |
System only. Name of a dynamic field that stores the extension of a person's office phone number. If a name is entered, the value of this field overrides the extension from the person data (PoPerson.officePhoneNumberExtension) when the office phone number is output in the person list reports. |
Field name (default: empty) |
|
ignorePayGradeChangesForSalaryReportDateCalculation |
Client only. Client field: "Ignore pay grade changes for salary report date calculation". Special case for customers who grant raises as pay grade increases but do not want this to shift the date of the next regular step: if true, the date calculation in the salary report compares only the labor contract and the pay group, a changed pay grade does not count as a change. Without a value, false applies. |
true/false (default: empty, acts like false) |
The rules for maternity protection and parental leave come from the bean HrMaternityRestrictionOptions (system parameter, module hr) and can be overridden on the client on the "Human resources" tab with the same property names; here, too, an empty client value means the system parameter applies. The following table is only an overview of the names; the meaning follows from the captions.
|
Property |
Description |
Possible value(s) |
|---|---|---|
|
protectionFromDayBeforeExpectedBirthDayWeeks |
Number of weeks before the expected birth date at which the maternity protection starts. |
Number (default: 8) |
|
expectedProtectionToDayAfterExpectedBirthDayWeeks |
Number of weeks after the expected birth date after which the maternity protection ends. |
Number (default: 8) |
|
protectionToDayAfterActualPrematureBirthDayWeeks |
Number of weeks after a premature birth after which the maternity protection ends. |
Number (default: 12) |
|
protectionToDayAfterActualMultiplesBirthDayWeeks |
Number of weeks after a multiple birth after which the maternity protection ends. |
Number (default: 12) |
|
protectionToDayAfterActualCesareanBirthDayWeeks |
Number of weeks after a cesarean birth after which the maternity protection ends. |
Number (default: 12) |
|
maximumPeriodOfMaternityProtectionAfterBirthInWeeks |
Duration of maternity protection after birth in weeks (relevant if the birth happens before the expected date). |
Number (default: 16) |
|
parentalLeaveMaximumEndDayAfterActualBirthDayMonths |
Number of months after the birth after which the parental leave ends at the latest. |
Number (default: 24) |
|
employmentStateToBeSetForProtection |
Employment state during maternity protection (ACTIVE, INACTIVE or TERMINATED). |
State (default: INACTIVE) |
|
reasonCodeToBeSetForProtection |
Reason (key-value type HrEmploymentStateReasonCode) during maternity protection. |
Key (default: MATERNITYPROTECTION) |
|
reasonCodeToBeSetAfterProtection |
Reason for the return after maternity protection has ended. |
Key (default: MATERNITYPROTECTION_END) |
|
zeroHoursPerWeekDuringProtection |
Whether the hours per week in the employment state and in the position assignments are set to 0 during maternity protection. |
true/false (default: false) |
|
employmentStateToBeSetForParentalLeave |
Employment state during parental leave (ACTIVE, INACTIVE or TERMINATED). |
State (default: INACTIVE) |
|
reasonCodeToBeSetForParentalLeave |
Reason during parental leave. |
Key (default: PATERNALLEAVE) |
|
reasonCodeToBeSetAfterParentalLeave |
Reason for the return after parental leave. |
Key (default: PATERNALLEAVE_END) |
|
zeroHoursPerWeekDuringParentalLeave |
Whether the hours per week in the employment state and in the position assignments are set to 0 during parental leave. |
true/false (default: false) |
userRoles and userRolesReadOnly (lists). The previously mentioned properties userRole and userRoleReadOnly no longer exist in the bean HrOptions.
| Mime Type | text/xml |  | text/xml |
| Datei-name | | ||
| Größe (in Bytes) | 36792 |  | 35182 |
|
Version 1 von Gabriel Gruber
am 17.10.26 19:05:24 Name: Systemparameter und Mandanteneinstellungen HR-Expert Variante: main - en Status: Entwurf |  |
Version 2 von Gabriel Gruber
am 17.10.26 19:06:24 Name: HR-Expert system parameters and client settings Variante: main - en Status: Veröffentlichung |