Adding a project to an application, integration service, or library

If a project contains resources that are required for your solution, you can add that project to an application, integration service, or library.

Before you begin

About this task

You can include the projects, such as Java™ projects, in an application, integration service, or library.

The following resources are not supported in shared libraries:
  • WebSphere® Adapters files
  • Decision services
  • IDL files
  • Message flows
  • Message sets
  • Static libraries
  • XSL files
You can add a project in an existing container in two ways:
  • Begin with a project and choose which application or library to include it in.
  • Begin with an application or library and choose which projects to include in it.
The following sections describe these methods.

Beginning with a project


  1. In the Application Development view, expand the Independent Resources folder and locate the relevant project.
  2. Right-click the project and click Add project to existing container.

    A wizard of the same name opens. The wizard also lists any projects that are referenced by your selected project.

  3. Select the application, integration service, or library in which you want to include the project, then click OK.

Beginning with an existing container


  1. In the Application Development view, right-click an application, integration service, or library, then click Manage included projects.

    A wizard lists all the projects that you can add to your application or library. The wizard does not list projects that are already included in other applications or libraries. Projects that refer to a project that is included in a different application or library are also not listed. If the project that you select refers to other projects, those projects are listed in the wizard for your information.

  2. Select the project or projects that you want to include in the application or library, then click OK.
  3. Eclipse also provides a method of managing project references. Right-click an application, library, or project in the Application Development view and click Properties, then Project References. However, use this method with caution. A list of all applications, libraries, and projects are listed, regardless of whether they can be referenced by the selected application, library, or project.
    For example, if you use this method to manage project references for a library, the interface allows you to select an application as a reference. However, a library cannot reference an application. Use this method only in the following circumstances:
    • If you want to refer to a project like a Java project or data design project from an integration project.
    • You can also use project references to enable content assist in the ESQL editor. (Content assist is context-sensitive help that displays valid ways in which a code statement can be completed.) If you set up a project reference from an integration project that contains ESQL code to a message model schema file, the ESQL editor can display a list of valid message references.


The container now includes a reference to your selected project or projects. Those projects are no longer visible under the Independent Resources folder in the Application Development view, but are listed under the application, integration service, or library. To check which resources will be deployed with your solution, look at the Prepare tab of the BAR file editor. When you expand the application, integration service, or library, included projects are listed.

What to do next

To remove a project from a container, see Removing a project from a container.