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.

1. 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.
2. Right-click the Independent Resources folder, or one of the selected projects, and click Convert to application or library > Analyze and convert multiple projects.
   The Convert Projects to Applications and Libraries wizard opens.
3. 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.

4. 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.

5. 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 project.

     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.
6. The conversion changes cannot be reversed. Therefore, you are prompted to back up your workspace by clicking Export.
7. 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.
8. To complete the proposed changes, click Finish.