Rational DOORS Structure data source properties reference

Open the Properties view in the Launcher application and select a Rational® DOORS® Structure data source. The Properties view displays these available properties for Rational DOORS Structure data sources.
Type Value Description
Name String Required. The title of the schema as entered in Document Studio. You cannot edit this field in this view.
Description String Required. The explanation of how the schema is used as entered in Document Studio. You cannot edit this field in this view.
Type DOORS Required. The schema type. You cannot edit this field in this view.
Configuration required none, uri, credentials, full, hidden Optional. You cannot edit this value in this view. Property set in the template which specifies which configurations are necessary when launching the document generation.
Restriction: New feature icon The Configuration required property is available only in version 2 templates.
  • none: No configuration is required from the report generator. If a data source is not configured, no warnings display at run time.
  • uri: Only the data source is required to be configured to generate the document.
  • credentials: Only the credentials to authenticate with the data provider are required to generate the document.
  • full: The data source must be configured and credentials must be given to generate the document.
  • hidden: The data source does not display in the Launcher so that the template settings cannot be overridden.
The default value is uri.
Important: When only user names are required for authentication and passwords are not required, do not use full or credentials

For more information about how user names and passwords are stored, see Security considerations for IBM® Rational Publishing Engine.

Driver eval Required. You cannot edit this field.
Default URI File path The path to the data source to use if a value for the URI property is not configured or accessible. If a value is provided for the Default URI, the data source displays as configured.
Allow read ahead true, false When set to true, documents are permitted to be generated as configured by the Data read ahead run time metadata property, which determines the order that data sources are processed.

For Rational DOORS, even when Allow read ahead is set to true, only one data source is handled at a time. The only scenario when two data sources are handled at a time is when the Data read ahead property is set to true in a document specification, at least one data source in the template has Allow read ahead set to true, and at least one data source in the template has Allow read ahead set to false.

Note: Do not set Allow read ahead to true if a template includes native filters that have variable calculations for a data source.
DOORS_home File path Required. Path to the Rational DOORS executable file. Example: C:\Program Files\IBM\Rational\DOORS\9.2\bin\doors.exe
DOORS_param String Required. The Rational DOORS database. A localhost entry refers to a Rational DOORS database located on the server. Example: -data 36677@localhost
Username String Optional. User name to login into the data source application. If there are authentication errors and the Ignore data source configuration errors property is set to true, the document generation continues. If there are authentication errors and the Ignore data source configuration errors property is set to false, the document generation cancels. See Run time metadata properties reference for more information about the Ignore data source configuration errors property.

For more information about how user names and passwords are stored, see Security considerations for IBM Rational Publishing Engine.

Password String Optional. Password to login into the data source application. If there are authentication errors and the Ignore data source configuration errors property is set to true, the document generation continues. If there are authentication errors and the Ignore data source configuration errors property is set to false, the document generation cancels. See Run time metadata properties reference for more information about the Ignore data source configuration errors property.

For more information about how user names and passwords are stored, see Security considerations for IBM Rational Publishing Engine.

New_instance true, false Required. The run mode of the Rational DOORS client. Set to true if Rational DOORS is running from the command line in the background or if Rational DOORS is not running in the background. Set to false when Rational DOORS client is running in the background. false is the default value.
Command String Optional. A script to execute when the output is generated.
Ignored true, false Optional. Set to true to exclude a template from generating when you are running multiple templates from one document specification. false is the default value.

Feedback