The allNestedRefs Installed Component Targeter

The <allNestedRefs> element may be used as a targeter for the <call>, <uninstall> and <addSnapshot> steps. It identifies the set of all nested components references declared or inherited by the current composite component. Only steps within composite components may use this targeter.

This targeter is special in that it may identify any number of components. If it identifies no components, then the step is a no-op. If it identifies more than one component, then the step is semantically expanded as if there is a separate occurrence of the step that using the <nestedRef> targeter for each component identified. The steps are executed serially rather than in parallel, and ordering of the steps varies depending on the step type, as described later. If execution of the step on one of the components causes an error, then the step will not be executed on the remaining matching components.

When used as a targeter for a <call> or <addSnapshot> step, the targeter matches all nested component references that are currently installed by this component, in the order of installation.

When used as a targeter for an <uninstall> step, the targeter matches all nested component references that are currently installed by this component, in the reverse order of installation.