Classes Entity

A quelques exceptions près, l'utilisation et la modification client directes des classes Entity de l'application sont maintenant déconseillées. Dans de nombreux cas, les opérations de la classe Entity de l'application disposent d'équivalents directs de couche de façade qui ont été marqués comme externes ; ils peuvent être utilisés par les clients. L'ajout d'opérations stéréotypées et non stéréotypées à des entités de l'application est toutefois toujours autorisé, tout comme la définition d'un grand nombre d'options Entity.

Avant la version 6.0.3, les attributs pouvaient être ajoutés à des classes Entity de l'application utilisant une extension. Toutefois, étant donné que le code source est supprimé pour les domaines de fonctionnalités clés, les clients n'auront plus de visibilité quant à savoir si les attributs ajoutés via les classes d'extension seront mappés aux API externes. Pour cette raison, l'ajout d'attributs à des classes Entity de l'application est désormais déconseillé.

Les clients qui souhaitent ajouter des données à des écrans d'application doivent ajouter de nouvelles classes Entity spécifiques au client et doivent encapsuler des opérations de maintenance de l'application externe dans leurs propres classes de processus afin de gérer les deux tables atomiquement. Les écrans d'application peuvent ensuite être changés afin de pointer vers les nouvelles classes de processus.

Remarque : Les entités représentant les types de preuves constituent une exception à cette règle. Les clients peuvent continuer à ajouter des attributs à ce type d'entité de preuve de l'application utilisant une extension, comme cela est requis par Evidence Generator.

Dans la version 6.0.3, les entités de preuve de l'application ont été incorrectement marquées comme internes ; cela sera corrigé dans une révision suivante. Pour l'instant, les clients utilisant une extension sur des entités de preuve pour ajouter des attributs peuvent lire des avertissements dissuasifs dans Eclipse concernant ces classes ; ces avertissements spécifiques peuvent être ignorés.

Cette remarque s'applique uniquement aux entités représentant des types de preuves, et non à toute autre classe Entity de l'application.