Skip to main content

Jama Connect User Guide

Import a Word file

Once you have exported data from DOORS, you can import it to Jama Connect using the Data Import Wizard in Jama Connect.

  1. Open the Data Import Wizard: In the Explorer Tree, right-click an item where you want to import new items, then select Import. Your file will be imported below the selected item.


    The first page of the wizard opens with the Destination field pre-populated.

  2. Complete the Select Import File and Destination page, then click Next.

    1. Click Choose File and select the Word file you want to import.

      If the file type isn’t recognized, the import doesn't continue.

    2. (Optional) If you previously saved your field mappings for importing a Word file, click the Select a saved field mapping field and choose that file.

      This is useful if you are importing multiple documents with the same field mapping.

    3. (Optional) In the Encoding section, select the character set encoding to use during the import. For most imports you can use the default, UTF-8, which is used by the Jama Connect database.

  3. Complete the Choose Field Mappings for Import page, then click Next.

    1. Document Scope Options — If you tagged your Word file to import and ignore some sections, select the checkboxes and enter the name of each keyword (for example, INCLUDESECTION and IMPORTSECTION).

    2. Field Mapping

      • Max length of Name field — Select this and enter a maximum number of characters for the name. Default is 255 but this option lets you further limit the name length.

      • Default Value — Use this option (when available) if you want a field value to be used by default. Then, all items created during import include the default value you enter. For example, you can set the status to Draft for all imported items.

  4. Complete the How to Handle Tables page, then click Next.

    1. Choose a Table Import Style — Select this option if your item description includes tables:

      • Descriptions may include tables — Select this option if your file uses headings for hierarchy, but the content includes some tables.

      • Each table is an individual item — Select this option if your file uses tables and includes a separate table for each item. Must complete Table Field Mapping.

      • Each table row is an individual item — Select this option if your file uses tables and the tables use a separate row for each item. Must complete Table Field Mapping.

    2. Table Field Mapping — Complete this section if importing table content as individual items (option 2 or 3 above). From your Word tables, copy the heading values into the Identifier field for each Jama Field mapping. For some Jama Fields, you can set a default value (for example, setting status to Draft), which populates the field if the mapping has no value.

  5. Verify First Item in Import File — Review the mapping of the first item found in the document you're importing. If the mapping is correct, select Submit to import the target document.

    1. (Optional) Select Import another file to restart the wizard.

    2. (Optional) To reuse the field mapping settings, select Save this as new document mapping.


      Field mappings are project-specific and can be used by any user in the project where the mappings are saved.

    3. Click Submit.

  6. Click Close.

A message appears in the Data Import Wizard to confirm that the import was successful.