Attributs requis dans une classe de modèle

Un élément de modèle peut contenir des attributs de types différents (primitif et complexe).
En général, un élément de modèle se compose d'un ou de plusieurs des types suivants :
Type d'attribut Description
Primitif, sauf octet ou tableaux d'octets
  • Appelez la méthode appropriée setProperty() pour définir la propriété de l'élément. Plusieurs substitutions existent pour tous les types primitifs sauf la substitution par un octet.
Tableau d'octets ou chaînes longues
  • Dans le cas du stockage de données binaires, l'attribut doit être associé au type LTAnnotation ou à l'un des types qui l'étend. Cette classe contient les méthodes setBytes() et getBytes() pour le stockage et l'extraction des informations binaires. Une fois la méthode getBytes() ou setBytes() appelée, les données sont conservées en mémoire jusqu'à la sauvegarde du test.
    Remarque : Si cette action n'est pas souhaitée (et elle ne l'est pas si le jeu de données peut être considérable), vous pouvez "vider" les données dans un fichier en appelant individuellement la méthode flush() pour LTAnnotation. Veillez à appeler cette méthode immédiatement après une méthode set ou get.
Complexe
  • Appelez la méthode setProperty(CBActionElement,CBActionElement) à laquelle vous pouvez transmettre l'ancienne et la nouvelle valeurs de l'attribut. Tous les éléments de modèle sont étendus à partir de la classe CBActionElement. L'ancienne valeur est transmise en vue de sa suppression du modèle et la nouvelle valeur est transmise en vue de sa définition. Si vous n'avez pas de valeur, transmettez la valeur Null. Par exemple, si la valeur val1 est remplacée par la valeur val2, appelez la méthode setProperty(val1,val2). Si vous définissez la valeur pour la première fois, appelez la méthode setProperty(null,val1). Pour désélectionner la valeur, appelez setProperty(val1,null).
  • Cette méthode est identique aux méthodes setProperty() du type primitif, mais elle requiert l'ancienne valeur.
  • Lorsque le modèle est chargé, la méthode addReference() est appelée ; elle doit être remplacée en vue de l'interprétation et de l'affectation correcte de l'attribut à l'objet. Appelez la méthode setXXX() appropriée pour définir l'attribut pour lequel la valeur a été transmise.
Liste
  • Le type de l'attribut doit être EList. Si l'élément est un conteneur, il peut implémenter l'interface LTElementHost et doit implémenter la méthode getElements() pour accéder à la liste. Cette méthode doit renvoyer le type EList. La méthode addReference() est appelée pour chaque enfant afin de charger la liste lorsque les enfants de cet élément de modèle sont en cours de chargement et l'élément doit placer l'enfant dans la liste appropriée.
Référence à un autre élément de modèle
  • Définissez un attribut dont le type est identique à celui de l'élément que vous référencez. Ainsi, l'attribut pourra utiliser les méthodes d'accès set et get simples. Ces méthodes n'appellent pas getProperty ni setProperty mais procèdent simplement à l'extraction ou à la définition de la valeur d'attribut.
  • Définissez un autre attribut qui servira de proxy à cet élément. Il s'agit de votre propre classe, qui étend ProxyElement à partir du modèle LTBM.
  • Lorsque vous créez la référence, appelez la méthode setHref() de ProxyElement avec l'ID (getId()) de l'élément référencé.
  • Pour extraire l'élément référencé, utilisez l'objet href de ProxyElement (getHref()) pour localiser l'élément dans le test. Vous pouvez également utiliser la méthode BehaviorUtil.findElement() (le test contenant cet élément, l'ID de l'élément recherché) pour extraire l'élément.

Commentaires