Apex Designer Documentation
What's New
Getting Started
Projects
Business Objects
Processes
User Interfaces
App Behaviors
Files
Dependencies
Project Settings
Libraries
Patterns and Best Practices
App Showcase

Branch Status Page

Synchronize changes between a branch and source.

Blank Profile Image
Written by Jim Volpe
Updated 6 months ago
3 min read

The branch status page compares a branch against the source and shows a list of differences. You can selectively merge changes from the branch to the source or pull changes from the source changes into the branch.

Accessing Branch Status

To get to the Branch Status Page from the Project page, click branch's bar on the graph. Or, from within a branch, use the compare button.

Branches section

Branch Status Page Layout

Branch Status

The branch status page has the branch on the left and the source on the right.

You can click the icon button in the middle arrow_forward to change the direction or define changes to ignore.

Merging from Branch to Source

When merging from branch to source, you must enter a description of the change in the "Change Description" field.

Adds

Changes shown in green are newly created artifacts:

Adds to the branch

Updates

Updates are shown in blue. Expanding an artifact shows further information about an update:

Updates to the branch

Selecting an implementation shows details of code changes:

Code changes in the branch

Resolving Conflicts

Conflicts are show in orange. These occur when an artifact has a change in both the branch and source. Expand the conflict to see the details. If a behavior or method's code is the source of the conflict, expand the implementation to determine how to reconcile the differences.

Conflicts between source and the branch

In this example, you could merge the effective and expiration properties from source to branch (right to left) and/or merge the accountNumber property from branch to source (left to right). The result is a perfectly merged artifact.

Deleting

Deleted artifacts are shown in red. Merge will delete them in source.

Deletes in the branch

Ignoring Changes

Some changes will never be merged into source. Environment variables is a good example. To ignore changes, click the merge direction icon button until notifications_off is shown:

Ignoring changes in the branch

When you have difference marked to ignore, "Ignore changes present" will be shown next to the branch name. You can review those ignored changes by clicking the merge direction icon button until they appear. Unchecking them will remove the ignore flag.

Typical Merge Scenario

In the example below, some changes have been made in branch as well as in Source.

Apply Source Changes to Branch

First, we will resolve the conflict in the PurchaseOrder business object:

Apply Source Changes to Branch

  1. Click the merge direction button until it points from Source to branch.
  2. Select the updates to be added from Source to branch.
  3. Click the Apply Selected Change to Branch button.

Apply Branch Changes to Source

Now that there are no remaining conflicts with the PurchaseOrder business object, we are ready to push our changes from branch to Source:

Apply Branch Changes to Source

  1. Click the merge direction button until it points from branch to Source.
  2. Add a Change Description.
  3. Select the updates to be added from branch to Source.
  4. Click the Apply Selected Change to Source button.

Generate the Source and Branch

After merging changes to source, you should trigger initiate an app generate of Source using the autorenew button next to the Source title.

In the example above, since changes were also made in branch, a generate of the application should also be run.

Powered by Apex Designer
Terms of ServicePrivacy Policy
© 2017-2022 Apex Process Consultants