Dans ce formulaire, vous avez la possibilité de modifier la définition d'une entité gérée par CARL Source et référencée dans le dictionnaire, afin de l'adapter à vos besoins spécifiques.
Sur la partie gauche, l'arborescence présente l'objet principal sous forme d'un nœud principal, avec tous ses attributs listés en dessous.
En sélectionnant un élément, vous pouvez visualiser en détail ses propriétés dans la section de droite. Chaque élément est identifié par une icône représentant son type, qui est également mentionné dans l'en-tête des propriétés sur la partie droite.
L'affichage des propriétés est responsive, seules les propriétés utiles sont affichées sur le formulaire selon le type d'élément sélectionné et catégorie d'objet affichée.
Pour les propriétés des attributs de l'objet, voir Attributs ci-dessous, après la section des propriétés d'un objet.
Actions disponibles
Des boutons d'action permettent de manipuler les éléments de l'arborescence de l'objet à gauche :
: Ajout d'un attribut uniquement sur un objet de catégorie "Recherche", en indiquant le nom, le libellé et son domaine (Alphanumérique, Date&Heure, Code, ...)
: Tri dans l'ordre alpha numérique ascendant
ou descendant
la liste des attributs de l'objet affiché.
Lors de création d'un attribut sur un objet Recherche, des règles de nommages sont à respecter :
- le nom d'attribut doit obligatoirement commencer par la chaine de caractère "xtrat" afin d'éviter les conflits avec des éléments standard,
- les préfixes (non sensible à la casse) suivant sont réservés à des attributs standard : xtraDate, xtraNul, xtraTxt, xtraBool.
Propriétés d'un objet
La catégorie d'objet est identifiée visuellement par des icones spécifique pour plus de clarté, elles sont au nombre de 4 :
: Entité
: Recherche
: Contrôleur d'écran
: Autres
- Objet : Identifiant de l'objet, unique dans l'application.
- Libellé : Description de l'objet.
Généralités
- Catégorie : Type de l'objet. Les objets modifiables sont essentiellement les entités.
- Module : Module auquel appartient l'objet.
- Spécifique : Indique si l'objet a été créé pour un besoin particulier ou est fourni en standard.
- Infobulle : Description de l'objet.
- Indexé : indexation Elasticsearch ; c'est à dire que l'objet utilisé pour la recherche full-text.
- Traduisible : Indique si au moins un attribut est géré de façon multilingue sur l'objet. Décocher permet de désactiver tous les attributs de l'objet gérés de façon multilingue.
Propriétés fonctionnelles
- Documents liés autorisés : Des documents liés peuvent être joints à l'objet.
Si vous déclarez une entité comme pouvant avoir des documents liés, n'oubliez pas d'affecter les droits d'accès à ces documents dans le détail des
profils concernés. Si les droits n'existent pas pour la fonctionnalité, un développement spécifique est nécessaire.
- Duplication possible : La création par recopie d'un élément existant est proposée. Dans ce cas, vous pouvez ajuster les attributs à recopier ou non dans l' onglet [Attributs], case "A recopier".
Restriction d'accès
- L'objet est une entité persistée en base,
- Aucun attribut de l'entité n'est utilisé comme porteur de la restriction. En effet, dans ce cas, la restriction est appliquée de manière indirecte, voir Objet [Attributs], porteur de la restriction.
- Attribut : Attribut utilisé comme critère de restriction, s'il y en a un.
Personnalisation
- Attribut : A renseigner si vous souhaitez que le formulaire détail de l'objet concerné soit différent selon la valeur de cet attribut.
Exemples :
- En sélectionnant l'attribut "Type d'équipement" pour l'objet MATERIAL, vous pourrez configurer les formulaires de telle sorte que le formulaire détail d'un Matériel soit propre à chaque type d'équipement.
- En sélectionnant l'attribut "Spécialité" pour l'objet TECHNICIAN, vous pourrez configurer les formulaires de telle sorte que le formulaire détail d'un intervenant s'adapte selon sa spécialité.
- La liste déroulante "Attribut de personnalisation" est proposée uniquement sur les objets possédant un formulaire de détail.
- Seuls les attributs, associés à une liste de valeurs ou liés à une autre entité sous la forme d’une sélection / InfoZone, sont autorisés.
Afin de personnaliser les écrans, il est ensuite nécessaire de créer les différents formulaires souhaités, via la fonctionnalité Formulaire personnalisé, puis de définir pour chacun des formulaires, les valeurs pour lesquelles cet attribut renseigné est applicable.
Traitements
- Workflow d'état : Cycle de vie de l'objet. Il est possible de définir un workflow spécifique pour un objet.
- Multi-workflow : Indique si l'objet autorise les workflows avec de multiples cycles de vie conditionnés.
Utile sur le détail d'un workflow lorsque l'objet est précisé : permet (ou non) de créer des branches alternatives à la branche principale du workflow (non modifiable).
Stockage
- Table : Table principale où sont stockées les données de l'objet.
RGPD
- RGPD - A anonymiser : case à cocher permettant d'identifier si l'objet est intégré au traitement d'anonymisation.
- Durée de conservation des données (en mois) : cette durée, permet de définir la valeur seuil au-delà de laquelle la donnée doit être anonymisée de manière automatique.
Propriétés d'un attribut
L'affichage de la partie de détail de droite s'ajuste en fonction du domaine d'attribut, voire de la catégorie d'objet concernée.
Pour rappel, une icône identifiant le type d'attribut est associée à chaque attribut dans l'arborescence. L'icône est également rappelée dans l'en-tête du détail de ses propriétés:
: Alphanumérique
: Numérique
: Booléen
: Date
: Date et heure
: Horaire
: Monétaire
: Liste
: Sous- objet
: Autre
Sélectionnez l'attribut dans l'arborescence et modifiez ses propriétés dans le volet de gauche.
La plupart des propriétés ne sont modifiables que pour les attributs personnalisés, c'est-à-dire des attributs non standard, que vous avez ajoutés dans CARL Source pour vos répondre à vos besoins spécifiques.
- Icône : Reprend la catégorie de l'attribut.
- Attribut : Identifiant de l'attribut. L'attribut doit commencer par 2 minuscules ou 2 majuscules.
Exemple : "monAttribut" et "MONATTRIBUT" sont autorisés. "MonAttribut" est interdit.
- Libellé : Description de l'attribut.
- Domaine : Type de valeur que peut prendre l'attribut, voir Domaine.
- Infobulle : Texte descriptif qui sera affiché lorsque l'utilisateur passera le curseur sur l'attribut dans un formulaire.
- Traduisible : Si coché, permet de traiter l'attribut (Alphanumérique) de façon multilingue dans l'application. Activer cette propriété sur l'un des attributs d'un objet coche automatiquement cette propriété sur l'objet de l'attribut.
Dans le contexte d'une utilisation internationale, il est préférable que des traductions existent pour les libellés et infobulles.
Liens
Propriété de données
Saisie
- Liste de valeurs : La valeur de l'attribut est à sélectionner dans une liste déroulante standard ou personnalisée, voir liste de valeurs.
- Format : A renseigner pour un attribut de domaine "Date" :
- DATEHOURMN, comprend la date et l'heure, sans les secondes,
- SHORT_DATE, n'affiche que la date sans l'heure,
- DTIME indique qu'un attribut "Heure" est affiché au format HH:mm.
D'autres formats peuvent être ajoutés dans le fichier formats.properties.
- Si le champ peut contenir plusieurs valeurs, indiquer celles-ci entre crochets, séparées par des virgules. Exemple : [VALIDATED, INPROGRESS], pour une liste d'états dans un formulaire de recherche.
- Si le champ est une date ou une heure, le format est toujours JJ/MM/AAAA hh:mm:ss, même si la partie date ou heure doit être ignorée. Exemple : '31/12/2010 08:00:00'.
- Pour un booléen, la valeur est 'true' ou 'false'.
- La valeur par défaut de l'état est à indiquer sur l'attribut "statusCode". Par exemple : 'VALIDATE' pour créer les Matériels directement dans l'état "Validé".
Attributs propriété
Ces attributs sont à renseigner dans le cas où la valeur de la propriété d'un attribut est elle-même stockée dans un autre attribut. Par exemple, sur une demande d'achat (objet PR), la devise du "montant TTC" (amountTTC) est indiquée dans le champ "Devise du fournisseur" (attribut vendorCurrency).
- Devise : Attribut où est stockée la devise du champ, pour un attribut de domaine "Montant".
- Unité : Attribut où est stockée l'unité du champ, obligatoire pour un attribut de domaine "Quantité". (Exemple : "unit" pour l'attribut "askedQty" de l'objet "PRLINE").
- Nb décimales : Attribut où est stocké le nombre de décimales du champ, pour un attribut de domaine "Quantité", "Montant" ou "Numérique". (Exemple : "precision" pour l'attribut "askedQty" de l'objet "PRLINE").
Valeur
- Minimum / Maximum / Précision / Décimales : Valables pour un attribut de type numérique. La précision est le nombre de chiffres de la partie entière, "décimales" désigne le nombre de chiffres après la virgule.
- Nb caractères : Nombre de caractères maximum de la valeur. Valable pour un attribut de type alphanumérique.
Masque de saisie
Ces cases à cocher permettent de définir l'aspect de la valeur affichée dans le champ correspondant à l'attribut.
Elles sont modifiables ou non selon le domaine auquel appartient l'attribut.
- Majuscules : La majuscule est forcée à la saisie de la valeur. C'est le cas pour les codes.
- Sans espace : Les espaces sont remplacés par des '_' lors de la saisie. C'est le cas pour les codes.
- Expression dynamique : La saisie d' expression dynamique est autorisée.
- Heure : Indique un affichage de type heure. C'est le cas pour les durées.
- Pourcentage : Affiche le symbole '%' derrière le nombre.
- Affichage devise : Automatique pour les attributs de domaine AMOUNT.
- Affichage unité : Automatique pour les attributs de domaine QUANTITY.
- Tronquer : S'applique aux valeurs numériques.
Si nombre de décimales = 2, lorsque l'utilisateur saisit la valeur 1,123, alors :
- Si tronquer est coché : la valeur en base (et affichée) est 1,12.
- Si tronquer n'est pas coché : La valeur en base est 1,123 et la valeur affichée 1,12.
- Multilignes : La valeur peut comporter des sauts de ligne, et le champ de saisie contient potentiellement plusieurs lignes. C'est le cas des commentaires.
- Éditeur : La saisie de texte mis en forme est possible, voir Description détaillée. NB : La barre de mise en forme ne sera activée que si le champ fait au moins 3 lignes.
Persistance - Uniquement objets enregistrés en base
- A recopier : A cocher si l'attribut doit être recopié en cas de création par duplication, de l'élément d'origine sur l'élément cible.
- Persisté : L'attribut est enregistré en base.
- Table / Colonne : Colonne de la table dans laquelle est stocké l'attribut.
Recherche
Cette partie permet de configurer les attributs qui participent à la recherche full-text.
Les éléments de cette partie sont accessibles uniquement si la propriété "Persistant" de l'attribut est positionnée à "Vrai" (case cochée).
A noter que, pour certains attributs, ces informations sont déjà renseignées et ne sont pas modifiables.
- Indexé : Si la case est cochée, indique d'utiliser cet attribut dans la recherche full-text.
-
Analyseur de texte : Détermine l'analyseur de texte à appliquer sur cet attribut. Les possibilités sont les suivantes :
- Mot-clé : Transforme le terme en minuscules et le convertit en caractères ASCII. Le terme est ensuite indexé sans découpage.
- Phrase : Transforme le terme en minuscules, le convertit en caractères ASCII puis le découpe en mots (selon espace, virgule, ...). Ces mots sont ensuite indexés avec un filtre n-gram prefix, ce qui permet de trouver des saisies ne possédant que le début du mot.
- HTML : Applique un filtre supprimant les symboles HTML, puis applique les mêmes traitements que l'analyseur "Phrase" ci-dessus.
Tout changement de configuration n'est pas répercuté automatiquement sur la recherche full-text.
Il est nécessaire d'indiquer à CARL Source que l'indexation a été modifiée ; pour cela, dans la fonctionnalité [Dictionnaire], se rendre dans le menu des actions
et choisir "Mise à jour de la configuration des index Elastic".
La durée d'indexation dépend du nombre d'attributs sélectionnés et de la volumétrie de la base.
Cette action n'est donc pas instantanée et peut prendre plusieurs dizaines de minutes.
Le suivi de son traitement peut se faire en consultant les logs de CARL Source :
- Au démarrage, un log avec le message "Start indexing entities in Elastic" sera visible.
- Pendant le traitement, plusieurs lignes seront inscrites avec un message du type : "On index carl_s1300374_cs02-csst_item, bulk operations succeeded: ...".
- A la fin du traitement, le log suivant sera visible : "Finish indexing entities in Elastic".
Contrôles
- Mise à jour en masse : La mise à jour en masse est proposée pour cet attribut. Cette case est active uniquement pour les attributs dont la modification de valeur ne déclenche pas de traitements standard. Elle est cochée par défaut, vous pouvez la décocher pour les attributs que vous ne souhaitez pas rendre accessibles à la mise à jour en masse.
- Restriction accès : Cet attribut peut être utilisé comme critère de restriction d'accès aux données. Les conditions sont les suivantes :
- L'attribut est de domaine "Code" ou lié à une liste de valeurs.
- La case à cocher "Restriction d'accès" est cochée sur l'objet.
- Porteur de la restriction : Si l'objet n'a pas de restriction d'accès spécifique, la restriction peut être appliquée sur l'un de ses attributs. Par exemple : Vous pouvez décider qu'il n'y a pas de restriction appliquée directement sur l'objet "Occupation", mais que la restriction sera la même que celle appliquée sur l'intervenant de l'occupation (attribut "technician").
Cela suppose que la case "Restriction d'accès" n'est pas cochée sur l'objet.
- Unique : La valeur de l'attribut n'admet pas de doublons pour cet objet.
- Obligatoire : L'attribut sera obligatoire : il sera impossible d'enregistrer l'objet sans avoir renseigné cet attribut. Cependant, pour faire apparaître l'astérisque *, vous devez personnaliser les formulaires.
Export
Ces paramètres concernent l'export effectué depuis le menu des actions
d'une liste, voir Exporter les données.
- Exporté fichier plat : L'attribut fait partie des informations exportées dans les formats Excel, CSV et texte brut. (Les collections ne sont jamais exportées). Dans tous les cas, si l'attribut est affiché dans la liste, il sera présent dans l'export.
- Exporté format XML : mode d'export est défini comme suit :
- Case décochée : L'attribut n'est pas exporté,
- Case cochée : L'attribut est exporté, ainsi que l'objet lié, si l'attribut a une entité associée,
- Case avec fond coloré (orange, bleu, vert ou violet) selon le thème : L'attribut est exporté, mais pas l'objet lié.
RGPD
Ce bloc permet de définir les attributs soumis au .
- RGPD ? : Si coché, l'attribut est soumis aux règles du RGPD, et donc au traitement d'anonymisation,
- Signature sur modification : indique si la modification de cet attribut nécessite une signature électronique pour être validée.
Critères de filtre - Uniquement objets de catégorie "Recherche"
- Opérateur : Type de comparaison entre la valeur de critère saisie et la valeur de l'objet recherché.
- Critère : Attribut utilisé comme critère de recherche. Il peut être un attribut de l'objet ou d'un objet lié.
- Relation : Relation entre l'objet principal, et l'objet auquel appartient l'attribut utilisé comme critère de recherche.
- Entité cible : Objet lié, auquel appartient l'attribut utilisé comme critère de recherche.
Voir Ajout d'un critère de recherche.
Audit
Ces attributs sont accessibles si la case "Audit activé" est cochée dans l'onglet Objet [Audit].
Chaque case cochée fera l'objet d'une ligne dans la table de trace. Il est donc plutôt conseillé de cocher les cases "Insertion" et "Suppression" uniquement pour l'attribut permettant d'identifier la ligne, généralement le code.
- Insertion : L'ajout d'une occurrence sera tracée, avec la valeur de l'attribut.
- Modification : Toute modification de l'attribut sera tracée, avec la nouvelle et l'ancienne valeur.
- Suppression : La suppression d'une ligne sera tracée, avec la valeur de l'attribut.