Defining the process environment

The Application Engine ensures that all your processes continue to work, even if you upgrade to a new version. Every new version of the Application Engine contains changes and bug fixes. New versions might change the BI# language and the runtime functions.

To ensure compatibility across all versions of the Application Engine, you must declare the version that you are targeting in your processes. Therefore, you must set the version of the BI# language and you must set the version of the runtime to use.

This statement sets the process' engine version to 1.0:

#define EngineVersion 1.0

You must set the engine version for every process.

The next statement sets the runtime version to 2.0:

#define RuntimeVersion 2.0

This implies that the process can only use runtime functions that have version 2.0. All included processes must use runtime version 2.0, too.

If you do not define the runtime version, it defaults to 1.0.

Not all combinations of engine versions and runtime versions are valid. This table shows all valid combinations:

Engine Version Runtime Version
1.0 1.0
2.0 2.0
2.0 3.0
3.0 3.0
4.0 4.0
5.0 5.0
Note:  The Application Engine still works, if you use different combinations, but in certain cases you cannot use all features that you expect. We recommend that you use the same version for the Engine and the Runtime.