Synchronizing through a batch file - command line interface (Integration for IBM Rational DOORS)
Integration for IBM Rational DOORS has a command line interface that allows you to perform a synchronization using one or more specified Integration for IBM Rational DOORS Mappings. You can use the command line to start the synchronization process in your absence, for example, by running the command line through the AT command under Windows. You can create a DOS batch file that contains one or more command lines.
The synchronization will use the options that have been set for the Integration for IBM Rational DOORS Mapping. In particular, you should decide how you want to set the Close on Completion and Save on Completion check boxes in the IBM Rational DOORS Module group of the Common Mapping Options page of Integration for IBM Rational DOORS.
The command line interface uses the following syntax:
"<path of DOORSSynchronizer.exe>\DOORSSynchronizer.exe" "<model reference>" [options]
Where the [options] are as follows:
• "<model reference>" - is the path and name of the model you want to synchronize (in Modeler, this value appears on the General tab of a Model's Property Pages). This value is stored in the ART Model Directory attribute of the root object, which can be the surrogate module or a surrogate object.
• /m"<mapping" ["<mapping>"] - are the names of the Integration for IBM Rational DOORS Mappings you want to use for the synchronizations.
• [/d¦/s¦/i] - specifies how clashes are resolved when performing bidirectional synchronizations of requirements:
◦ /d specifies that the value in the DOORS surrogate module is updated using the value from the Modeler model.
◦ /s specifies that the value in Modeler model is updated using the value from the DOORS surrogate module.
◦ /i specifies that items that clash are ignored.
if neither /d, /s or /i is specified, the value from the requirement that was last changed is used.
• /f - specifies that if the synchronization is bi-directional and the DOORS surrogate module is not fully writable, then Integration for IBM Rational DOORS should perform a uni-directional DOORS -> Modeler synchronization, even if the Modeler Requirement was last changed.
Note that if the /f option is omitted and the DOORS surrogate module is not fully writable, then Integration for IBM Rational DOORS will abort the synchronization.
• /u "<doors user name>" - is the login name to use for logging in to the DOORS project.
• /p "<doors user password>" - is the password for the specified user.
• /l "<log file>" - is the path and name of a log file to record Integration for IBM Rational DOORS log.
• /a - specifies that Integration for IBM Rational DOORS is opened based on the currently selected item in Modeler. If you use the /a option, do not use any other options.