1. Using Integrations in Oracle Integration Generation 2
  2. Manage Integrations
  3. Edit and Replace Dependent Resources

Edit and Replace Dependent Resources

You can edit and replace dependent resources in a single integration or all integrations in a package.

Topics:

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.

  1. In the left navigation pane, click Home > Integrations > Integrations.
  2. Select the integration in which to edit or replace resources in either of two ways:
    1. Go to the row of the integration.
    2. Select Configure from the Actions menu menu.

    Or:

    1. Select Import.
    2. 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.
      Description of config_integ.png follows
      Description of the illustration config_integ.png

      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.
      Description of config_integ_alone.png follows
      Description of the illustration config_integ_alone.png

  3. Click the link at the top for the type of resource you want to edit or replace.
  4. Click Edit icon 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.
    1. Make the necessary edits and save your changes.
      1. If editing an integration, click Save, then click Close to return to the Configuration Editor page.
      2. If editing a connection, lookup, library, or certificate, click Save, then click Back button to return to the Configuration Editor page.
  5. Click Replace icon 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.
    The Start Typing field is displayed at the top. Below this are the connections with which your connection can be replaced.

    • 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:
    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.
  6. Click Actions menu 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.

    See Define the Integration Schedule.

    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.

    See Edit an Integration Schedule.

    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.

    See Override Design-Time Properties in an Integration.

  7. Click a resource in the Style column to see which integrations are using the resource.
  8. 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.

  1. In the left navigation pane, click Home > Integrations > Integrations.
  2. Go to the row of the integration to active or deactivate. The integration type must a recipe or accelerator. Use Filter icon to filter the search for integration types.
  3. Select Configure from the Actions menu 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.
  4. If you want to activate the integration, perform the following steps.
    1. Click Activate in the upper right corner to access a page for activating the integration.

      Note:

      You can also click Activate icon at the end of the row. If the integration is not completely configured for activation, a message describing what tasks must be performed is displayed.


      This page shows the Integrations, Connections, Certificates, Lookups, and Libraries links. To the right are the Save and Activate buttons. Below are tables for Integrations and Connections.

      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 Expand icon to view details about what must be resolved before this integration can be activated.


      This page shows the Activate Package, Integrations to Activate, Trace, and Contribute fields. The Cancel and Activate buttons are in the lower right corner.

    2. Provide responses for the tracing and mapping recommendations fields on the page.
    3. Click Activate.
  5. If you want to deactivate the integration, click Deactivate.
    This page shows the Integrations, Connections, Certificates, Lookups, and Libraries links. To the right is the Deactivate button. Below are tables for Integrations and Connections.

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.

  1. In the navigation pane, click Home > Integrations > Packages.
  2. Select the package in which to edit or replace resources in either of two ways:
    1. In the banner, click Import.
    2. Browse for and select the PAR file when prompted.
    3. Click Import and Configure.

    Or:

    1. Go to the row of the package.
    2. Click Configure icon.

    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.
    Shows the Integrations, Connections, Certificates, Lookups, and Libraries links at the top with columns below for Name, Style, and Status.

  3. Click Edit icon 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).
    1. Make the necessary edits and save your changes.
      1. If editing an integration, click Save, then click Close to return to the Configuration Editor page.
      2. If editing a connection, lookup, library, or certificate, click Save, then click Back button to return to the Configuration Editor page.
  4. Click Replace icon 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.
    Description of replace_connection.png follows
    Description of the illustration replace_connection.png

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

  5. Click Actions menu 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.

    See Define the Integration Schedule.

    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.

    See Edit an Integration Schedule.

    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.

    See Override Design-Time Properties in an Integration.

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

  1. Go to the row of the recipe or accelerator package. Use Filter icon to filter the search for package types.
  2. Click Configure icon.
    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.
  3. If you want to activate the package, perform the following steps.
    1. 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 click Activate icon at the end of the row. If the integration is not completely configured for activation, a message describing what tasks must be performed is displayed.

      Description of activate_package_type.png follows
      Description of the illustration activate_package_type.png

      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.

      Description of activate_package.png follows
      Description of the illustration activate_package.png

    2. Expand Expand icon to view details about the integrations. For this example, adapter connections require configuration before these integrations can be activated.
      The words "Not ready to activate" appear at the top. Details about what requires configuration are displayed. For this example, adapter connections require configuration.

    3. Resolve any issues.
    4. Provide responses for the tracing and mapping recommendations fields on the page.
    5. Click Activate.

      Depending upon the number of integrations in the package, activation can take several minutes.

  4. If you want to deactivate the package, click Deactivate.

    Depending upon the number of integrations in the package, deactivation can take several minutes.