Identificação de elementos do Oracle Redboard

Atributos do seletor exibidos pela UIAutomation para elementos do Oracle Redboard, incluindo redboard-id, data-key e data-oj-field.

As páginas do Oracle Redboard renderizam a interface do usuário por meio de elementos personalizados do Oracle JET (Oracle JavaScript Extension Toolkit). Os seletores gerados para esses elementos são fáceis de reconhecer pelo prefixo oj- no atributo tag e pelos atributos específicos da estrutura descritos abaixo.

Um seletor para um elemento Oracle Redboard contém a tag <webctrl> , semelhante a outros elementos de interface gráfica da web.

Os seguintes atributos são exibidos em seletores para elementos do Oracle Redboard:

Atributo	Description
tag	A tag do elemento personalizado JET (por exemplo, oj-button, oj-input-text, oj-table, oj-list-view). Ajuda a desambiguar componentes JET de elementos HTML simples.
redwood-id	Identificador estável derivados da expressão de :id do JET. O JET geralmente regenera valores id aleatórios na atualização, enquanto a expressão :id não o faz; portanto, prefira redwood-id quando disponível.
data-key	Chave que o JET carimbo em contêineres vinculados a dados ou dinâmicos, como cartões de painel ou cabeçalhos de tabela agrupados, definidos como a chave do item vinculado. Não presente em linhas comuns; o seletor âncora o ancestral mais data-key que carrega.
data-oj-field	Nome do campo vinculado, carimbo pelo JET em um elemento pai de campos de formulário. Revelado no ancestral fechado, mantendo o seletor estável quando as partes internas do campo são renderizadas novamente.

O atributo id dos elementos do Oracle Redboard é incluído em seletores apenas quando seu valor é confiável. O JET gera automaticamente muitos valores id que mudam entre carregamentos de página ou sessões; o driver os reconhece e os deixa fora do seletor. Quando o id é filtrado, o driver retorna ao redwood-id e ao identificador estável do componente JET circundando-o. O valor redwood-id também fornece o nome de exibição do elemento no Studio quando o elemento não tem nome melhor.

O driver também pode adicionar um atributo class contendo a classe de função JET do elemento indicado (por exemplo, class='*oj-button-text*' para a parte de texto dentro de um oj-button). Os compósitos JET retratam essas classes de função em suas partes internas, o que as torna uma maneira estável de abordar uma parte quando a própria parte não tem id.

Exemplos

redboard-id versus id. O JET regenera o id de um elemento em cada renderização, por exemplo, um banner de mensagem cujo id passa por _oj45_bannerunsaved, _oj112_bannerunsaved, … à medida que o contador _ojNNN avança. O driver filtra esse id volátil e usa o redwood-id estável (derivado da associação :id do componente) em vez disso:

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

data-key + classe de função (uma métrica do painel). Cada cartão do painel é um contêiner associado a dados JET carimbos com data-key, então o seletor âncora o cartão por sua chave; o elemento de valor dentro dele é fixado por sua classe de função JET:

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

data-oj-field (um campo de formulário). Em um formulário de edição/criação, o JET carimbo o nome do campo vinculado no componente do campo, que o driver usa para ancorar o campo, independentemente de sua id interna:

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

Um campo seletor de CX. O oj-vb-fragment do seletor obtém um ID de runtime do formulário {fieldName}-cx-{uid}, onde o sufixo é gerado novamente a cada sessão. O driver recupera o nome do campo estável e âncora o fragmento com um ID curinga:

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

Dica:

O tipo de localização Seletor - Padrão do projeto deve ser Uma correspondência , para que os seletores ambíguos falhem no tempo de criação, em vez de no runtime — consulte Sobre a automação do Oracle Redboard.