toplevelRef インストール済みコンポーネントターゲッター
<toplevelRef> 要素は、<checkDependency>、<createDependency>、<call>、<uninstall>、および <addSnapshot> 手順のターゲッターとして使用できます。 この要素は、現在の複合コンポーネントによって宣言または継承が行われた最上位のコンポーネント参照を特定します。 このターゲッターを使用できるのは、複合コンポーネント内の手順だけです。
このターゲッターは、「name」、「path」、および「version」属性が参照先コンポーネントに基づいて事前定義されることを除き、意味的に <installedComponent> ターゲッターと同じです。
toplevelRef ターゲッターの属性
名前
|
型
|
必須
|
構成可能
|
説明
|
name
|
識別子
|
はい
|
不可
|
当該コンポーネント内の最上位コンポーネント参照の名前
|
versionOp
|
次の 1 つ:
|
いいえ
|
不可
|
参照先コンポーネントのバージョンを対象ホスト上にインストールされたコンポーネントのバージョンと比較する際に使用する演算子を指定する。 該当するインストール済みコンポーネントが複数存在する場合、最新のインストール済みコンポーネントが使用される。 指定しないと、デフォルトで「>=」が使用される
|
only Compat
|
ブール型
|
いいえ
|
不可
|
true の場合、参照先コンポーネントと呼び出し互換性のあるコンポーネントだけを照合する必要があることを示す。 指定しないと、デフォルトで「false」が使用される
|
installPath
|
文字列
|
はい
|
可能
|
参照先コンポーネントのインストールパス。 指定しないと、任意のパスの最新の参照先コンポーネントインストールが使用される。 この値は、コンポーネントの解決処理の前に共通書式に変換される
|
host
|
文字列
|
はい
|
可能
|
参照先コンポーネントがインストールされているホスト。 デフォルトは現在のホスト。 詳細は、<retarget> 手順の host 属性を参照
|