<installedComponent> インストール済みコンポーネントターゲッター

<installedComponent> 要素は、ターゲットホスト上にインストールされていると想定される特定のインストール済みコンポーネントを特定します。

この要素は、<checkDependency>、<createDependency>、<call>、<uninstall>、および <addSnapshot> ステップのターゲッターとして使用できます。

このターゲッターは指定されたコンポーネントを直接照合するもので、指定されたコンポーネントの派生インスタンスの照合には使用できません。特定の型から派生したコンポーネントを対象とする場合は、<systemType> ターゲッターを使用してください。

<installedComponent> ターゲッターの属性

このターゲッターには次の属性があります。

• name – entityName 型の必須属性で、インストール済みコンポーネントの名前。

• path – pathReference 型のオプション属性で、コンポーネントのパス。この属性を指定しないと、包含するエンティティのパスが使用されます。

• version – version 型のオプション属性で、インストール済みコンポーネントのバージョン。この属性を指定しないと、バージョンを考慮せず、最後にインストールされたコンポーネントが使用されます。

• versionOp – オプション属性で、version 属性と、ターゲットホストにインストールされているコンポーネントのバージョンを比較する際に使用する演算子を指定します。複数のインストール済みコンポーネントが適用される場合、最後にインストールされたコンポーネントが使用されます。使用できる値は、=、>=、および > です。

  デフォルトでは >= 演算子が使用されます。version を指定しないと、versionOp は無視されます。

• onlyCompat – オプション属性で、照合を行うコンポーネントを指定します。

  値が true である場合、バージョン version のコンポーネントと呼び出し互換性のあるコンポーネントだけを照合する必要があります。バージョン version のコンポーネントが存在する必要があります。デフォルトでは値は false です。version を指定しないと、この要素は無視されます。

• installPath – オプション属性で、インストール済みコンポーネントのインストールパス。この属性を指定しないと、任意のパスの一番新しいインストール済みコンポーネントが使用されます。この値は、コンポーネントの解決処理の前に共通書式に変換されます。この属性は、単純置換変数を参照できます。

• host – オプション属性で、コンポーネントがインストールされているホスト。デフォルトでは、host は現在のホストです。host 属性の詳細については、「<retarget> ステップの属性」を参照してください。この属性は、単純置換変数を参照できます。