Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Here is an example of test cases structure:

Image RemovedImage Added


This is how the CSV file looks like once the test cases above are exported (download it from the downloadable examples section):

Image RemovedImage Added



Info
titleCSV column separator

If you choose the “,” (comma) as the CSV column separator, then you must use quotation marks around any field that contains commas.

...

  1. Log in with an administrator account.
  2. Go to System > Import and Export > External System Import.
  3. Select the Xray Test Case Importer. Image RemovedImage Added
  4. Follow the Setup Page section instructions

...

  1. Log in with a non-administrator account.
  2. Got to Tests menu > Test Case Importer as shown in the image Image RemovedImage Added
  3. Select the Test Case Importer menu item
  4. Follow the Setup Page section instructions

...

Provide the basic settings for the importation process.

Image RemovedImage Added

  • The CSV Delimiter field is the column delimiter used in your CSV source file.
  • The File Encoding field is the encoding used in your CSV source file. 
  • Optionally, you can use the settings from a previous importation.

...

  • Select the Xray project where you want your Manual Test cases to be imported. 
  • Set the Date formats that will be used for all Jira custom fields and also to the Manual Test Step Custom fields of type "Date picker" and "DateTime picker".

Image RemovedImage Added

Field Mapping Page

Map the fields from your CSV to Jira and Xray fields

Image RemovedImage Added


It is mandatory to map at least three fields:

...

Info
titleCustom field mapping

Only custom fields that have the issue type Test selected as one of the applicable issue types will be available for mapping.

Image Modified

Available custom fields for import:

  • Checkboxes
  • Labels
  • Number fields
  • Radio buttons
  • Select lists (single choice and cascading)
  • Text field
  • URL field
  • User picker

Note: Only "single-value" custom fields are supported. "Select List (cascading)" custom fields behave as a single-value field; in that case, you have to specify the value in the format "parent -> child" as mentioned also for Jira's native CSV importer.

...

Map the CSV column values. In the example above, the Map Field Value checkbox is selected for Priority, so those values are going to be mapped.

Image RemovedImage Added

Now just click Begin Import and Xray Test Case Importer will import the manual test cases to the selected project.

Image RemovedImage Added

The importation process is complete. A configuration file can be saved to import other manual test cases in the future.

...

It is possible to attach files to Test and to Test Steps.

Image RemovedImage Added


Info
titleAttachments

The attachment may be referred by name (in this case the file:// protocol is assumed), by "file://" or "http(s)://". Multiple files may be specified within one CSV column; for this, the attachments must be delimited by space.Image RemovedImage Added

Note: For file protocol, only files in the "<JIRA_DATA_HOME>/import/attachments" folder will be imported.

...

Folders and their respective sub-folders must be delimited by "/", as shown in the following example:

Image RemovedImage Added


During the mapping step, you need to map the CSV column containing the path to the "Test Repository Path" Xray's custom field.

Image RemovedImage Added


Info
titlePlease note

The "Test Repository Path" is case insensitive and each folder is trimmed (spaces are removed from the start/end of it).

This means that "components/compA", "components /compA", and " components/COMPA" are all the same and will be mapped to the same folder within the Test Repository.

If the folder is not found, then the Test is created, but it is not associated with any folder; it will appear in the "Orphans" meta-folder. Unless you selected the option 'Create Folders', in the Setup page.

...

Make sure you have the Hierarchical Test Organization enabled and the logged in user belongs to a Project Role allowed to edit the Test Repository. You can check this settings under the Xray Global Settings.

Image RemovedImage Added

You can import a link to other issues for newly-created Tests by choosing the "Link ..." mapping.

...

Info
titleLinks to requirements

When importing Tests, you can specify the links to the requirements that each Test validates. For that purpose, columns must be mapped as Link "Tests".

If the Test covers multiple requirements, then multiple CSV columns must be used, each one being mapped in the same way.


Image Modified

Date Time fields

...

As in Jira's native CSV import, we provide means to updating an existing issue.

Image RemovedImage Added

In order to Update an issue you must comply with the following pre-conditions:

...