Dans ce formulaire, vous modifiez les attributs d'un objet référencé dans le dictionnaire, pour l'adapter à vos besoins.
Sélectionnez l'attribut dans la liste et modifiez sa description dans le volet inférieur.
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 besoins spécifiques.
- 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.
- Signature : indique si la modification de cet attribut nécessite une signature électronique pour être validée.
Dans le contexte d'une utilisation internationale, il est préférable que des traductions existent pour les libellés et infobulles.
Liens
- Entité associée : Indique le type de la donnée et dépend donc directement du domaine. Si le domaine est "Code", l'attribut peut être lui-même un objet, indiqué dans l'entité associée (exemple : fournisseur d'un article, responsable d'un Matériel).
- Multiple : A cocher si la valeur est présentée sous forme de tableau. Cela concerne essentiellement les formulaires de recherche, pour un critère en multi-sélection (comme les états des interventions par exemple).
- Liste de choix : La valeur de l'attribut est à sélectionner dans une liste d'entités (domaine "Code" uniquement. Sinon, utiliser la liste de valeurs).
- Entité composante : Pour les attributs correspondant à des collections ou des listes d'éléments. Par exemple, l'attribut documents est composé d'objets DOCUMENT.
- Relation : Si l'entité associée est un objet, la relation indique la cardinalité de l'association.
Exemple : Entre un budget et son responsable, la relation est "n à 1". Un budget ne peut avoir qu'un seul responsable, alors qu'un acteur peut être responsable de plusieurs budgets.
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").
Audit
Ces attributs sont accessibles si la case "Audit activé" est cochée dans l'onglet Objet [Général].
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.
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é.
Valeur
- Minimum / Maximum / Précision / Décimales : Valables pour une 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 une attribut de type alphanumérique.
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.
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.
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.
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.
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".
RGPD
Ce bloc permet de définir les attributs soumis au .
- RGPD ? : Si coché, l'attribut est soumis aux règles du RGPD.
- Durée de conservation de la donnée : Durée, en nombre d'années, pendant laquelle la valeur de l'attribut sera conservée dans la base de données de CARL Source. Obligatoire.