Specification Import from Word Document Files

Overview

This tool enables users to import structured Word documents into Requirements & Systems Portal. It was developed to read formatted Word documents that adhere to specific guidelines and automate the transfer of requirements directly into Requirements & Systems Portal. This documentation provides the necessary steps and guidelines to prepare your documents and use the tool effectively.

Formatting Guidelines

To ensure the successful import of your document, it must be formatted according to the following standards:

• Specification Name: Utilize "Heading 1" to mark the Specification Name.

• Sections and Sub-sections: Use "Heading 2", "Heading 3", and further subheadings to indicate different sections and sub-sections of the document.

• Requirement Identifier: Create and apply a custom paragraph style named "ReqID" to paragraphs that define the Requirement Identifier. This identifier is crucial for mapping the data correctly in Requirements & Systems Portal.

• Requirement Text: The body of the requirement should follow directly after the "ReqID" paragraph and be formatted in the "Normal" style.

• Tables and Images: Include tables and images directly in the document. Tables will be imported into Requirements & Systems Portal accordingly, and images will be attached to the respective requirements.

Files and Downloads

Example Document

• Airplane Standards Example.docx: Use this document as a template to understand how to format your requirements correctly. It is critical that your document matches the structure demonstrated in this example.

Airplane Standards Example.docx

Import Script

• import_to_valispace.py: This Python script reads the formatted Word document and imports the data into Requirements & Systems Portal.

Word_specification_importer.py

Usage Instructions

1. Prepare Your Document: Format your Word document according to the "Airplane Standards Example.docx" guidelines.

2. Run the Script: Run the script in Requirements & Systems Portal's Scripting Module making use of the temporary access token for authentication. It can also be modified to run from the user's desktop environment.

Disclaimer

This tool is provided "as is," with no guarantees of performance or appropriateness for a particular purpose. It serves as an example and may require modification to function with your specific configuration of Requirements & Systems Portal.

Licensing

This script and accompanying documentation are released under the MIT License. You are free to modify, distribute, and use them as needed, subject to the terms of this license.

Acknowledgments

For assistance, feedback, or to discuss your experiences with this tool, please contact us.