Edit and Replace Dependent Resources
You can edit and replace dependent resources in a single integration or all integrations in a package.
Edit and Replace Dependent Resources in an Integration
The Configuration Editor page lists all the dependent resources used by all integrations in a specific package or any standalone integrations that are not part of a package.
Edit and Replace Dependent Resources
Dependent resources consist of integrations, connections, libraries, lookups, and PGP keys. You can edit integrations, connections, libraries, lookups, and PGP keys. You can replace connections and PGP keys unless they are included in business and technical accelerators or the integration is active or locked. Only the admin user can edit PGP keys. You can also update integration property values for integrations in which properties have been defined and add schedules to scheduled integrations.
Editing a dependent resource impacts all integrations that use that resource. Replacing a dependent resource only impacts the integrations in the specific package or the standalone integration that is not part of any package.
- In the left navigation pane, click Home > Integrations > Integrations.
- Select the integration in which to edit or replace resources in either of two
ways:
- Go to the row of the integration.
- Select Configure from the
menu.
Or:
- Select Import.
- Browse for and select the integration to import, then select Import and Configure.
- If the integration you selected is part of a package, the
Configuration Editor page is displayed with the package name in the
banner and links to the integrations, connections, certificates (PGP
keys), lookups, and libraries included in the package. The integration
you selected is highlighted on the page.A message automatically slides out from the upper right corner to identify the integration name and its associated package.
Integration_name (version_number) belongs to the package package_name. It is highlighted below and will be configured as part of this package.
- If the integration you selected is not part of a package,
the Configuration Editor page is displayed with links at the top to the
connections, certificates (PGP keys), lookups, and libraries included in
the package.
- Click the link at the top for the type of resource you want to edit or replace.
- Click
at the far right of the row to access the corresponding edit page of the resource (for example, the Connections page, Lookup page, JavaScript Library page, or Update Certificate page). Editing a resource impacts all integrations that use that resource.
- Make the necessary edits and save your changes.
- If editing an integration, click Save, then click Close to return to the Configuration Editor page.
- If editing a connection, lookup, library, or
certificate, click Save, then click
to return to the Configuration Editor page.
- Make the necessary edits and save your changes.
- Click
at the far right of the row to replace a connection or PGP key. For example, to replace a connection, the following page is displayed. Only connections of the same role type (trigger, invoke, or trigger and invoke) are displayed for selection.
- A connection resource can only be replaced by another resource of the same role (trigger, invoke, or trigger and invoke).
- The connection status must be Configured. You cannot replace a connection with a connection whose status is Draft. If a compatible connection resource does not exist, a message is displayed.
- A PGP key must be the same type of key. For example, a public PGP key can only be replaced with another public PGP key, and not a private PGP key.
If you replace a resource, the information is persisted in the details section under the header. For example:
You can revert the replaced resource to the original by clicking the Revert link in the message.The connection for the integrations in this package was changed from connection_name. Revert
- Click
at the far right of the row to display the following options.
Option Description Add Schedule If this is a scheduled integration and a schedule has not been created, this option is displayed. Select to open the Schedule page. You can add a schedule to the integration. Schedule If this is a scheduled integration and a schedule has been created, select to open the Schedule and Future Runs page. You can edit the schedule for the integration. Update Property Values Select to slide open the Update Property Values dialog on the right side of the page. A message is displayed if properties have not yet been defined. You can configure integration properties outside of the regular integration design. At runtime, these integration properties take effect and override the values you configured at design time. - Click a resource in the Style column to see which integrations are using the resource.
- When you have completed editing resources on the Configuration Editor page, click Save.
Activate or Deactivate an Integration
If your integration type is a recipe or an accelerator, you can activate or deactivate the integration from the Configuration Editor page.
- In the left navigation pane, click Home > Integrations > Integrations.
- Go to the row of the integration to active or deactivate. The integration type
must a recipe or accelerator. Use
to filter the search for integration types.
- Select Configure from the
menu.
The current status of integration activation is displayed in the upper right corner:- If Activate is displayed, the integration is not activated.
- If Deactivate is displayed, the integration is activated.
- If you want to activate the integration, perform the following steps.
- Click Activate in the upper right
corner to access a page for activating the integration.
Note:
You can also clickat the end of the row. If the integration is not completely configured for activation, a message describing what tasks must be performed is displayed.
If the selected integration is part of a package, status is provided for all other integrations in the package, and not just the integration you selected.
If the integration cannot be activated, the Not ready to activate field is displayed. Expand
to view details about what must be resolved before this integration can be activated.
- Provide responses for the tracing and mapping recommendations fields on the page.
- Click Activate.
- Click Activate in the upper right
corner to access a page for activating the integration.
- If you want to deactivate the integration, click
Deactivate.
Edit and Replace Dependent Resources in a Package
The Configuration Editor page lists all the dependent resources used by all integrations in a specific package.
Edit and Replace Dependent Resources
Dependent resources consist of integrations, connections, libraries, lookups, and PGP keys. You can edit integrations, connections, libraries, lookups, and PGP keys. You can replace connections and PGP keys unless they are included in business and technical accelerators or the integration is active or locked. Only the admin user can edit PGP keys.
Editing a dependent resource impacts all integrations that use that resource. Replacing a dependent resource only impacts the integrations in the specific package.
- In the navigation pane, click Home > Integrations > Packages.
- Select the package in which to edit or replace resources in either of two
ways:
- In the banner, click Import.
- Browse for and select the PAR file when prompted.
- Click Import and Configure.
Or:
- Go to the row of the package.
- Click
.
The Configuration Editor page is displayed with the package name in the banner and links to the integrations, connections, certificates (PGP keys), lookups, and libraries included in the package.
- Click
at the far right of the row to access the corresponding edit page of the resource (for example, the integration canvas, Connections page, Lookup page, JavaScript Library page, or Update Certificate page).
- Make the necessary edits and save your changes.
- If editing an integration, click Save, then click Close to return to the Configuration Editor page.
- If editing a connection, lookup, library, or
certificate, click Save, then click
to return to the Configuration Editor page.
- Make the necessary edits and save your changes.
- Click
at the far right of the row to replace a connection or a PGP key across all the integrations in a package. For example, to replace a connection, the following page is displayed. Only connections of the same role type (trigger, invoke, or trigger and invoke) are displayed for selection.
- You can replace connections used by inactive integrations in a package. For example, if a package contains five integrations, and one integration is inactive, you can replace the connection for only that integration. The connections in the other four integrations cannot be replaced.
- You cannot replace connections used by active, currently being activated, currently being deactivated, and locked integrations in a package. For example, if a package contains five integrations, and two integrations are active, one is currently being activated, and two are inactive, you can replace the connections for only the two inactive integrations. The connections in the other three integrations cannot be replaced.
- A connection can only be replaced by another connection of the same role (trigger, invoke, or trigger and invoke).
- The connection status must be Configured. You cannot replace a connection with a connection whose status is Draft. If a compatible connection resource does not exist, a message is displayed.
- A PGP key must be the same type of key. For example, a public PGP key can only be replaced with another public PGP key, and not a private PGP key.
If you replace a resource, the information is persisted in the details section under the header. For example:The connection for the integrations in this package was changed from connection_name. Revert
You can revert the replaced resource to the original by clicking the Revert link in the message.
- Click
at the far right of the row to display the following options.
Option Description Add Schedule If this is a scheduled integration and a schedule has not been created, this option is displayed. Select to open the Schedule page. You can add a schedule to the integration. Schedule If this is a scheduled integration and a schedule has been created, select to open the Schedule and Future Runs page. You can edit the schedule for the integration. Update Property Values Select to slide open the Update Property Values dialog on the right side of the page. A message is displayed if properties have not yet been defined. You can configure integration properties outside of the regular integration design. At runtime, these integration properties take effect and override the values you configured at design time. - Click a resource in the Style column to see which integrations are using the resource.
Activate and Deactivate All Integrations in a Recipe or Accelerator Package
If your package type is a recipe or an accelerator, you can activate and deactivate all integrations in the package together. You cannot activate and deactivate user-created packages (known as developed packages). See Integration Accelerators and Recipes in Getting Started with Oracle Integration Generation 2.
- Go to the row of the recipe or accelerator package. Use
to filter the search for package types.
- Click
.
The current status of package activation is displayed in the upper right corner:- If Activate is displayed, the package is not activated.
- If Deactivate is displayed, the package is activated.
- If you want to activate the package, perform the following
steps.
- Click Activate in the upper right
corner to access a page for activating all integrations in the package
together.
Note:
If you only want to activate a single integration in the package, you can instead clickat the end of the row. If the integration is not completely configured for activation, a message describing what tasks must be performed is displayed.
Details about the activation status of all integrations in the package are displayed:- If at least one integration in the package is ready to activate, the Activate button is enabled. Any integrations that cannot be activated are displayed under the Not ready to activate button.
- If no integrations are ready to activate (as is the case with the following example), the Activate button is disabled. Details are displayed under the Not ready to activate button.
- Expand
to view details about the integrations. For this example, adapter connections require configuration before these integrations can be activated.
- Resolve any issues.
- Provide responses for the tracing and mapping recommendations fields on the page.
- Click Activate.
Depending upon the number of integrations in the package, activation can take several minutes.
- Click Activate in the upper right
corner to access a page for activating all integrations in the package
together.
- If you want to deactivate the package, click
Deactivate.
Depending upon the number of integrations in the package, deactivation can take several minutes.