Skip to content
Sahi Pro Flowcharts is retired. These pages document the last release (v12) and are no longer updated. Go to the current documentation.Flowcharts is retired. Current docs
Get Free Trial
Sahi Pro Flowcharts is retired. These pages document the last release (v12) and are no longer updated. Go to the current documentation.

Version Control and Collaboration

When working on any big software project, we need version control of automation artifacts. Version Control allows individuals to work independently with their own copy of files/artifacts and prevents overwriting or clobbering another person's work. It also helps us associate specific artifacts with specific versions of the application under test. We recommend using Git for version control.

  • When we create flowcharts, all the information about the flowchart project is stored as plain text (json or csv) files on the file system.
    The path to the files is <sahipro>/userdata/scripts/flowchartsdata/<project_name>.
  • You can open the flowchartsdata folder from the Flowcharts UI by clicking on the folder icon on the Projects page.
  • You can also click on the Scripts Folder icon on the Dashboard and then navigate to flowchartsdata folder.
  • We recommend adding the entire userdata folder to your version control system (VCS) since it contains all configurations, script files and other user specific data.
    Files and folders which need to be excluded are already added in a .gitignore file.
    If you are using any other VCS, adapt from the .gitignore file accordingly.

Merge conflicts may arise when two users have changed the same content in an artifact. They can also occur when one user deletes an artifact while another user is modifying it.

Following are ways to identify a merge conflict:

  1. From Project List Page:

    On the Project List page, merge conflicts can be identified by checking for the following indicators:

    1. Number of projects that have merge conflicts.
    2. Specific project that has merge conflicts.
    3. Show only projects that have merge conflicts.

    These indicators are highlighted in the below image.

    Project list page with merge conflict data

  2. From Project Details Page:

    On a Project Details page, merge conflicts can be identified by checking for the following indicators:

    1. Number of specific artifacts those have merge conflict.
    2. Project level merge conflict. (for flowchart/ddcsv tags and execution order, filters)
    3. Particular artifact that has merge conflict.
    4. Show only artifacts that have merge conflicts.

    These indicators are highlighted in the below image.

    Project details page with merge conflict data

  3. From Flowchart Page:

    On a Flowchart page, merge conflicts can be identified by checking for the following indicators:

    1. Particular flowchart that has a merge conflict.

    These indicators are highlighted in the below image.

    Flowchart page with merge conflict data

  4. From Automate Dialog:

    On an Automate dialog, merge conflicts can be identified by checking for the following indicators:

    1. Number of specific artifacts those have merge conflict.
    2. Particular artifact that has a merge conflict.

    These indicators are highlighted in the below image.

    Automate dialog with merge conflict data

The artifacts in Sahi Pro Flowcharts inherently follow a noticeable hierarchical structure. Each Project consists of one or multiple flowcharts. Every Flowchart will have reference to multiple entities, screens, etc. Consequently, in Diff-Merge UI, if there is a conflict for an artifact, conflicts would also exist for for the references of this artifact.

Lets say, there is a conflict for an Entity $user. Consequently, there may be a conflict inside Keyword ‘Login $user’ where this Entity $user is referred. In such a case, it would be linear to resolve the conflict in the Entity before resolving conflicts in the Keyword.

Conforming to this, it is recommended to resolve merge conflict in the following order:

  1. Project
  2. Flowchart
  3. Entity
  4. Screen
  5. Keyword
  6. DataSet

Below we have examples to resolve merge conflicts at the Flowchart level:

  1. Open the flowchart that has merge conflicts. Click on Merge Conflict icon Merge Conflict Icon near flowchart name to open Diff & Merge UI. This Diff & Merge UI shows a comparison between the Local and Remote Head version of the flowchart. Merge conflicts information can be identified by checking for following indicators:

    1. The Total number of merge conflicts.
    2. The Different types of merge conflict changes
    3. The Keep All Left option provides a quick way to resolve conflicts by prioritizing changes from the left side. However, it’s essential to use this option judiciously and carefully review potential data loss.
    4. The Use All Right option provides a quick way to resolve conflicts by prioritizing changes from the right side. However, it’s essential to use this option judiciously and carefully review potential data loss.
    5. The Keep All Conflict option provides a quick way to revert all resolved changes, effectively moving the merge back to a conflicted state.

    Diff & Merge UI for Flowchart

    Hovering the mouse over a specific change on one side will highlight the respective change on the other side.

    Highlight respective change

  2. By default, changes from the Local version will be chosen. To choose a specific version, hover over the specific change on the left side. When you hover the Diff Menu will be visible. Select the required option from the Diff Menu.

    Resolve merge conflict

  3. Once a conflict is resolved, the conflict icon associated with that conflict will change to the selected resolved state icon.

    Resolve merge conflict

    A Merge conflict can have five states:

    • Conflict state

      Diff State

    • Keep Left Version: Keep the left side change, ignore the right side change.

      Diff State

    • Use Right Version: Keep the right side change, ignore the left side change.

      Diff State

    • Use Both: Left + Right: Keep changes from both sides in order of Left side changes first then Right side changes.

      Diff State

    • Use Both Right + Left: Keep changes from both sides in order of Right side changes first then Left side changes.

      Diff State

  4. Once all merge conflicts are solved, click on Save button to save the changes to file system.

  5. Optionally, you can also compare the saved changes with the Local or Remote Head version. To do this comparison, refresh the flowchart page and click on Compare With button:

    Flowchart with Compare With option

    1. To compare with the Local Head version, click on Local Head under the Compare With dropdown. This will show the comparison between the Current system version and the Local Head version.

      Diff & Merge UI for Flowchart comparing current system and Local Head version

    2. To compare with the Remote Head version, click on Remote Head under the Compare With dropdown. This will show the comparison between the Current system version and the Remote Head version.

      Diff & Merge UI for Flowchart comparing current system and Remote Head version

    3. Click on Save button to save the changes to file system.

    4. After solving all the merge conflicts, click on Mark as Resolved button.

  6. In your Git client application, commit the changed files.