Manage Packages

You can group integrations into a package. When you import or export the package to or from Oracle Integration, all integrations in that package are imported or exported.

Topics:

• View the Integrations in a Package

• Import a Package

• Export a Package

• Update the Package for an Integration

• Delete a Package

• Convert a Package to a Project

When you create an integration, you can also create a package or select an existing package in which to include the integration. See Create an Integration.

View the Integrations in a Package

You can view the integrations included in a package.

1. In the navigation pane, click Design, then Packages.
   The Packages page is displayed. The package names and the number of integrations included in each package are displayed. If you have not yet created or imported a package into Oracle Integration, this page is empty.

   
   
   Description of the illustration oic3_packages.png
   

2. Use Search or Filter to find the package you want, then click the package name.
   The integrations included in the selected package and their current states are displayed (for example, active or inactive).
3. Click Close.

Import a Package

You can import a package of integrations into Oracle Integration from the Packages page. The Packages page enables you to import packages that you or other users have created. To import packages that consist of integrations that are prebuilt by Oracle, you must go to Oracle Cloud Marketplace.

Note:

You cannot import a package if it contains activated integrations. Ensure that all integrations are deactivated before including them in a package archive (PAR) file.

1. In the navigation pane, click Design, then Packages.
2. In the banner, click Import.
3. Browse for and select the PAR file when prompted.
4. Click Import.
   The package is added to the list on the Packages page.

You can import prebuilt packages from Oracle Cloud Marketplace. See Import a Prebuilt Integration and Get Familiar with the Home Page in Getting Started with Oracle Integration 3.

Export a Package

You can export a package of integrations from Oracle Integration on the Packages page. This action exports all the integrations included in that package.

1. In the navigation pane, click Design, then Packages.
2. Hover over the package to export.
3. Click Actions , then select Export.
4. Click Export when prompted to confirm your selection.
5. Save the package (PAR) file of integrations to a file system location when prompted. The individual integrations inside the PAR file are exported as integration archive (IAR) files.

Update the Package for an Integration

You can update the package in which your integration is included. For example, you can create a new package for your integration or move your integration to an existing package.

1. In the navigation pane, click Design, then Integrations.
2. Hover over the integration of the package that you want to update, then click Edit .

   Note:

   The integration must not be active.
3. Click Primary Info .
4. In the Package field, enter a new package name or search for an existing package name (as you type the initial letters, the existing package is displayed) to move your integration to an existing package.
5. Click Save.
6. In the navigation pane, click Packages.
7. Click the package name you specified to see your integration.

Delete a Package

You can delete a package. This action deletes the package and all integrations included in that package.

1. In the navigation pane, click Design, then Packages.
2. Hover over the package to delete.
3. Click Actions , then select Delete.
4. Click Delete when prompted to confirm your selection. The package and all of its integrations are deleted.

   Note:

   If you want to delete a package, but not the integrations, navigate to each integration listed in the package and clear the Package field or replace the package name with a different name. When the last integration is removed from the package, the package is automatically deleted. See Update the Package for an Integration.

Convert a Package to a Project

You can convert a user-developed package into a project in Oracle Integration. This action creates a project that includes all resources in the package (integrations, connections, lookups, and JavaScript libraries). The existing package remains untouched.

1. In the navigation pane, click Design, then Packages.
2. Hover over the user-developed package to convert to a project. Accelerator and recipe packages cannot be converted to projects.
3. Click Actions , then select Create Project.
4. Enter a name and optional keywords and descriptions for the project.
5. Review the following options to determine if you want to select the Anyone can edit, view, and monitor check box.
   • Select this option to allow anyone to edit, view, and monitor resources in the project.

     You can always restrict access at a later time.

   • Don't select this option if you want to restrict access to editing, viewing, and monitoring resources in this project. After project creation, you can select the specific groups and users to which to provide access to this project. See Control Who Can Edit, View, and Monitor in a Project.
6. Click Create.
   A message is displayed.

   Project project_name has been submitted for creation. Click here to see the newly created project.

7. Click the link to access the Projects page.
8. Open the project and note that the resources available in the package (integrations, connections, lookups, and JavaScript libraries) are now available in the project.