How Various Word Layouts Will Look When Imported into Jama Connect®

Amanda Jennewein
Amanda Jennewein
  • Updated

Author: Amanda Jennewein

Updated: August 2024

Audience: Everyone

Products Applicable: Jama Connect®

Use Case

How Various Word Layouts Will Look When Imported into Jama Connect®

Headings

Jama Connect® utilizes the Heading font styles incorporated into Word during document imports. These font styles indicate the start of a new item or if an item is a folder or child item.

Screenshot 2024-08-13 at 9.48.08 AM.png

For example, if you were to use headings in your Word document like this:

Screenshot 2024-08-13 at 9.49.13 AM.png

It should look like this in your Project Tree in Jama Connect®:

Screenshot 2024-08-13 at 9.50.27 AM.png

Likewise, this organization:

Screenshot 2024-08-13 at 9.51.14 AM.png

Will import like this:

Screenshot 2024-08-13 at 9.51.49 AM.png

Headings are an effective way to indicate hierarchy when importing items into Jama Connect®. It's important to note that using up to seven (7) hierarchy levels in Word is feasible.

Tables

You can import items into Word using tables in three different ways.

1. Treating tables as part of your item's description would look like:

Screenshot 2024-08-13 at 9.54.49 AM.png

2. Treating each table as an individual item. Cells directly to the right of identifiers will populate corresponding item fields.

Screenshot 2024-08-13 at 9.55.40 AM.png

3. Treating each row in the table as an individual item makes it similar to importing items from Excel. Each row within the table will be imported as an item, and the fields will be mapped similarly to Excel.

Screenshot 2024-08-13 at 9.56.36 AM.png

How Do I Map Tables I Created in Word?

Tables in Word can only be mapped using one style. If you use multiple tables, they must have the same Import Style. Additionally, the Rich Text Editor in Jama Connect is best compatible with a "Table Style" within Word and Excel.

Screenshot 2024-08-13 at 9.57.59 AM.png

This is recommended when importing tables that are part of the item's description; it is optional for importing tables or rows as individual items.

When importing tables as a part of the item's description, there is no need to map the table. Jama Connect will add the table to the description of your item in Jama Connect. To illustrate this, a Word document with a table such as this:

Screenshot 2024-08-13 at 10.00.34 AM.png

Using the "Descriptions may include tables" option:

Screenshot 2024-08-13 at 10.01.48 AM.png

It will look like this in Jama Connect®:

Screenshot 2024-08-13 at 10.02.50 AM.png

The table is editable within the description.
The second and third examples listed above will import differently, and Jama Connect® needs to do further mapping to understand how and where to import your information.

Mapping each table as an individual item

Your Word document will resemble this:

Screenshot 2024-08-13 at 10.04.55 AM.png

Please note that the item fields are in the left columns, while the field values are in the correct columns. No special formatting is required for the item fields, but some users prefer highlighting or bolding the font to differentiate them from the field values.

To import the document, right-click the set or component you want to import or go to Project > Import. Follow the standard import instructions until Step 2, where you can choose the table format. Once you select the second table, a field mapping option will appear at the bottom of the pop-up window. If you've mapped Excel spreadsheets before, this process will familiarize you.

Screenshot 2024-08-13 at 10.06.29 AM.png

After completing the import, your items will appear similar in Jama Connect®:

Screenshot 2024-08-13 at 10.07.24 AM.png

If you open one of the items, you will find the data you entered in the table within the item's information.

Screenshot 2024-08-13 at 10.07.47 AM.png

Treating Each Row as an Individual Item 

Tables can also be formatted to import multiple individual items. An example of this is below:

Screenshot 2024-08-13 at 11.00.20 AM.png

Like an Excel import, the table's top row contains item fields you want to import, such as ID, Name, and Description.
Select the third Table Import Style for this format. Similar to importing tables as individual items, you will have to map the fields of your table, as we have done in the example below.

Screenshot 2024-08-13 at 11.01.38 AM.png

If you have successfully imported this document, the items will appear like this in your Project Tree:

Screenshot 2024-08-13 at 11.06.04 AM.png

The item's details will be based on the information provided during the import process, such as the description.

Screenshot 2024-08-13 at 11.06.43 AM.png

References

Please feel free to leave feedback in the comments below.

Related to

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.