Pre-Compiling Projects

Pre-compiling projects enables projects to be compiled without having to regenerate the derived artifacts that are required for the deployment and run-time execution of business object models.

If your BPM application has multiple business object models (for example, projects that have WSDLs with multiple schemas) then it can take a long time to generate the derived artifacts. Every time a project is imported into a workspace, the derived artifacts are regenerated. When multiple users are working on a BPM application, each user incurs this overhead.

By setting a project to pre-compile, all the WSDL and BOM related derived artifacts are preserved internally in a project. When a pre-compiled project is exported, all the derived artifacts in the project are also exported. When a pre-compiled project is imported, the artifacts are not generated again but are accessed from the project.

There are some restrictions for pre-compiled projects.

  • You can pre-compile any project that has the right asset types. The following assets can be pre-compiled:
    • Business object models
    • Imported WSDL files for services

    In other words, you only have the option of pre-compilation on a project that contains business object models and imported WSDL files for services.

  • You must not change any of the assets, for example, the business object model or WSDL files in a pre-compiled project. In other words, you must not add, update, copy/paste or delete WSDL, XSD or BOM related files. Business Studio validates this, so any changes to the files causes error messages in the Problems view. If you want to make any changes, you must disable pre-compile, make the changes and then set the project to pre-compile again. Business Studio enforces this so that the pre-compiled derived artifacts remain consistent with their source files.

  • All projects that are referenced from a pre-compiled project must also be set to pre-compiled to ensure the consistency of the derived artifacts when projects depend upon each other. Business Studio automatically includes the appropriate referenced projects when enabling/disabling pre-compilation.

  • You must ensure that the internal pre-compilation folders (projectname\.precompiled) are not listed under Ignored Resources. Select Window > Preferences > Team > Ignored Resources for a list of resources that are ignored.