Adding an Assign step

You can use the Assign step to assign values from datasets to test variables or store values extracted from UI elements in variables during a test run.

Before you begin

You must have completed the following tasks:
  • Ensured that you are assigned a Team Space Owner, Project Owner, or Member with a Tester role to create or edit a test resource.
  • Read and understood the information in Edit branch overview and Create or select an Edit branch.
  • Ensured that your project contains a Web UI test or suite.
  • Ensured that the required variables have been created and are included in your Web UI test or suite.
  • Ensured that your project contains a dataset.

About this task

You can use the Assign step to assign values to variables during a test run. You can assign values from datasets to support data-driven testing or extract values from UI elements and store them in variables. The assigned values can then be used in subsequent test steps to perform flexible data-driven testing across multiple scenarios

Procedure

  1. Click the Edit button displayed on the Test Editor page.

    The Edit button appears only when no active edit branch is selected.

    Alternatively, right-click the test in the test navigator panel and select Edit.

    The Edit branch dialog is displayed.

    If the Edit branch dialog is not displayed, then go to step 3.

  2. Select an existing branch or create a new branch.
  3. Drag the Assign statement from the Catalog > General pane and drop it under a test step as required.
    The Assign step is inserted.
    Note:

    You can also use the Assign step within a while or do-while step, so that the Assign step retrieves the values from a dataset to process each row of the dataset iteratively and assign the retrieved values to the test variables.

  4. Click the Assign step.

    The step details pane opens with the Details tab which was the default selection.

  5. Select the required mode from the Mode list:
    • UI
    • General
    Note:
    The default mode depends on where the If step is added. When the If step is added within a With step, it opens in UI mode. When it is added outside a With step, it opens in General mode.

    A confirmation dialog is displayed, indicating that switching modes clears the current step configuration.

  6. Click Yes.
    Note:
    • The default mode depends on where the Assign step is added. When the Assign step is added within a With step, it opens in UI mode. When it is added outside a With step, it opens in General mode.
    • You can switch between the available modes by selecting a different option from the Mode list.
    • If you switch modes after configuring the step, select the required mode and then click Yes in the confirmation dialog. The existing configuration is cleared and the step opens in the selected mode.
  7. You can perform the actions that are listed in the following table to configure assign during a test run:
    Mode Action
    General
    Perform the following steps:
    1. Select an existing dataset in the Dataset field.
    2. Click Add to add a variable and assign the value from dataset.
    3. Select an existing variable from the Select a variable to assign drop down.
      Note:
      You can also select Create variable from the list to create a new variable and assign the value from the dataset.
      The variable is displayed in the Variables section.
    4. Select the column in the dataset from which you want to assign the values during test run.
    5. Click the Close icon to close the run details pane.
    UI
    Perform the following steps:
    1. Hover over a UI element in the Smartshot view, right-click, and then select Use this element as a step target.

      Alternatively, you can drag and drop a UI element from the Smartshot view to the Object identified by section.

      The UI Object type is identified.

    2. Enter a property name such as Content, Id, or XPath of the object that must be used for variable assignment in UI Property.

      If you entered the property name correctly, the value of the property is displayed under Extracted Value.

    3. Select an existing variable, or Select Add new variable, enter a name for the variable, and then click Add.
  8. Click the Save icon to save the modifications.

Results

You can configured the Assign step to assign values to test variables during a test run. Based on the selected mode, the Assign step assigns values from a dataset to variables or stores values extracted from UI elements in variables.

What to do next

You can run the test in Test Editor and view the Functional Report to verify the test steps with the variable assignment. See Running a Web UI test.