using the oracle erp cloud adapter · using the oracle erp cloud adapter with oracle integration...

of 59 /59
Oracle® Cloud Using the Oracle ERP Cloud Adapter Release 18.3 E66641-18 September 2018

Author: hoangnguyet

Post on 15-Apr-2019

364 views

Category:

Documents


4 download

Embed Size (px)

TRANSCRIPT

Oracle CloudUsing the Oracle ERP Cloud Adapter

Release 18.3E66641-18September 2018

Oracle Cloud Using the Oracle ERP Cloud Adapter, Release 18.3

E66641-18

Copyright 2015, 2018, 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 onuse and disclosure and are protected by intellectual property laws. Except as expressly permitted in yourlicense 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 forinteroperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. Ifyou 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 onbehalf 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 agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of theprograms, 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 thatmay create a risk of personal injury. If you use this software or hardware in dangerous applications, then youshall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure itssafe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of thissoftware or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks oftheir respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks areused 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 MicroDevices. 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 expresslydisclaim all warranties of any kind with respect to third-party content, products, and services unless otherwiseset forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not beresponsible 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

PrefaceAudience vi

Documentation Accessibility vi

Related Resources vi

Conventions vii

1 Getting Started with the Oracle ERP Cloud AdapterOracle ERP Cloud Adapter Capabilities 1-1

Supported Business Events 1-3

What Application Version Is Supported? 1-9

About Oracle Integration Cloud Service 1-9

About Oracle Integration Cloud Service Connections 1-9

About Oracle Integration Cloud Service Integrations 1-10

About Oracle ERP Cloud Adapter Use Cases 1-10

FTP Adapter to Oracle ERP Cloud Adapter Integration 1-10

Typical Workflow for Creating and Including an Adapter Connection in an Integration1-12

2 Creating an Oracle ERP Cloud Adapter ConnectionPrerequisites for Creating a Connection 2-1

Obtaining the Oracle ERP Cloud Service Catalog Service WSDL or EventCatalog URL 2-2

For Fusion Applications Releases 10 Through 12 2-2

For Fusion Applications Releases 13 and Later 2-6

Assigning Required Roles to an Integration User 2-7

Configuring Oracle ERP Cloud for Event Subscriptions 2-8

Uploading Files in Bulk and Inserting Data into Oracle ERP Cloud ApplicationTables 2-9

Uploading an SSL Certificate 2-11

Creating a Connection 2-12

Adding a Contact Email 2-13

Configuring Connection Properties 2-13

iii

Configuring Connection Security 2-14

Testing the Connection 2-14

Editing a Connection 2-15

Cloning a Connection 2-15

Deleting a Connection 2-16

Refreshing Integration Metadata 2-16

3 Creating an Integration

4 Adding the Oracle ERP Cloud Adapter Connection to an IntegrationConfiguring Basic Information Properties 4-1

What You Can Do from the Basic Info Page 4-1

What You See on the Basic Info Page 4-2

Configuring Oracle ERP Cloud Trigger Request Properties 4-3

What You Can Do from the Oracle ERP Cloud Trigger Request Page 4-3

What You See on the Oracle ERP Cloud Trigger Request Page 4-4

Configuring Oracle ERP Cloud Trigger Response Properties 4-5

What You Can Do from the Oracle ERP Cloud Trigger Response Page 4-5

What You See on the Oracle ERP Cloud Trigger Response Page 4-6

Configuring Oracle ERP Cloud Invoke Operation Properties 4-8

What You Can Do from the Oracle ERP Cloud Invoke Operations Page 4-8

What You See on the Oracle ERP Cloud Invoke Operations Page 4-9

Configuring Oracle ERP Cloud Invoke Response Properties 4-10

What You Can Do from the Oracle ERP Cloud Invoke Response Page 4-10

What You See on the Oracle ERP Cloud Invoke Response Page 4-11

Reviewing Configuration Values on the Summary Page 4-12

What You Can Do from the Summary Page 4-12

What You See on the Summary Page 4-12

5 Creating Mappings and Lookups in Integrations

6 Administering Integrations

7 Troubleshooting Oracle ERP Cloud AdapterTroubleshooting Event Subscription Errors 7-1

Import Payables Invoice Report Job is Not Triggered from an Import PayablesInvoice 7-1

iv

Data Uploaded in the Oracle ERP Cloud Interface Tables Is Not Uploaded in theBase Tables 7-2

Oracle ERP Cloud Callback About the Bulk Import Issue 7-2

Jobs Not Appearing in the Import Jobs List on the Operations Page 7-2

Oracle ERP Cloud Callback Not Received in Oracle Integration Cloud Service 7-3

Business Events Being Sent to Deactivated Integrations 7-6

v

Preface

Using the Oracle ERP Cloud Adapter with Oracle Integration Cloud Service describeshow to configure the Oracle ERP Cloud Adapter as a connection in an integration inOracle Integration Cloud Service.

Topics

Audience

Documentation Accessibility

Related Resources

Conventions

AudienceUsing the Oracle ERP Cloud Adapter with Oracle Integration Cloud Service is intendedfor developers who want to use the Oracle ERP Cloud Adapter in integrations inOracle Integration Cloud Service.

Documentation AccessibilityFor information about Oracle's commitment to accessibility, visit the OracleAccessibility 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 supportthrough 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=trsif you are hearing impaired.

Related ResourcesSee these Oracle resources:

Oracle Cloud

http://cloud.oracle.com

Using Oracle Integration Cloud Service

Using the Oracle Mapper

Preface

vi

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacchttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacchttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infohttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infohttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trshttp://cloud.oracle.com

ConventionsThe following text conventions are used in this document:

Convention Meaning

boldface Boldface type indicates graphical user interface elements associatedwith an action, or terms defined in text or the glossary.

italic Italic type indicates book titles, emphasis, or placeholder variables forwhich you supply particular values.

monospace Monospace type indicates commands within a paragraph, URLs, codein examples, text that appears on the screen, or text that you enter.

Preface

vii

1Getting Started with the Oracle ERP CloudAdapter

Review the following conceptual topics to learn about the Oracle ERP Cloud Adapterand how to use it as a connection in integrations in Oracle Integration Cloud Service. Atypical workflow of adapter and integration tasks is also provided.

Topics

Oracle ERP Cloud Adapter Capabilities

What Application Version Is Supported?

About Oracle Integration Cloud Service

About Oracle Integration Cloud Service Connections

About Oracle Integration Cloud Service Integrations

About Oracle ERP Cloud Adapter Use Cases

Typical Workflow for Creating and Including an Adapter Connection in anIntegration

Oracle ERP Cloud Adapter CapabilitiesThe Oracle ERP Cloud Adapter enables you to create an integration with OracleEnterprise Resource Planning (ERP) applications.

Note:

Ensure that you have reviewed the Oracle HCM Cloud Adapter Capabilitiesfor supported SOAP services in Oracle HCM Cloud.

The Oracle ERP Cloud Adapter enables you to easily integrate on-premises or SaaSapplications with Oracle ERP Cloud without having to know about the specific detailsinvolved in the integration. The Oracle ERP Cloud Adapter provides the followingbenefits:

Integrates easily with the Oracle ERP Cloud applications WSDL file to produce asimplified, integration-centric WSDL.

Generates automatic mapping to the exposed business object or eventsubscription that you select during adapter configuration:

Business object: Represents a self-contained business document that can beacted upon by the integration. An integration can send requests to create anew record for that business object. They can send a request either to updateor delete an existing record for a business object. Integrations can also sendrequests to retrieve information about one or more records representing thatbusiness object.

1-1

Event subscription: Represents an event document to which you subscribe.The event subscription is raised by the Oracle ERP Cloud application. Theproduct inventory module (PIM) exposes public APIs and events in release 11and release 12 for Oracle ERP Cloud. See Supported Business Events.

Automatically handles security policy details required to connect to the OracleERP Cloud application.

Provides standard error handling capabilities.

Exposes Supply Chain Management (SCM) Cloud events and web services.

Enables you to upload a file to a secure FTP location. The file is identified andprovided to Oracle ERP Cloud so that the data can be uploaded in the Oracle ERPCloud business tables. In the invoke (outbound to Oracle ERP Cloud) direction,files can be uploaded in the following formats:

BASE64 format: Files uploaded in this format are embedded in the SOAPmessage.

MTOM format: This is the default upload format. Files uploaded in this formatare sent as an attachment in the SOAP message. If there are errors duringMTOM upload, the file is uploaded in BASE64 format.

As a part of the file upload configuration process in the invoke direction (outboundto Oracle ERP Cloud), you specify the integration name, identifier, and versiondetails to receive a callback. The callback provides detailed status about theoutbound request. The inbound integration flow handles the callbacks from OracleERP Cloud. When the callback response is received, the log files can bedownloaded in BASE64 format or the default MTOM format. If there is any errorduring MTOM download, the file is downloaded in BASE64 format.

During runtime, the Oracle ERP Cloud file upload occurs:

The file is picked up.

In the invoke (outbound to Oracle ERP Cloud) direction, Oracle ERP Cloudreceives the file as an attachment object.

The file is first uploaded in MTOM format to UCM. After uploading thedocument to UCM, a request is sent to Oracle ERP Cloud to process the file.

If the document upload to MTOM fails, the file is uploaded in BASE64 formatby providing the files as BASE64 content directly to Oracle ERP Cloud.

Oracle ERP Cloud Adapter invokes the importBulkData API and provides theinformation configured during the design time.

Note:

Create the UCM URL by appending the host and port of the servicecatalog with the following URI: /idcws/GenericSoapPort.

During runtime, the callback is received.

ERP sends the callback on the callback endpoint.

The callback contains the following information:

* Overall status.

* Document ID of the file that contains all the log data.

Chapter 1Oracle ERP Cloud Adapter Capabilities

1-2

* List of all jobs, their child jobs, and their statuses.

The file is first downloaded in MTOM format. If the download fails, the file isdownloaded in BASE64 format.

The file is stored in the attachment store. The reference of the file is providedas an output in the XML document.

Note:

During bidirectional account and contact synchronization, echoes aregenerated. Oracle Integration Cloud Service-based integrations useecho suppression to prevent unwanted update or create events (theechoes) from returning to the source application.

You cannot write database SQL queries with the Oracle ERP CloudAdapter. Instead, you must write a Business Intelligence Publisher (BIP)report in Oracle Fusion Applications and invoke it from the Oracle ERPCloud Adapter. See this blog.

Video

Supported Business EventsThe following business events are supported. You can subscribe to these eventsduring adapter configuration in the Adapter Endpoint Configuration Wizard.

Cloud Product SupportedBusinessEvents

Description First ReleaseAvailable

CallbackService

InventoryManagement

AdvanceShipment Notice

Signals that anadvanceshipment noticecan be sent to anexternal customerfor the shipment.

R12 SOAP Service:ShipmentService

Operation:getAdvancedShipmentNoticeData

InventoryManagement

ASN Cancellation Notifies that anASN/ASBN linehas beencancelled inOracle FusionReceiving Cloud.

R13 18B SOAP Service:InboundShipmentService

Operation:findShipment

InventoryManagement

ASN Creation Notifies that anASN/ASBN linehas been createdin Oracle FusionReceiving Cloud.

R11 SOAP Service:InboundShipmentService

Operation:findShipment

Chapter 1Oracle ERP Cloud Adapter Capabilities

1-3

https://www.ateam-oracle.com/using-oracle-bi-publisher-to-extract-data-from-oracle-sales-and-erp-cloudshttp://apexapps.oracle.com/pls/apex/f?p=44785:265:0::::P265_CONTENT_ID:18894

Cloud Product SupportedBusinessEvents

Description First ReleaseAvailable

CallbackService

InventoryManagement

Backorder Line Signals that ashipment line hasbeen backordered.

R13 17B SOAP Service:ShipmentLineService

Operation:GetBackorderLineData

InventoryManagement

Create CorrectionTransaction

Notifies that acorrectiontransaction iscreated in OracleFusion ReceivingCloud.

R11 SOAP Service:ReceivingTransactionService

Operation:findTransaction

InventoryManagement

Create DeliverTransaction

Notifies that adelivertransaction iscreated in OracleFusion ReceivingCloud.

R11 SOAP Service:ReceivingTransactionService

Operation:findTransaction

InventoryManagement

Create ReceivingReceipt

Notifies that areceipt is createdin Oracle FusionReceiving Cloud.

R11 SOAP Service:ReceiptService

Operation:findReceipt

InventoryManagement

Create ReturnTransaction

Notifies that areturn (tosupplier,customer,organization)transaction iscreated in OracleFusion ReceivingCloud.

R11 SOAP Service:ReceivingTransactionService

Operation:findTransaction

InventoryManagement

Manifest Request Signals thatshipmentinformation canbe sent to thecarriermanifestingsystem todetermine rate,freight cost, andlabels for theshipment.

R11 SOAP Service:Shipment Service

Operation:getManifestRequestData

InventoryManagement

Receipt AdviceEvent Notification

Notifies that areceipt adviceis generated inOracle FusionReceiving Cloudand available forexternal systemsto process.

R13 17B SOAP Service:ReceiptAdviceService

Operation:getReceiptAdviceDetails

Chapter 1Oracle ERP Cloud Adapter Capabilities

1-4

Cloud Product SupportedBusinessEvents

Description First ReleaseAvailable

CallbackService

InventoryManagement

Shipment Advice Signals that theshipment isshipped and isready forinforming thesource systemwith the shippedinformation.

R13 17B SOAP Service:ShipmentService

Operation:getShipmentAdviceData

InventoryManagement

ShipmentRequestGenerate

Signals thatshipment lineselection criteriais published forexternal systemsto process thelines.

R11 SOAP Service:ShipmentLineService

Operation:GenerateShipmentRequest

InventoryManagement

Standard CostExported Event

Signals that astandard cost isexported for ascenario.

R13 17C NA

InventoryManagement

Standard CostPublished

Signals that thestandard cost ispublished for ascenario.

R13 17C NA

InventoryManagement

Trade ScreeningRequest

Signals to requesttrade screeningfor a shipmentline.

R13 17B SOAP Service:ShipmentLineService

Operation:getShipmentLineData

InventoryManagement

Transfer PricePublished

Signals that thetransfer price ispublished for asales orderfulfillment line.

R13 17C NA

Maintenance Customer AssetCreated

Signals that acustomer asset iscreated.

R13 17C SOAP Service:AssetService

Operation:getAsset

Maintenance Customer AssetRelationshipCreated

Signals that acustomer assetrelationship iscreated.

R13 17C SOAP Service:AssetRelationshipService

Operation:getAssetRelationship

Maintenance Customer AssetRelationshipDeleted

Signals that anasset relationshipis deleted.

R13 17C SOAP Service:AssetRelationshipService

Operation:getAssetRelationship

Chapter 1Oracle ERP Cloud Adapter Capabilities

1-5

Cloud Product SupportedBusinessEvents

Description First ReleaseAvailable

CallbackService

Maintenance Customer AssetUpdated

Signals that acustomer asset isupdated.

R13 17C SOAP Service:AssetService

Operation:getAsset

Maintenance MaintenanceAsset Created

Signals that amaintenanceasset is created.

R13 17D SOAP Service:AssetService

Operation:getAsset

Maintenance MaintenanceAsset Updated

Signals that amaintenanceasset is updated.

R13 17D SOAP Service:AssetService

Operation:getAsset

Manufacturing Print ProductLabel

Signals that aprint product labelis triggered

R13 18B NA

Manufacturing Work OrderCreate

Signals that awork order iscreated.

R13 17B SOAP Service:WorkOrderEnrichService

Operation:getWorkOrderEnrich

Manufacturing Work OrderUpdate

Signals that awork order isupdated.

R13 17B SOAP Service:WorkOrderEnrichService

Operation:getWorkOrderEnrich

OrderManagement

Order StatusUpdated

Informs asubscriber that anorder status orstatus of afulfillment line thatis part of an orderwas updated.

R12 SOAP Service:EventEnrichmentService

Operation:getEnrichmentDetails

OrderManagement

Sales OrderNotification

Informs asubscriber abouta significantdevelopment on asales order. Thisevent occurswhen the orderstatus changes,the line statuschanges, thevalue of anattribute changes,a fulfillment linesplits, or anexception occurs,such as ajeopardy or hold.

R13 17B SOAP Service:DocumentService

Operation:getSalesOrderNotificationDetails

Chapter 1Oracle ERP Cloud Adapter Capabilities

1-6

Cloud Product SupportedBusinessEvents

Description First ReleaseAvailable

CallbackService

OrderManagement

Sales OrderTradeComplianceScreening

Communicatesscreeningrequests to asystem thatmanages tradecompliance.

R13 17B SOAP Service:OrderFulfillmentRequestService

Operation:getOrderFulfillmentRequestDetails

OrderManagement

Sales OrderTransportationPlanning

Communicatesfulfillmentrequests to atransportationplanning system.

R13 17B SOAP Service:OrderFulfillmentRequestService

Operation:getOrderFulfillmentRequestDetails

Purchasing Purchase OrderEvent

Published when apurchase order iscreated, changed,finally closed, orreopened.

R13 17B SOAP Service:PurchaseOrderService

Operation:getPurchaseOrder

Product LifecycleManagement

Change OrderApproval Event

Signals that achange order is inapproval.

R13 18B SOAP Service:ChangeOrderService

Operation:getChangeOrder

Product LifecycleManagement

Change OrderCompleted Event

Signals that achange order iscompleted.

R13 18B SOAP Service:ChangeOrderService

Operation:getChangeOrder

Product LifecycleManagement

Change OrderInterim ApprovalEvent

Signals that achange order is ininterim approval.

R13 18B SOAP Service:ChangeOrderService

Operation:getChangeOrder

Product LifecycleManagement

Change OrderOpen Event

Signals that achange order isopen.

R13 18B SOAP Service:ChangeOrderService

Operation:getChangeOrder

Product LifecycleManagement

Item StructureComponentCreate

Signals that anitem structurecomponent iscreated.

R12 SOAP Service:StructureService

Operation:findStructure

Product LifecycleManagement

Item StructureComponentUpdate

Signals that anitem structurecomponent isupdated.

R12 SOAP Service:StructureService

Operation:findStructure

Chapter 1Oracle ERP Cloud Adapter Capabilities

1-7

Cloud Product SupportedBusinessEvents

Description First ReleaseAvailable

CallbackService

Product LifecycleManagement

Item StructureCreate

Signals that anitem structure iscreated.

R12 SOAP Service:StructureService

Operation:findStructure

Product LifecycleManagement

Item StructureUpdate

Signals that anitem structure isupdated.

R12 SOAP Service:StructureService

Operation:findStructure

Product MasterDataManagement

Change OrderScheduled

Signals that achange order isscheduled.

R13 17B SOAP Service:ProductDesignChangeOrderService

Operation:getChangeOrder

Product MasterDataManagement

Data PoolSubscription

Signals that adata poolsubscription iscreated.

R11 SOAP Service:DataPoolSyndicationService

Operation:findSubscription

Product MasterDataManagement

Data PoolSubscriptionConfirmationSent

Signals that adata poolsubscriptionconfirmation issent.

R11 SOAP Service:DataPoolSyndicationService

Operation:findConfirmation

Product MasterDataManagement

Item Bulk Load Signals that itemsare imported.

R11 NA

Product MasterDataManagement

Item CatalogCategoryAssignmentChange

Signals a changein the itemcatalog categoryassignment.

R11 SOAP Service:ItemService

Operation:findItem

Product MasterDataManagement

Item Create Signals that anitem is created.

R11 SOAP Service:ItemService

Operation:findItem

Product MasterDataManagement

Item PublicationEvent

Signals that itemsare published.

R13 17C NA

Product MasterDataManagement

Item UpdateEvent

Signals that anitem is updated.

R13 17B SOAP Service:ItemService

Operation:findItem

Product MasterDataManagement

Product UploadStatus Change

Signals a statuschange in aproduct upload.

R11 NA

Chapter 1Oracle ERP Cloud Adapter Capabilities

1-8

What Application Version Is Supported?For information about which application version is supported by this adapter, see theOracle Integration Adapters Certification Matrix under section Oracle IntegrationAdapters Certification at the top of the page:

Oracle Integration Adapters Certification Matrix

About Oracle Integration Cloud ServiceOracle Integration Cloud Service is a complete, secure, but lightweight integrationsolution that enables you to connect your applications in the cloud. It simplifiesconnectivity between your applications and connects both your applications that live inthe cloud and your applications that still live on premises. Oracle Integration CloudService provides secure, enterprise-grade connectivity regardless of the applicationsyou are connecting or where they reside.

Oracle Integration Cloud Service provides native connectivity to Oracle Software as aService (SaaS) applications, such as Oracle Sales Cloud, Oracle RightNow Cloud,and so on. Oracle Integration Cloud Service adapters simplify connectivity by handlingthe underlying complexities of connecting to applications using industry-wide bestpractices. You only need to create a connection that provides minimal connectivityinformation for each system. Oracle Integration Cloud Service lookups map thedifferent codes or terms used by the applications you are integrating to describesimilar items (such as country or gender codes). Finally, the visual data mapperenables you to quickly create direct mappings between the trigger and invoke datastructures. From the mapper, you can also access lookup tables and use standardXPath functions to map data between your applications.

Once you integrate your applications and activate the integrations to the runtimeenvironment, the dashboard displays information about the running integrations so youcan monitor the status and processing statistics for each integration. The dashboardmeasures and tracks the performance of your transactions by capturing and reportingkey information, such as throughput, the number of messages processed successfully,and the number of messages that failed processing. You can also manage businessidentifiers that track fields in messages and manage errors by integrations,connections, or specific integration instances.

About Oracle Integration Cloud Service ConnectionsConnections define information about the instances of each configuration you areintegrating. Oracle Integration Cloud Service includes a set of predefined adapters,which are the types of applications on which you can base your connections, such asOracle Sales Cloud, Oracle Eloqua Cloud, Oracle RightNow Cloud, and others. Aconnection is based on an adapter. For example, to create a connection to a specificRightNow Cloud application instance, you must select the Oracle RightNow adapterand then specify the WSDL URL, security policy, and security credentials to connect toit.

Video

Chapter 1What Application Version Is Supported?

1-9

http://www.oracle.com/technetwork/middleware/adapters/documentation/index.htmlhttp://apexapps.oracle.com/pls/apex/f?p=44785:265:0::::P265_CONTENT_ID:11240

About Oracle Integration Cloud Service IntegrationsIntegrations are the main ingredient of Oracle Integration Cloud Service. An integrationincludes at the least a trigger (source) connection (for requests sent to OracleIntegration Cloud Service) and invoke (target) connection (for requests sent fromOracle Integration Cloud Service to the target) and the field mapping between thosetwo connections.

When you create your integrations, you build on the connections you already createdby defining how to process the data for the trigger (source) and invoke (target)connections. This can include defining the type of operations to perform on the data,the business objects and fields against which to perform those operations, requiredschemas, and so on. To make this easier, the most complex configuration tasks arehandled by Oracle Integration Cloud Service. Once your trigger (source) and invoke(target) connections are configured, the mappers between the two are enabled so youcan define how the information is transferred between the trigger (source) and invoke(target) data structures for both the request and response messages.

Video

About Oracle ERP Cloud Adapter Use CasesThe Oracle ERP Cloud Adapter can be used in scenarios such as the following.

FTP Adapter to Oracle ERP Cloud Adapter Integration

FTP Adapter to Oracle ERP Cloud Adapter IntegrationThis use case describes how to load data from a secure FTP location to Oracle ERPCloud by using a trigger file mechanism. The data is sent to Oracle Integration CloudService for orchestration. Oracle Integration Cloud Service schedules the integrationflow for polling the trigger file.

Video

Create an orchestrated integration that is triggered by a schedule.

From the Invoke palette, drag an FTP Adapter into the integration canvas.

Configure the FTP Adapter to perform the following tasks:

Specify a name of readTriggerFile.

Specify a file name pattern of *.TRG.

Specify an input directory from which to read a trigger file.

Define a schema from a CSV file as the trigger file format.

From the Actions panel, add an Assign action below the FTP Adapter to declarethe set of variables.

Specify a name of ExtactFileName.

In the Expression Builder, configure variables, such as extracting the ZIP filename of *.TRG from a relative path.

Chapter 1About Oracle Integration Cloud Service Integrations

1-10

http://apexapps.oracle.com/pls/apex/f?p=44785:265:0::::P265_CONTENT_ID:11241http://apexapps.oracle.com/pls/apex/f?p=44785:265:0::::P265_CONTENT_ID:18894

Add a second invoke FTP Adapter below the Assign action to download and stagethe file temporarily in Oracle Integration Cloud Service.

Configure the FTP Adapter to perform the following tasks:

Specify a name of DownloadFile.

Select the Download to ICS operation.

Specify the input directory and download directory path.

Select the Unzip the File option.

A mapper is automatically added to the integration whenever a Stage Fileaction or new endpoints such as the FTP Adapter are added to the integration.The mapper appears between the Assign action and the DownloadFile FTPAdapter.

In the mapper, map the source extracted ZIP file to the target DownloadFileToICSfilename element.

Because the ZIP file may contain multiple files, drag a For-Each action below theDownloadFIle FTP Adapter in the integration. This action enables iteration over arepeated element.

Specify the repeating element and current element name.

To read each file from the input directory, add a Stage File action below the For-Each action and configure it as follows:

In the Expression Builder, specify the file name and directory from which toread the file.

Specify the schema file by loading a CSV file that contains the data structure.

When a file is staged in Oracle Integration Cloud Service, add a second For-Eachaction below the Stage File action to iterate through each record.

Add the repeating element and current element name.

Add a second Stage File action to write each record into a new file.

Specify a name of WriteRecordToFile.

In the Expression Builder, set the name and the output directory. All theenriched data is appended to the staged file. The schema file for the new ERPfile uses the same structure as the source file.

Perform the data mapping and transformation in the automatically added mapper.Functions, operators, and XSLs are useful to enrich and transform the new file forERP.

Add a Stage File action below the WriteRecordToFile Stage File action to write amanifest file with the business data details.

Specify a name of CreateManifest.

In the Expression Builder, select the Write File option and Append toExisting File.

In the mapper that is automatically created above the CreateManifest Stage Fileaction, define the manifest file content.

Add a Stage File action below the CreateManifest Stage File action to rezip thefile before sending it to the ERP cloud endpoint.

In the Expression Builder, select the ZIP Files option.

Chapter 1About Oracle ERP Cloud Adapter Use Cases

1-11

Select the zip file name to concatenate and the directory to zip.

Add an Oracle ERP Cloud Adapter at the end of the integration to import the datainto the ERP Financial application.

Select the Import Payable Invoices operation.

Once the data loading and processing are complete, an email notification mustbe triggered.

Select Email Notification.

Define a callback to retrieve any details about failed records.

In the mapper above the Oracle ERP Cloud Adapter, define the file references forthe endpoint so that the ERP system processes the rezipped file accordingly.

Activate the integration and monitor the activity stream from the Runtime Healthpage. The activity stream and diagnostic logs are available for download.

Save and activate your integration.

Invoke the integration.

Monitor the activity stream and the diagnostics log.

Typical Workflow for Creating and Including an AdapterConnection in an Integration

You follow a very simple workflow to create a connection with an adapter and includethe connection in an integration in Oracle Integration Cloud Service.

Step Description More Information

1 Create the adapter connectionsfor the applications you want tointegrate. The connections canbe reused in multipleintegrations and are typicallycreated by the administrator.

Creating an Oracle ERP Cloud Adapter Connection

2 Create the integration. Whenyou do this, you add trigger andinvoke connections to theintegration. For a trigger, youselect to include either abusiness object or event in yourintegration.

Creating an Integration and Adding the Oracle ERPCloud Adapter Connection to an Integration

3 Map data between the triggerconnection data structure andthe invoke connection datastructure.

Mapping Data of Using Oracle Integration CloudService

4 (Optional) Create lookups thatmap the different values used bythose applications to identify thesame type of object (such asgender codes or country codes).

Creating Lookups of Using Oracle Integration CloudService

5 Activate the integration. Managing Integrations of Using Oracle IntegrationCloud Service

Chapter 1Typical Workflow for Creating and Including an Adapter Connection in an Integration

1-12

Step Description More Information

6 Monitor the integration on thedashboard.

Monitoring Integrations of Using Oracle IntegrationCloud Service

7 Track payload fields inmessages during runtime.

Assigning Business Identifiers for Tracking Fields inMessages and Managing Business Identifiers forTracking Fields in Messages of Using OracleIntegration Cloud Service

8 Manage errors at the integrationlevel, connection level, orspecific integration instancelevel.

Managing Errors of Using Oracle Integration CloudService

Chapter 1Typical Workflow for Creating and Including an Adapter Connection in an Integration

1-13

2Creating an Oracle ERP Cloud AdapterConnection

A connection is based on an adapter. You define connections to the specific cloudapplications that you want to integrate. The following topics describe how to defineconnections.

Topics

Prerequisites for Creating a Connection

Uploading an SSL Certificate

Creating a Connection

Editing a Connection

Cloning a Connection

Deleting a Connection

Refreshing Integration Metadata

Prerequisites for Creating a ConnectionYou must satisfy the following prerequisites to create a connection with the OracleERP Cloud Adapter:

Prerequisite Description For More Information

Subscribe to Oracle ERPCloud.

This action enables you tocreate an Oracle ERP Clouduser account with the correctprivileges. You specify thisuser account when creating anOracle ERP Cloud Adapterconnection on theConnections page. See Configuring ConnectionSecurity.

See Oracle ERP Cloud.

Obtain the necessary OracleERP Cloud service catalogservice WSDL URL or eventcatalog URL.

You must specify a mandatoryOracle ERP Cloud servicecatalog service WSDL (foraccessing business objects)and optionally an eventcatalog URL (for subscribingto events).

See Obtaining the Oracle ERPCloud Service Catalog ServiceWSDL or Event Catalog URL.

Assign roles to the user. Ensure that the FusionApplications user has therequired roles These roles arerequired for enabling eventsubscriptions or selectingbusiness objects.

See Assigning Required Rolesto an Integration User.

2-1

http://cloud.oracle.com/erp-cloud

Prerequisite Description For More Information

Subscribe to events in OracleERP Cloud

To subscribe to Oracle ERPCloud events in an integration,you must create a CSF key.Create the CSF key from theOracle SOA Composerinstance located in the OracleFusion Applications SupplyChain Management (SCM)domain.

See Configuring Oracle ERPCloud for Event Subscriptions.

Upload files in bulk and insertdata into Oracle ERP Cloudapplication tables.

The Oracle ERP CloudAdapter supports the loadingof bulk data into Oracle ERPCloud through integration withthe Universal ContentManagement (UCM) system.UCM enables you to performbulk upload of files andinsertion of data into OracleERP Cloud application tables.

See Uploading Files in Bulkand Inserting Data into OracleERP Cloud ApplicationTables.

Obtaining the Oracle ERP Cloud Service Catalog Service WSDL orEvent Catalog URL

You must obtain a required service catalog service WSDL (for accessing andconfiguring the inbound and outbound adapter to use either business objects orbusiness services) and optionally an event catalog URL (for accessing and configuringthe inbound adapter to use event subscriptions).

The following sections describe how to obtain the service catalog service WSDL andevent catalog URL:

For Fusion Applications Releases 10 Through 12

For Fusion Applications Releases 13 and Later

For Fusion Applications Releases 10 Through 12Obtain the Oracle Fusion Applications Releases 10 through 12 service catalog serviceWSDLs and event catalog URLs through the following methods.

Obtaining the Service Catalog Service WSDL for Releases 10 Through 11

Obtaining the Service Catalog Service WSDL for Release 12

Obtaining the Event Catalog URL

Chapter 2Prerequisites for Creating a Connection

2-2

Obtaining the Service Catalog Service WSDL for Releases 10 Through 11

WSDL Requirements Where Do You Get the WSDL?

The URL must be that of a service catalogservice WSDL. The service catalog service isa Fusion Application service that returns a listof external services available for integration. Itallows clients to retrieve information about allpublic Fusion Application service endpointsavailable for that instance.

The service catalog service enables clients toretrieve information about all public OracleFusion Application service endpoints availablefor that instance. The information it returns isspecific to the particular cloud instance andalso reflects the new services that may havebeen introduced in patches applied to theinstance. This service is used toprogrammatically discover the SOAP servicesavailable on the cloud instance and retrievethe necessary metadata to invoke the SOAPservices to manage business objects.

The developer creating an Oracle ERP Cloudconnection must work with the Oracle ERPCloud service administrator to get the concreteWSDL URL for the service catalog serviceprovisioned for the specific SaaS application.

This section describes how to derive the external virtual host and port for a tokenizedservice catalog service WSDL. The topology information in the Topology Registrationsetup task contains the external virtual host and port for the domains and applications.The following instructions describe the steps for deriving the values using the servicecatalog service WSDL URL as an example: https://atf_server:port/fndAppCoreServices/ServiceCatalogService.

To access the Review Topology page, theASM_REVIEW_TOPOLOGY_HIERARCHY_PRIV entitlement must be granted to theusers job role. The entitlement is granted to theASM_APPLICATION_DEPLOYER_DUTY duty role, which is inherited by the dutyroles ASM_APPLICATION_DEVELOPER_DUTY andASM_APPLICATION_ADMIN_DUTY.

If the menu items and tasks described in the following procedure are not available inyour cloud instance, your user account is missing the required role. Contact your cloudinstance security administrator for assistance.

1. Log in to the cloud instance.

2. Click the Navigator icon in the global area in the top part of the window, thenchose Setup and Maintenance under the Tools heading.

3. Select Review Topology under the Topology Registration section in the Tasksregional area on the left side of the window.

4. Click the Detailed tab in the middle of the window.

The tab shows the list of domains configured in the cloud instance.

Chapter 2Prerequisites for Creating a Connection

2-3

5. Map the token name for the service path value to the domain name in theTopology Manager:

Token Name in Service Path Domain Name

atf_server CommonDomain

crm_server CRMDomain

fin_server FinancialDomain

hcm_server HCMDomain

ic_server ICDomain

prc_server ProcurementDomain

prj_server ProjectsDomain

scm_server SCMDomain

6. Expand the domain name and select any external virtual host and port for theJ2EE applications that are deployed on the domain. In the sample window, thevalues for this particular instance are fs-your-cloud-hostname and 443,respectively.

Chapter 2Prerequisites for Creating a Connection

2-4

7. Replace the domainName_server:PortNumber with the external virtual host and portidentified in the previous step. For example:

https://fs-your-cloud-hostname:port/fndAppCoreServices/ServiceCatalogService?

wsdl

Obtaining the Service Catalog Service WSDL For Release 12

To obtain the physical endpoint of your instance, perform the following steps:

1. Log in to the Fusion Applications home page. For example:

https://acme.fs.us2.oraclecloud.com/homePage/faces/FuseWelcome

Where acme is the system name and fs is a Fusion Applications domain.

2. Copy https://acme.fs.us2.oraclecloud.com/ and append fndAppCoreServices/ServiceCatalogService?WSDL to it.

https://acme.fs.us2.oraclecloud.com/fndAppCoreServices/ServiceCatalogService?WSDL

Obtaining the Event Catalog URL

You must know the customer relationship management (CRM) URL format to accessthe CRM application user interface. Follow the URL format to determine the eventcatalog URL. For example:

1. Copy the following URL and replace fs with the respective domain, such as fin,scm, crm, and so on.

https://acme.fs.us2.oraclecloud.com/

The event catalog URL to use is:

https://acme.fin.us2.oraclecloud.com/soa-infra

Chapter 2Prerequisites for Creating a Connection

2-5

The event catalog URL https://host/soa-infra is a partial URL and must only beprovided on the Connections page. Do not open this URL with a browser. If you do,you receive a Page not found error. The adapter does not access this URL directly.Instead, it automatically appends the required resource path to make the URL fullyvalid (when it needs to access the event catalog).

To check the public events defined in the catalog, enter the following complete URL ina browser:

https://host:port/soa-infra/PublicEvent/catalog

For Fusion Applications Releases 13 and LaterObtain the Oracle Fusion Applications Release 13 and later service catalog serviceWSDLs and event catalog URLs through the following methods.

Obtaining the Service Catalog Service WSDL

Obtaining the Event Catalog URL

Obtaining the Service Catalog Service WSDL

To obtain the physical endpoint of your instance, perform the following steps:

1. Log in to the Fusion Applications home page. For example:

https://acme.fa.us6.oraclecloud.com/fscmUI/faces/FuseWelcome

Where acme is the system name and us6 is the data center.

2. Copy https://acme.fa.us6.oraclecloud.com/ and append it with fscmService/ServiceCatalogService?WSDL. For example:

https://acme.fs.us2.oraclecloud.com/fscmService/ServiceCatalogService?WSDL

Obtaining the Event Catalog URL

Starting in Release 13, you access all Fusion Applications URLs using a consolidatedendpoint. You must switch to the new consolidated endpoint that conforms to thefollowing naming pattern:

https://systemName.fa.dcsn.oraclecloud.com/...

You must switch to the consolidated endpoint immediately after upgrading to Release13. Newly provisioned instances using Release 13 only have the consolidatedendpoint available. In Release 13, multiple domains are consolidated. You mustspecify the domain in the URL. For example, if specifying the fa domain, the URLlooks as follows:

1. Copy the following URL:

https://acme.fa.us6.oraclecloud.com/

2. Append soa-infra to the end of the URL:

https://acme.fa.us6.oraclecloud.com/soa-infra

Chapter 2Prerequisites for Creating a Connection

2-6

Assigning Required Roles to an Integration UserTo use the Oracle ERP Cloud Adapter in an integration, you must assign specific rolesto an integration user.

Associating the Integration User with the Following Roles and Privileges

You associate the user with the following roles and privileges.

Role Description

ALL_INTEGRATION_POINTS_ALL_DATA Starting with release 12, this role is no longersupported. When existing customers upgradeto release 12, users with this role continueusing it, although it is hidden from the SecurityConsole. If you create a new integration userin release 12 or later, you cannot assign thisrole.

Integration Specialist This is a job role and does not include dataroles. Assign the Integration Specialist rolethat inherits Oracle ERP Cloud roles. This roleapplies to Releases 12 and 13.

Oracle ERP Cloud-specific data access tothe integration user

You must specify the specific data accessroles based on the objects you want tointegrate. This role applies to Releases 12 and13. See Managing Data Access for Users:Explained of Cloud Securing Oracle ERPCloud.

AttachmentsUser Provides access to the Attachments securitygroup to download the log file or the output filewith the ERP Integration Service. Starting withRelease 12, this role is automatically shipped.You must verify that this role is automaticallyassigned to the user.

SOAOperator The SOA operator role.

FND_MANAGE_CATALOG_SERVICE_PRIV The role to manage the web services catalog.

Customer Relationship ManagementApplication Administrator (for Oracle CRMCloud implementations)

See Job Role: Customer RelationshipManagement Application Administrator ofCloud Security Reference for Oracle SalesCloud.

Additional roles may be required as per each interface requirements.

See the Oracle Integration Cloud - Fusion Applications Security Requirements blog foradditional details.

Using the Security Console

Use the Security Console to manage application security such as roles, users,certificates, and administration tasks. Access to the Security Console is provided bythe predefined Security Manager role. Access the Security Console in the followingways:

Use the Manage Job Roles or Manage Duties tasks in the Setup and Maintenancework area.

Chapter 2Prerequisites for Creating a Connection

2-7

https://docs.oracle.com/en/cloud/saas/applications-common/r13-update17d/faser/provisioning-roles-to-application-users.html#FASER1780839https://docs.oracle.com/en/cloud/saas/applications-common/r13-update17d/faser/provisioning-roles-to-application-users.html#FASER1780839https://docs.oracle.com/en/cloud/saas/sales/r13-update17d/oaslm/toc.htm#_Toc468200728_1_12https://docs.oracle.com/en/cloud/saas/sales/r13-update17d/oaslm/toc.htm#_Toc468200728_1_12https://community.oracle.com/blogs/jack.desai/2017/11/14/oracle-integration-cloud-fusion-applications-security-requirements

Select Navigator > Tools > Security Console.

See Using the Security Console of Cloud Securing Oracle ERP Cloud.

Configuring Oracle ERP Cloud for Event SubscriptionsYou must create a CSF key to subscribe to events in Oracle ERP Cloud. This key isrequired by the event handler framework when it invokes the integration. Thecredentials of the integration are managed by the CSF key. Create the CSF key inOracle SOA Composer.

Note:

There is only one SOA instance in Release 13.

The Oracle Integration Cloud Service password may expire periodically.Your application administrator must contact the Oracle Integration CloudService administrator to get the refreshed user credentials. Theapplication administrator must update the CSF key when this passwordis refreshed.

Ensure that you specify the following information correctly when creating the CSF key:

Create the CSF key with a key name that matches the identity domain of theOracle Integration Cloud Service instance.

Create the CSF key with the Oracle Integration Cloud Service user account withwhich you log in to Oracle Integration Cloud Service and not the user namecreated when you subscribed to Oracle ERP Cloud.

Ensure that the CSF key password has not expired.

1. Log in to Oracle SOA Composer with a user that has the SOA administrator role.Obtain the hostname and port from your administrator.

For example, in Release 12:

http://ERP_domain_URL:port/soa/composer

For example, in Release 13:

https://acme.fa.us6.oraclecloud.com/soa/composer

Chapter 2Prerequisites for Creating a Connection

2-8

https://docs.oracle.com/en/cloud/saas/applications-common/r13-update17d/faser/using-the-security-console.html

2. Click Manage Security.

3. Add the CSF key name. The name must be the same as the identity domain of theOracle Integration Cloud Service instance. (Oracle Integration Cloud Servicesubscription identity domain).

4. Provide the username and password that you enter to log in to Oracle IntegrationCloud Service. Do not enter the username and password created when yousubscribed to Oracle ERP Cloud.

The Oracle Integration Cloud Service user must exist in Oracle Integration CloudService and have been assigned the IntegrationServiceRuntime role. The CSF keyentry in the Oracle ERP Cloud infrastructure stores the Oracle Integration CloudService credentials used by Oracle ERP Cloud. When Oracle Fusion Applicationssend outbound requests to Oracle Integration Cloud Service (at runtime), it sendsthe credentials (username and password) of this account for authentication.

5. Click Register.

Uploading Files in Bulk and Inserting Data into Oracle ERP CloudApplication Tables

You must satisfy the following prerequisites for the upload of files in bulk and theinsertion of data into Oracle ERP Cloud application tables.

Note:

Only file-based data import (FBDI)-compliant jobs are supported forcallbacks.

Chapter 2Prerequisites for Creating a Connection

2-9

Satisfy the following prerequisites for the bulk upload of files and the insertion ofdata into Oracle ERP Cloud application tables. This is only required for an ERPCloud callback upon job completion.

1. Create a user similar to the ERP Cloud Adapter connection user in the MyService Page. This user is linked to the Oracle Integration Cloud ServiceWebLogic security realm. The user name must exactly match the Oracle ERPCloud user name. The password and email address can be anything. Ensurethat you select the correct roles for the Oracle ERP Cloud user in the OracleERP Cloud application. The user must have the SOAOperator and Integrationroles.

2. Import the following certificates:

In your browser, enter Service Catalog URL:

For Release 12:

https://hostname:port/fndAppCoreServices/ServiceCatalogService?WSDL

For Release 13:

https://hostname:port/fscmService/ServiceCatalogService?WSDL

In the WSDL, navigate to X509 certificates section:

Copy the first certificate string to a file.

Copy the second certificate to a file. You have two certificate files (forexample, erp_cert1.cer and erp_cert2.cer).

In the Upload Certificate dialog in Oracle Integration Cloud Service, importboth certificates as Message Protection Certificate types and enterunique alias names. See Uploading an SSL Certificate.

Satisfy the following manifest file recommendations (that is, the propertiesfile in the zip file that must be uploaded to Universal Content Management(UCM)).

* The manifest file expects import process details in the followingformat:

,,,

For example:

oracle/apps/ess/financials/payables/invoices/transactions,APXIIMPT,AP,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,INVOICE

Chapter 2Prerequisites for Creating a Connection

2-10

* The manifest file name should be a prefix of the actual zip file name ifit contains _. Otherwise, it should just be the name. For example, if thezip file name is AP_301.zip, the manifest file name should beAP.properties and the third value in the manifest should be themanifest file name. If the zip file name is AP.zip, the manifest file nameshould be AP.properties and the third value in the manifest should bethe manifest file name.

* Only one job is supported per invoke. You can have multiple entries inthe manifest property file to import data from the interface table to theapplications tables in batches of up to 10 for sequential or up to 5 forparallel processing. For example, the journal import data file hasrecords of 10 ledgers. The property file has 10 entries with the uniqueledger name as a parameter. After the data file is loaded in theinterface table, the import process has 10 subprocesses for eachledger.

Satisfy the following prerequisites to configure the integration that uses the bulkimport feature:

1. Map the following parameters to the Oracle ERP Cloud Adapter.

Map parameter ICSFileReference to the File Reference parameter from theother adapter (for example, the FTP Adapter, the REST Adapter, orwhichever adapter you used that has the ICSFileReference parameter).

Map the FileName parameter from the source schema to the target schema(the target schema is the Oracle ERP Cloud bulk import schema). TheFileName must be unique for every request.

Uploading an SSL CertificateCertificates are used to validate outbound SSL connections. If you make an SSLconnection in which the root certificate does not exist in Oracle Integration CloudService, an exception is thrown. In that case, you must upload the appropriatecertificate. A certificate enables Oracle Integration Cloud Service to connect withexternal services. If the external endpoint requires a specific certificate, request thecertificate 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 Certificatesdialog. The Filter By > Type list displays the following details:

Preinstalled: Displays the certificates automatically installed in OracleIntegration Cloud Service. These certificates cannot be deleted.

Uploaded: Displays the certificates uploaded by individual users. Thesecertificates can be deleted and updated.

You can also search for certificates in the Search field. The search results arelimited to a maximum of ten records sorted by name for performance and usability

Chapter 2Uploading an SSL Certificate

2-11

reasons. To ensure that your search results are more granular, enter as much ofthe 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 certificatetype 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) toupload.

Message Protection Certificate: Use this option to upload a keystorecertificate with SAML token support. Create, read, update, and delete (CRUD)operations are supported on this type of certificate.

a. Enter a unique alias for the certificate.

b. Click Browse, then select the certificate file (.cer or .crt) to upload.

Identity Certificate: Use this option to upload a certificate for two-way SSLcommunication.

a. Click Browse, then select the keystore file (.jks) to upload.

b. Enter the password of the keystore being imported.

c. Enter the comma-separated list of aliases from the keystore beingimported.

d. Enter the comma-separated list of passwords corresponding to keyaliases.

e. If you want to display the passwords in clear text, select Show KeyPassword(s). This enables you to ensure that you are correctly entering alist of keystore passwords.

5. Click Upload.

6. Click the certificate name to view details such as the subject of the certificate, theissuer of the certificate, the date the certificate was issued, and the date thecertificate expires.

Creating a ConnectionThe first step in creating an integration is to create the connections to the applicationswith which you want to share data.

1. In the Oracle Integration Cloud Service home page, click Connections.

2. Click Create.

The Create Connection Select Adapter dialog is displayed.

3. Select an adapter from the dialog. You can also search for the type of adapter touse by entering a partial or full name in the Search field, and clicking Search.

The Create New Connection dialog is displayed.

4. Enter the information to describe the connection.

Enter a meaningful name to help others find your connection when they beginto create their own integrations. The name you enter is automatically added in

Chapter 2Creating a Connection

2-12

capital letters to the Identifier field. If you modify the identifier name, do notinclude a blank space (for example, Sales Opportunity).

Select the role (direction) in which to use this connection (trigger, invoke, orboth). Only the roles supported by this adapter are displayed for selection.When you select a role, only the connection properties and security policiesappropriate to that role are displayed on the Connections page. If you selectan adapter that supports both invoke and trigger, but select only one of thoseroles, then try to drag the adapter into the section you did not select, youreceive an error (for example, configure an Oracle RightNow Cloud Adapter asonly an invoke, but drag the adapter to the trigger section).

Enter an optional description of the connection.

5. Click Create.

Your connection is created and you are now ready to configure connection details,such as email contact, connection properties, security policies, connection logincredentials, and (for certain connections) agent group.

Adding a Contact EmailFrom the Connection Administrator section of the connection, you can add a contactemail address for notifications.

1. In the Email Address field, enter an email address to receive email notificationswhen problems occur.

2. In the upper right corner, click Save.

Configuring Connection PropertiesEnter connection information so your application can process requests.

Chapter 2Creating a Connection

2-13

1. Click Configure Connectivity.

The Connection Properties dialog is displayed.

2. In the WSDL URL field, specify the URL to use in this integration.

ERP Services Catalog WSDL URL

ERP Events Catalog URL (optional)

For information about obtaining the URL, see Obtaining the Oracle ERP CloudService Catalog Service WSDL or Event Catalog URL.

3. Click OK.

4. Configure connection security.

Configuring Connection SecurityConfigure security for your Oracle ERP Cloud Adapter connection by selecting thesecurity policy and security token.

1. Click Configure Credentials.

2. Enter your login credentials:

a. Select the security policy. Only the Username Password Token policy issupported. It cannot be deselected.

b. Enter a username and password. You received this username and passwordwhen subscribing to Oracle ERP Cloud.

c. Reenter the password a second time.

3. Click OK.

Testing the ConnectionTest your connection to ensure that it is successfully configured.

1. In the upper right corner of the page, click Test.

2. Select the type of connection testing to perform:

Validate and Test: Performs a full validation of the WSDL, includingprocessing of the imported schemas and WSDLs. Complete validation cantake several minutes depending on the number of imported schemas andWSDLs. No requests are sent to the operations exposed in the WSDL.

Test: Connects to the WSDL URL and performs a syntax check on the WSDL.No requests are sent to the operations exposed in the WSDL.

If successful, the following message is displayed and the progress indicator shows100%.Connection connection_name was tested successfully.

3. If your connection was unsuccessful, an error message is displayed with details.Verify that the configuration details you entered are correct.

4. When complete, click Save, then click Close.

Chapter 2Creating a Connection

2-14

Editing a ConnectionYou can edit connection settings after creating a new connection.

1. On the Oracle Integration Cloud Service home page, click Connections.

2. On the Connections page, search for the connection name.

3. Select Edit from the connection Actions menu or click the connection name.

The Connection page is displayed.

4. Make any necessary edits.

If you edit a connection currently used by an active integration, a dialog isdisplayed indicating that you must re-activate the integration for the connectionupdates to take effect.

Cloning a ConnectionYou can clone a copy of an existing connection, even if the connection is locked. Thisprovides a quick way to create a new connection.

1. On the Oracle Integration Cloud Service home page, click Connections.

2. On the Connections page, search for the connection name.

3. Select Clone from the connection Actions menu.

Chapter 2Editing a Connection

2-15

The Clone Connection dialog is displayed.

4. Enter the connection information.

5. Click Clone.

6. Click Edit to configure the credentials of your cloned connection. Cloning aconnection does not copy the credentials.

See Editing a Connection for instructions.

Deleting a ConnectionYou can delete a connection from the connection menu.

1. On the Oracle Integration Cloud Service home page, click Connections.

2. On the Connections page, search for the connection name.

3. Click Delete from the connection Actions menu.

The Delete Connection dialog is displayed if the connection is not used in anintegration.

4. Click Yes to confirm deletion.

Refreshing Integration MetadataYou can manually refresh the currently-cached metadata available to adapters thathave implemented metadata caching. Metadata changes typically relate tocustomizations of integrations, such as adding custom objects and attributes tointegrations. There may also be cases in which integrations have been patched, whichresults in additional custom objects and attributes being added. This option is similar toclearing the cache in your browser. Without a manual refresh, a staleness check isonly performed when you drag a connection into an integration. This is typicallysufficient, 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:

Chapter 2Deleting a Connection

2-16

Note:

The Refresh Metadata menu option is only available with adapters that haveimplemented metadata caching.

1. On the Oracle Integration Cloud Service home page, click Connections.

2. Locate the connection to refresh.

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

Chapter 2Refreshing Integration Metadata

2-17

3Creating an Integration

Integrations use the adapter connections you created to your applications, and definehow information is shared between those applications. You can create, import, modify,or delete integrations; create integrations to publish or subscribe to messages; addand remove request and response enrichment triggers; and create routing paths fordifferent invoke endpoints in integrations. Click the following topic for more information:

Topic

Creating Integrations (in Using Oracle Integration Cloud Service)

3-1

4Adding the Oracle ERP Cloud AdapterConnection to an Integration

When you drag the Oracle ERP Cloud Adapter into the trigger and invoke areas of anintegration, the Cloud Endpoint Configuration Wizard is invoked. This wizard guidesyou through configuration of the Oracle ERP Cloud Adapter endpoint properties.

The following sections describe the wizard pages that guide you through configurationof the Oracle ERP Cloud Adapter as a trigger or invoke in an integration.

Topics

Configuring Basic Information Properties

Configuring Oracle ERP Cloud Trigger Request Properties

Configuring Oracle ERP Cloud Trigger Response Properties

Configuring Oracle ERP Cloud Invoke Operation Properties

Configuring Oracle ERP Cloud Invoke Response Properties

Reviewing Configuration Values on the Summary Page

Configuring Basic Information PropertiesYou can enter a name and description on the Basic Info page of each adapter in yourintegration.

Topics

What You Can Do from the Basic Info Page

What You See on the Basic Info Page

What You Can Do from the Basic Info PageYou can specify the following values on the Basic Info page. The Basic Info page isthe initial wizard page that is displayed whenever you drag an adapter to the section ofthe integration canvas supported by your adapter.

Specify a meaningful name.

Specify a description of the responsibilities.

Select to be part of a scenario for loading and orchestrating data from a secureFTP location to Oracle ERP Cloud.

4-1

What You See on the Basic Info PageThe following table describes the key information on the Basic Info page.

Element Description

What do you want to call your endpoint? Provide a meaningful name so that others canunderstand the responsibilities of thisconnection. You can include Englishalphabetic characters, numbers, underscores,and dashes in the name. You cannot includethe following: Blank spaces (for example, My Inbound

Connection) Special characters (for example, #;83& or

righ(t)now4) Multibyte characters

What does this endpoint do? Enter an optional description of theconnections responsibilities. For example:This connection receives an inboundrequest to synchronize accountinformation with the cloud application.

Chapter 4Configuring Basic Information Properties

4-2

Element Description

What actions would you want to perform onthis endpoint?

Select the action to perform. These optionsare only displayed when you are configuringthe Oracle ERP Cloud Adapter as an invokeconnection in an integration. Create, Update, Delete, Read Business

Object: Provides the standardconfiguration path for selecting a businessobject or service. This option displays thestandard Operations and Responsepages. This is the default selection.

Import Data into Financials CloudApplication: Provides a scenario forloading and orchestrating data from asecure FTP location to Oracle ERP Cloud.

Data is loaded into a selected productinterface table and then imported into therelated main product application tables. Acallback notification may also beconfigured to send when the data importcompletes. This option also shows amodified Operations page and a uniqueResponse page in the Adapter EndpointConfiguration Wizard for importing data.

Configuring Oracle ERP Cloud Trigger Request PropertiesEnter the Oracle ERP Cloud connection trigger request values for your integration.The values you specify start the integration.

Topics

What You Can Do from the Oracle ERP Cloud Trigger Request Page

What You See on the Oracle ERP Cloud Trigger Request Page

What You Can Do from the Oracle ERP Cloud Trigger Request PageYou can select the following trigger request values for the Oracle ERP Cloudapplication.

Select the specific type to receive as a request from Oracle ERP Cloud. Your ability toselect either a business object or event subscription is based on the content of theWSDL file (for business objects) or event catalog URL (for event subscriptions) youspecified during Oracle ERP Cloud Adapter configuration.

Select to receive a business object as a request from the Oracle ERP Cloudapplication. This selection invokes the integration.

Select to receive an event subscription raised by the Oracle ERP Cloudapplication as a request from Oracle ERP Cloud. This selection invokes theintegration.

Select to configure a callback notification response.

Chapter 4Configuring Oracle ERP Cloud Trigger Request Properties

4-3

Note:

If the options for selecting business objects and events are missing, thatindicates that the event catalog URL was not supplied on the Connectionpage.

What You See on the Oracle ERP Cloud Trigger Request PageThe following table describes the key information on the Oracle ERP Cloud triggerRequest page.

Element Description

Configure a Request Select the request type appropriate to yourintegration. The fields that are displayed beloware based on the request type that you select.

With Business Objects: Select to displaya list of business objects.

With Business Events: Select to displaya list of business events.

As a Callback: Select to configure acallback notification response to sendupon completion of the data import intothe Oracle ERP Cloud application.

Select a Business Object(is displayed if With Business Objects isselected)

Select the business object from the OracleERP Cloud application to receive as a requestthat starts the integration.

Business Event For Subscription(is displayed if With Business Events isselected)

Select the event subscription from the OracleERP Cloud application. This event is receivedas a request that starts the integration. Onlyevents that can be subscribed to aredisplayed.

Chapter 4Configuring Oracle ERP Cloud Trigger Request Properties

4-4

Element Description

Filter Expr for Business_Event_Name(is displayed if With Business Events isselected)

Enter an event condition filter expression. Afilter expression specifies that the contents(payload or headers) of a message beanalyzed before any event is sent. Forexample, you can apply a filter expression thatspecifies that an event be sent only if themessage includes a customer ID. When theexpression logic is satisfied, the event isaccepted for delivery to the integration.

Filter by object name or Filter By EventName

Type the initial letters of the name to filter thedisplay of business objects or eventsubscriptions.

Download Options (is displayed if As aCallback is selected)

Specify when to download the log files thatdescribe the overall status of the Oracle ERPCloud import job. Always: Always download the logs,

regardless of import job failure orsuccess.

On Failure: Only download the logs if theimport job is a failure.

On Success: Only download the logs ifthe import job is successful.

Never: Never download the logs.

Configuring Oracle ERP Cloud Trigger Response PropertiesEnter the Oracle ERP Cloud trigger response values for your integration.

Topics

What You Can Do from the Oracle ERP Cloud Trigger Response Page

What You See on the Oracle ERP Cloud Trigger Response Page

What You Can Do from the Oracle ERP Cloud Trigger Response PageYou can configure the operation and business object that comprise the response typefor the Oracle ERP Cloud application.

Immediate (synchronous) response: A response business object is immediatelyreturned as output. You select Immediate as the response type on the Responsepage and select the business object as part of the response to the client.

Delayed (asynchronous) response: A callback service to which to route thecallback is exposed. You select Delayed as the response type on the Responsepage and select the operation and business object that comprise a successfulcallback response, a failed callback response, or both.

No response is required: You select None on the Response page because aresponse is not required.

The Response page looks as follows:

Chapter 4Configuring Oracle ERP Cloud Trigger Response Properties

4-5

What You See on the Oracle ERP Cloud Trigger Response PageSelect the business object for the integration to send as a response document to theOracle ERP Cloud application. The following types of responses are available.

Select the type of response appropriate to your business requirements:

Immediate: A synchronous response is required (See Table 4-1 for instructions)

Delayed: An asynchronous response is required (See Table 4-2 for instructions)

None: No response is required (See Table 4-3 for instructions)

The following table describes the fields available if an immediate (synchronous)response is required.

Table 4-1 Response Type Immediate (Synchronous) Response is Required

Element Description

Response Type Select Immediate for the Oracle ERP Cloudapplication to wait until a response is receivedfrom the integration. This is also known as therequest and response message exchangepattern. This is the default selection.

Filter by object name Enter the initial letters to filter the display ofbusiness objects.

Select a Business Object Select the business object to receive from theOracle ERP Cloud application as a response.A description of the selected business object isdisplayed below this list.

Name Displays the name of the selected businessobject.

Description Displays the description of the selectedbusiness object.

Chapter 4Configuring Oracle ERP Cloud Trigger Response Properties

4-6

The following table describes the fields available if a delayed (asynchronous) callbackresponse is required. You can configure a successful callback response, a failedcallback response, or both.

Table 4-2 Response Type Delayed (Asynchronous) Response is Required

Element Description

Response Type Select Delayed to configure a successfulcallback response, a failed callback response,or both.

This enables you to configure the operationand business objects that you want the OracleERP Cloud application to process as part of asuccessful callback response, failed callbackresponse, or both.

Successful Response/Failed Response Select the type of callback to configure. Afterconfiguring one type of callback (for example,successful), you can configure the other type(for example, failed). Successful Response: Select to

configure the operation and businessobjects that you want the Oracle ERPCloud application to process as part of asuccessful callback response sent by theintegration.

Failed Response: Select to configure theoperation and business objects that youwant the Oracle ERP Cloud application toprocess as part of a failed callbackresponse sent by the integration.

Select the operation to perform on thebusiness object

Select the operation to perform on thebusiness object.

Life Cycle Displays the current state of the selectedbusiness document. Active indicates thebusiness document is available for use.Deprecated indicates the business documentis nearing the end of use and must be usedwith caution.

Name Displays the name of the selected businessobject.

Description Displays the description of the selectedbusiness object.

The following table describes the fields available if no response is required.

Table 4-3 Response Type None

Element Description

Response Type Select None.

Select a Business Object If you select None, this section is hidden.

Chapter 4Configuring Oracle ERP Cloud Trigger Response Properties

4-7

Configuring Oracle ERP Cloud Invoke Operation PropertiesEnter the Oracle ERP Cloud invoke operation values for your integration.

Topics

What You Can Do from the Oracle ERP Cloud Invoke Operations Page

What You See on the Oracle ERP Cloud Invoke Operations Page

What You Can Do from the Oracle ERP Cloud Invoke OperationsPage

You can configure one of the following invoke operation options for the Oracle ERPCloud.

Select the business object or service and the operation to perform on the selectedbusiness object or service.

Select the job name to import, the job property name, and the type of log data forOracle ERP Cloud to extract.

Chapter 4Configuring Oracle ERP Cloud Invoke Operation Properties

4-8

What You See on the Oracle ERP Cloud Invoke Operations PageThe following table describes the key information on the Oracle ERP Cloud invokeOperations page.

If you selected Create, Update, Delete, Read Business Object on the Basic Infopage, then provide the following information:

Element Description

Browse by Select to browse by business object orservice. There is a one-to-one correspondencebetween the business object and service. Theservice acts on the business document.

Business Objects: Select to browse a listof available business objects.

Services: Select to browse a list ofavailable services.

Filter by object name(displayed if Business Objects is selected)

Type the initial letters to filter the display ofbusiness objects or select a specific category: All Active Custom Deprecated Standard

Select a Business Object(displayed if Business Objects is selected)

Select the business object to use.

Filter by service(displayed if Services is selected)

Type the initial letters to filter the display ofservices.

Select a Service(displayed if Services is selected)

Select the service to use.

Select the operation to perform on thebusiness object or service

Select the operation to perform on theselected business object or service.

Life Cycle Displays the state of the selected businessobject or service. Deprecated indicates thebusiness document is nearing the end of useand must be used with caution.

Name Displays the name of the selected businessobject or service.

Description Displays the description of the selectedbusiness object or service.

If you selected Import Data into Financials Cloud Application on the Basic Infopage, then provide the following information:

Chapter 4Configuring Oracle ERP Cloud Invoke Operation Properties

4-9

Element Description

Import Job Name Select the job name to import. Import jobs arethe background jobs that run on Oracle ERPCloud to perform data upload operations. Thejob name you select is used to import data.The list of import jobs is obtained by invokingErpIcsIntegrationService in the servicecatalog service WSDL. The followinginformation is obtained with each job: Job display name: To be displayed in the

user interface. Interface ID: The import job key. UCM account: The account with which to

upload the file.

Reuse job property file uploadedseparately in respective UCM account

Select this check box, then enter the jobproperty file name (without an extension) thatOracle ERP Cloud can obtain from therespective UCM account.

Extract File Select the type of log data for Oracle ERPCloud to extract while processing the data file: All: All failed records with supporting load

and import process files. Error: Records that failed to load and

import. Log: Log files for load and import

processes. Out: Output files for load and import

processes. None: None.

Additional Import Options This field is not currently supported.

Configuring Oracle ERP Cloud Invoke Response PropertiesEnter the Oracle ERP Cloud invoke response values for your integration.

Topics

What You Can Do from the Oracle ERP Cloud Invoke Response Page

What You See on the Oracle ERP Cloud Invoke Response Page

What You Can Do from the Oracle ERP Cloud Invoke Response PageYou can configure the following invoke operation values for the Oracle ERP Cloud.

Select an option for being notified of data import completion status.

Select when to receive a notification about data import status.

Specify a callback integration in which to receive details about the status of theoutbound Oracle ERP Cloud request flow.

Chapter 4Configuring Oracle ERP Cloud Invoke Response Properties

4-10

What You See on the Oracle ERP Cloud Invoke Response PageThe following table describes the key information on the Oracle ERP Cloud invokeResponse page.

Element Description

Notification Mode Select an option for being notified of dataimport completion status: Email & Bell Notification: Select to

receive both email and bell notifications. Email notification: Select to receive only

an email notification. Bell Notification: Select to receive only a

bell notification.

Occurrence Select when to receive a notification aboutdata import status: Send in any case Send on import success Send on import failure

Integration Flow Identifier Optionally specify a callback integration inwhich to receive details about the status of theoutbound Oracle ERP Cloud request flow(failed records) (for example, enter01.00.0000). This is a completely separateintegration that handles callbacks. The nameof the integration is not required. The inboundintegration is expected to handle callbacksfrom Oracle ERP Cloud. The integration musthave an Oracle ERP Cloud Adapter configuredin the trigger (inbound) direction. You selectAs a Callback on the Request page in thetrigger direction.

Version Enter the integration version in two digits. Forexample, enter 01 if the identifier version is01.00.0000.

Chapter 4Configuring Oracle ERP Cloud Invoke Response Properties

4-11

Reviewing Configuration Values on the Summary PageYou can review the specified adapter configuration values on the Summary page.

Topics

What You Can Do from the Summary Page

What You See on the Summary Page

What You Can Do from the Summary PageYou can review configuration details from the Summary page. The Summary page isthe final wizard page for each adapter after you have completed your configuration.

View the configuration details you defined for the adapter. For example, if youhave defined an inbound trigger (source) adapter with a request business objectand immediate response business object, specific details about this configurationare displayed on the Summary page.

Click Done if you want to save your configuration details.

Click a specific tab in the left panel or click Back to access a specific page toupdate your configuration definitions.

Click Cancel to cancel your configuration details.

What You See on the Summary PageThe following table describes the key information on the Summary page.

Element Description

Summary Displays a summary of the configurationvalues you defined on previous pages of thewizard.

The information that is displayed can vary byadapter. For some adapters, the selectedbusiness objects and operation name aredisplayed. For adapters for which a generatedXSD file is provided, click the XSD link to viewa read-only version of the file.

To return to a previous page to update anyvalues, click the appropriate tab in the leftpanel or click Back.

Chapter 4Reviewing Configuration Values on the Summary Page

4-12

5Creating Mappings and Lookups inIntegrations

You must map data between trigger (source) connections and invoke (target)connections in integrations. You can also optionally create lookups in integrations.

Topics

Mapping Data (in Using Oracle Integration Cloud Service)

Creating Lookups (in Using Oracle Integration Cloud Service)

5-1

6Administering Integrations

Oracle Integration Cloud Service provides you with the information and tools requiredto activate, monitor, and manage your integrations in the runtime environment.

Topic

Administering Oracle Integration Cloud Service (in Using Oracle Integration CloudService)

6-1

7Troubleshooting Oracle ERP CloudAdapter

Review the following topics to learn about troubleshooting issues with the Oracle ERPCloud Adapter.

Topics

Troubleshooting Event Subscription Errors

Import Payables Invoice Report Job is Not Triggered from an Import PayablesInvoice

Data Uploaded in the Oracle ERP Cloud Interface Tables Is Not Uploaded in theBase Tables

Oracle ERP Cloud Callback About the Bulk Import Issue

Jobs Not Appearing in the Import Jobs List on the Operations Page

Oracle ERP Cloud Callback Not Received in Oracle Integration Cloud Service

Business Events Being Sent to Deactivated Integrations

Troubleshooting Event Subscription ErrorsTo subscribe to Oracle ERP Cloud events in an integration, you must create a CSFkey. Failure to correctly create the CSF key results in event subscription errors.

Common CSF key errors are as follows:

The CSF key was never created.

The CSF key was created with the wrong key name.

The CSF key was created with the wrong user name: the Oracle ERP Cloud useraccount created when you subscribed to Oracle ERP Cloud was incorrectlyspecified instead of the Oracle Integration Cloud Service user account.

The CSF key was created correctly but the password had expired.

Ensure that you carefully following the instructions in Configuring Oracle ERP Cloudfor Event Subscriptions to correctly create the CSF key.

Import Payables Invoice Report Job is Not Triggered froman Import Payables Invoice

If the import payables invoice report job is not triggered from the import payablesinvoice, check the status of the import payables invoice job. Depending on the statusof the import payables invoice job, the import payables invoice report gets triggered.

7-1

Data Uploaded in the Oracle ERP Cloud Interface Tables IsNot Uploaded in the Base Tables

If data is uploaded in the Oracle ERP Cloud interface tables, but not in the basetables, do the following.