ChangeSets in GeneXus Server

Official Content
This documentation is valid for:

A ChangeSet is an arbitrary aggrupation of objects which it's defined by the user. It allows sorting and grouping all the Pending for Commits objects in differents sets.

It often happens that a Developer works on several unrelated tasks at once, and when looking in the Commit dialog, all the changes are mixed in together.

To solve this, ChangeSet option allows the Developer to group objects together, making it easier to see the relationship between them. This it's very useful when working for example on a huge feature but at the same time, fixing some minor problems, because allows the Developer to identify quickly and select the corresponding objects to Commit.

Note: This option can only work if the changes do not overlap. If two different tasks affect the same object, there is no way to separate the changes.

How does it work? 

First of all, to move an object into a ChangeSet, it has to be Pending for Commit. 

From the Commit dialog, or from the Team Development option of the object's contextual menu, the Developer will be able to select one or more objects and, by right-clicking on them, choose the Move to changelist option to add them to a ChangeSet.

If any ChangeSets were created before, only the <new changelist> option would be displayed giving the possibility to choose a name for the new ChangeSet. Otherwise, all the existing ChangeSets will also be presented.

When selecting a ChangeSet, the object will automatically be added to it, changing it position in the Pending for Commit list giving an immediate visual indication of groupings. 

The only thing left to do is to click the Commit button.

Notes: 

  • If an object doesn't belong to any changelist, it will be shown at the beginning of the Pending for Commit list under the title of (no changeset).
  • An object can only belong to one, and only one, ChangeSet. The ChangeSet of an object can always be changed. 
  • After selecting the Commit option, the object will be removed from the ChangeSet, so when the object returns to the Pending for Commit list, will not belong to any ChangeSet.

Usage example

Let's consider the TravelAgency reality.

The Developer is working on a huge feature related to the Reservation of hotels, and also he's fixing some bugs, and he want to Commit only the Bugs fixes.

The first time he opens the Commit dialog, all the objects are mixed in together:

ChangeSet1

And he decides to define two differents ChangeSets: Bugs and Reservation Feature. To do so, he selects an object which will belong to the Bugs ChangeSet. 

By right-clicking on the object and selecting the move to ChangeSet option, the <new ChangeSet> option is displayed:

ChangeSet2

The Developer selects it and creates the first ChangeSet:

ChangeSet3

Using the same method, he creates the next ChangeSet.

After that the ChangeSet creation it's done, the Developer select all the object to assign to the Reservation Feature ChangeSet:

ChangeSet4

And to the Bugs ChangeSet:

ChangeSet5

As a result, all the objects are assigned to the corresponding ChandeSet allowing the Developer to identify quickly and select the corresponding objects to Commit.

ChangeSet6