Converting one or more projects with the conversion wizard
Convert all imported projects, or a project that contains references to other resources, by using the Convert Projects to Applications and Libraries wizard.
About this task
To convert projects to applications or static libraries, including precondition checks, complete the following steps.
- In the Application Development view, select
the resources that you want to convert. You can select multiple projects in the Independent Resources folder, or you can select all projects by right-clicking the Independent Resources folder.
- Right-click the Independent Resources folder, or one of
the selected projects, and click .The Convert Projects to Applications and Libraries wizard opens.
- Projects that you can convert are listed. Projects that
you selected in step 2 are preselected in the wizard. Select the projects
to convert, then click Next.
The wizard completes a precondition check. If any errors are detected that would prevent successful conversion, those errors are listed. For example, an integration project cannot be converted if it references a project that does not exist. You cannot continue with the conversion until all errors are fixed.
- Select an error and click Fix selected.
Alternatively, you can fix all the errors that are listed by clicking Fix all. If more than one solution is available for an error, you can select the solution from the Quick Fix dialog box that opens. An error that was fixed is indicated by a green tick.
After you apply one or more fixes, if you change your mind, you can undo fixes. Click Cancel, then specify whether the fixes made during the precondition check are to be undone.
After you apply fixes to the errors, the wizard runs the precondition check again. If new errors occur, they are listed so that you can fix them.
When no errors exist, click Next.
- Review the proposed conversion actions.
The wizard analyzes the required conversion actions and shows a summary of changes that it will make. The proposed new applications and libraries are shown in tree form. Expand an application or library to see the resources that it references. The Conversion Actions pane lists the changes that will be made to convert the selected resource.The wizard applies the following rules to convert projects to applications or libraries:
- A top-level integration project, or an integration project that is not referenced by another integration project, is converted to an application.
- An integration project that is referenced by another integration project is converted to a static library.
- If you choose to convert a referenced project that is not an integration
project, it is converted to a static
library, except for data design projects and adapter connection projects.
These projects are unchanged and are referenced by the application
or library. If you choose not to convert the referenced project, it
remains unchanged, and the referencing project refers to the original
For example, an integration project refers to a message set. If the integration project and the message set project are both selected for conversion, the integration project is converted to an application, and the message set project is converted to a static library. If, however, the integration project is selected for conversion, but the referenced message set project is not selected, the integration project is converted to an application that refers to the message set. The message set is not converted.
- A project that is not an integration project, and that is referenced by multiple projects, is converted to a wrapper library. A wrapper library is a library that refers to the original project, such as a message set project. Project references from other projects are updated to refer to the wrapper library.
- A stand-alone project that is not an integration project is converted to a static library.
- An integration project that contains broken references is not converted. The broken references are reported so that you can fix them.
- The conversion changes cannot be reversed. Therefore, you are prompted to back up your workspace by clicking Export.
- Optional: For future reference, you can save the conversion actions for all converted projects by clicking Save all conversion actions to file. You can then save the single document as a .txt file.
- To complete the proposed changes, click Finish.
What to do next
- Creating resources in an application
- Creating resources in a library
- Referencing resources in other libraries
- Deployment rules and guidelines
If you converted an integration project that referred to a Java™ project, you can now convert the Java project to a library so that it can be used by other applications. In the Application Development view, right-click the Java project, click Add project to existing container, then select an existing shared library or other container.
You can also convert an application to a static library, or a shared or static library to an application, by following the instructions in Converting between applications and libraries.