Exporting Web UI test projects to DevOps Test Hub

You can migrate Web UI test projects to a compatible format and export them to IBM® DevOps Test Hub (Test Hub) so that you can edit and run the exported tests in Test Hub.

You must have completed the following tasks:
  • Configured the URL and offline user token of Test Hub in the Window > Preferences > Test > DevOps Test Hub page of IBM DevOps Test UI (Test UI). See Publishing test results to DevOps Test Hub.
  • Ensured that the test project to be exported is present in the Test UI workspace and the project contains a test suite. Otherwise, the project does not get displayed in the Export wizard.
  • Ensured that you are the owner of the target project in Test Hub.
  • Added a repository for the project to export test assets.

When you export Web UI test projects that contain assets such as tests, variables, datasets, and application visuals to Test Hub, Test UI extracts test assets, and transforms them into a compatible format. For each test suite, Test UI generates a .yaml file that contains the step details and the associated smartshots.

The export feature supports the following scenarios:
  • Migration of test projects that contain Web UI tests, and compound tests and AFT Suites with only Web UI tests. The individual Web UI tests and compound tests are listed as tests (.dtx.yaml files) after migration in Test Hub, whereas AFT Suites are listed as suites(.dts.yaml files).
    Restriction:
    You cannot export tests such as HTTP test, functional test, Selenium test, mobile test, SAP test, API test, and Windows test.
  • Migration of compound tests that contain a linked dataset.
  • Migration of tests that contain an encrypted dataset.
    Note:
    After migration, you must create a classification to play back the test with an encrypted dataset in Test Hub. For more information, refer to Adding an encrypted dataset to a classification.
  • Migration of datasets. The datasets can be linked or non-linked.
  • Migration of Web UI tests that contain JavaScript alerts such as alert, prompt, or confirm dialogs, and drag-and-drop actions.
  • Migration of Web UI tests that contain key press actions.
    Note:
    You must unselect the Native System Input checkbox in the User Actions Details panel for all key press actions in a test before migration.
  • Migration of infinite and iterative loops.
  • Migration of regular expressions (Regex) used in object identifiers and variables.
  • Migration of the GoToURL step. The GoToURL step is converted to the Open step in Test Hub.
  1. Go to the UI Test perspective.
  2. Perform one of the following steps to open the Export wizard:
    • Click File > Export from the menu.
    • Right-click the project in the test navigator, and then click Export.
    • Select a specific test in the test navigator, and then click Export.

    The Export wizard is displayed.

  3. Expand the Test folder, and then select Web UI assets to Test Hub Web UI assets.
  4. Click Next.
    The Web UI assets to Test Hub Web UI assets screen is displayed.
  5. Select test projects, or expand a project and select specific tests and datasets to be exported under Select Project(s).
  6. Select a Test Hub project and the repository to host the exported test assets under Select a Test Hub project and repository to migrate to.
  7. Select your action in Select/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 list if Edit branches already exist in the selected branch of the repository.
    • 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.
  8. Click Finish.
    The progress bar is displayed with the status of the export process.

    You can cancel the process by clicking the icon in the Progress pane.

  9. Perform one of the following steps in the Migration Complete dialog:
    • Click OK to close the dialog.
    • Click Migration Report to view the report.
      The report is displayed in a web browser with the following details:
      • Total number of files migrated in each project.
      • Number of passed and failed tests.
      • Number of tests with warning messages.
      • Number of datasets in the migrated files. Each dataset is counted as a step.
      • Total number of steps migrated in each project.
      • Number of passed and failed steps.
      • Number of steps with warning messages.
      • List of failed test suites and failure details.
You have exported Web UI test projects to Test Hub.
You can view and run the exported test projects in Test Hub. For more information, refer to Viewing test assets exported from DevOps Test UI.