Modify Instance
Modifies the attribute data values of an existing instance. The model that holds the actual instance must be open for write access before this command can be performed successfully.
The actual instance to modify can be specified by its unique numeric instanceID or by a query.
This command will invoke the EDMinstanceBrowser to enable the user to set attribute values to the instance to modify.
Arguments:
instanceID or query? |
One of two arguments are accepted: |
InstanceId: |
Specify an unsigned integer value denoting the EDMdatabase unique instanceID of the instance to be modified. This argument is only effective when the <instanceID or query?> argument is set to instanceID. |
Repository: |
Specify the name of the open repository that holds the actual instance to modify. Repository names are case sensitive. This argument is only effective when the <instanceID or query?> argument is set to query. |
Model: |
Specify the name of the open model that holds the instances to modify. Model names are case sensitive. This argument is only effective when the <instanceID or query?> argument is set to query. This model must be open for write access. |
Entity: |
Specify the instance type of the instance to modify, i.e., the name of the entity that defines the actual instance. Entity names are case insensitive. This argument is only effective when the <instanceID or query?> argument is set to query. |
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 be queried. The instance type is specified by the <Entity> argument. The first instance in the entity extent aggregate has index zero. |
Condition: |
Specify the conditions the actual instance should match. All queried instances will match the query when this argument is empty (blank). This argument is effective only 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. |
activate debugger |
The EDMdebugger will be invoked on the first declaration, which is triggered. |