Benutzerdefinierte Felder und Erweiterbarkeit
Hinzufügen eines Feldes, das nicht zur Standardausstattung der Plattform gehört, ohne eine neue Version zu erstellen und ohne die Kerntabellen zu verändern.
Ein Feld, das Ihr Unternehmen benötigt, das aber von der Plattform nicht bereitgestellt wird, wird als benutzerdefiniertes Feld hinzugefügt. Es wird pro Unternehmen definiert, einer Ressource zugeordnet, mit einem Typ und einer Bezeichnung versehen und erscheint anschließend im Formular dieser Ressource, in ihren Listenspalten, Filtern, der Importzuordnung und beim Export.
- Benutzerdefinierte Felder befinden sich außerhalb der Kerntabellen, sodass das Hinzufügen eines solchen Feldes das Schema, das alle Unternehmen gemeinsam nutzen, nicht verändert.
- Es handelt sich um gewöhnliche Felder, sobald sie definiert sind – filterbar, sortierbar, importierbar und exportierbar, nicht um ein Notizfeld mit einer Bezeichnung.
- Sie gelten pro Unternehmen, daher sind die Ergänzungen eines Unternehmens für ein anderes nicht sichtbar.
- Ein Ja/Nein-Feld ist wie die Kontrollkästchen des Produkts selbst gestaltet: das Kästchen neben der Bezeichnung, die Bezeichnung anklickbar, die Hilfe direkt darunter.
Bevor Sie eine neue Liste hinzufügen, prüfen Sie, ob eine Klassifizierungsliste ausreicht. Wenn Sie lediglich einen neuen Wert in einer bestehenden Dropdown-Liste hinzufügen möchten, handelt es sich um eine Konfigurationseinstellung, nicht um eine Erweiterung.
Ein Feld als Pflichtfeld festlegen
Um ein Feld immer oder vor einem Schritt wie „Absenden“ oder „Posten“ als Pflichtfeld festzulegen, wählen Sie „Plattform“ › „Anpassen“ › „Feldanforderungen“: Aktivieren Sie die Option, es ist keine Regel erforderlich. Weitere Informationen finden Sie unter „Beliebige Felder als Pflichtfeld festlegen: Feldanforderungen“. Die unten beschriebene benutzerdefinierte Logik bezieht sich auf eine Bedingung.
Plattform → Anpassung → Benutzerdefinierte Logik enthält die unternehmensinternen Regeln: eine Validierung, die das Speichern verhindert, einen Wert, der bei jedem Speichern eines Datensatzes neu berechnet wird, und einen Standardwert für neue Datensätze. Um ein Feld als Pflichtfeld zu kennzeichnen – sei es ein vom Produkt mitgeliefertes oder ein von Ihnen hinzugefügtes –, erstellen Sie auf diesem Bildschirm eine Validierung, die nur dann zutrifft, wenn das Feld einen Wert enthält, und geben Sie die entsprechende Meldung an, die angezeigt werden soll, wenn das Feld leer ist.
- Open Platform → Customization → Custom Logic und wählen Sie das Modul und den Bildschirm — HRMS, Employees.
- Füge eine Regel vom Typ „Validieren“ hinzu, die bei jedem Speichern ausgeführt wird.
- Schreiben Sie die Bedingung, die erfüllt sein muss. `not_empty(iqama_number)` macht die Angabe der Iqama-Nummer für jeden Mitarbeiter erforderlich. `is_saudi or not_empty(iqama_number)` verlangt sie von allen, die keine saudischen Staatsangehörigen sind, was üblicherweise gemeint ist: Ein saudischer Staatsangehöriger besitzt einen Personalausweis, keine Iqama.
- Verfassen Sie die Nachricht – „Für Mitarbeiter, die keine saudischen Staatsangehörigen sind, ist eine Iqama-Nummer erforderlich“ – und speichern Sie sie. Testen Sie die Nachricht anschließend anhand eines Datensatzes auf demselben Bildschirm, bevor Sie sich darauf verlassen.
Die Regel wird vom Server bei jedem Speichern überprüft, unabhängig davon, wie der Datensatz übermittelt wird: per Formular, Import, ASK oder API. Änderungen an einem bestehenden Datensatz, die gegen die Regel verstoßen, werden ebenfalls abgelehnt.
In Saudi-Arabien enthält das Mitarbeiterformular auch die saudischen Daten: Staatsangehörigkeit, Iqama-Nummer und deren Ablaufdatum, Ablaufdatum der Arbeitserlaubnis, GOSI-Nummer und -Mitgliederklasse, Sponsorenwechsel, Einstellungsdatum nach der Hijri-Ära sowie Grundgehalt und die für die Berechnung der GOSI-Beiträge verwendeten Wohn- und Transportkosten. Jede dieser Angaben kann auf diese Weise als Pflichtfeld markiert werden. Das Formular zeigt bereits nur die zutreffenden Informationen an: Iqama-Nummer und deren Ablaufdatum, Ablaufdatum der Arbeitserlaubnis und Sponsorenwechsel, wenn die Staatsangehörigkeit nicht angekreuzt ist, sowie die GOSI-Mitgliederklasse, wenn sie angekreuzt ist.
Die Werte Ihrer Felder anzeigen
Unter „Plattform → Anpassung → Benutzerdefinierte Felder“ wird für den ausgewählten Bildschirm eine Tabelle mit den Datensätzen dieses Bildschirms angezeigt, wobei die firmeneigenen Felder als Spalten dienen. Die Tabelle ist durchsuchbar und wie jede Liste seitenweise lesbar, sodass Sie die ausgefüllten Felder einsehen können, ohne jeden Datensatz einzeln öffnen zu müssen.
- Es werden nur die Datensätze aufgelistet, die Sie bereits auf diesem Bildschirm öffnen konnten.
- Die Felder werden anhand ihrer Bezeichnungen angezeigt, so wie sie auf dem Formular erscheinen – nicht anhand eines internen Namens.
Die gleiche einfache Darstellungsweise wird überall dort verwendet, wo Werte zum Lesen aufgelistet sind: Die Details eines Prüfeintrags, die Genehmigungsanfrage eines Agenten und das Ergebnis einer Aktion zeigen eine Tabelle mit Feldern und Werten anstelle von Rohdaten.