Delete Instance

Owned by Former user (Deleted)
Nov 27, 2017
3 min read

Deletes the specified instance from the EDMdatabase. The model that holds the instance to be deleted must be open for write access to enable a successful execution of this command.
Instances that are referred to by any other instances cannot be deleted before all the references are deleted unless the EDMserver option [deleting instances with refs] is set. The command Aux>ConfigureEDMS can be used to set and reset the EDMserver option [deleting instances with refs]. All relations, i.e., all references to an instance can be deleted by the Data>Delete>InstanceReferences command.
The instance to delete can be specified either by its unique instanceID or by a query.
When a query is used the EDMinstanceBrowser is invoked to display the first instance that matches the actual query. The user must activate the Delete instance button before the displayed instance is deleted.
Arguments:

instanceID or query?

One of two arguments are accepted:
instanceID: The instance to delete will be specified by its instanceID number.
query: The instance to delete will be specified by a query.

InstanceId:

Specify an unsigned integer value denoting the EDMdatabase unique instanceID of the instance to be deleted. This argument is only effective when the <instanceID or query?> argument is set to instanceID.

Repository:

Specify the name of the repository holding the instance to be deleted. This argument is only effective when the <instanceID or query?> argument is set to query. Repository names are case sensitive.
When activating the Select button, the name of all open repositories will be displayed in the related selection list.

Model:

Specify the name of the model that holds the instance to be deleted. This argument is only effective when the argument <instanceID or query?> is set to query. This model must be open for write access to enable a successful execution of this command. 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 name of the entity, i.e. the type of the instance to be deleted. This argument is only effective when the <instanceID or query?> argument is set to query. Entity names are case insensitive.
When activating the Select button, the name of all existing instance types in the model(s) specified by the arguments <Repository> and <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 is only effective when the <instanceID or query?> argument is set to query.
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 query to identify the actual instance. An empty query, i.e., a blank in the <Condition> argument will match all queried instances. This argument is only effective when the <instanceID or query?> argument is set to 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 next index after the one currently displayed.

delete instance references:

All references (relations) to the actual instance will automatically be deleted when the actual instance is deleted