Oracle Utilities Adapter User Manual
Reklam
Reklam
Oracle® Cloud
Using the Oracle Utilities Adapter
Release 17.2
E76820-05
July 2017
Oracle Cloud Using the Oracle Utilities Adapter, Release 17.2
E76820-05
Copyright © 2016, 2017, Oracle and/or its affiliates. All rights reserved.
Primary Author: Mark Kennedy
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means.
Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are
"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agencyspecific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.
No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro
Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.
Contents
Preface
1
Getting Started with the Oracle Utilities Adapter
Oracle Utilities Adapter Capabilities
What Application Version Is Supported?
Typical Oracle Utilities Adapter Use Case
How to Access Oracle Integration Cloud Service
2
Setting Up the Oracle Utilities Adapter
Workflow for Setting Up the Oracle Utilities Adapter
Before You Begin Setting Up the Oracle Utilities Adapter
Choosing an Integration Pattern
Creating a Map Data Integration
Creating an Orchestrated Integration
Refreshing Integration Metadata
About the Fields in the Adapter Endpoint Configuration Wizard
Adding Customized Mappings to Prebuilt Integrations
Creating a Lookup to Map Values Between Applications
Monitoring and Managing an Integration
iii
3
Troubleshooting the Oracle Utilities Adapter
java.net.ConnectException Error Message
Unable to Connect to OUAF Application at Run Time Error Message
Unresponsive Agent Error Message
iv
Preface
Using the Oracle Utilities Adapter describes how to configure the Oracle Utilities
Adapter as a connection in an integration in Oracle Integration Cloud Service.
Topics
•
•
•
•
Audience
Using the Oracle Utilities Adapter is intended for developers who want to use the
Oracle Utilities Adapter in integrations in Oracle Integration Cloud Service.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=docacc
.
Access to Oracle Support
Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/ lookup?ctx=acc&id=info
or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
Related Resources
See these Oracle resources:
• Oracle Cloud http://cloud.oracle.com
•
Using Oracle Integration Cloud Service
•
Using the Oracle Mapper
Conventions
The following text conventions are used in this document: v
Preface
Convention boldface
italic
monospace
Meaning
Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.
Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.
Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.
vi
1
Getting Started with the Oracle Utilities
Adapter
As a developer, you can use the Oracle Utilities Adapter to integrate Oracle Utilities applications with your sales, human resources, customer service, contact center, marketing, and reporting applications. The Oracle Utilities Adapter supports web service standards for the creation of open and reusable service-oriented applications
(SOA).
Topics
•
Oracle Utilities Adapter Capabilities
•
Typical Oracle Utilities Adapter Use Case
•
How to Access Oracle Integration Cloud Service
•
Oracle Utilities Adapter Capabilities
The Oracle Utilities Adapter lets you integrate the Oracle Utilities application suite with other Oracle applications such as Oracle Enterprise Resource Planning (ERP).
Implement the Oracle Utilities Adapter to:
• Integrate on-premise Oracle Utilities applications with Oracle Cloud applications.
• Integrate Oracle Utilities Customer Care and Billing with Oracle ERP Cloud.
• Oracle Service Order Management with Oracle TOA Field Service.
The Oracle Utilities Adapter provides trigger (inbound) and invoke (outbound) support.
This enables Oracle Utilities Applications to trigger an integration in Oracle Integration
Cloud Service or invoke an Oracle Utilities Application using web services from Oracle
Integration Cloud Service.
Both inbound and outbound services are exposed using the Oracle Utilities service catalog. This catalog provides a simplified user experience to create data mappings at design time while constructing integrations with utilities applications using the Oracle
Utilities Adapter.
Every inbound and outbound service structure is exposed using a SOAP-based
WSDL. (No support for REST.) Only synchronous invocations of utilities web services are currently supported.
Integrating with on-premises Oracle Utilities applications can be done using the onpremises agent.
1-1
Chapter 1
Typical Oracle Utilities Adapter Use Case
What Application Version Is Supported?
For information about which application version is supported by this adapter, see the adapter certification matrix:
Oracle Integration Adapters Certification
Limitations and Restrictions
The Oracle Utilities Adapter can only be used with Oracle Utilities applications that support web services. If you are using DB file or Java Message Service (JMS) integration services, generic Oracle Integration Cloud Service adapters must be used and not the Oracle Utilities Adapter.
Typical Oracle Utilities Adapter Use Case
This use case describes how the Oracle Utilities Adapter and the Oracle ERP Cloud
Adapter can be used to integrate Oracle Utilities Customer Care and Billing with
Oracle Enterprise Resource Planning (ERP).
• A bill is created in the Oracle Utilities Customer Care and Billing application and a batch job to send an outbound message is run.
• The Oracle Utilities Adapter receives the inbound message and invokes the Oracle
ERP Cloud Adapter to create an adjustment in Oracle ERP.
• An invoice is created in Oracle ERP.
• The Oracle ERP Cloud Adapter receives the message from Oracle ERP and the payment details are sent to the Oracle Utilities Adapter.
• The Oracle Utilities Adapter sends the payment details to the Oracle Utilities
Customer Care and Billing application.
• The previously created invoice is cancelled in Oracle ERP.
• The Oracle ERP Cloud Adapter receives the message from Oracle ERP that the invoice has been cancelled.
• The Oracle Utilities Adapter sends the cancelled invoice information to the Oracle
Utilities Customer Care and Billing application.
• The Adjustment Maintenance service in the Oracle Utilities Customer Care and
Billing application cancels the invoice.
• A ledger is created in Oracle Utilities Customer Care and Billing and a batch job to send outbound message to the Oracle Utilities Adapter is run.
• The Oracle Utilities Adapter receives the ledger information.
• The Oracle Utilities Adapter sends the ledger information to the Oracle ERP Cloud
Adapter.
• The Oracle ERP Cloud Adapter sends the ledger information to the Oracle ERP.
How to Access Oracle Integration Cloud Service
Log in to Oracle Integration Cloud Service to create connections and integrations and to manage and monitor active integrations. Before you log in to Oracle Integration
1-2
Chapter 1
How to Get Support
Cloud Service, you must have a user account. Oracle provides user account information when you subscribe to Oracle Integration Cloud Service.
1.
Go to https://hostname:port_number/ics
.
2.
Enter your user name and password and click Sign In.
How to Get Support
Use these resources to resolve problems:
•
Review Troubleshooting the Oracle Utilities Adapter
.
• Visit the Oracle Integration Cloud Service Support Forum at https:// community.oracle.com/community/cloud_computing/platform-as-a-service-paas/ oracle-integration-cloud-service .
• Visit the Oracle Help Center at http://docs.oracle.com/en/ .
• Contact Oracle Technical Support. See Contacting Oracle Support in Getting
Started with Oracle Cloud.
1-3
Chapter 1
How to Get Support
1-4
2
Setting Up the Oracle Utilities Adapter
To set up your adapter so you can import and export Oracle Utilities application data, follow the procedures in the order they’re presented.
Topics
•
Workflow for Setting Up the Oracle Utilities Adapter
•
Before You Begin Setting Up the Oracle Utilities Adapter
•
•
Choosing an Integration Pattern
•
•
•
Monitoring and Managing an Integration
Workflow for Setting Up the Oracle Utilities Adapter
You can set up the Oracle Utilities Adapter by completing the tasks listed in the table.
This image represents the workflow for setting up an adapter:
Task
Complete the prerequisite tasks.
Create the connection(s).
Choose an integration pattern.
Map the data.
(Optional) Create lookups.
Activate the integration.
Description
Complete the prerequisite tasks to successfully create a connection and an integration.
Create the connections to the applications with which you want to share data.
Create an integration to exchange data between on-premises, legacy, and cloud applications.
Create mappings to exchange data between the trigger and invoke connections.
(Optional) Create lookups to map the object types (such as gender codes or country codes) used by the applications.
Make the integration active.
More Information
Before You Begin Setting Up the
Choosing an Integration Pattern
Creating a Lookup to Map Values
2-1
Chapter 2
Before You Begin Setting Up the Oracle Utilities Adapter
Before You Begin Setting Up the Oracle Utilities Adapter
Before you set up the Oracle Utilities Adapter:
• Upload a trusted public certificate (if required). Typically, the certificate is included with Oracle Integration Cloud Service. See
.
• Make sure the Oracle Utilities server is running and accessible.
• Know the host name address and port number of the Oracle Utilities server.
• Know the user name and password used to access the Oracle Utilities server.
Uploading an SSL Certificate
Certificates are used to validate outbound SSL connections. If you make an SSL connection in which the root certificate does not exist in Oracle Integration Cloud
Service, an exception is thrown. In that case, you must upload the appropriate certificate. A certificate enables Oracle Integration Cloud Service to connect with external services. If the external endpoint requires a specific certificate, request the certificate and then upload it into Oracle Integration Cloud Service.
To upload an SSL certificate:
1.
From the Oracle Integration Cloud Service home page, click the
menu in the upper left corner.
2.
Click Settings > Certificates.
All certificates currently uploaded to the trust store are displayed in the Certificates dialog. The Filter By > Type list displays the following details:
• Preinstalled: Displays the certificates automatically installed in Oracle
Integration Cloud Service. These certificates cannot be deleted.
• Uploaded: Displays the certificates uploaded by individual users. These certificates can be deleted and updated.
You can also search for certificates in the Search field. The search results are limited to a maximum of ten records sorted by name for performance and usability reasons. To ensure that your search results are more granular, enter as much of the certificate name as possible.
3.
Click Upload at the top of the page.
4.
In the Upload Certificate dialog box, select the certificate type. Each certificate type enables Oracle Integration Cloud Service to connect with external services.
• Trust Certificate: Use this option to upload a trust certificate.
a.
Enter a unique alias for the certificate.
b.
Click Browse, then select the trust file (for example,
.cer
or
.crt
) to upload.
• Message Protection Certificate: Use this option to upload a keystore certificate with SAML token support. Create, read, update, and delete (CRUD) operations are supported on this type of certificate.
2-2
Chapter 2
Creating a Connection
a.
b.
Enter a unique alias for the certificate.
Click Browse, then select the certificate file (
.cer
or
.crt
) to upload.
• Identity Certificate: Use this option to upload a certificate for two-way SSL communication.
a.
b.
c.
d.
Click Browse, then select the keystore file (
.jks
) to upload.
Enter the password of the keystore being imported.
Enter the comma-separated list of aliases from the keystore being imported.
Enter the comma-separated list of passwords corresponding to key aliases.
e.
If you want to display the passwords in clear text, select Show Key
Password(s). This enables you to ensure that you are correctly entering a list of keystore passwords.
5.
Click Upload.
6.
Click the certificate name to view details such as the subject of the certificate, the issuer of the certificate, the date the certificate was issued, and the date the certificate expires.
Creating a Connection
To create an integration, you must first create the connections to the applications with which you want to share data.
1.
Log in to Oracle Integration Cloud Service.
2.
Click Connections.
3.
Click New Connection.
4.
Select an adapter.
5.
Complete the Connection Name, Connection Role, and Description fields.
6.
Click Create.
7.
To receive email notifications when problems occur, in the Email Address field, enter your email address.
8.
Click Configure Connectivity.
9.
Enter the URL for the Oracle Utilities server in the Catalog URL field and click OK.
10.
Click Configure Security.
11.
Select a security policy, and then complete the Username, Password, and
Confirm Password fields.
12.
Click OK.
13.
Click Configure Agents and then select an agent to act as the communication link between the Oracle Utilities applications and Oracle Integration Cloud Service.
14.
In the upper right corner of the page, click Test.
15.
Click Save.
2-3
Chapter 2
Choosing an Integration Pattern
Choosing an Integration Pattern
Exchange data between on-premises, legacy, and cloud applications using an integration. To create the integration, add adapter connections and define how information is shared between them.
Choose one of these integration patterns and then complete the procedure for the selected pattern:
• Map Data: Creates an integration to which you add a trigger and an invoke connection. You can create a single routing expression, and request and response enrichments, as needed. This pattern doesn’t support multiple routing expressions.
If your integration requires this feature, then create an Orchestration integration.
See
Creating a Map Data Integration
.
• Orchestration: Creates a synchronous, asynchronous, or fire-and-forget (no response) orchestrated integration. Orchestrations provide the following features:
– Capability to build a multistep integration between multiple applications.
– Ability to perform conditions, iterations, Javascript callouts, and file processing.
– Ability to model fault/error handlers.
See
Creating an Orchestrated Integration
.
Creating a Map Data Integration
Create a Map Data integration pattern to which you add a trigger (source) and an invoke (target) connection. The trigger connection sends requests to Oracle
Integration Cloud Service. You can create a single routing expression as well as request and response enrichments as needed.
Note:
If your integration requires multiple routing expressions, create an
Orchestration integration. See Creating an Orchestrated Integration .
1.
Log in to Oracle Integration Cloud Service, click Integrations, and then New
Integration.
2.
Select the Map Data integration pattern, complete the required and optional fields, and then click Create.
3.
Add the trigger connection:
a.
b.
From the Connections or Technologies panes, drag a connection to the Drag
and Drop a Trigger area on the integration canvas.
Complete the Adapter Endpoint Configuration Wizard. For field descriptions, see
About the Fields in the Adapter Endpoint Configuration Wizard
.
4.
c.
Click Save.
Add the invoke connection:
a.
From the Connections or Technologies panes, drag a connection to the Drag
and Drop an Invoke area on the integration canvas.
2-4
Chapter 2
Choosing an Integration Pattern
b.
Complete the Adapter Endpoint Configuration Wizard. For field descriptions, see
About the Fields in the Adapter Endpoint Configuration Wizard
.
5.
c.
Click Save.
Assign the business identifiers for tracking fields:
a.
b.
Click the Tracking icon in the upper right part of the page.
Define the tracking fields.
c.
d.
Click Done.
Click Save, and then click Exit Integration.
6.
Map the data. See Creating Mappings and Lookups .
7.
Activate the integration. See Activating an Integration .
Creating an Orchestrated Integration
When you design your integration, you can do the following:
• Add switch activities to create multiple routing expressions.
• Create ad hoc mappings on switch branches.
• Add callback activities (to end an integration and respond back to the sender) and end activities (to end an integration without responding back to the sender) in asynchronous integrations.
1.
Log in to Oracle Integration Cloud Service, click Integrations, and then New
Integration.
2.
Select the Orchestration integration pattern, complete the required and optional fields, and click Create.
3.
Define the inbound trigger:
a.
b.
On the left side of the integration canvas, click TRIGGERS to expand the panel.
Click the adapter type to display the specific type and number of configured adapters. Synchronous, asynchronous, and fire-and-forget (no response) triggers are supported.
c.
d.
Drag the configured adapter to the large plus (+) symbol within the circle on the integration canvas.
Complete the Adapter Endpoint Configuration Wizard. For field descriptions, see
About the Fields in the Adapter Endpoint Configuration Wizard
.
4.
Define the outbound invoke:
a.
b.
On the left side of the integration canvas, click INVOKES to expand the panel.
Click the adapter type to display the specific type and number of configured adapters.
c.
d.
Drag an adapter to the integration canvas and drop it on one of the large plus
(+) symbols.
Complete the Adapter Endpoint Configuration Wizard. For field descriptions, see
About the Fields in the Adapter Endpoint Configuration Wizard
.
5.
Define the switch branches:
2-5
Chapter 2
Choosing an Integration Pattern
a.
b.
On the left side of the canvas, click ACTIONS to expand the panel.
Drag the SWITCH icon to the integration canvas and drop it on one of the large plus (+) symbols.
c.
d.
Click the Undefined branch icon.
Select the Edit icon.
e.
f.
Define a routing expression, then click Save and Exit Expression Builder.
On the left side of the canvas click INVOKES to expand the panel.
g.
Drag an adapter to the plus (+) symbol on the defined branch or the otherwise branch.
h.
Complete the Adapter Endpoint Configuration Wizard. For field descriptions, see
About the Fields in the Adapter Endpoint Configuration Wizard
.
6.
Define the optional ad-hoc mappings:
a.
b.
On the left side of the canvas, click ACTIONS to expand the panel.
Drag a MAP icon to a branch of the switch activity.
c.
d.
Select an endpoint to map.
Map the source data structure to the target data structure.
e.
f.
Click Save, and then click Exit Mapper.
Drag a MAP icon to the otherwise branch of the switch activity.
g.
Repeat steps d to f.
7.
Assign the business identifiers for tracking fields:
a.
b.
Click the Tracking icon in the upper right part of the page.
Define the tracking fields.
c.
d.
Click Done.
Click Save, and then click Exit Integration.
8.
Activate the integration. See Activating an Integration .
Refreshing Integration Metadata
You can manually refresh the currently-cached metadata available to adapters that have implemented metadata caching. Metadata changes typically relate to customizations of integrations, such as adding custom objects and attributes to integrations. There may also be cases in which integrations have been patched, which results in additional custom objects and attributes being added. This option is similar to clearing the cache in your browser. Without a manual refresh, a staleness check is only performed when you drag a connection into an integration. This is typically sufficient, but in some cases you may know that a refresh is required. For these cases, the Refresh Metadata menu option is provided.
To refresh integration metadata:
2-6
Chapter 2
Choosing an Integration Pattern
Note:
The Refresh Metadata menu option is only available with adapters that have implemented metadata caching.
1.
In the Oracle Integration Cloud Service toolbar, click Designer.
2.
In the Designer Portal, click Connections.
3.
Locate the connection to refresh.
4.
From the menu at the right, select Refresh Metadata.
A message is displayed indicating that the refresh was successful.
Metadata refresh for connection "connection_type" has been initiated successfully.
About the Fields in the Adapter Endpoint Configuration Wizard
The following tables provide descriptions of the fields that appear in the Oracle
Integration Cloud ServiceAdapter Endpoint Configuration Wizard. The wizard appears when you create an integration.
Basic Info Page
Field
What do you want to call your endpoint?
What does this endpoint do?
Description
Provide a meaningful name so that others can understand the purpose of the connection. For example,
LinkedInTarget_update_status
. You can use English alphabetic characters, numbers, underscores, and dashes in the name. You can’t use:
• Blank spaces (for example,
My FTP
Connection
)
• Special characters (for example,
#;83&
or righ(t)now4
)
• Multibyte characters
Enter an optional description of connection functionality. For example:
This endpoint updates status on a user's LinkedIn timeline.
2-7
Chapter 2
Choosing an Integration Pattern
Trigger Request Page
Field
Browse by
Select a Business Object
Filter by object name
Description
Select the Oracle Utilities application that hosts the business object.
Select the business object from the Oracle Utilities application to receive as a request that starts the integration.
Enter the initial letters to filter the display of business objects.
Trigger Response Page
Field
Browse by
Select a Business Object
Filter by object name
Response Type
Description
Select the Oracle Utilities application that hosts the business object.
Select the business object from the Oracle Utilities application to receive as a request that starts the integration.
Enter the initial letters to filter the display of business objects.
Select one of these options:
• Request-Response: The default. The Oracle
Utilities application waits until a response is received from the integration. This is also known as the request and response message exchange pattern.
•
Send Faults
Invoke Operations Page
Field
Browse by
Select a Business Service
Filter by service name
Select the Operation to Perform on the Service
Description
Select the Oracle Utilities application that hosts the business object.
Select a business service to invoke.
Enter the initial letters to filter the display of business services.
Select an operation from the published web service.
2-8
Chapter 2
Creating Mappings and Lookups
Summary Page
Field
Summary
Description
Displays a summary of the trigger (source) or invoke (target) configuration values that you defined on previous pages of the wizard. The information that’s displayed can vary by adapter. For some adapters, the selected business objects and operation name are displayed. For adapters for which a generated XSD file is provided, click the
XSD link to view a read-only version of the file. To return to a previous page to update any values, click the appropriate tab in the left panel or click
Back.
Creating Mappings and Lookups
Create mappings and optional lookups to exchange data between the trigger and invoke connections.
Topics:
•
•
Adding Customized Mappings to Prebuilt Integrations
•
Creating a Lookup to Map Values Between Applications
Creating Mappings
Map fields directly from the source data structure to the target data structure in the mapper. To learn more about mapping, see Using the Oracle Mapper.
1.
Create the connection and the integration. See Creating a Connection and
Choosing an Integration Pattern
.
2.
Open the integration.
3.
In the middle of the integration, click the Mapper icon.
4.
Click the Create icon.
5.
Click a field in the Source pane and drag it to the corresponding field in the Target pane, and click Save.
6.
Click Exit Mapper.
Adding Customized Mappings to Prebuilt Integrations
It’s a common practice to customize the application endpoints of the prebuilt integrations that you import into Oracle Integration Cloud Service from the Oracle
Marketplace (for example, adding custom fields). As a result, you must customize the integration mappings to take advantage of these custom fields. Oracle Integration
Cloud Service lets you customize the mappings in the imported prebuilt integrations.
This action creates a customized mapping layer on top of the base mapping file, which
2-9
Chapter 2
Activating an Integration isn’t modified. You can add customized mappings only to prebuilt integrations imported from Oracle Marketplace, not to integrations that you or another user created.
1.
Log in to Oracle Integration Cloud Service and click Integrations.
2.
Select a prebuilt integration. Prebuilt integrations are identified with the label BUILT
BY ORACLE to the right of the integration name.
3.
From the menu at the far right of the integration name, select Customize.
4.
Click the icon for the type of mapping that you want to customize. You can customize request, response, fault, enrichment source, and enrichment response mappings.
5.
Click Customize.
6.
Drag and drop source fields to target elements.
7.
Click Save, then click Exit Mapper.
Creating a Lookup to Map Values Between Applications
1.
Log in to Oracle Integration Cloud Service, scroll down, and click Lookups.
2.
Click Create Lookups.
3.
Click New Lookup.
4.
Enter a name and optional description for the lookup.
5.
Click Create.
Activating an Integration
After 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 percent and is eligible for activation only after you’ve specified the source (trigger) connection, the target (invoke) connection, the data mappings, and the tracking fields.
Note:
If you activate a new version of an existing integration, then tracking instances or logs of the old version aren’t deleted. However, related artifacts are deleted and redeployment is performed on the back end. Monitoring data is also removed.
1.
Log in to Oracle Integration Cloud Service.
2.
Click Integrations.
3.
In the Integrations list, select an integration to activate.
4.
Click the PENDING ACTIVATION slider.
5.
To collect detailed logging information about messages processed by this integration flow at runtime, select Enable detailed tracing. Detailed tracing may affect performance. To disable tracing, you must deactivate the integration, and then reactivate it without selecting the Enable detailed tracing check box.
2-10
Chapter 2
Monitoring and Managing an Integration
If activation is successful, the status of the integration changes to ACTIVE in the list. If activation fails, an error message is displayed at the top of the Integrations page. To troubleshoot the activation error, click Download diagnostic logs to download the logs for diagnosing the issue If you selected to enable tracing, the words TRACE ENABLED are displayed next to ACTIVE.
6.
To access the detailed trace logging information, click the Monitoring tab and then
Download Logs.
7.
To view active integrations, click the integration name or from the menu to the right of the integration, select View.
When viewing your active integration in read-only mode:
• You won’t see Save or Actions buttons.
• You can’t add adapters because there’s no Connections Palette.
• You can view configuration details, such as the business identifiers under the
Tracking tab, the source-to-target and target-to-source mappings in the mapper, and the configurations on the pages of the connection wizards, but you can’t modify anything.
Monitoring and Managing an Integration
Task
Monitor integration performance.
Track payload fields in messages during runtime.
Manage errors at the integration level, connection level, or specific integration instance level.
Description
Use the Oracle Integration Cloud
Service dashboard to monitor integration performance.
Manage the business identifiers used for field message tracking.
More Information
Monitoring Integration Cloud
Services
Manage integration, connection, or integration instance errors.
Assigning Business Identifiers for
Tracking Fields in Messages and
Managing Business Identifiers for
Tracking Fields in Messages
Managing Errors
2-11
Chapter 2
Monitoring and Managing an Integration
2-12
3
Troubleshooting the Oracle Utilities
Adapter
Review the following topics to learn about troubleshooting Oracle Utilities Adapter issues.
Topics
•
java.net.ConnectException Error Message
•
Unable to Connect to OUAF Application at Run Time Error Message
•
Unresponsive Agent Error Message
java.net.ConnectException Error Message
If the error message java.net.ConnectException: Connection refused: connect; No available router to destination.
appears, make sure the Oracle SOA server hosting the catalog is operating and accessible.
Unable to Connect to OUAF Application at Run Time Error
Message
If the error message
Unable to connect to OUAF Application at run time
appears, make sure the connectivity and security credentials for the connection are correct.
See
.
Unresponsive Agent Error Message
If the error message
No response received within response time out window of 120 seconds. Agent may not be running, or temporarily facing connectivity issues to
Oracle Messaging Cloud Service. Please check the health of the Agent in Agent.
appears and you are using the on premises agent, make sure the agent is operational and accessible.
3-1
Chapter 3
Unresponsive Agent Error Message
3-2
İndir
Herkese açık bağlantı güncellendi
Sohbetinize giden herkese açık bağlantı güncellendi. You may view and manage your chat links after registration here.
Belge herkese açık bağlantısı
Reklam