When the reader is launched from rules or Java code, you can set options to tweak the reader's behavior.
A Java snippet is available in the Javadoc of the class
You can define the scope of the reader, to restrict the modules to be read or to force them to be loaded at once,
You can specify for each formal module which baseline should be used,
You can specify for each formal module which specific view should be used over the default one,
instance might also be set to introduce additional filtering on top on the one provided by the current view.
Note that a DOORS client doesn't provide any mean to read a baseline using a specific view when the baseline is not open and visible in the DOORS client.
The reader usually requires a DOORS client to be open in order to access the data.
It is possible to configure the reader so that DOORS is executed in batch mode, provided you give the reader
the DOORS user identity to connect to.
To use the batch mode, you need to set the
as described in the snippet in
shall also be used to share a DOORS batch client between a model reader and a DXL command to update DOORS data
Note that, even in batch mode, on-demand loading is still supported (a hidden DOORS client is kept alive as long as data is retrieved).
The model reader can be configured using many options, which are defined in the class
Here is a list of the most significant options:
is programmatically set.
It may be used to to restrict the modules to be read or to force them to be loaded at once.
Common.OPTION_IGNORE_OLE_PREVIEW_IMAGES option must be set to
Row) are to be ignored.
These objects are usually not used.
Note: Objects contained in table cells are always read and not affected by this setting.
The default value is a comma (
","), for historical reasons. As this character might be used in an enumeration literal,
it is recommended to use another separator, like
"\n" or any other character that cannot be used in a literal.
whereas the DOORS legacy URL uses a
true, this setting requires additional properties:
- the full path of
doors.exe, used to launch DOORS
- the port and server name of the database to connect to (e.g.
- the name of the DOORS user to make the connection
- the password of the DOORS user to make the connection
should also be set
true in such use case.
Reading DOORS data