Share this page

# Fields for import files

This topic lists the required and supported fields for the item types that you can import from an Excel file.

In this topic:

## General notes

Note the following regarding import files:

- The list values described in the tables are the default system values. Your workspace may use different values depending on the workspace configuration.

- Field names are not case-sensitive.

## User story/Quality story fields

In the User stories or Quality stories sheet, enter the following fields.

### Required fields

Field | Details
--- | ---
unique_id | Required if you are updating an existing item. Use the item's ID, prefaced by `'@`. For example, `'@9100`.
name | Free text field, with a maximum of 255 characters.
type | Enter the entity type: `story` or `quality_story`. This is only required when updating an existing entity, but not when creating a new one.

### Optional fields

Field | Details
--- | ---
epic feature | An existing or new epic or feature name. If the value matches an existing epic and feature name, the imported item is associated with the epic and feature. If the value does not match, a new epic and feature are created. The epic and feature must both be in the import file to import the values. If one of the columns is not present, neither value is imported.
description | Free text field.
author | The login name in the space settings for the user who created the story. If there is no value entered, the value is set to the user performing the import.
owner | The login name for the item's owner.
phase | A list value. Possible values include: New, In Progress, In Testing, and Done. If you do not enter a value, the phase is set to New.
product_areas | The application modules of your workspace. The name of the application module associated with the item. For lower-level application modules, specify the path to the application module. Example: `top-level/appmod1` If you associate the story with multiple application modules, separate the names with a comma or any other delimiter character or string defined by your admin. If the application module’s name itself contains a forward slash or backslash, double the slash in the Excel sheet. Example: `top-level/appmod//1` An application module’s name cannot start or end with a slash.
release | The name of an existing release.
sprint | The name of a sprint in the relevant release.
story_points | Positive integer.
team | The name of a team. You must assign the team to the specified release and sprint.
user_tags | Free text specifying the name of a tag to assign to the item. To assign multiple tags to an item, separate the tags with a comma or any other delimiter character or string defined by your admin. If a tag does not yet exist, the tag is created after import. Note: Tags are not case-sensitive. If you import several tags with the same letters but different casing, only the first tag is created. For example, if you import the tags `My-Tag` and `my-tag`, the tag `My-Tag` is created. The item with the `my-tag` tag is assigned the `My-Tag` tag.

## Defect fields

In the defects sheet, enter the following fields.

### Required fields

Field | Details
--- | ---
unique_id | Required if you are updating an existing item. Use the item's ID, prefaced by `'@`. For example, `'@9100`.
name | Free text field, with a maximum of 255 characters.
type | Enter `defect` to indicate that you are importing a defect. This is only required when updating an existing defect, but not when creating a new defect.

### Optional fields (recommended)

Field | Details
--- | ---
epic/ feature | An existing or new epic or feature name. If the value matches an existing epic and feature name, the imported item is associated with the epic and feature. If the value does not match, a new epic and feature are created. The epic and feature must both be in the import file to import the values. If one of the columns is not present, neither value is imported.
description | Free text field.
severity | A list value. Possible values include: Low, Medium, High, Very High, and Critical.
defect_type | A list value. Possible values include: Pre-release or Escaped.
detected_by | The login name of the user who opened the defect.
owner | The login name of the defect owner.
phase | A list value. Possible values include: New, Deferred, Opened, Proposed Close, Closed, Rejected, and Duplicated. If you do not enter a value, the phase is set to New.
taxonomies | The environment tags for the defect. Enter the tag names for the environments defined in your workspace, separated with a comma or any other delimiter character or string defined by your admin.
product_areas | The application modules of your workspace. The name of the application module associated with the item. For lower-level application modules, specify the path to the application module. Example: `top-level/appmod1` If you associate the story with multiple application modules, separate the names with a comma or any other delimiter character or string defined by your admin. If the application module’s name itself contains a forward slash or backslash, double the slash in the Excel sheet. Example: `top-level/appmod//1` An application module’s name cannot start or end with a slash.
release | The name of an existing release.
sprint | The name of a sprint in the relevant release.
story_points | Positive integer.
team | The name of a team. You must assign the team to the specified release and sprint.
user_tags | Free text specifying the name of a tag to assign to the item. To assign multiple tags to an item, separate the tags with a comma or any other delimiter character or string defined by your admin. If a tag does not yet exist, the tag is created after import. Note: Tags are not case-sensitive. If you import several tags with the same letters but different casing, only the first tag is created. For example, if you import the tags `My-Tag` and `my-tag`, the tag `My-Tag` is created. The item with the `my-tag` tag is assigned the `My-Tag` tag.

## Task fields

In the tasks sheet, enter the following fields.

### Required fields

Field | Details
--- | ---
story | The ID of the story or defect to which the tasks will be assigned. Note: If you are importing tasks directly from the Tasks tab, the story field is not required.
name | Free text field, with a maximum of 255 characters.

### Optional fields

Field | Details
--- | ---
description | Free text field.
author | The login name of the user who created the story.
owner | The login name for the task owner.
phase | A list value. Possible values include: New, In Progress, Completed. If you do not enter a value, the phase is set to New.
estimated_hours | An integer representing the number of estimated hours.
invested_hours | An integer representing the number of invested hours.

## Requirement document fields

In the requirement document sheet, enter the following fields.

### Required fields

Field | Description
--- | ---
name | Free text field, with a maximum of 255 characters.

### Optional fields

Field | Description
--- | ---
description | Free text field.
owner | The login name for the task owner.
phase | A list value. Possible values include: Draft, In Design, In Review, Accepted, and Approved. If you do not enter a value, the phase is set to New.
release | The release to which the requirement document should be added.

## Manual test fields

In the manual tests sheet, enter the following fields.

### Required fields

Field | Description
--- | ---
unique_id | The value of this field depends on whether you are creating a new test or updating an existing test. Creating a new test: Enter a temporary number by which to identify the test. Use this number to reference the test in a call step, or to include the test in a test suite. After the test is imported, it is assigned a permanent ID. Updating a test: Enter the test's ID, prefaced by `'@`. For example: `'@9100`.
name | Free text field, with a maximum of 255 characters.
type | Enter `test_manual` to indicate that you are importing a manual test. Enter `step` to indicate that you are importing a test step to the specified test.

### Optional fields

Field | Description
--- | ---
test_type | A list value. Values can be Acceptance, End to End, Regression, Sanity, Security, or Performance. Use the values allowed by the UI's language.
product_areas | The application modules of your workspace. The name of the application module associated with the item. For lower-level application modules, specify the path to the application module. Example: `top-level/appmod1` If you associate the story with multiple application modules, separate the names with a comma or any other delimiter character or string defined by your admin. If the application module’s name itself contains a forward slash or backslash, double the slash in the Excel sheet. Example: `top-level/appmod//1` An application module’s name cannot start or end with a slash.
covered_requirement | The ID of the requirements covered by this test. To specify multiple requirement IDs, use a comma as the delimiter or any other character or string defined by your admin. Make sure that the values in the Excel file correspond to existing requirement IDs.
covered_content | The ID of the backlog items this test covers.
designer | The login name of the user who created the test and test steps.
description | Free text field.
estimated_duration | An integer representing the expected number of minutes required to perform the test run.
owner | The login name of the item's owner.
phase | A list value. Possible values include: New, In Design, Awaiting Review, Ready, or Obsolete. If you do not enter a value, the phase is set to New. Use the values allowed by UI's language.
user_tags | Free text specifying the name of a tag to assign to the item. To assign multiple tags to an item, separate the tags with a comma or any other delimiter character or string defined by your admin. If a tag does not yet exist, the tag is created after import. Note: Tags are not case-sensitive. If you import several tags with the same letters but different casing, only the first tag is created. For example, if you import the tags `My-Tag` and `my-tag`, the tag `My-Tag` is created. The item with the `my-tag` tag is assigned the `My-Tag` tag.

## Test step fields

In the manual test sheet, define the test step fields.

Field name | Description
--- | ---
step_type | Possible values: Simple, Validation, or Call. Use the values allowed by UI's language.
step_description | Simple or Validation steps: Free text describing the step. Call steps: The ID of the test that the step is calling. You can refer either to a test that you are importing in the same sheet, by using its unique_id, or to an existing test, by using its ID, prefaced by `@`. For example, `@9003`.
type | Enter `step` to indicate that you are importing a test step.

## Test suite fields

In the test suites tab, enter the following fields.

### Required fields

Field | Description
--- | ---
unique_id | The value of this field depends on whether you are adding a new test suite or updating an existing test suite. Adding new test suite: Enter a temporary number by which to identify the test suite. After the test suite is imported, it is assigned a permanent ID. Updating test suite: Enter the test suite's ID, prefaced by `'@`. For example, `'@9100`.
name | Free text field, with a maximum of 255 characters.
type | Enter `test_suite` to indicate that you are importing a test suite. Enter `test_manual` to indicate manual tests under the test suite.

### Optional fields

Field | Description
--- | ---
test_id | The ID of the test to include in the suite. For a new test: The unique_id of the manual test, as assigned in the manual test sheet. You must include the referenced manual test in the same import file as the test suite. For an existing test: The ID assigned to the test, prefixed by `'@`. For example, `'@2001`.
product_areas | The application modules of your workspace. The name of the application module associated with the item. For lower-level application modules, specify the path to the application module. Example: `top-level/appmod1` If you associate the story with multiple application modules, separate the names with a comma or any other delimiter character or string defined by your admin. If the application module’s name itself contains a forward slash or backslash, double the slash in the Excel sheet. Example: `top-level/appmod//1` An application module’s name cannot start or end with a slash.
covered_content | The ID number representing the backlog items this test covers.
designer | The login name of the user who created the test and test steps.
description | Free text field.
owner | The login name of the test suite's owner.
user_tags | Free text specifying the name of a tag to assign to the item. To assign multiple tags to an item, separate the tags with a comma or any other delimiter character or string defined by your admin. If a tag does not yet exist, the tag is created after import. Note: Tags are not case-sensitive. If you import several tags with the same letters but different casing, only the first tag is created. For example, if you import the tags `My-Tag` and `my-tag`, the tag `My-Tag` is created. The item with the `my-tag` tag is assigned the `My-Tag` tag.

## See also

- Export data
- Import from Excel

https://admhelp.microfocus.com Software Delivery Management 8942
Tips to improve your search results... OpenText™ Software Delivery Management Help Center OpenText™ Software Delivery Management Help 26.3 All View Local Help Center View Online Help Center Version: