To convert one or more projects
to applications or 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 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.
When
you have applied 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.
Alternatively, click Cancel, fix the errors
manually, then repeat steps 1 - 3.
- 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 library.
- If you choose to convert a referenced project that is not an integration project, it is converted to a 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 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 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.
- 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.
Your selected projects, and affected referenced projects,
are converted to applications and libraries and are shown in the Application
Development view.
Next: Now that you have created
an application or library, you can continue with any of the following
tasks:
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 and click Include
project in a new library. A library is created for the Java project, and the reference
between the application and Java project
is rebuilt.
You can also convert an application to a library,
or a library to an application, by following the instructions in Converting between applications and libraries.