Show Instance References
Display an instance and offer the possibility to display all instances that have a relation to the actual instance.
The actual instance can be specified by its unique numeric instanceID or by a query.
This command is invoking the EDMinstanceBrowser to display the actual instances. For more details about the EDMinstanceBrowser.
This command acts like the Data>Show>Instance except that a Next reference button can be used to display the instances that have one or more relations to the actual instance. All instances that have a relation to the actual instance can be regarded as being in a list of instances. By activating the Next reference button the next instance in this list will be displayed. The Next reference button cannot be activated when the end of this list is reached, i.e., all instances that have at least one relation to the actual instance has already been displayed.
The instance type, instanceID, attribute names, attribute domain, and attribute value will be displayed for each displayed instance.
For attributes referring to another instance or attributes of type aggregate, the instance or aggregate "pointed to" can be displayed by clicking on the arrow button to the left of the value field. In this way a graph of instances can be browsed, by displaying instances one by one.
A history chain of browsed instances will be maintained, and the Next and Prev buttons can be used to navigate forward and backward in the chain. The Delete button is used to delete the currently displayed instance/aggregate from the history chain. The Cancel button is used to remove the complete history chain as well as closing the window of the currently displayed instance and returning to the command dialogue.
The horizontal scroll bar can be used to scroll the attribute, type and instance value fields in horizontal direction when required, and the vertical scroll bar can be used to scroll the complete display window in vertical direction when required.
The model containing the actual instance to be displayed must be open before the Data>ShowInstanceReferences command can be performed successfully. This command cannot change any data in the EDMdatabase.
Arguments:
instanceID or query? |
Specify one of the following: |
InstanceId: |
Specify an unsigned integer value denoting the EDMdatabase unique instanceID of the actual instance. 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. 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 model that holds the actual instance. 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. |
Entity: |
Specify the name of the entity, i.e. the type of the instance to display. 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. |
First reference index: |
Specify an integer that defines the index of the actual referencing instance to be displayed. All referencing instances can be regarded as being in a list of referencing instances. This argument specifies the index in this list of referencing instances. This index must be in the range 0 <= index < number of referencing instances. |
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 that is triggered. |
instance id in show aggregate: |
When displaying aggregates of instances in table format, the instance id is displayed in the first column if this option is checked. |