Build & Deploy Projects

To build, deploy or execute a project , open it and go to the execution screen.


Project activity is sorted by requested time in descending order.

Building a Standard Project

From the Execution tab, click the Build button.

Select the Environment, Branch, and optionally Release, Change Numbers, and Issues. If you have enough permissions, you can also open the advanced section and select a different workflow version. The currently active workflow version is the default.

Click Submit to start the build.

Deploying a Project

From the Execution tab, click the Submit Deploy Request button in the row of the project version that you wish to deploy. This is the same for standard and package-based projects.

Make sure to select the correct environment and target group(s) that you wish to deploy to.

If the project was already successfully deployed, click the Force Deploy check box.

If you want to schedule the deployment, you can find that option in the Advanced section.

Click the Submit button to submit the deployment request.

Building a Package-Based Project

Package-based projects have an extra tab called Packages. This tab allows you to define groups of files that will be built and deployed together.

The screenshot below shows a Salesforce project with several packages in it.

Open a package to view and modify its contents.

Files can be added to the package either from the file list or by adding an SCM revision. If you add by revision, all files that were added or modified in the selected revision will be added to the package.


Files can also be removed from the package on the package files screen.

Once the package contains the right files, you can create a build and deploy it on the execution tab.

It’s easiest to do it on the Execution tab of the package, but the Execution tab above works too.

Select the correct Environment and Branch, and optionally a release, change number, ITS issues, and the workflow version in Advanced. Check Force Build if you have build from the same SCM revision in the past and want to build again..

Click the Submit button to start the the build.


Re-build, Re-deploy, or Re-execute a Workflow Execution

Sometimes during the course of development it is helpful to redo a specific Build, Deploy, Test, or Utility execution. In the case of packages, developers will be updating files and refining the package over time. You can click the Re-build/Re-deploy/Re-execute icon on the project activity screen to bring up the corresponding Request Form with the values from the chosen workflow execution filled in. This helps create new build, deploy, test, or utility requests quickly based on the current workflow execution's parameters.

Executing a Utility Project

From the Execution tab, click the Execute button.



Fill in the values of the Environment and the Target Groups you wish to execute the utility on. Optionally enter change tickets or a start time in the advanced section.

Click the Submit button to submit the execute request.

Testing a Project

From the Execution tab, click the Test button.

Enter the Environment and Target Groups to un tests on. Optionally enter a test name to execute. Otherwise all tests that meet the filter criteria of the environment and target group will be executed.

Click the Test button to start the test.

Monitoring Project Workflow Requests

Once a project build or deployment request has been submitted, the request status can be monitored by clicking on the Request Id.

The request shows data that was available when the workflow request was created, and doesn’t rely on the workflow having started to show up.

Read more about the Project Workflow Request.

Monitoring Project Workflow Execution

Once a project build or deployment request has been submitted, it can be monitored by clicking on the Execution Id.

The pages changes as the workflow runs. You can see the details in the screens on the left.


Read more about the Project Workflow Execution.

The following macros are not currently supported in the footer:
  • style