Access
To compare an object's version numbers, click the Compare with other environments button on the Version tab in the Information dialog box.
This dialog box is only accessible from an environment in a version manager (i.e. a correction, production or development environment).
It shows the results of comparing an object's version numbers in the reference environment (i.e. the environment to which the user is connected when the comparison request is submitted) and all the other environments in which the object exists.
This reveals whether a version of an object has been correctly distributed to all the desired environments.
Radio buttons
By result
Displays the results of the version number comparison in the tree structure, sorted by result (same version, most recent version, oldest version, etc.).
By version manager
Displays the results of the version number comparison in the tree structure, sorted with the environments groups that belong to a particular version manager shown together.
Tree structure (left part of the dialog box)
This tree list shows the environments and the result of comparing the version numbers with the reference environment, based on the choice made using the radio buttons, i.e. By result or By version manager.
Comparison by result
Environments are grouped according to the result of the comparison with the reference environment:
Same version |
The same version of the object is present in both environments. |
Same version except current modification |
The only difference between the object versions is the current modification in the reference environment. |
Older version |
The version of the object is older than the one in the reference environment: the latest modification(s) validated in the reference environment have not been propagated to it. |
Newer version |
The version of the object is more recent than the one in the reference environment: the reference environment has not received the latest correction validation(s) for the object. |
Divergent versions |
Both versions of the object contain changes that have not been propagated to the other version. |
Object not found |
The object was not found because it has not been created in the environment. |
Object deleted |
The object was not found because it has been deleted from the environment. |
Analysis failed |
The comparison could not be performed. This can happen, for example, if the analyzed environment is not catalogued on your workstation. |
With, Older, Newer and Divergent versions, the environments are grouped by matching version differences.
These differences are represented by a series of EnvironmentName[Difference], where EnvironmentName is an environment in which a change to the object has been received, and Difference represents the difference in terms of the number of times that the object was modified and received.
Difference will be:
- negative if the version in the reference environment has more modifications received in EnvironmentName,
- positive if the version in the analyzed environment has more modifications received in EnvironmentName.
Example:
If the difference between the reference environment and the analyzed environment is ENV_A[-1] – ENV_B[2], we know that the object in the reference environment contains one additional change that has been validated in ENV_A, but does not contain the two changes validated in ENV_B, relative to the object in the analyzed environment. This means that the object versions are divergent.
Therefore:
- With an older version, all differences are negative,
- With a newer version, all differences are positive,
- with a divergent version, there are one or more negative differences and at least one positive difference.
Comparison by version manager
Environments are grouped by version manager.
The result of the comparison is shown in brackets after the environment name.
In both cases, when an environment is selected in the tree, the result of the version number comparison between the selected environment and the reference environment is shown in the details list.
Lists (right part of the dialog box)
Comparison between the reference environment and the environment selected in the tree
When an environment is selected in the tree, the list shows details of the version number comparison between the selected environment and the reference environment, highlighting any differences by changing the background color.
The comparison details include the following information:
Object name |
Because it is possible to rename an object during a validation process, object names may vary between environments. |
Object status |
Objects can have the following statuses: "Unmodified", "Modified" (meaning that the object has been modified since it was last updated by a correction validation), "Deleted" and "Not found". |
Correction |
Name of the correction (for correction environments only, if the object is held by a correction). |
Version numbers |
List showing the number of times that a new version of an object was received in an environment before reaching the current version. The environment's name is shown in the first column. |
Buttons
Enter
Closes the dialog box.
Keyboard shortcut: Esc.
Compare
Clicking this button opens an interface highlighting the differences between the sources of two objects, if the objects contain a source (i.e. a macro-instruction, RAD template, program, management rule or program template), or between the definitions of two CDM or LDM objects (i.e. a logical entity, conceptual entity, join entity, conceptual property, relationship or data type).
This button is only available with the above object types.