Champs personnalisés et extensibilité
Ajouter un champ que la plateforme ne propose pas, sans nouvelle version et sans modifier les tables principales.
Un champ nécessaire à votre entreprise et non inclus par la plateforme est ajouté en tant que champ personnalisé. Défini pour chaque entreprise, il est associé à une ressource, se voit attribuer un type et une étiquette, puis apparaît dans le formulaire de cette ressource, ses colonnes de liste, ses filtres, son mappage d'importation et son exportation.
- Les champs personnalisés sont situés en dehors des tables principales, leur ajout ne modifie donc pas le schéma commun à toutes les entreprises.
- Une fois définis, ce sont des champs ordinaires — filtrables, triables, importables et exportables, et non pas un champ de notes avec une étiquette.
- Elles sont spécifiques à chaque entreprise, donc les ajouts d'une entreprise sont invisibles pour une autre.
- Un champ Oui/Non est conçu comme les cases à cocher du produit : la case à côté de son libellé, le libellé cliquable et l’aide directement en dessous.
Avant d'en ajouter un, vérifiez si une liste de classification convient. Si vous souhaitez simplement ajouter une nouvelle valeur à une liste déroulante existante, il s'agit d'une configuration et non d'une extension.
Rendre un champ obligatoire
Pour rendre un champ toujours obligatoire, ou obligatoire avant une étape comme la soumission ou la publication, utilisez Plateforme › Personnalisation › Exigences des champs : cochez la case, aucune règle à saisir. Consultez la section « Rendre un champ obligatoire : Exigences des champs ». La logique personnalisée ci-dessous concerne une condition.
La section Plateforme → Personnalisation → Logique personnalisée contient les règles définies par l'entreprise : une validation empêchant l'enregistrement, une valeur calculée à chaque enregistrement et une valeur par défaut pour les nouveaux enregistrements. Pour rendre un champ obligatoire (qu'il soit présent dans le produit ou ajouté par vos soins), créez une validation sur l'écran correspondant. Cette validation doit être vraie uniquement si le champ est renseigné, et définissez le message d'erreur à afficher en cas de champ vide.
- Plateforme ouverte → Personnalisation → Logique personnalisée et choisissez le module et l'écran — SIRH, Employés.
- Ajoutez une règle de type Valider, à exécuter à chaque sauvegarde.
- Écrivez la condition qui doit être remplie. `not_empty(iqama_number)` exige le numéro d'Iqama pour chaque employé. `is_saudi` ou `not_empty(iqama_number)` l'exige pour toute personne qui n'est pas de nationalité saoudienne, ce qui correspond généralement à l'intention : un ressortissant saoudien possède une carte d'identité nationale, et non un Iqama.
- Saisissez le message : « Un numéro d’Iqama est requis pour un employé qui n’est pas de nationalité saoudienne », puis enregistrez-le. Testez-le sur le même écran en le comparant à un enregistrement avant de l’utiliser.
Le serveur vérifie la règle à chaque enregistrement, quelle que soit la méthode de transmission : formulaire, importation, requête ASK ou API. Toute modification d'un enregistrement existant qui enfreindrait la règle est également refusée.
En Arabie saoudite, le formulaire d'employé comprend également les informations relatives au statut saoudien : nationalité, numéro et date d'expiration de l'Iqama, date d'expiration du permis de travail, numéro et catégorie d'assuré GOSI, transfert de parrainage, date d'embauche selon l'Hégire, salaire de base et allocations logement et transport servant au calcul de la GOSI. Chacune de ces informations peut être rendue obligatoire. Le formulaire n'affiche par défaut que les informations applicables : numéro et date d'expiration de l'Iqama, date d'expiration du permis de travail et transfert de parrainage si la case « nationalité saoudienne » n'est pas cochée, et catégorie d'assuré GOSI si elle l'est.
Afficher les valeurs de vos champs
Plateforme → Personnalisation → Champs personnalisés affiche, pour l'écran sélectionné, un tableau des enregistrements de cet écran, les champs de votre entreprise étant présentés en colonnes. Ce tableau est consultable et paginé comme une liste, ce qui vous permet de vérifier les champs renseignés sans avoir à ouvrir chaque enregistrement individuellement.
- Seuls les enregistrements que vous pouviez déjà ouvrir sur cet écran sont affichés.
- Les champs sont affichés par leur libellé, tel qu'il apparaît sur le formulaire — et non par un nom interne.
La même présentation simple est utilisée partout où des valeurs sont listées pour que vous puissiez les lire : le détail d’une entrée d’audit, la demande d’approbation d’un agent et le résultat d’une action affichent un tableau de champs et de valeurs plutôt que des données brutes.