Document Export Custom Templates

Requirements & Systems Portal's Document Export wizard is your go-to for whipping up editable Microsoft Word *.docx files straight from your requirements and V&V activities. You can use predefined templates or upload your own templates. The wizard is fueled by the Python-Docx-Template library, which, in turn, leverages the Jinja Templating Engine. This dynamic duo allows you to craft custom templates.

Python-Docx-Template Library Copy Link Copied

The Python-Docx-Template library is a powerful tool that extends the functionality of the Python-Docx library. It incorporates the Jinja Templating Engine, enabling dynamic content generation within your Word files. This means you can use variables, loops, and conditionals to populate your document with data on the fly. Essentially, it's like giving your Word doc a shot of espresso.

Managing Export Templates Copy Link Copied

Templates available to your Requirements & Systems Portal instance are listed on the Export templates page (  » Settings » Export templates).

• By default, six templates are provided – three for the requirement document export and three for the V&V activity document export.

  • For more information about requirements export templates, refer to the Document Export page.

  • For more information about V&V activities export templates, refer to the Document Export page.

• To add a new user-defined template, click the  button at the top right of the page. In the Add template window that appears, choose if the new template needs to be applied to Requirements or V&V Activities using the Applicable objects drop-down and then use the Select template region to select the template file.

  

  Click the  button in the dialog to add the template. It will be shown in the list on the Export templates page and can then be used in document export.

• The file of any template can be downloaded. To do this,  click the  button in the Name column of the required template and select the Download command. According to your personal browser settings, your browser will either automatically download the file to a predefined location or ask you where to store it on your hard drive.

• A user-defined template can be overwritten with a new template file. To do this, click the  button in the Name column of the required template and select the Overwrite Template command from the menu that appears. Use the Overwrite template window that opens to define the template applicability and select the new file. Enable the I confirm I want to overwrite option and click the  button to complete the process.

Appendix – Data Object Structure of Requirement Export Templates Copy Link Copied

Here’s the basic structure of the object from which your requirement export templates will pull information from.

Sorting of the Fields

You can sort the requirements using the Sort function on the Jinja template document. For example, you can add |sort(attribute='identifier') where the requirements are sorted alphanumerically on the identifier column.

Example:

{% for requirement in requirements|selectattr("specification_id", "equalto", specification.id)|selectattr("group_id", "none") |sort(attribute='identifier') -%}

Custom Columns

With the current document exporter, you can export the custom column values easily. For a simple text based custom column, you can use the following generic structure:

{% for custom_field in requirement.custom_fields|selectattr(“field”, “equalto”, “Name of Custom Column”) %}{% for value in custom_field.value %}{{ value }}{% endfor %}{% endfor %}

Be sure to substitute the Name of Custom Column text with the actual name of the column indicated on the column header.

If the custom column is not a text and is a multi-selection option, the user can use the following code and update it for their use case.

Appendix – Data Object Structure of V&V Activity Export Templates Copy Link Copied

Here’s the basic structure of the object from which your V&V activities export templates will pull information from.