The following tables summarize the Build and Compile options available with Progress Developer Studio for OpenEdge. Some of these options are provided by the Eclipse framework, while others are a part of the Progress Developer Studio for OpenEdge functionality. The tables also list the help topics associated with each option that you can refer to for detailed information.

Options provided by Progress Developer Studio for OpenEdge:

Option Description Associated help topics
Build Working Set Automatically Allows you to automatically build a working set.

To access this option, select Project > Build Working Set Automatically.

Note: The Build Working Set Automatically option is enabled only when the automatic build preference (at the project level) is disabled (ensure that Project menu > Build Automatically is not selected).
 Build a working set automatically
Clear OpenEdge Compile Errors Clears any error messages for a particular file from the Problems view or the marker bar.

To use this option, select Project > Clear OpenEdge Compile > Errors or select Progress OpenEdge > Clear OpenEdge Compile > Errors from the ABL Editor context (right-click) menu.

Clear OpenEdge errors

Progress OpenEdge context menu

Save automatically before build Saves all the modified resources in the Workbench before a manual build.

To access this option, select Windows > Preferences > General > Workspace.
Compilable file extensions Specifies the file extensions defined in the workspace for file types that the OpenEdge Editor and SpeedScript can compile.

To access this option select Windows > Preferences > Progress OpenEdge > Editor > Build.

Editor Build options

Build properties page

SpeedScript properties page
Compile on save if required Compiles ABL source files each time you save them.

To access this option select Windows > Preferences > Progress OpenEdge > Editor > Build.

 Compile ABL code

Editor Build options

Exclude from Build Excludes compilable resources when you build your project. You can exclude files, folders, or both from the build.

To access this option select the Progress OpenEdge menu that is available from the ABL Editor context (right-click) menu.

You can also exclude resources using Exclusion Pattern Selection and Add Resource Exclusions. See Exclude resources using Exclusion Pattern Selection and Exclude resources using Add Resource Exclusions for more information.

 Excluded resources

Exclude resources from the context menu

Progress OpenEdge context menu

Include in Build Includes the excluded resources to the build. This option is only available for the resources that were excluded from the build.

To access this option select the Progress OpenEdge menu that is available from the ABL Editor context (right-click) menu.

You can also include resources using the Source tab of the Build properties page. See Include resources using the Source tab for more information.

 Include resources using the Source tab

Progress OpenEdge context menu

Recompile files that have errors

Allows you to compile only the files that have errors.

To access this option for a project, right-click the project or a folder or select the project from the main menu and select Compile Files with Error. You can also select Compile All Files with Error from the main menu in the Problems view to compile all the files with the errors.

 Compile ABL code

Compile files with errors
Compile Allows you to explicitly compile your current file.

To access this option, select Compile from either the Source menu or the ABL Editor context (right-click) menu.

 Compile ABL code

Progress OpenEdge context menu

Save r-code Saves .r files when you build the code. When this option is enabled, OpenEdge saves compiled .r files in the directory you specify in the Build destination field; or, if that field is blank, in the same directory as the source file.

To access this option, select Properties > Progress OpenEdge > Build.

 Build properties page

Configure r-code generation
Build only when source files are newer than r-code Compiles only those source files that do not have the latest r-code. This option can save time when compiled code already exists.

To access this option, select Properties > Progress OpenEdge > Build.

 Build properties page
Project build destination Specifies the directory that will contain the r-code. If this field is blank, the r-code is saved in the same directory as the source files.

To access this option, select Properties > Progress OpenEdge > Build.

 Build properties page

Configuration variables

Pre-compile callback routine Specifies a procedure that runs prior to compilation.

To access this option, select Properties > Progress OpenEdge > Build.

 Build properties page
Source tab Allows you to specify the directories in the project where source code resides, the environment (TTY or GUI) of the source code, and the build destination for r-code.

To access this option, select Properties > Progress OpenEdge > Build.

 Build properties page

Options provided by the Eclipse framework:

Option Description Associated help topics
Build All Performs an incremental build on all the projects in the Workbench. It builds (compiles) all the resources in the Workbench that are affected by any resource changes since the last incremental build.

To use this option, select Project > Build All.

To build all resources, even those that have not changed since the last build, select Project > Clean before building the project.
Note: The Build All option is only available if the Build Automatically menu option is not selected. You can access this option from the Project menu or from the General > Workspace preference page.
Build Project Builds the selected projects in the workspace. To use this option, you can:
  • Select the project that you want to build and then select Project > Build Project
  • Select Build Project from the project context (right-click) menu
Note: The Build Project option is only available if the Build Automatically menu option is not selected. You can access this option from the Project menu or from the General > Workspace preference page.
Build Working Set Builds (compiles) all the resources in the working set that are affected by any resource changes since the last build. It also allows you to create a new working set by using Select Working Set.

To access this option select Project > Build Working Set.

Note: The Build Working Set option is only available if the Build Automatically menu option is not selected. You can access this option from the Project menu or from the General > Workspace preference page.
 Build a working set manually

Create a new working set

Build Automatically Allows you to toggle the auto build preference. When checked, builds are invoked automatically as resources are saved. Automatic builds are always incremental and always operate over the entire workspace.

To access this option, select Project > Build Automatically. You can also configure your preferences (Window > Preferences > General > Workspace) to perform builds automatically on resource modification.

 Compile ABL code
Build Order Allows you to explicitly define the order in which projects are built. Alternatively, you can let the platform compute the build order by interpreting project references as prerequisite relationships. The build order is applied for building the entire workspace or for a group of projects.

To access the build order options, select Windows > Preferences > General > Workspace > Build Order.

The following build order options are provided:
  • Up and Down: Manually changes the build order.
  • Add Project and Remove Project: Add and removes projects from the build order.
  • Use default build order: Allows the platform to compute the order in which the projects are built. Turning off this option enables access to the projects list, the order of which can be manipulated.
  • Max iterations when building with cycles: Allows you to specify the maximum number of times the workbench will attempt to iterate over the build order before giving up.

You can also use the Source tab of the Build properties page to change the build order, add, and remove projects from the build order.

 Build properties page
Wait for ongoing build to complete before launching

Controls whether to wait for the ongoing build to complete before launching other resources.

To access this option select Windows > Preferences > Run/Debug > Launching.
Build (if required) before launching Allows you to manually build the project before launching, when the Build Automatically option is not selected.

To access this option select Windows > Preferences > Run/Debug > Launching.