Erreurs et avertissements liés au vocabulaire

Si vous rencontrez des ambiguïtés de vocabulaire, des espaces réservés manquants ou des problèmes sur des éléments métier, le valideur du modèle d'objet génère des erreurs et des avertissements sur des termes et des phrases lors de l'édition ou de la compilation.

Les éléments de vocabulaire tels que les termes, les phrases, les articles et les constantes, sont formés d'un ou de plusieurs mots, que l'on appelle unités lexicales. Celles-ci doivent se conformer à des règles lexicales spécifiques. Les éléments de vocabulaire ne doivent jamais être ambigus. Vous ne pouvez pas verbaliser deux classes avec le même terme ; il n'est pas non plus possible de verbaliser deux membres avec la même phrase.

Termes

Les termes ne doivent pas entrer en conflit avec les éléments du langage de règles métier et du modèle d'objet métier du système. Par exemple, une erreur est générée si un mot dans un terme peut être interprété comme un nombre.

Une erreur due à une ambiguïté peut être signalée localement lorsque vous éditez un vocabulaire au sein du même fichier de vocabulaire, ou globalement au moment de la compilation si l'ambiguïté résulte de termes en double dans deux fichiers distincts.

Phrases

Dans les phrases, chaque type d'espace réservé ne peut être utilisé qu'une seule fois.

Un avertissement est émis dans les circonstances suivantes :

  • L'espace réservé du sujet n'est pas utilisé dans une phrase de navigation

  • L'espace réservé {this} est manquant

Il est possible de définir une préférence afin que ces avertissement soient ignorés.

Dans les phrases, les erreurs peuvent aussi provenir des éléments métier liés à ces phrases :

  • Une phrase d'action pour un attribut en lecture seule ou final

  • Une phrase de navigation pour un attribut en écriture seule

Tableau 1. Exemples d'erreurs liées au vocabulaire
Messages Descriptif
Le caractère > est interdit. Un élément de vocabulaire utilisé un caractère interdit. Cette erreur est signalée lors de l'édition du vocabulaire.
Le caractère > dans le terme de la classe balsample.Book est interdit. Un élément de vocabulaire utilisé un caractère interdit. Cette erreur est signalée au moment de la compilation.
Le terme book est en double. Le terme est déjà utilisé pour une autre classe dans le fichier de vocabulaire en cours.
L'espace réservé "author" est manquant dans "balsample.Book: author" L'espace réservé du sujet (author) est absent de la phrase associée au membre balsample.Book.author.
Verbalisation en double : [balsample.Book: author] et [balsample.Book: title] Les membres balsample.Book.author et balsample.Book.title ont la même verbalisation.
Phrase d'action non autorisée pour "balsample.Book: author" (ce membre est en lecture seule) L'attribut est en lecture seule et ne doit pas être verbalisé comme une phrase d'action.
Phrase de navigation non autorisée pour "balsample.Book: author" (ce membre est en écriture seule) L'attribut est en écriture seule et ne doit pas être verbalisé comme une phrase de navigation.

Délimiteurs dans les nombres

Des virgules et des espaces sont utilisés pour séparer les différentes parties des règles et des expressions. Dans certains environnements locaux et linguistiques, ces caractères servent aussi de délimiteurs dans les nombres :

  • Dans les pays anglophones, la virgule peut servir à grouper trois chiffres, comme dans 10,000.
  • Un espace peut aussi servir à grouper trois chiffres, comme dans 10 000.
  • Une virgule peut servir de séparateur décimal, comme dans 3,14159265.

Suivez ces instructions pour éviter tout problème dans l'expression des nombres :

  • Dans la mesure du possible, n'utilisez pas de chiffres dans les verbalisations.
  • Si vous devez utiliser des chiffres, évitez de les séparer par des espaces ou des virgules, en particulier si ces caractères servent de séparateur des milliers et de séparateur décimal dans l'environnement local et linguistique du vocabulaire (ce qui est le cas en français).
  • Si une verbalisation doit contenir un nombre avec chiffres séparés par des espaces ou des virgules, placez ce nombre entre guillemets, comme ici : "3,14159265".