Merge Multiple Steps to One

TABLE OF CONTENTS

1. Overview

2. How Merging Multiple Steps Works

3. How To Use Merge Multiple Steps Feature

3.1 Inline Merge

3.2 Dataset Merge

4. Limitations

1. Overview

This document provides detailed information on Merge Multiple Steps feature and how to use Merge Multiple Steps feature to merge Scenario Steps.

2. How Merging Multiple Steps Works

Merging steps means combining two or more separate steps into a single, more efficient. This is done to:

• Simplify processes
• Reduce time or complexity

3. How To Use Merge Multiple Steps Feature

Firstly there are 2 types of merge, inline and dataset merge, To merge steps within the scenario, click the Edit icon next to the recorded scenario to view the Scenario Steps list. Then, click the Select Steps button to enable the checkboxes beside each step. Select the steps you want to merge, and click Merge Steps button. 

Note: After selecting Select Steps, you can use Master Select to select all steps at once. However, deleting all steps is not allowed because at least one step is required in the scenario steps list, so the delete icon will be disabled. If you unselect one step and then click the delete icon, a confirmation pop-up will appear asking “Do you want to delete multiple scenario steps?”. Click OK to delete the selected steps at once.

3.1 Inline Merge

A pop-up will appear prompting you to choose between Inline Merge and Dataset Merge. Select Inline Merge, then click Manual Merge to proceed.A pop-up will appear showing the selected steps. You can either click Create Custom Method to create a new custom method for these steps or choose Use Existing Method to apply an existing custom action.

Note: A Verify action cannot be the first step in the scenario steps list. If you attempt to merge steps where a Verify action is first, a warning message will be displayed. Additionally, if there are multiple Verify actions among the selected steps, those steps cannot be merged. 

1. How to create a new custom method in merge multiple steps
   Select Create Custom Method. In the File Name will be filled automatically based on the selected language. You can either choose an existing file from the dropdown or create a new one. Then Action Name, Method Name, and Description will be filled automatically, you can also edit them and click Submit to save the custom method.A pop-up will appear confirming that the method has been successfully created with the selected steps and method details. Alias name will be filled automatically in Alias Step field and there will also be suggestions available for you to choose, then click Merge Steps. The selected steps will be merged into a single step, which will be displayed in green.
   Note: The method will also be created under Utilities. If you try to edit a step that has been merged, and attempt to change its default or custom action, a pop-up will appear stating:
   "Changing Default/Custom Action will update all alias steps that currently use the existing action in the merged step."
   
   

2. How to use existing method in merge multiple steps
   Click on Use Existing Method. The Create Custom Method pop-up will appear. In the Method Name field, select a suitable method from the dropdown to merge the selected steps. The method details will be displayed. Click Submit.
   A pop-up will appear confirming that the method has been successfully created with the selected steps and method details. Alias name will be filled automatically in Alias Step field and there will also be suggestions available for you to choose, then click Merge Steps. The selected steps will be merged into a single step, which will be displayed in green. 

   
   
   
   
   
   

   By clicking the down arrow next to a merged step, you can view the individual steps that were combined to create the current merged step. These steps can be edited, deleted, added and changes will be automatically applied to that custom action.
   
   

   3.2 Dataset Merge
   
   

   To merge steps, first ensure that Dataset is enabled for the scenario by selecting the Dataset checkbox. Next, click the Edit icon for the recorded scenario to open the Scenario Steps list. Click Select Steps to display checkboxes beside each step, select the steps you want to merge, and then click Merge Steps.
   
   A pop-up will appear prompting you to choose between Inline Merge and Dataset Merge. Select Dataset Merge, then click Manual Merge to proceed with the merge operation.
   
   To merge steps by creating a new custom method, follow Step 1 in Section 3.1. To merge steps using an existing method, follow Step 2 in Section 3.2.
   
   Note: If you attempt to reorder merged steps within the scenario steps, a notification will appear indicating that reordering may affect the data sequence. Please review the changes carefully before proceeding.Navigate back to the Scenario List, click the More Options (⋮) icon, and then select the Edit icon besides dataset.
   You can view the available datasets and make any necessary modifications if required.
   
   

4. Limitations

1. Merge Steps functionality is currently supported only for Java Selenium and Python Selenium frameworks.

2. Once steps are merged, there is no option to undo or revert the merge operation.

3. Changes made in the configuration, such as Control Name, Control Type, or Default Action, are not reflected in the alias steps within a merged step, and vice versa.

4. When merging steps in another scenario, if the same set of steps has already been merged in an existing scenario, the system compares attributes such as step sequence, custom/control values, and associated actions. If an exact match is found, the system suggests reusing the existing alias step.

5. Any edits made to a merged step are automatically reflected in all scenarios that use the same merged step within the selected setup file.

6. If a step is deleted from a merged step, the corresponding data is not automatically updated in the dataset sheet.

7. After merging steps, if a user modifies the custom values or control values in the scenario, those changes are not automatically synchronized with the dataset. The dataset must be updated manually.

8. Reordering scenario steps after merging does not update the sequence in the dataset sheet. Users must either manually update the sequence and indexing or delete and regenerate the dataset.

9. If the same step is used multiple times within a scenario and is also part of a merged step, the dataset indexing may become incorrect. In such cases, it is recommended to manually adjust the indexing or regenerate the dataset.

10. Steps containing inline parameters in the Test Step Settings cannot be merged.

11. If a merged step contains a Custom Action, Auto Healing is not supported for that step, and execution may fail.

12. Minimum of 2 steps is required and only 5 steps can be merged at a time.

Note: You can also create Custom Actions from Action List, To know more about custom actions check this article Using Custom Actions