Version control and branching

Table of contents:

• What is branching?
  
  • Create a branch
• Version control
  
  • Merge a branch
  • Edit branch name
  • Delete branch
  • Copy and Overwrite

What is branching?

The development process often requires you to work on multiple branches. Grids can be branched to enable version control and allow testing to be performed in isolation.

When opening a Grid, a single branched called Master is displayed by default (this is displayed in the header).

Create a branch

To create a branch:

1. In the header, click Master to view the drop-down menu.
2. Select Create New Branch. The Create Branch popup box displays the Grid and version this branch will branch from.
3. Enter a Branch name.
4. Configure advanced settings (optional):
   • Include automations: Automations in the original branch will be available in the new branch
   • Include records in current view: If selected, only records in the current view are included in the new branch. Otherwise, all columns in the original branch will be available in the new branch.
   • Managing branch access for groups
5. Click Save.

The new branch will be displayed and will be added to the list of available versions in the header drop-down menu.

The branch selected in the header drop-down menu is the one where changes are being made.

Version control

Merge a branch

To merge a branch into another:

1. Click on the right sidebar and select icon.
2. Check the Current Branch.
3. Select Merge branch to merge changes into another branch.
4. Click Compare changes to view changes if necessary. The records and the content that have been edited will be highlighted in one of the colors: blue (updated), red (deleted), green (added), yellow (conflict).
5. Configure merge options:
   • Records options: Add new records at bottom, Update existing records, Delete existing records, Overwrite all conflict data
   • Column options: Add new column, Update existing column (selected by default)
6. Click Merge.

Edit branch name

1. Click on the right sidebar and select icon.
2. Check the Current Branch.
3. Click Edit branch name.
4. Enter the new branch name and click Save.

Delete branch

1. Click on the right sidebar and select icon.
2. Select Delete branch.
3. Select the branches you want to delete.
4. Confirm in the prompt.

Copy and Overwrite

This feature allows you to copy data from another branch into the current branch. All data in the current branch will be overwritten, this includes: View data, Column data, Record data.

1. Click on the right sidebar and select icon.
2. Select Copy and Overwrite.
3. Select a source branch to copy from.
4. Click Clone.