Oracle Redwood要素の識別

Oracle Redwood要素のUIオートメーションによって表示されるセレクタ属性(redwood-id、data-key、data-oj-fieldなど)。

Oracle Redwoodページでは、Oracle JET (Oracle JavaScript Extension Toolkit)カスタム要素を介してUIがレンダリングされます。これらの要素に対して生成されたセレクターは、tag 属性の oj- プレフィックスと、以下で説明するフレームワーク固有の属性によって簡単に認識できます。

Oracle Redwood要素のセレクタには、他のWeb UI要素と同様に、 <webctrl> タグが含まれます。

Oracle Redwood要素のセレクタには、次の属性が表示されます。

属性	説明
tag	JET カスタム要素タグ ( oj-button、 oj-input-text、 oj-table、 oj-list-viewなど)。JET コンポーネントとプレーンな HTML 要素を明確に区別するのに役立ちます。
redwood-id	JETの :id 結合式から導出される安定した識別子。JET は更新時にランダムな id 値を再生成することがよくありますが、 :id 式では再生成しないため、利用可能な場合は redwood-id を優先します。
data-key	ダッシュボード カードやグループ化されたテーブルのヘッダーなど、データ バインドまたは動的コンテナーに JET スタンプを押すキーで、バインドされた項目のキーに設定します。通常の行には存在しません。セレクターは、 data-keyを運ぶ最も近い祖先を固定します。
data-oj-field	フォーム フィールドの親要素に JET によってスタンプされた、バインドされたフィールドの名前です。外側の祖先に表示され、フィールドの内部が再レンダリングされるときにセレクターを安定させます。

Oracle Redwood要素の id 属性は、その値が信頼できる場合にのみセレクタに含まれます。JETは、ページの読み込みまたはセッションごとに変化する多くの id 値を自動生成します。ドライバーはこれらを認識し、セレクターから除外します。idがフィルター処理されると、ドライバーは redwood-id と周囲の JET コンポーネントの安定した識別子にフォールバックします。redwood-id値は、要素に適切な名前がない場合に、Studio での表示名も提供します。

ドライバーは、指定した要素の JET ロール クラスを保持する class 属性を追加することもできます (たとえば、oj-button内のテキスト パーツの class='*oj-button-text*' など)。JET コンポジットは、これらのロール クラスを内部パーツにペイントするため、パーツ自体に ID がない場合にパーツをアドレス指定するための安定した方法になります。

例

レッドウッド-IDとID。JET は、レンダリングのたびに要素の id を再生成します (たとえば、 id が _oj45_bannerunsaved、 _oj112_bannerunsaved、... _ojNNN カウンターが進むにつれて。ドライバーは、その揮発性 id をフィルター処理し、代わりに安定した redwood-id (コンポーネントの :id バインディングから派生) を使用します。

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

data-key + ロール クラス (ダッシュボードのメトリック)。各ダッシュボード カードは、 data-keyでスタンプが押されたデータ バインド コンテナーであるため、セレクターはキーをキーで固定します。その中の value 要素は、JET ロール クラスによって固定されます。

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

data-oj-field(フォームフィールド)。編集/作成フォームでは、JET はバインドされたフィールド名をフィールド コンポーネントにスタンプし、ドライバーは内部 id チャーンに関係なくフィールドを固定するために使用します。

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

CX ピッカー フィールド。ピッカーの oj-vb-fragment はフォーム {fieldName}-cx-{uid}のランタイム ID を取得し、セッションごとにサフィックスが再生成されます。ドライバは安定したフィールド名を復元し、フラグメントをワイルドカード ID で固定します。

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

ヒント:

プロジェクトの [セレクター] - 既定の検索の種類 は [1 つの一致 ] である必要があります。これにより、あいまいなセレクターは実行時ではなく作成時で失敗します — 「Oracle Redwood の自動化について」を参照してください。