N1 Service Provisioning System 4.1 リファレンスガイド

toplevelRef インストール済みコンポーネントターゲッター

<toplevelRef> 要素は、<checkDependency>、<createDependency>、<call>、<uninstall>、および <addSnapshot> 手順のターゲッターとして使用できます。 この要素は、現在の複合コンポーネントによって宣言または継承が行われた最上位のコンポーネント参照を特定します。 このターゲッターを使用できるのは、複合コンポーネント内の手順だけです。

このターゲッターは、「name」、「path」、および「version」属性が参照先コンポーネントに基づいて事前定義されることを除き、意味的に <installedComponent> ターゲッターと同じです。

toplevelRef ターゲッターの属性

名前 

型 

必須 

構成可能 

説明 

name 

識別子 

はい 

不可 

当該コンポーネント内の最上位コンポーネント参照の名前 

versionOp 

次の 1 つ: 

  • 「=」

  • 「>=」

  • 「>」

いいえ 

不可 

参照先コンポーネントのバージョンを対象ホスト上にインストールされたコンポーネントのバージョンと比較する際に使用する演算子を指定する。 該当するインストール済みコンポーネントが複数存在する場合、最新のインストール済みコンポーネントが使用される。 指定しないと、デフォルトで「>=」が使用される  

only Compat 

ブール型 

いいえ 

不可 

true の場合、参照先コンポーネントと呼び出し互換性のあるコンポーネントだけを照合する必要があることを示す。 指定しないと、デフォルトで「false」が使用される 

installPath 

文字列 

はい 

可能 

参照先コンポーネントのインストールパス。 指定しないと、任意のパスの最新の参照先コンポーネントインストールが使用される。 この値は、コンポーネントの解決処理の前に共通書式に変換される 

host 

文字列 

はい 

可能 

参照先コンポーネントがインストールされているホスト。 デフォルトは現在のホスト。 詳細は、<retarget> 手順の host 属性を参照