Managing Integrations

Once you create an integration and the progress indicator shows 100 percent, you can activate that integration to the runtime environment. An integration shows as 100% and is eligible for activation after you have specified the source connection, the target connection, the data mappings, and the tracking fields.

1. If you are not already on the Integrations page, click Designer on the toolbar, then click Integrations.
2. In the Integrations list, locate the integration you want to activate.
3. Click Activate.
   
   
   Description of the illustration GUID-4CCEAAFA-08A5-4E67-B726-7F3366348232-default.png
   
   .
   The Confirmation dialog is displayed.
4. If you want to enable detailed tracing, click the Enable detailed tracing checkbox.
   When selected, detailed logging information about messages processed by this integration flow at runtime is collected. This can aid in troubleshooting issues. However, this may also impact performance. To disable tracing, you must deactivate the integration, then reactivate it without selecting the Enable detailed tracing checkbox.
5. Click Activate.
   The status of the integration changes to ACTIVE in the list. If you selected to enable tracing, the words TRACE ENABLED are displayed next to ACTIVE.
   

   
   Description of the illustration GUID-6C60F199-13BD-4C7F-8655-C72C54F501E4-default.png

   
   

   To access the detailing trace logging information:

   1. Click the Monitoring tab.

   2. Click the Activity Stream tab.

   3. Click Download Logs.

6. View active integrations by clicking the integration name or selecting View from the menu at the far right of the integration. The active integration is displayed with a message saying Viewing.

You can deactivate an integration to stop it from processing any new messages. If you want to modify an active integration, you need to deactivate it first.

1. In the Integration Cloud Service toolbar, click Designer.
   The Designer Portal appears.
2. Click Integrations.
3. On the expanded Integrations page, find the integration you want to deactivate.
   To view only active integrations, select Active in the Integrations list. You can also filter by integration name or integration type (prebuilt, custom, or developed) to narrow down the list.
4. In the row containing the integration you want to deactivate, click the vertical bars icon to the far right and then click Deactivate.
   
   
   Description of the illustration GUID-76DD76D0-55D2-4D36-B197-1C242FD33318-default.png
   
   
5. Click Yes on the dialog that appears.

You can modify an existing integration, including changing a source or target connection, reconfiguring the connection, and updating the data mapping. Changes to the source or target can cause changes to the existing mappings.

1. In the Integration Cloud Service toolbar, click Designer.
   The Designer Portal appears.
2. Click Integrations.
3. On the Integrations page, find the integration you want to modify. You can filter the display of integrations by their current status on the left side of the page.
   
   
   Description of the illustration GUID-DB8248EB-506F-4DB1-B247-724699B4A741-default.png
   
   
   You can also search by entering a partial or complete integration name in the Search field or filter integrations by selecting an option from the Filter By list. From this list, you can filter by Type (Custom, Developed, and Prebuilt ) or Pattern (Map My Data, Publish to Integration Cloud Service, Subscribe To Integration Cloud Service, File Transfer, Orchestration, and others). Search or filter criteria are displayed in the blue banner above the returned list of integrations. To remove search or filter criteria, click the x icon in the blue banner or the x icon to the right of the Filter By list.
4. On the row that contains the integration you want to change, click the integration name or click the vertical bars icon on the far right and select Edit.
   
   
   Description of the illustration GUID-772EA1E5-8BF3-4305-8BEF-1A8604D1B3C6-default.png
   
   
5. To modify the name, package, or description, click the Edit icon on the right side.
   
   
   Description of the illustration GUID-61225E39-C469-4F72-B918-DDE285A79D2B-default.png
   
   
6. To modify the source or target configuration, click the connection on the canvas and click Edit on the menu that is displayed.
   
   
   Description of the illustration GUID-A83DA165-5BA2-4994-9386-83B067A03B89-default.png
   
   
7. Modify any of the open fields in the wizard that appears. See Connection Configuration Reference for instructions.
8. To assign a new connection as the source or target, click the connection to delete, then click Delete on the menu that is displayed.
   
   
   Description of the illustration GUID-13454651-71B3-4851-9686-340703CC4000-default.png
   
   
9. Click the Show Palette icon on the right side and drag the new adapter from the Connections or Technologies panel on the right to the connection on the canvas that you want to replace. Configure the new connection. See Connection Configuration Reference for instructions.
10. To modify a data mapping, click the appropriate map icon in the middle of the integration and update the mappings. See Mapping Data of Using the Oracle Mapper.
11. When you are done making changes, click Save and then click Exit Integration.

You can view the details associated with trigger, invoke, and enrichment endpoints of an integration.

1. In the Integration Cloud Service toolbar, click Designer.
   The Designer Portal appears.
2. Click Integrations.
3. On the Integrations page, find the integration you want to view. You can filter the display of integrations by their current status on the left side of the page.
4. Click the trigger, invoke, or (if configured) enrichment endpoint of the integration.
5. Click the Details icon.
6. View the connection name, endpoint name, input payload, and output payload of the integration.
   
   
   Description of the illustration GUID-C36EB342-303D-4325-A6C6-37428A860B7F-default.png
   
   

Cloning an integration creates a new copy with identical connections and data mappings. You give the clone a new name, identifier, version number, and package name, but the remaining configuration is the same. You can reconfigure the clone after you create it.

1. In the Integration Cloud Service toolbar, click Designer.
   The Designer Portal appears.
2. Click Integrations.
3. On the Integrations page, find the integration you want to clone. You can filter the display of integrations by their current status on the left side of the page.
4. In the row containing the integration you want to clone, click the vertical bars icon on the far right and then click Clone.
   
   
   Description of the illustration GUID-772EA1E5-8BF3-4305-8BEF-1A8604D1B3C6-default.png
   
   
5. In the dialog that appears, enter a name, unique identifier, version number, package name, and an optional description.
   You can include English alphabetic characters, numbers, underscores, and dashes in the identifier. Enter the version using numbers only in this format: xx.xx.xxxx.
6. Click Clone.
7. You can modify the clone in any of the ways described in Modifying an Integration.

You can delete an integration that is no longer needed.

1. In the Integration Cloud Service toolbar, click Designer.
   The Designer Portal appears.
2. Click Integrations.
3. On the Integrations page, find the integration you want to delete. You can filter the display of integrations by their current status on the left side of the page.
4. In the row containing the integration you want to delete, click the vertical bars icon on the far right and then click Delete.
   
   
   Description of the illustration GUID-772EA1E5-8BF3-4305-8BEF-1A8604D1B3C6-default.png
   
   
5. Click Yes on the dialog that appears.

You can filter the display of integrations by their type (custom, user-developed, or prebuilt).

1. In the Integration Cloud Service toolbar, click Designer.
   The Designer Portal appears.
2. Click Integrations.
3. Select the Show list to filter the display of integrations.
   
   
   Description of the illustration GUID-291D50FD-5F88-4391-85F9-5D1BD0657C46-default.png
   
   
   You can filter integrations by the following types:

   • All: Displays all integrations, regardless of their type.

   • Custom: Displays prebuilt integrations imported from the Oracle Marketplace that have been customized.

   • Developed: Displays integrations created completely from scratch.

   • Prebuilt Displays prebuilt integrations imported from the Oracle Marketplace.

4. Select the Sort By list to filter the display of integrations by the last update or name.

You can change the time zone that is displayed in Integration Cloud Service.

1. In the upper right corner, click the username dropdown list, then select Preferences.
2. From the Time Zone Settings list, select the time zone you want to use.
3. Click Save.
4. Go to the Integrations page and note that the time zone is changed in the message below the status of the integration and inside the information icon at the far right.
   The time zone change is also shown in other parts of Integration Cloud Service in which the time is displayed (for example, on the Tracking page).