...
Prerequisites: access to a central repository and a MySQL database installation. CompareSOX Installation Process (starting from SOX V4 a empty MySQL 8 is needed), sections re. server/client setup.
...
SOX-DNG Connection Setup
You will receive from EnCo a “properties” file which can be edited in order to configure your server. The properties file supplements the read-only configuration file, supplied as a compressed archive, that also needs to be deployed on your server. In the current configuration, user credentials are “hard-saved” server-side, although this may be subject to change in future releases. I.e., the properties file allows the customer to nominate one DNG user, with his associated password, who will then have access to the external (DNG) repository. This user is not required to be a physical person; it could be an entity generically named “SOX Synchronization” or suchlike, with the implication that this entity may subsume multiple, and varying, users of the SOX rich client. As such, the credentials used authenticate a systemic identity, rather than a personal one.
It will also be possible to edit as required details like the DNG server’s port number (its IP address seems unlikely to change). This setup will enable the SOX server to connect to the DNG server.
...
Video Tutorial
See below for a visualization of the synchronization process.
...
...
Configure Synchronization
Initiate the process by right-clicking your project. Select Configure Synchronization:
Outcome: the Editor will display the synchronization file associated with your project.
Right-click on the single entry and select New Child. The choices shown result from actual queries of the DNG installation. Our example uses the DNG project “English”.
Outcome: the project chosen will appear in the Editor window.
Next, query the Shapes (artifact types) in your DNG project in order to import Shape Definitions. This is done by right-clicking on your project, our example being project “English” once again.
Outcome: SOX will initiate a server-side query (in technical terms, the SOX server will query the DNG server). The SOX client will then display the results, i.e., the complete set of Instance Shapes (artifact types) found in DNG. SOX can now work on any property structure defined for a given artifact type. Expressed differently, the data structure definition established DNG-side will now be available for working on with the SOX interface.
You can now open the drill-down list to review any field/property definition.
For example, it is possible to examine and, where appropriate, change a given Field Type.
Next, there exists an option to create a new Group Definition, corresponding to a DNG module (i.e., a logical, hierarchical container for requirements). Do this by right-clicking your DNG project and selecting New Child > Group Definition.
In the SOX context, a Group references a ReqIF document. This setup achieves synchronization of a SOX specification document with a DNG module. Select your Document Path, as well as the Query Executor “Module”. The Query String needs to match the module identifier (number) used in DNG, in the example scenario, “385”.
Lastly, you will need to create default Item Definitions. To accomplish this, right-click the Safety Group Definition (corresponding to a Doors Module) and select New Child - Import Item Definitions. - Outcome: SOX will query the specified DNG module in order to determine which artifact types are present in the relevant requirements subset. These will be displayed accordingly.
Further properties can then be modified as required.
...
| Note |
|---|
Use good judgment to decide which changes to your field types are appropriate in a specific context. Some changes, although technically possible, may yield unexpected results or errors. Most defaults are adequate and should, hence, not be modified. |
...
Synchronizing Your Project
It is now possible to initiate the synchronization process. As an initial phase, you may wish to perform a Dry Run. So doing will serve the twofold purpose of familiarizing yourself with the process and interface, as well as validating your configuration settings. To achieve these objectives, right-click your SOX project and choose Synchronize (Dry Run).
...
When synchronizing backwards any changes/additions to your data, you will be prompted for the target change set.
...
Synchronization: Method and Example Walkthroughs
There now follows a brief example walkthrough of synchronizing SOX and a DNG system with one another. Our raw material is the module synchronized with in the above demonstration.
SOX to DNG
Note in the screenshot below that the Hazard bears the idiosyncratic name “Lyo Never Rocks”.
...
If next we locate the relevant Hazard on the DNG system, we can confirm that the change became effect, i.e., migrated from SOX to DNG consequent to our synchronization:
...
DNG to SOX
Our starting point is a Hazard that in DNG - and, by implication, in SOX - is originally titled “Sharp Edges”:
...
We edit the name to make the title “Really Sharp Edges” and synchronize yet again. Subsequent to this performance, SOX displays our modification:
...
...
Configuration Management Enabled Projects
This feature introduces a new type of project based on configurable components. Each configuration of each component is able to figure as an external project within the overall configuration. The general logic of interacting with the DNG interface remains the same.
...