Creating a dataset by using a CSV file

Edit online

When you use variable data that is contained in a CSV file, you can import the data from the CSV file and create a dataset in IBM® DevOps Test Hub (Test Hub).

Before you begin

You must have completed the following tasks:

Ensured that you are assigned a role as a Project Owner or Tester in the project. See Managing access to the server projects.
Created a project in your team space in Test Hub. See Creating a project.
Added the remote Git repository that contains the test resources to the project. See Adding repositories to a server project.
Saved a CSV file that contains variable data on your computer.
Created an application in your project. See Creating an application.

Procedure

Log in to Test Hub.
The Projects page of the initial team space is displayed.
Click My projects > project_name to open the project that contains the test assets.

The Overview page of the project is displayed.
Click Author > Data.

The Data page and the data navigator panel are displayed.
Select the branch in the project repository from the Branch list.

The assets and resources in the selected branch are displayed in the data navigator panel.
Perform any of the following actions:
- Click Add files and select Dataset on the Test Editor page.
- Click the Action Menu icon and select Dataset.
- Right-click the application in the data navigator panel, select New > Dataset.
The Edit Branch dialog is displayed.

If the Edit branch dialog is not displayed, then go to step 7.
Select your action to either select an existing Edit branch or create an Edit branch:
- Perform the following steps to select an existing Edit branch:
  1. Select Use an existing edit branch.
  2. Select an Edit branch from the Select branch list if Edit branches already exist for your repository.
    
    Note: A warning message is displayed if the Edit branch, which you selected, is behind the source branch. To update the selected edit branch and maintain synchronization with the source branch, you can select the Update branch option when switching checkbox.
  3. Click Ok.
- Perform the following steps to create the Edit branch:
  1. Select Create new edit branch.
  2. Enter a name for the Edit branch in the Branch Name field.
  3. Click Save.
The Create dataset dialog is displayed.
In Step 1 of the Create dataset dialog, perform the following tasks:
1. Select the Application for which you want to create a dataset.
2. Select Location from the drop-down list to store the dataset.
3. Type a name for the dataset.
4. Click Next to proceed to Step 2.
In Step 2 of the Create dataset dialog, perform the following tasks:
1. Select Source as Import a CSV file.
2. Click Select File and choose the CSV file that contains variable data to import into the dataset.
3. Toggle on the First row contains headers option if your CSV file includes column headers.
4. Click Create.

Results

You have created the dataset by using the CSV file in your project.

What to do next

You can perform the following tasks:

Add, modify, or remove data in the dataset. See Editing a dataset.
Publish the dataset to the Git repository so that other members of the project can use the dataset. See Publishing changes in datasets.