You can extract data from Rational® DOORS® running
in secure mode. When Rational DOORS runs
in secure mode, DXL scripts and some included files are restricted.
If the trusted DXL is not defined in Rational DOORS,
no additional tasks must be performed for Rational Publishing Engine to
access files for generating reports from Rational DOORS data.
If the trusted DXL setting is defined, you must configure Rational Publishing Engine to
work with Rational DOORS.
DXL
scripts are files that are created in the temporary directory for
the user to configure the DXL execution. The information stored here
is what is extracted from Rational DOORS,
including module paths, view names, baseline versions, and names of
the attributes. The Rational Publishing Engine installer
deploys its own DXLs and compiles an XML file that provides run time
details to the DXL environment. The path to this XML file is set in
a system variable. This task provides you with the steps to configure
the system variable with the path.
About this task
About the trusted DXL location:
- Defined through the RPE_DXLLOCATION system variable
- Must be the same path as the one in the Rational DOORS database
properties
- Must be an absolute path and cannot contain system variables.
Example of bad value: %DOORS_SERVER%\DOORS\trusted_dxl where DOORS_SERVER is \\Arakis
- Must be an UNC path. The path cannot be a mapped drive letter
as drive mappings are user-specific drives and might not be accessible
from all user accounts, including the Local System account used by
NT Services, such as the Tomcat service. Example of bad value: Z:\trusted_dxl where Z: = \\Arakis\DOORS
- The path must not end with a backslash (\)
Procedure
- In your Rational DOORS installation,
locate the paths to the Add-ins and Batch
files directories:
- Open Rational DOORS.
- Right-click DOORS Database and
click Properties.
- In the Properties window, select DXL
Securities.
- Note the path values for the Add-ins path and Batch
files path fields.
- Copy the %RPE_HOME%\source directory.
- Paste the source directory into the Rational DOORS add-ins
directory. Because Rational Publishing Engine references
the included files using relative paths, the Rational DOORS DXL
run time can retrieve them. The folder structure must be preserved.
The source directory cannot be renamed.
- Paste the source directory into the Rational DOORS batch
files directory. The folder structure must be preserved.
The source folder cannot be renamed.
- Define the RPE_DXLLOCATION variable to
point to the Batch files path. Rational Publishing Engine uses
this location as the startup location for the DXLs instead of the
default RPE_HOME.
Note: Specify a
full UNC path for the trusted DXL location. Paths using mapped drive
names cannot be used as they are user-specific drives and might not
be available to all users.