Identifizieren von Oracle Red Erstellen-Elementen

Selektorattribute, die von der UI-Automatisierung für Oracle Red Abschluss-Elemente angezeigt werden, einschließlich redmodus-id, Datenschlüssel und Daten- Anweisungen-Feld.

Oracle Red versuchen-Seiten rendern die Benutzeroberfläche über benutzerdefinierte Oracle JET-Elemente (Oracle JavaScript Extension Toolkit). Selektoren, die für diese Elemente generiert wurden, sind leicht an dem Präfix oj- auf dem Attribut tag und an den unten beschriebenen Framework-spezifischen Attributen zu erkennen.

Ein Selektor für ein Oracle Redzelan-Element enthält das Tag <webctrl> , ähnlich wie bei anderen Web-UI-Elementen.

Die folgenden Attribute werden in Selektoren für Oracle Red Erstellen-Elemente angezeigt:

Attribut	Beschreibung
tag	Das benutzerdefinierte JET-Element-Tag (z. B. oj-button, oj-input-text, oj-table, oj-list-view). Hilft bei der Unterscheidung von JET-Komponenten von einfachen HTML-Elementen.
redwood-id	Stabiler Bezeichner, der vom :id -Bindungsausdruck von JET abgeleitet ist. JET generiert beim Aktualisieren häufig zufällige id -Werte neu, während der :id -Ausdruck dies nicht tut, also bevorzugen Sie redwood-id wenn verfügbar.
data-key	Schlüssel, den JET auf datengebundene oder dynamische Container stempelt, wie z. B. Dashboardkarten oder gruppierte Tabellenheader, der auf den Schlüssel des gebundenen Elements festgelegt ist. In gewöhnlichen Zeilen nicht vorhanden; Der Selektor verankert den nächsten Vorgänger mit data-key.
data-oj-field	Name des gebundenen Felds, gestempelt von JET in ein übergeordnetes Element von Formularfeldern. Wird auf dem umschließenden Vorgänger aufgetaucht, um den Selektor stabil zu halten, wenn die internen Elemente des Felds erneut gerendert werden.

Das Attribut id von Oracle Redhead-Elementen ist nur dann in Selektoren enthalten, wenn sein Wert zuverlässig ist. JET generiert automatisch viele id -Werte, die sich zwischen Seitenladungen oder Sitzungen ändern; Der Treiber erkennt diese und lässt sie aus dem Selektor heraus. Wenn id gefiltert wird, greift der Treiber auf redwood-id und den stabilen Bezeichner der umgebenden JET-Komponente zurück. Der Wert redwood-id gibt auch den Anzeigenamen des Elements in Studio an, wenn das Element keinen besseren Namen hat.

Der Treiber kann auch ein class -Attribut hinzufügen, das die JET-Rollenklasse des angegebenen Elements enthält (z. B. class='*oj-button-text*' für den Textteil innerhalb eines oj-button). JET-Composer schreiben diese Rollenklassen auf ihre inneren Teile, was sie zu einer stabilen Möglichkeit macht, einen Teil zu adressieren, wenn der Teil selbst keine ID hat.

Beispiele

Red Klicken-ID vs. ID. JET generiert bei jedem Render das id eines Elements neu, z. B. ein Nachrichtenbanner, dessen id durch _oj45_bannerunsaved, _oj112_bannerunsaved, … durchläuft, wenn der _ojNNN -Zähler läuft. Der Treiber filtert diese flüchtige id und verwendet stattdessen die stabile redwood-id (abgeleitet von der :id -Bindung der Komponente):

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

Datenschlüssel und Rollenklasse (eine Dashboard-Metrik). Jede Dashboardkarte ist ein datengebundener Container JET-stempel mit data-key, d. h. der Selektor verankert die Karte mit seinem Schlüssel; Das darin enthaltene Wertelement wird durch seine JET-Rollenklasse angeheftet:

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

data-of-field (ein Formularfeld). In einem Bearbeitungs-/Erstellungsformular stempelt JET den gebundenen Feldnamen auf die Feldkomponente ab, die der Treiber zum Ankern des Felds unabhängig von seiner internen id -Abfolge verwendet:

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

Ein Cloud-Auswahlfeld. Der oj-vb-fragment der Auswahl erhält eine Runtime-ID im Format {fieldName}-cx-{uid}, wobei das Suffix in jeder Sitzung neu generiert wird. Der Treiber stellt den stabilen Feldnamen wieder her und verankert das Fragment mit einer Platzhalter-ID:

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

Tipp:

Der Selektor – Standardsuchtyp des Projekts sollte Eine Übereinstimmung sein, damit mehrdeutige Selektoren zur Erstellungszeit und nicht zur Laufzeit fehlschlagen – siehe Über Oracle Red also-Automatisierung.