Adding a DOORS data source schema with the schema discovery wizard

A data source schema can be created for a IBM Engineering Requirements Management DOORS (DOORS) data source. The data source schemas simplify authoring document templates for modules with the same structure and similar attribute lists.

Procedure

  1. In Document Studio, click Data > Schema Discovery > DOORS Schema Discovery.
  2. In the New DOORS Schema Wizard window, click Next.
  3. Specify the connection details:
    • To use a running instance of DOORS, select Use running DOORS instance.
    • To run DOORS in the background, select Run a new background DOORS process. Specify the user name, password, database, and path to doors.exe.
  4. Select a view:
    • Database view
    • Project view
  5. Click Next.
  6. Select the attribute type:
    • To add attributes to the main objects, Module/Object schema elements, select Module and objects attributes.
    • To add attributes for linked objects, Module/Object/Link/Linked schema element, select Attributes of linked objects.
  7. Click Next.
  8. In the DOORS Module Selection window, select a module from the DOORS database structure and click Next.
  9. In the DOORS Baseline window, select a baseline for the module. The baseline that you select determines which attribute set to use.
  10. Click Next.
  11. In the DOORS Attributes window, the following attribute information is displayed:
    • Attribute name: Lists attributes available in the selected baseline.
    • Scope: Displays the scope of the attribute as a module or an object.
    • Elevation name: The elevated name of the attribute is the name used in script expressions. A valid name is generated from the DOORS attribute name to prevent entering an invalid value. An elevated attribute allows direct access to that attribute value from a Module/Object context. Non-elevated attribute values are available only from a Module/Object/Attribute context.

    Select a check box to specify an attribute or Select All to select all attributes. The Deselect All clears all attributes. Click Next.

  12. In the DOORS Views and Columns window, select the view. Then select the check box for a column name to select the column or Select All to select all column names. Click Next.
    Note: An elevation name of the column displays in the Elevation Name column. You can elevate columns from any number of views. You can elevate the attributes later while designing the template. Attributes add declarative information to elements beyond the usual predefined keywords. User-defined DOORS attributes are only accessible through the Attribute nodes in the standard DOORS schema file. To use these attributes, the attribute values can be elevated as XML attributes by using the XML schema discovery wizard. An attribute might have a single occurrence, for example, Module Name, and the Last Modified On property. Attributes might apply to an object, but have multiple occurrences, such as the Object Heading and Object Text.
  13. In the Select Schema Options window, enter the details for the following fields:
    1. Select Schema Location: Click Browse to select the location to save the data source schema.
    2. Data Source Schema ID: Enter the ID for the data source schema.
      For example: DOORS 1.
    3. Optional: Select the Add Data Source Schema to the current Template check box to add this schema to the open template. Click Next.
    4. Save the schemas to reuse them in other templates without running the Schema Discovery Wizard again.
  14. Review the information in the summary window and click Finish.

Results

The schema is loaded in the Data Source Schemas view. You can see the attributes and columns added to the Module/Object element.

What to do next

To reuse the schema:
  1. In Document Studio, click Data > Add Data Source Schema. The Add Data Source Schema window opens. Click Next.
  2. In the Schema type field, select a schema type.
  3. In the Schema file field, click Browse and select a schema.
  4. In the Data Source ID field, enter a name to display in the tab for the schema in the Data Source Schemas view.
  5. Click Next and Finish.