C.8.9.3.10. select-all-objects

Selects a set of objects based on given criteria. Searches only non-ambiguous objects given the initial selection.

<select-all-objects
    type="group_name"
    state="{any | stateless | fully-defined | under-defined | suppressed | 
       not-updated | updated | obsolete | error | bad-license}"
    name-regexp="regular_expression" />

Note:  It was necessary to "word wrap" the long line of code in the above example.


Attributes

type

Optional. Identifies an object group name or an object type constant as a search criteria. If omitted, the object type is not considered.

Object groups are defined by using the object-group element. Refer to the Standard Object Groups Reference.

Type constants for specific objects (prefixed by "id_") are defined in the script file DSConstants.js.

state

Optional. Specifies an object state as a search criteria. If omitted, the default of "any" is used, meaning that object state is not considered.

States are defined in the script file DSConstants.js.

name-regexp

Optional. Specifies a regular expression of an object's name as a search criteria. For example, "part" matches any object that includes "part" in its name (e.g. "part 2"). If omitted, object names are not considered. See the Microsoft regular expressions reference .

Element Information
Parents activate-event, if, and, or, not, then, else
Children None
End Tag No - close element with "/>"
Return Value True if one or more objects meeting the criteria were selected.
See Also

select-first-object.