Gestion des classes

Modifier et créer des classes dans un modèle est simple. Après avoir sélectionné le modèle souhaité dans l'arborescence, la vue « Modifier le modèle » s'affiche, permettant de gérer les classes. Les classes apparaissent sous le modèle sélectionné dans l'ordre d'affichage sur les fiches de données, initialement selon leur ordre d'ajout. Cet ordre peut être modifié dans la vue « Modifier le modèle ».

Pour organiser les classes au sein d'un modèle, attribuez un numéro de séquence à chaque classe. Les numéros spécifiques utilisés ne sont pas essentiels, mais l'utilisation d'une séquence logique facilite l'insertion de nouvelles classes sans modifier significativement les numéros de séquence existants. Par exemple, l'utilisation d'un système de numérotation en base dix (10, 20, 30, etc.) simplifie l'insertion d'une nouvelle classe entre les classes existantes.

Par défaut, toutes les classes sont développées, mais elles peuvent être réduites dans le modèle en cochant la case correspondante dans la colonne « Réduit ». Les attributs des classes réduites ne seront pas visibles dans les vues de cartes de données ni en mode édition tant que l'utilisateur ne les aura pas développés.

Les classes permettent également l'organisation des attributs, notamment la définition d'attributs comme uniques ou obligatoires et la définition de leur visibilité par défaut dans les résultats de recherche.

Gestion des attributs

Les attributs, unités fondamentales du modèle de données ESM, spécifient les champs individuels des fiches de données et incluent des règles et des propriétés d'affichage des informations. Les attributs peuvent être statiques ou dynamiques, à valeur unique ou multiple, et les administrateurs ont la possibilité de les créer et de les modifier. Ils permettent de stocker une valeur unique sur les fiches de données. Des attributs individuels peuvent être ajoutés et modifiés sans interruption de service. Ils peuvent être considérés comme des champs de formulaire, où sont stockés les détails d'une instance de données (fiche de données).

Un concept clé est l'attribut principal, qui nomme les cartes de données en fonction du modèle. Un modèle sans attribut principal est marqué d'un point d'exclamation, indiquant qu'il n'est pas identifié. Dans ce cas, les cartes de données tirent leur nom du premier attribut accessible.

Chaque attribut comprend au moins un nom et un type de données. Les types de données suivants sont disponibles :

• Chaîne, avec un maximum de 450 caractères.
• Texte
• Entier, peut être un nombre jusqu'à 10 chiffres.
  • Par exemple, « 10000000001 » ne peut pas être stocké, car il comporte 11 chiffres.
• Décimal
  • Le modèle de sortie peut être configuré dans les paramètres de la plateforme decimal.output.pattern.
• Date
  • Le modèle d'entrée et de sortie peut être configuré dans les paramètres de la plateforme date.input.pattern et date.output.pattern.
• Date et heure (datetime)
  • Le modèle d'entrée et de sortie peut être configuré dans les paramètres de la plateforme datetime.input.pattern et datetime.output.pattern.
• Référence (la valeur de l'attribut est une relation avec une autre carte de données, par exemple une équipe affectée à un ticket. Dans ce cas, un ticket fait référence à une équipe)
• Référence arrière (la valeur de l'attribut est une relation avec une autre carte de données formant une paire avec une carte de données référente. La valeur peut être modifiée sur la référence ou la référence arrière, mais les valeurs appariées sur les deux cartes de données sont toujours synchronisées. La carte de données avec la valeur de référence arrière est référencée)
• Référence externe (lien vers une page Web ou un fichier sur un serveur de fichiers)

Les valeurs décimales, date et date/heure ont un paramètre de plate-forme de modèle de sortie spécifique.

Un attribut peut être configuré pour contenir une ou plusieurs valeurs. Il est possible de définir un ensemble fixe de valeurs sélectionnables pour un attribut.

Les attributs ne peuvent être activés que sous certaines conditions, créant ainsi un contenu de modèle de données dynamique. Par exemple, un attribut ne peut être activé que si un autre attribut possède une valeur statique spécifique. Ces attributs de condition doivent être de type chaîne avec des valeurs statiques.

Des gestionnaires spéciaux peuvent être attribués aux attributs pour ajouter des fonctionnalités telles que des calculs ou des combinaisons de valeurs. Pour en savoir plus sur l'utilisation des gestionnaires spéciaux, consultez le uid des gestionnaires d'attributs disponible dans la section Administration > Modèles.

Chaque modèle doit posséder un attribut principal, car les cartes de données basées sur ce modèle sont nommées selon cet attribut. Un modèle sans attribut principal est un modèle non identifié et est affiché dans l'arborescence avec un point d'exclamation. Si un modèle ne possède pas d'attribut principal, les cartes de données basées sur ce modèle tirent leur nom du premier attribut visible par l'utilisateur.

Création d'attributs

Créer un nouvel attribut implique de sélectionner une classe dans un modèle, puis de choisir « Nouvel attribut » dans le menu d'affichage. La vue « Nouvel attribut » permet de saisir les informations de base, les propriétés et les paramètres d'apparence de l'attribut :

Les informations de base incluent le nom de l'attribut, une description facultative et un texte d'aide, qui peut contenir des balises HTML pour le formatage.

Les propriétés de base couvrent le gestionnaire, le type de données et la valeur par défaut de l'attribut. Le type de données est notamment fixé à la création et ne peut être modifié ultérieurement. Les valeurs par défaut sont particulièrement polyvalentes et prennent en charge les macros et références de date, y compris la fiche de données de l'utilisateur actuel.

Les paramètres d'apparence déterminent la visibilité de l'attribut sur les cartes de données, avec des options pour les modes d'affichage et/ou d'édition, et peuvent inclure des textes d'en-tête et de pied de page pour un contexte supplémentaire.

Types de données d'attribut

Les types de données définissent la forme et le type de données qu'un attribut peut contenir, allant des chaînes et des nombres aux dates, références, etc. Chaque type de données possède des caractéristiques et des limites spécifiques :

Attributs de référence

Après l'enregistrement initial d'un attribut avec un type de données de référence, les paramètres permettant de spécifier la cible de référence deviennent disponibles. Cela inclut la sélection des modèles de référence possibles et la configuration de l'affichage des cartes de données référencées.

Pour les attributs de référence pointant vers le modèle ESM « utilisateur » (qui pourrait être nommé différemment, mais est identifié par le code de modèle « admin »), il est possible de définir la fiche utilisateur ESM de l'utilisateur actuel comme valeur par défaut. Pour ce faire, utilisez la macro #user# ou $USER$ pour une référence directe au modèle « utilisateur ». Cette fonctionnalité lie automatiquement l'attribut à la fiche utilisateur active dans le système.

Si l'utilisateur actuel ne dispose pas d'une carte de données « utilisateur » ESM correspondante, comme c'est le cas pour un utilisateur root, aucune référence ne sera établie. De plus, il est possible d'étendre cette valeur par défaut pour faire référence à d'autres modèles associés au modèle « utilisateur » ESM en spécifiant un chemin d'accès tel que #user:attribute_code#.

Exemple:

Pour une fiche « Incident » avec un champ « Contact », définir #user# comme valeur par défaut crée un lien vers la fiche « utilisateur » ESM de l'utilisateur actuel. Si le modèle « utilisateur » ESM inclut une référence à un autre modèle, par exemple un modèle « Personne » avec le code d'attribut « personne », vous pouvez utiliser #user:person# pour utiliser cette référence par défaut.

Cette méthode autorise les références directes et les références arrière au sein des chemins de référence, facilitant ainsi les chaînes de référence complexes telles que #user:code1:code2#. Cependant, il est essentiel que chaque attribut du chemin soit un attribut de référence à valeur unique pour garantir l'intégrité du chemin de référence. L'attribut final de tout chemin de référence doit être conforme aux modèles cibles de l'attribut configuré, préservant ainsi la cohérence de la chaîne.

Points clés:

• La macro #user# ou $USER$ peut définir des valeurs par défaut pour les attributs de référence ciblant le modèle « utilisateur » ESM.
• Les valeurs par défaut sont automatiquement liées à la carte de données utilisateur ESM de l'utilisateur actuel, facilitant ainsi les configurations de carte de données personnalisées.
• Les chemins de référence étendus permettent de créer des liens vers d'autres modèles via le modèle « utilisateur » ESM, élargissant ainsi la portée des valeurs par défaut.
• Tous les attributs d'un chemin de référence doivent être des attributs de référence à valeur unique pour fonctionner correctement, garantissant un lien clair et direct avec les modèles cibles prévus.

Attributs statiques

Les attributs statiques utilisent des valeurs prédéfinies parmi lesquelles les utilisateurs peuvent choisir. La création de valeurs statiques pour ces attributs doit être effectuée avec prudence afin de ne pas impacter les cartes de données existantes.

Lorsque vous ajoutez des valeurs aux attributs de votre système, il est important de comprendre la distinction entre les attributs statiques et dynamiques.

Ajout d'une valeur statique : Les valeurs statiques ne peuvent être attribuées qu'à des attributs statiques. Lors de la création de l'attribut, assurez-vous de cocher la case « Statique ». Vous pourrez ensuite définir les valeurs de cet attribut statique.

Utilisation d'attributs statiques existants : Choisir d'utiliser un attribut statique déjà défini revient à hériter de toutes ses valeurs statiques associées. Soyez vigilant : modifier la valeur d'un attribut statique la met à jour dans tous les modèles qui l'incluent. Cette modification se répercute en cascade sur les valeurs de toutes les cartes de données associées à ces modèles. Pour éviter toute modification involontaire des données, pensez à créer un nouvel attribut statique lorsque ses valeurs actuelles ne correspondent pas à vos besoins.

Création d'un attribut statique : Le système génère automatiquement une entrée de valeur statique portant le même nom que l'attribut statique correspondant lors de sa création. Cette fonctionnalité permet d'identifier facilement les valeurs statiques associées à chaque attribut.

Modification des attributs statiques : Pour modifier un attribut statique, localisez-le dans l'arborescence des modèles, ce qui ouvrira la vue « Modifier l'attribut ». Pour ajouter ou modifier des valeurs statiques, accédez à « Valeurs de menu » dans le menu d'affichage, ce qui vous mènera à la vue « Valeurs statiques ». Vous pourrez alors saisir de nouvelles valeurs statiques, qui seront ensuite sélectionnables lors de la création de la carte de données.

Attributs conditionnels

Les attributs conditionnels ne s'affichent que lorsque des conditions spécifiques sont remplies, ce qui permet un contenu dynamique dans les modèles.

Créer du contenu de modèle dynamique grâce à des attributs conditionnels offre une expérience utilisateur plus interactive et réactive. Cette fonctionnalité permet aux attributs des modèles de devenir visibles ou actifs selon des conditions spécifiques, comme la valeur d'un autre attribut. Voici comment utiliser efficacement les attributs conditionnels :

Création d'un attribut conditionnel :

1. Création initiale : Commencez par créer un nouvel attribut, sélectionnez le type de données correspondant à vos besoins, puis enregistrez-le. Cette sauvegarde initiale est essentielle pour conserver le type de données sélectionné.
2. Définition des conditions : Après avoir enregistré, recherchez le champ « Activer si », qui répertorie les attributs de chaîne statique. Sélectionnez l'attribut qui déclenchera l'activation de votre nouvel attribut.
3. Rechargement de l'interface utilisateur : une fois votre condition définie, l'interface utilisateur (UI) s'actualise automatiquement, vous présentant des options pour les valeurs qui activent l'attribut conditionnel.

Conseils de configuration :

• Sélection de valeurs : Vous pouvez choisir une ou plusieurs valeurs statiques comme critères d'activation de l'attribut conditionnel. L'attribut devient actif lorsque l'une de ces conditions est remplie.
• Chaînage d'attributs : Les attributs conditionnels peuvent être liés dans une chaîne où la visibilité de l'un dépend de la valeur de l'autre, et ainsi de suite. Cette chaîne peut s'étendre à plusieurs niveaux, créant des scénarios complexes de visibilité et d'activation basés sur plusieurs conditions.
• Champs obligatoires : si un attribut conditionnel est défini comme obligatoire, l'obligation de le remplir n'est appliquée que lorsque l'attribut est visible, ce qui signifie que ses conditions ont été remplies.

Considérations importantes :

Lors de la manipulation de données, sachez que si les conditions d'un attribut conditionnel ne sont plus remplies, sa valeur sera supprimée de la base de données. Si les conditions sont à nouveau remplies ultérieurement, les données de l'attribut devront être saisies à nouveau.

L'utilisation d'attributs conditionnels permet de créer des modèles qui s'adaptent aux données saisies, améliorant ainsi la convivialité et l'efficacité des formulaires et des processus de saisie. Cette approche dynamique garantit que seuls les champs pertinents sont présentés aux utilisateurs en fonction de leurs saisies, simplifiant ainsi la saisie.

Modification des attributs

Pour modifier les propriétés d'un attribut au sein d'une classe, sélectionnez la classe sous le modèle souhaité. La vue « Modifier les attributs de classe » permet d'ajuster les noms, l'ordre, les codes et les paramètres de visibilité, entre autres.

Pour ajuster les propriétés des attributs dans une classe spécifique d’un modèle, suivez ces étapes :

1. Accès Pro propriétés des attributs : Accédez au modèle sur lequel vous travaillez et sélectionnez la classe contenant l'attribut à modifier. Cette action ouvre la vue « Modifier les attributs de classe », qui fournit un aperçu détaillé des paramètres d'attribut spécifiques à la classe choisie.
2. Comprendre la portée des modifications : Les modifications apportées dans la vue « Modifier les attributs de classe » affectent uniquement les attributs de la classe sélectionnée. Par exemple, les modifications apportées à l'attribut « Affichage(s) » de la classe « Informations sur le poste de travail » n'affecteront aucune autre classe à laquelle cet attribut pourrait appartenir. Cependant, les propriétés de la classe, telles que les exigences et la visibilité des attributs, s'appliquent universellement à tous les modèles qui l'intègrent.
3. Vérification préalable : Avant toute modification, vérifiez si la classe est utilisée dans plusieurs modèles. Cette précaution vous permet de prendre conscience de l'impact plus large que vos modifications pourraient avoir en raison de l'application des paramètres d'attributs à l'ensemble de la classe.

Modification des informations de base d'un attribut :

• Nom ** : Définit le libellé de l'attribut. Cliquer sur le nom de l'attribut ouvre la vue « Modifier l'attribut » pour des modifications plus détaillées.
• Ordre : Contrôle l'ordre d'apparition des attributs dans la classe. Utilisez des incréments logiques (par exemple, 10, 20, 30) pour faciliter l'ajout ultérieur de nouveaux attributs sans modifier l'ordre existant.
• Code : sert d'identifiant unique pour l'attribut, crucial pour les processus d'importation de données et lors de l'application de gestionnaires spécifiques aux attributs.
  • Remarque : il est essentiel d’attribuer un code à chaque attribut.
• Obligatoire : garantit que les cartes de données ne peuvent pas être enregistrées à moins qu'une valeur ne soit saisie pour cet attribut, garantissant ainsi l'exhaustivité des données.
• Unique : garantit que la valeur de l'attribut reste unique parmi toutes les cartes de données partageant la classe. Le système vérifie l'unicité lors de la création et de l'importation des cartes de données. L'unicité peut être limitée à la visibilité de l'utilisateur éditant ou globale à l'ensemble du système, le mode spécifique étant réglable dans les paramètres de la plateforme.
• Sélectionné : détermine si l'attribut est visible par défaut, comme dans les listes de résultats de recherche, améliorant ainsi l'expérience utilisateur en priorisant les informations importantes.

N'oubliez pas que, lors de la configuration des attributs, vous devez prendre en compte les implications plus larges des modifications afin de garantir la cohérence et l'intégrité de la structure de données de votre système.