Identification des éléments Oracle Redtime

Attributs de sélecteur affichés par UI Automation pour les éléments Oracle Redboard, notamment redboard-id, data-key et data-oj-field.

Les pages Oracle Redtime affichent l'interface utilisateur via des éléments personnalisés Oracle JET. Les sélecteurs générés pour ces éléments sont faciles à reconnaître par le préfixe oj- sur l'attribut tag et par les attributs spécifiques à l'infrastructure décrits ci-dessous.

Un sélecteur d'élément Oracle Redboard contient la balise <webctrl> , semblable à d'autres éléments de l'interface utilisateur Web.

Les attributs suivants sont affichés dans les sélecteurs pour les éléments Oracle Redboard:

Attribut	Description
tag	La balise de l’élément personnalisé JET (par exemple, oj-button, oj-input-text, oj-table, oj-list-view). Aide à désambiguer les composants JET à partir d’éléments HTML simples.
redwood-id	Identificateur stable dérivé de l'expression de liaison :id d'JET. JET régénère souvent des valeurs aléatoires id lors de l’actualisation, tandis que l’expression :id ne le fait pas. Préférez donc redwood-id lorsqu’elle est disponible.
data-key	Clé que JET tamponne sur les conteneurs liés aux données ou dynamiques, tels que les cartes de tableau de bord ou les en-têtes de table regroupée, définie sur la clé de l’élément lié. Non présent sur les lignes ordinaires; le sélecteur ancre l'ancêtre le plus proche qui porte data-key.
data-oj-field	Nom du champ lié, estampé par JET sur un élément parent des champs de formulaire. Apparaît sur l’ancêtre englobant, maintenant le sélecteur stable lorsque les internes du champ sont réaffichés.

L’attribut id des éléments Oracle Redboard est inclus dans les sélecteurs uniquement lorsque sa valeur est fiable. JET génère automatiquement de nombreuses valeurs id qui changent entre les chargements de pages ou les sessions; le pilote les reconnaît et les laisse hors du sélecteur. Lorsque le id est filtré, le pilote revient à redwood-id et à l’identificateur stable du composant JET environ. La valeur redwood-id fournit également le nom d’affichage de l’élément dans Studio lorsque l’élément n’a pas de meilleur nom.

Le pilote peut également ajouter un attribut class contenant la classe de rôle JET de l’élément indiqué (par exemple, class='*oj-button-text*' pour la partie texte à l’intérieur d’un oj-button). Les composites JET peuvent dessiner ces classes de rôles sur leurs parties internes, ce qui en fait un moyen stable d'adresser une partie lorsque la partie elle-même n'a pas d'identifiant.

Exemples

red rapporter-id vs id. JET régénère la valeur id d'un élément à chaque rendu, par exemple une bannière de message dont la valeur id parcourt _oj45_bannerunsaved, _oj112_bannerunsaved,... à mesure que le compteur _ojNNN augmente. Le pilote filtre cette phase volatile id et utilise la version stable redwood-id (déduite de la liaison :id du composant) à la place:

<webctrl tag='OJ-MESSAGE-BANNER' redwood-id='uidbannerunsaved' />

data-key + role class (une mesure du tableau de bord). Chaque carte de tableau de bord est un conteneur lié aux données tampons JET avec data-key de sorte que le sélecteur ancre la carte par sa clé; l'élément de valeur à l'intérieur est épinglé par sa classe de rôle JET:

<webctrl tag='DIV' data-key='accounts' />
<webctrl tag='DIV' class='*oj-sp-scoreboard-metric-card-metric*' />

data-oj-field (un champ de formulaire). Dans un formulaire de modification/création, JET tamponne le nom du champ lié sur le composant de champ, que le pilote utilise pour ancrer le champ quel que soit son ton id interne:

<webctrl tag='OJ-COMBOBOX-ONE' data-oj-field='OrganizationName' />

Un champ de sélecteur CX. Le oj-vb-fragment du sélecteur obtient un ID de runtime au format {fieldName}-cx-{uid}, où le suffixe est régénéré à chaque session. Le pilote récupère le nom du champ stable et ancre le fragment avec un identifiant de caractère générique:

<webctrl tag='OJ-VB-FRAGMENT' id='PrimaryContactPartyId-cx-*' />
<webctrl tag='INPUT' type='text' />

Astuce :

Le type de recherche Sélecteur - Par défaut du projet doit être Une correspondance afin que les sélecteurs ambigus échouent au moment de la création plutôt que au moment de l'exécution — voir À propos de l'automatisation Oracle Redtime.