The import for tree structures needs a set of control fields to be provided. The control fields determine what forms are affected by import and how are affected.

●      Form Type: Form Type name of the form.

The value provided must be a valid form-type in the project.

It is mandatory to be provided for any form in the import file.

Examples: Test Group

Test Case

Test Step

Requirement Group

Requirement

●      UID: Unique ID of the form. A form has a single UID; a numeric value. The UID of a form never changes.

If provided, this control field notifies that the form already exists in TRACE. Only existing forms have UID.

If not provided, a new form is created for this row in the import file.

If provided, it must be valid – an UID of a form in the project.

Examples: 1234567

767890

●      Form ID: Logical ID of the record in the tree structure.

If provided and depending on the Import Options, this field could be used for reordering (renumbering) the tree structure.

Examples: TG 1, TC 1.1, TS 1.1.1; TG1, TG2, TG1.1, TG2.1; RG 1, RG 2, 1.1, 1.2;

●      Depth: Level of the form in the tree structure; a numeric value.

If provided and depending on the Import Options, this field can be used for reordering (renumbering) the tree structure.

A form has a single Depth at a time. The form Depth changes when the form is moved in a different position in tree.

Examples: 1 (Depth for a root branch is 1. TG 1 branch has the depth equal to 1)

 2 (Depth for a sub-branch of a root branch is 2. TG 1.1 branch has the depth equal to 2.)

Note: If you already have a tree structure, use export feature to obtain a .csv file that provides the Control Fields for the existing records.