Trace Holders Element

The TraceHolders element manages how traced Document Objects Types can be created. Among other functionality, it determines whether trace holder types can be generated from the Action Pane. Generate means that a new Document Object Type gets created with a trace from this Document Object Type.

Example

The following example allows for the specified Document Object Types to be generated.

<TraceHolders>
  <TraceHolder TypeName="Design Input Requirement" Generatable="true" />
  <TraceHolder TypeName="Validation Test Case" Generatable="true" />
</TraceHolders>

AllowTraceFrom (optional, default true)

AllowTraceTo (optional default true)

XML Elements

TraceHolder

The Document Object Type for downward/ outgoing tracing to be managed.

FromTraceHolder

The Document Object Type for incoming tracing to be managed.

XML Attributes

TypeName (required)

The name of the Document Object Type to be managed.

Generatable (required)

Specifies whether the Document Object Type can be generated. Generate means that a new Document Object Type gets created with a trace from this Document Object Type.

Attributes in the source object will automatically be copied to the target project provided that the attribute name and attribute type in the target object is identical as in the source object.

<TraceHolder TypeName="Design Input Requirement" Generatable="true" />

Executable (optional)

Specifies whether the Document Object Type can be executed (classic text execution, not relevant for Test Run execution). Execute means that a new Document Object Type gets created with a trace from this Document Object Type.

<TraceHolder TypeName="Design Input Requirement" Executable="true" />

CopyChapterStructure

Specifies if the chapter structure from should be copied on generate. The default value is false. If set to true and:

a) no corresponding chapter structure exists in the target type, the entire chapter path to the source object is recreated in the target type and the target object is placed in the corresponding target chapter.

b) a corresponding chapter structure exists in the target type, no additional chapters will be created. The target object is placed in the existing, corresponding target chapter.

<TraceHolder TypeName="Design Input Requirement" Generatable="true"
  CopyChapterStructure="true" />

AdditionalFormattedChapter (optional)

Applicable to Generate and Execute. If AdditionalFormattedChapter is set to a formatted string value, a chapter is created with the name of the resolved formatted string. The generated / executed item is placed in this chapter.

The formatted string options available are the same as in using MailContentSettings.ReplaceParameter() for population., e.g. "Actions for {IDNoProject}: {Title} by {FullName}".

<TraceHolder TypeName="Design Input Requirement" AdditionalFormattedChapter="Tests for {IDNoProject}" />

PreventAttributesAtGenerate (xml element, optional)

Specifies the attributes that shall not be copied from the source object to the target object.

<TraceHolder TypeName="Requirement">
  <PreventAttributesAtGenerate>
    <PreventAttributeToBeCopiedAtGenerate AttributeName="Title"/>
  </PreventAttributesAtGenerate>
</TraceHolder>

GenerateAttributeMapEntry (xml element, optional)

Specifies a source object attribute that shall be copied to a different attribute in the target object.

    <TraceHolder TypeName="Requirement">
      <GenerateAttributeMapEntry ParentAttributeName="Title" TargetAttributeName="Description"/>
    </TraceHolder>