Find Instances

Searches the specified model for instances that match specified condition. The actual model must be open to enable a successful execution of this command. The result from this command is the number of instances, the index of the last instance, and the instanceID of each instance that matches the actual condition.
Arguments:

Repository:

Specify the name of the repository holding the model to query. Repository names are case sensitive.
When activating the Select button, all open repositories will be displayed in the related selection list.

Model:

Specify the name of the model to query. Model names are case sensitive.
When activating the Select button, the name of all open models located in the repository(ies) specified by the <Repository> argument will be displayed in the related selection list.

Entity:

Specify the instance types, i.e., the entity name of the instances to be queried. Entity names are case insensitive.
When activating the Select button, the name of all existing instance types in the specified model will be displayed in the related selection list.

First instance index to check:

Specify an integer value denoting the index, i.e., element number in the Entity Extent aggregate that holds all instances of the same type in a model. The value of the <First instance index to check> argument specifies the index of the first instance to query The instance type is specified by the <Entity> argument. The first instance in the entity extent aggregate has index zero.
This argument will be automatically updated to the index of the last instance that matched the query plus one, when the option [update indexes] is set. This feature makes it convenient to query all instances of a particular type in several consecutive queries.

Condition:

Specify the Conditions the required instances should match. Default value is that no condition is specified.

Max number of hits:

Specify the maximum number of instances that matches the condition specified in the argument <Condition>. This argument restricts the number of instanceID to be returned. This argument can be set with the string value all – i.e. to return all instanceID matching the query.

Options:

accumulating command output:

A global option that appends the command output to the EDMsupervisor output window. Otherwise the output window is refreshed and only the last command output is displayed.

match selected input:

A global option that specifies that only items that partly or exactly matches the string in the related argument input field when activating a Select button, will be in the selection list. An empty (blank) string will match all items.

update indexes:

A global option that specifies that the <First instance to check> argument will be updated to the "index of the last matching instance + 1"