Options for importing plain text files
Decomposition level
The decomposition level determines how the text file is imported. The text file can be imported into a single object, or an object can be created for each sentence in a paragraph or in a heading.
Decomposition level | Description |
---|---|
None | Creates one object and imports all the text into that object. The layout of the text in the file is maintained in the object. |
Paragraph | Creates an object for each paragraph of text in the file. Text that is preceded by a blank line is interpreted as a paragraph. A second blank line is interpreted as the end of the paragraph. An object is created below the previous heading object and the text is inserted in the Object Text attribute. |
Sentence | Creates an object for each sentence in the file. A block of text up to and including a period is interpreted as a sentence. |
Sentence w/keyword(s) | Creates an object after each sentence that contains
a keyword.
|
Headings
- period space [.]
- semicolon space [;]
- colon space[:]
- space hyphen space [-]
- carriage return
Controlling how list items are imported
Use the advanced options to control how enumerated lists and documents lists are imported.
- character.
- character)
- (character)
If you extract enumerated list items, an object is created for each item in the list. The object hierarchy reflects the structure of the list.
A document list item is a line of text that contains a user-specified delimiter. The text before the delimiter is imported into the object heading; the text that follows the delimiter is imported into the object text attribute. The new object is created as a child of the previous heading object.
Capturing embedded data
- Heading number
The number of the paragraph in the text file that generated an object is captured. Capturing the paragraph number creates traceability from the object in IBM® Engineering Requirements Management DOORS® (DOORS) to the paragraph in the text file. The heading number is the paragraph number of the preceding heading followed by a section number.
- Security classification
Characters in parentheses ( ) that are preceded by white space and a heading number are imported as Security classifications. Plain text paragraphs are assigned the same classification as the heading that precedes them. If headings do not have a security classification, you can set a default value for the security classification attribute.
- Reference
Text in square brackets [ ] is treated as reference information. Multiple references in the same object are stored in the attribute you specify as a comma-separated list.
Controlling line breaks and numbering
- To select whether all the carriage returns in the file are imported, or only carriage returns that are preceded by a blank line.
- When there are missing level 1 headings in the text file, automatically
insert objects to maintain the hierarchy in the module. You can specify
a default value for the Object Heading attributes of the objects that
are inserted.
This feature supports MIL-STD numbering for appendixes (for example, 10.0, 20.0, 30.0).