Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Tutorial: Merging branches

Updated on June 10, 2020

Branches are containers for rulesets. You can use branches to work on an application in parallel with other development teams. Branches allow you to perform development work within an isolated space (the branch) without affecting functionality in the base ruleset branch or other teams’ development changes. After development is completed, branches can be merged with each other and into the base ruleset branch.

You can use the Merge Branches wizard to merge multiple branches into base rulesets at one time. For example, your team can use one branch to fix bugs and another branch to develop a feature for the application. After development is completed on both branches, you can then merge them into the base rulesets.


Before starting this tutorial, your development environment must be correctly configured:

Merging branches

To merge branches:

  1. Open the application rule for your development application that contains the branch.​Application rule for development application that contains the branch
  2. Optional. If you plan to delete the branch and branch rulesets after the merge, you can package your branches before you merge to keep a copy of the rules in your branch. Select Actions > Package in the application rule.

  3. Click the Definition tab, and then click Merge Branches.

  4. Select the branches you want to merge and click OK.Select the branches to merge

  5. If there are issues with the merge, the wizard displays the number of conflicts and warnings in the Target ruleset area. You must resolve conflicts before you can merge the branches. For more information about conflicts and the wizard, see the help topic Conflicts and warnings in the Merge Branches wizard.​Conflicts and warnings during a merge

  6. Click the displayed number of conflicts and warnings to open the Conflicts and Warnings window.
    Conflicts and Warnings window

  7. To examine your conflicts, you can the following actions:

    • Click Compare next to the first conflict to examine the differences between your branch copy of the rule and the one in the base ruleset.

    • Click the ruleset name to open the base rule and directly examine it.

  8. Resolve the conflicts, and then select the Mark as Resolved check box. If you are merging multiple branches, you must resolve conflicts in all branches before you can merge​.

  9. Click Submit.

  10. In the Merge Branches wizard, select from the menu whether you want to merge your branch into a new version or to use an existing ruleset version.​

  11. In the Password field, enter the appropriate password if it is required. Depending on the target ruleset version that is selected, one of five password types are displayed.

For example, the Target version field appears when you merge rules into a locked ruleset version.

Target version field in the Password field

  1. Optional. Select the Keep all source rule and rulesets after merge check box to retain all the branch rulesets and their rules after you have merged the rules into the base rulesets.

The default setting and recommended practice is to delete the branch and branch rulesets after a successful merge. You can keep a copy of the branch and branch rulesets by packaging the rules before merging (see step 2).

  1. Click Merge. The final wizard window displays the merge details.Merge details in the final wizard window
  • Previous topic Using Branch RuleSets and Merging for Parallel Development
  • Next topic Tutorial: Using branches for parallel development

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us