Après la création d'un élément, complétez sa définition avec des contrôles supplémentaires.
Il est possible d'établir des contrôles simples sur le contenu d'un champ en définissant des contrôles statiques. Les contrôles disponibles dépendent du type du champ.
Longueur fixe | Nombre exact de caractères requis pour ce champ. |
Longueur minimale | Nombre minimum de caractères requis pour ce champ. |
Longueur maximale | Nombre maximum de caractères autorisés pour ce champ. |
Pattern | Expression régulière à laquelle la valeur du champ doit être conforme. Il est interdit de définir un pattern à la fois sur un champ et sur son type de donnée. |
Partie décimale | Nombre maximum de chiffres autorisés dans la partie décimale de la valeur d'un champ de type décimal. |
Nombre maximum de chiffres | Nombre maximum de chiffres composant la valeur d'un champ de type entier ou décimal. |
Énumération | Définit une liste de valeurs possibles pour ce champ. Si une énumération est définie à la fois sur ce champ et sur son type de données, alors une énumération représentant l'intersection entre ces deux énumérations sera utilisée dans les jeux de données associés au modèle de données. |
Supérieur à [constante] | Définit la valeur minimale autorisée pour ce champ. |
Inférieur à [constante] | Définit la valeur maximale autorisée pour ce champ. |
Voir Facettes XML schema supportées.
Il est possible d'établir des contrôles avancés sur le contenu d'un élément en définissant des contrôles dynamiques contextuels. Les contrôles disponibles pour un élément dépendent de sa nature (table, groupe, etc.) et de son type de données.
Contrainte de clé étrangère | |
Table | Définit la table ciblée par la clé étrangère. Une clé étrangère référence une table dans le même jeu de données par défaut. Elle peut aussi référencer une table d'un autre jeu de données du même espace de données, ou un jeu de données d'un autre espace de données. |
Mode | Emplacement de la table ciblée par la clé étrangère. "Défaut" : modèle courant. "Autre jeu de données" : jeu de données qui se trouve dans le même espace de données. "Autre espace de données" : jeu de données appartenant à un espace de données différent. |
Table référencée | Expression XPath indiquant l'emplacement de la table. Par exemple, |
Jeu de données référencé | Obligatoire si la table est dans un autre jeu de données. Le nom unique du jeu de données contenant la table référencée. |
Espace de données référencé | Obligatoire si la table est dans un autre espace de données. Nom unique de l'espace de données contenant la table référencée. |
Libellé | Définit les champs composant un libellé par défaut et des libellés localisés pour présenter les enregistrements de la table cible. Peut aussi spécifier une classe Java qui définit le libellé programmatiquement quand "Expression XPath" a la valeur "Non". Cette classe Java doit implémenter l'interface Attention : Les droits d'accès définis dans les jeux de données associés ne sont pas appliqués lors de l'affichage des libellés. |
Filtre | Définit un filtre de clé étrangère en utilisant une expression XPath. Peut aussi spécifier une classe Java qui implémente l'interface |
Supérieur à [variable] | Définit un champ qui spécifie la valeur minimale autorisée pour ce champ. |
Inférieur à [variable] | Définit un champ qui spécifie la valeur maximale autorisée pour ce champ. |
Longueur fixe [dynamique] | Définit un champ qui spécifie le nombre exact de caractères requis pour ce champ. |
Longueur minimale [dynamique] | Définit un champ qui spécifie le nombre minimum de caractères requis. |
Longueur maximale [dynamique] | Définit un champ qui spécifie le nombre maximum de caractères autorisés. |
Valeurs exclues | Définit une liste de valeurs non autorisées pour ce champ. |
Plage exclue de valeurs | Définit une plage de valeurs non autorisées pour ce champ. Valeur maximale exclue : La valeur maximale non autorisée pour ce champ. Valeur minimale exclue : La valeur minimale non autorisée pour ce champ. |
Contrainte spécifique (composant) | Spécifie une ou plusieurs classes Java qui implémentent l'interface |
Enumération spécifique (composant) | Spécifie une classe Java pour définir une énumération. La classe doit définir une liste ordonnée de valeurs, en implémentant l'interface |
Enumération alimentée par un autre noeud | Spécifie un champ qui définit les valeurs autorisées pour cette énumération. Le champ spécifié doit être une liste ou doit définir une énumération. |
Configuration des espaces de données | Définit quels sont les espaces de données pouvant être référencés par un champ de type Identifiant d'espaces de données (osd:dataspaceKey).
|
Configuration des jeux de données | Définit quels sont les jeux de données pouvant être référencés par un champ de type Identifiant de jeux de données (osd:datasetName).
|
Chaque contrainte, excepté celles utilisant une classe Java, peut définir des messages de validation. Il est possible d'associer une sévérité à ces messages de validation et ils peuvent être localisés en utilisant les propriétés suivantes :
Validation | Spécifie le message de validation et la sévérité associée à la contrainte. |
Sévérité | Spécifie la sévérité de la contrainte. Les valeurs possibles sont : "Erreur", "Avertissement", et "Information". |
Gestion des erreurs | Spécifie le comportement de la contrainte en cas d'erreur de validation. Il est possible d'indiquer que la contrainte doit toujours être valide pour toute opération (mise à jour d'un jeu de données, création, mise à jour et suppression d'un enregistrement), ou lorsqu'un utilisateur soumet un formulaire. Dans ce cas, toutes les saisies ou opérations qui rendraient la contrainte invalide seront rejetées et les données seront non modifiées. Si cette propriété n'est pas spécifiée, alors la contrainte bloquera uniquement les erreurs lors de la soumission d'un formulaire, sauf dans le cas de modèles relationnels où les contraintes de clés étrangères bloquent par défaut toutes les erreurs. Cette propriété est uniquement disponible sur les contrôles statiques, valeurs exclues, plage exclue de valeurs et contraintes de clés étrangères. Le caractère bloquant pour toutes les opérations ne s'applique pas sur les filtres de clé étrangère. Une contrainte de clé étrangère n'est donc pas bloquante si un enregistrement référencé existe mais ne répond pas aux critères de filtrage. Il n'est pas possible de définir cette propriété sur les contraintes structurelles définies dans les modèles relationnels. Si cette propriété est définie sur les contraintes "Longueur fixe", "Longueur maximum", "Nombre total de chiffres" et "Partie décimale" dans des modèles relationnels, une erreur sera levée lors de la compilation du modèle. Le caractère bloquant d'une contrainte est ignoré lors de l'import d'archives. Toutes les contraintes bloquantes, sauf les contraintes dites structurelles, sont désactivées lors de l'import d'archives. |
Message | Message à afficher lorsque la valeur de ce champ dans un jeu de données ne respecte pas cette contrainte. Ce message peut être localisé. |
Sommaire du guide utilisateur