TeamcenterKnowledge

Developing requirements > Unstructured (flat file) import

Configuring the parser rules

The parser rules section of the configuration file specifies the rules used by the parser to identify objects and their relations in the file. A rule defines the primary and secondary object identifiers and the relations between them. You can define multiple rules to match your environment needs.

The object identifier is a regular expression that is used to identify the object in the unstructured document.

The regular expression is in the following format:

Range Boundary Open + Keyword + Separator Symbol + value + Range Boundary Close

You use delimiters to specify the start and end value of the identifier. The delimiter is enclosed in square brackets in the range boundaries. By default, the start delimiter is set to square brackets. You can change the value of the delimiter in the configuration file. The following example shows using parentheses as the delimiters for the regular expression: [(]D:ENG-FNC1-TSC[0-9]{1,}[)]

Caution: Some characters such as <, >, and & cannot be used in XML.

Delimiters are also used in the regular expression Value to designate the valid property values for the identifier.

The following describes the parameters you can configure.

Setting name Description
LinkType (optional) Specifies the type of link you want to create between the object identifier matching the PrimaryKeyword rule and the SecondaryKeyword rule. Default value: FND_TraceLink
RuleID (required) Specifies the unique identifier for the rule. Each rule must have a unique identifier. (Note: Siemens Digital Industries Software recommends that you set the RuleID using digits.) Default value: 1
PrimaryKeyword (required) Specifies the pattern for the object identifier for the primary object. This pattern is used to match objects in the document for this rule. The object identifier is a regular expression that is used to identify the object in the unstructured document. Any string that matches the regular expression is treated as the ID of the object of the type specified in PrimaryKeywordType. Keyword should be one of the values that you set for IDPrefix in the common settings section. The separator symbol is a colon by default. Default value: [[]ID:REQ-[0-9]{6}[]]
PrimaryKeywordType (required) Specifies the type to be used when creating the object matching the rule defined for PrimaryKeyword. Default value: Requirement Revision
CreatePrimaryKeyword (required) Specifies whether you want to create the object matching the rule defined for PrimaryKeyword, if it does not exist in Teamcenter. Valid values are true or false. Default value: true
SecondaryKeyword (optional) Specifies the pattern for the object identifier for the secondary object. This pattern is used to match objects in the document for this rule. Any string that matches the regular expression is treated as the ID of the object of the type specified in SecondaryKeywordType. Default value: [[]CID:PAR-[0-9]{6}[]]]]
SecondaryKeywordType (optional) Specifies the type to be used when creating the object matching the rule defined for SecondaryKeyword. Default value: Paragraph Revision
CreateSecondaryKeyword (optional) Specifies whether you want to create the object matching the rule defined for SecondaryKeyword, if it does not exist in Teamcenter. Valid values are true or false. Default value: false
LinksAs (optional) Specifies the cardinality of the trace link between the object identifiers. If LinksAs is set to Defining, then the object identifier matching the rule using the SecondaryKeyword is primary in the relation. If LinksAs is set to Complying, then the object identifier matching the rule using the SecondaryKeyword is secondary in the relation. Default value: Defining

Source: https://docs.sw.siemens.com/en-US/doc/282219420/PL20251212545240207.plm00038/xid461132 · retrieved Fri Jul 10 2026 00:00:00 GMT+0000 (Coordinated Universal Time)