Identificar elementos de Oracle Redwood

Atributos del selector que aparecen en los elementos de UI Automation para Oracle Redwood, incluidos redwood-id, data-key y data-oj-field.

Las páginas de Oracle Redwood representan la interfaz de usuario a través de elementos personalizados de Oracle JET (Oracle JavaScript Extension Toolkit). Los selectores generados para estos elementos son fáciles de reconocer por el prefijo oj- en el atributo tag y por los atributos específicos del marco descritos a continuación.

Un selector para un elemento de Oracle Redwood contiene la etiqueta <webctrl> , similar a otros elementos de la interfaz de usuario web.

Los siguientes atributos aparecen en los selectores para los elementos de Oracle Redwood:

Atributo	Descripción
tag	La etiqueta del elemento personalizado JET (por ejemplo, oj-button, oj-input-text, oj-table, oj-list-view). Ayuda a eliminar la ambigüedad de los componentes JET de los elementos HTML simples.
redwood-id	Identificador estable derivado de la expresión de enlace :id de JET. JET a menudo regenera valores id aleatorios al actualizar, mientras que la expresión :id no lo hace, por lo que prefiere redwood-id cuando esté disponible.
data-key	Clave que JET estampa en contenedores vinculados a datos o dinámicos, como tarjetas de panel o encabezados de tablas agrupadas, establecida en la clave del elemento vinculado. No está presente en las filas normales; el selector ancla el ancestro más cercano que lleva data-key.
data-oj-field	Nombre del campo vinculado, estampado por JET en un elemento principal de los campos de formulario. Apareció en el ancestro circundante, manteniendo el selector estable cuando se vuelven a renderizar las partes internas del campo.

El atributo id de los elementos de Oracle Redwood se incluye en los selectores solo cuando su valor es fiable. JET genera automáticamente muchos valores id que cambian entre cargas de página o sesiones; el controlador los reconoce y los deja fuera del selector. Cuando se filtra id , el controlador recurre a redwood-id y al identificador estable del componente JET circundante. El valor redwood-id también proporciona el nombre para mostrar del elemento en Studio cuando el elemento no tiene un nombre mejor.

El controlador también puede añadir un atributo class que contenga la clase de rol JET del elemento indicado (por ejemplo, class='*oj-button-text*' para la parte de texto dentro de una oj-button). Los compuestos JET pintan estas clases de rol en sus partes internas, lo que las convierte en una forma estable de abordar una parte cuando la parte en sí no tiene ID.

Ejemplos

redwood-id frente a id. JET regenera id de un elemento en cada renderización, por ejemplo, un banner de mensaje cuyo id recorre _oj45_bannerunsaved, _oj112_bannerunsaved, … a medida que avanza el contador _ojNNN . El controlador filtra ese id volátil y utiliza el redwood-id estable (derivado de la vinculación :id del componente) en su lugar:

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

clave de datos + clase de rol (una métrica del panel). Cada tarjeta del panel es un contenedor vinculado a datos que JET marca con data-key, por lo que el selector ancla la tarjeta por su clave; el elemento de valor en su interior está fijado por su clase de rol JET:

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

data-oj-field (un campo de formulario). En un formulario de edición/creación, JET estampa el nombre del campo vinculado en el componente del campo, que el controlador utiliza para anclar el campo independientemente de su rotación interna id :

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

Un campo selector de CX. El oj-vb-fragment del selector obtiene un ID de runtime de la forma {fieldName}-cx-{uid}, donde el sufijo se regenera en cada sesión. El controlador recupera el nombre del campo estable y ancla el fragmento con un ID de comodín:

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

Consejo:

El tipo de búsqueda Selector: predeterminado del proyecto debe ser Una coincidencia para que los selectores ambiguos fallen en el momento de la creación y no en el tiempo de ejecución; consulta Acerca de la automatización de Oracle Redwood.