Branches

A branch is used when your development team needs to work on two distinct copies of a set objects at the same time. With branches it is possible to reserve, group, develop and take a deeper look at selected versions of objects. It makes it possible to work on reserved versions of objects or even develop simultaneously on the same object.

Setup

Setup
Setup

Branch Nos. FormatThis is the no. series format used when a new branch is created.
Branch Description %1 will be replaced by the Branch No.. You can use date expressions like: <Day> <Month Text> <Year4>.

Comments

Comments are similar to Comments in projects.
For more information see Comments.

Documents

Documents in transports are similar to Documents in projects.
For more information see chapter Documents.

Add Objects to a Branch

Branch Card
Branch Card


You can add different objects to a branch. The current version is retrieved.

Add Objects
Add Objects


Or you can add a selection from the C/AL History table to your branch if needed.

Add History Objects
Add History Objects


Card


In the example above you see two lines for the table car. The first one is the latest version. The second line is an older version. It is possible to expand and collapse an object to see only the latest version. In the C/AL History table the branch is added to the selected versions.

Branch No.
Branch No.


You can add an object from the Object Explorer and add C/AL History Lines from the C/AL History to a Branch.

Outdated Objects in a Branch

When an object in your branch is not the current version they have a Boolean in the outdated field. There are three possibilities to cope with this conflicts.

Outdated Objects
Outdated Objects

  1. Get Latest Versions If the version of an object in your branch is outdated a new line for the latest version will be added.
  2. Show Outdated History Objects Shows the latest version of the outdated objects in your branch. This can be used to roll back the objects in the database to the last known version of the branch.
  3. Show Initial History Objects Show the first version of the objects in the branch. This can be used to roll back the objects in the database to the initial state of the branch.

Activate a Branch

When you want to work on a branch and reserve the objects in the branch you can activate it. All objects in the branch will be locked by you. If an object is active in another branch you get an error.

Object Active in other Branch
Object Active in other Branch


If there is an object in your branch that is outdated you get the following error.

Object Outdated
Object Outdated


Because of this two checks it is possible to have an object in more than one branch with totally separated functionality.