Download pdf - Using the Oracle ERP Cloud Adapter with Oracle Integration · Using the Oracle ERP Cloud Adapter with Oracle Integration E85427-32 February 2020. Oracle Cloud Using the Oracle ERP

Oracle® CloudUsing the Oracle ERP Cloud Adapter withOracle Integration

E85427-32February 2020

Oracle Cloud Using the Oracle ERP Cloud Adapter with Oracle Integration,

E85427-32

Copyright © 2017, 2020, Oracle and/or its affiliates.

Primary Author: Oracle Corporation

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 embedded, installed or activated on delivered hardware, and modifications of such programs)and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government endusers are "commercial computer software" or “commercial computer software documentation” pursuant to theapplicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use,reproduction, duplication, release, display, disclosure, modification, preparation of derivative works, and/oradaptation of i) Oracle programs (including any operating system, integrated software, any programsembedded, installed or activated on delivered hardware, and modifications of such programs), ii) Oraclecomputer documentation and/or iii) other Oracle data, is subject to the rights and limitations specified in thelicense contained in the applicable contract. The terms governing the U.S. Government’s use of Oracle cloudservices are defined by the applicable contract for such services. 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 Inside 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, Epyc,and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registeredtrademark 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

Preface

Audience vi

Documentation Accessibility vi

Related Resources vi

Conventions vii

1 Understand the Oracle ERP Cloud Adapter

Oracle ERP Cloud Adapter Capabilities 1-1

Supported SCM and Procurement Business Events 1-4

Supported Financials Business Events 1-24

Supported Project Portfolio Management Business Events 1-28

Oracle ERP Cloud Adapter Restrictions 1-29

What Application Version Is Supported? 1-29

Workflow to Create and Add an Oracle ERP Cloud Adapter Connection to anIntegration 1-29

2 Create an Oracle ERP Cloud Adapter Connection

Prerequisites for Creating a Connection 2-1

Obtain the Oracle ERP Cloud Service Catalog Service WSDL, Event CatalogURL, or Interface Catalog URL (For Existing Connections Only) 2-2

For Fusion Applications Releases 10 Through 12 2-3

For Fusion Applications Releases 13 and Later 2-6

Assign Required Roles to an Integration User 2-7

Create Connections Based on the User Role 2-9

Configure Oracle ERP Cloud for Event Subscriptions 2-9

Upload Files in Bulk and Insert Data into Oracle ERP Cloud Application Tablesfor New Integrations 2-10

Upload Files to Oracle WebCenter Content 2-12

Create Custom Business Events 2-13

Create a Connection 2-13

Add a Contact Email 2-14

Configure Connection Properties 2-14

iii

Configure Connection Security 2-15

Test the Connection 2-16

Upload an SSL Certificate 2-16

Refresh Integration Metadata 2-17

3 Add the Oracle ERP Cloud Adapter Connection to an Integration

Basic Info Page 3-1

Trigger Request Page 3-2

Trigger Response Page 3-4

Invoke Actions Page 3-7

Invoke Operations Page 3-7

Invoke Response Page 3-11

Summary Page 3-12

4 Implement Common Patterns Using the Oracle ERP Cloud Adapter

Configure Callbacks 4-1

Upload a File to Oracle WebCenter Content 4-1

Invoke an Endpoint Dynamically 4-4

Invoke a File-Based Data Import (FBDI) Job 4-9

Invoke a Non-File-Based Data Import (FBDI) Job 4-10

5 Troubleshoot the Oracle ERP Cloud Adapter

Bulk Import Troubleshooting Issues 5-1

How to Pass an Interface Request ID to an Import Job in a Bulk Import Process 5-2

Bulk Data Import Implementation Recommendations 5-2

Create a Job Property File for the importBulkData Operation 5-2

Error Response Received When Invoking a Bulk Import with the Oracle ERPIntegration WSDL 5-3

Use the importBulkData Operation and its Parameters 5-3

Import Bulk Data into ERP Cloud Application Option Must Be Reselected in anImported Integration 5-3

Jobs Not Appearing in the Import Jobs List on the Operations Page 5-3

Receive a Callback from an ExportBulkData Operation 5-4

Configure the Callback for the ExportBulkData Operation 5-4

Oracle ERP Cloud Callback About the Bulk Import Issue 5-5

Business Event Troubleshooting Issues 5-5

Event Subscription Error Troubleshooting 5-5

Business Events Being Sent to Deactivated Integrations 5-5

iv

Use a Unique File Name for the Upload Request Payload When using PGPEncryption 5-7

Oracle ERP Cloud Adapter Error Messages 5-7

Import Payables Invoice Report Job is Not Triggered 5-9

Reactivate Integrations when the Connection URL is Modified 5-10

Oracle ERP Cloud Callback Not Received in Oracle Integration 5-10

Error When Discovering REST Services through the Oracle ERP Cloud Adapter 5-13

Oracle Universal Content Management (UCM) File Upload Failure 5-14

v

Preface

This guide describes how to configure the Oracle ERP Cloud Adapter as a connectionin an integration in Oracle Integration.

Note:

The information in this guide applies to all of your Oracle Integrationinstances. It doesn’t matter which edition you’re using, what features youhave, or who manages your cloud environment. You’ll find what you needhere, including notes about any differences between the various flavors ofOracle Integration when necessary.

Topics

• Audience

• Documentation Accessibility

• Related Resources

• Conventions

AudienceThis guide is intended for developers who want to use the Oracle ERP Cloud Adapterin integrations in Oracle Integration.

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=trs if you are hearing impaired.

Related ResourcesSee these Oracle resources:

Preface

vi

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs

• Oracle Cloud

http://cloud.oracle.com

• Using Integrations in Oracle Integration

• Using the Oracle Mapper with Oracle Integration

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

http://cloud.oracle.com

https://www.oracle.com/pls/topic/lookup?ctx=oic&id=ICSUG-GUID-1A01B559-8A46-4D9E-8313-E5400C3A0C9B

https://www.oracle.com/pls/topic/lookup?ctx=oic&id=OCMAP-GUID-C8ED0D16-0602-4EC9-B68B-54A911C23DF3

1Understand the Oracle ERP Cloud Adapter

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. A typicalworkflow of adapter and integration tasks is also provided.

Topics:

• Oracle ERP Cloud Adapter Capabilities

• Oracle ERP Cloud Adapter Restrictions

• What Application Version Is Supported?

• Workflow to Create and Add an Oracle ERP Cloud Adapter Connection to anIntegration

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

Note:

If you have a co-located Oracle HCM Cloud with Oracle ERP Cloud, you maysee Oracle HCM Cloud APIs in the Oracle ERP Cloud Adapter. It isrecommended that you use the Oracle HCM Cloud Adapter for any HCMintegrations. However, if you do use the Oracle ERP Cloud Adapter withthese APIs, ensure that you have reviewed the supported SOAP services inOracle HCM Cloud.See Oracle HCM Cloud Adapter Capabilities.

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 application’s WSDL file to produce asimplified, integration-centric WSDL.

• Provides declarative support for subscribing to business events raised by variousmodules in Oracle ERP Cloud and Oracle Supply Chain Cloud. See SupportedSCM and Procurement Business Events and Supported Financials BusinessEvents.

• Generates automatic mapping to the exposed business object, event subscription,or business (REST) API 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 a

1-1

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

– Event subscription: Represents an event document to which you subscribe.The event subscription is raised by the Oracle ERP Cloud application.

See Supported SCM and Procurement Business Events.

You can also create custom business events in Oracle ERP Cloud that can bepublished and subscribed to with the Oracle ERP Cloud Adapter. See CreateCustom Business Events.

– Business (REST) API: Represents an Oracle Fusion Applications REST APIresource.You can select parent business resources and their corresponding childbusiness resources. Support is provided in the invoke (outbound) direction.

• Simplified connection creation: Automatically identifies the required service catalogservice WSDL, optional event catalog URL, and optional interface catalog URL touse based on the Oracle ERP Cloud host name you specify when creating a newconnection on the Connections page.

• Dynamically invokes a REST endpoint/URL at runtime without requiring you toconfigure any extra invoke connection or REST outbound details.

See Invoke an Endpoint Dynamically.

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

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.

Chapter 1Oracle ERP Cloud Adapter Capabilities

1-2

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.

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

• Enables you to upload files to Oracle WebCenter Content (Universal ContentManager) in encrypted or unencrypted format. Oracle WebCenter Contentprovides a unified repository to store unstructured content, enabling organizationsto deliver the content to business users in the proper format.

See Upload a File to Oracle WebCenter Content.

Note:

Downloading files from Oracle WebCenter Content is not supported.

• Supports the ErpImportBulkDataEvent event subscription. The process of importbulk data is now simplified and based on the ErpImportBulkDataEvent event:

– Change in design for the invoke integration:For new integrations in the invoke direction (Oracle Integration to Oracle ERPCloud), support is added to raise an ErpImportBulkDataEvent event in OracleERP Cloud once the import bulk process completes.

To raise the ErpImportBulkDataEvent event, you must select the EnableCallback check box on the Response page of the Adapter EndpointConfiguration Wizard.

The callback-based Integration Flow Identifier and Version fields areremoved because the callback is now an ErpImportBulkDataEvent eventpayload.

– Change in the callback integration:All new callback integrations are now based on the ErpImportBulkDataEventevent. While configuring the callback integration, you must select the exactimport job on the Operations page of the Adapter Endpoint ConfigurationWizard for which the ErpImportBulkDataEvent event is to be received.

For older, existing integrations, the ErpImportBulkDataEvent event is notused. You must continue to manually specify details in the Integration Flow


1-3

Identifier and Version fields on the Response page of the invoke integrationto receive a callback.

See Invoke a File-Based Data Import (FBDI) Job.

Note:

Note the following behavior:

• During bidirectional account and contact synchronization, echoes aregenerated. Oracle Integration-based integrations use echo suppressionto prevent unwanted update or create events (the echoes) from returningto 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.

Supported SCM and Procurement Business EventsThe following SCM and Procurement business events are supported. You cansubscribe to these events during adapter configuration in the Adapter EndpointConfiguration Wizard.

Cost Management

SupportedBusinessEvents

Event Payload First Release Callback Service

FinancialOrchestrationTransfer PriceBusinessEvent: Thisevent signalsthat the transferprice ispublished forsupply chainfinancialorchestration

SourceEventIdentifier

EventType

EventDate

SourceDocumentId

SourceDocumentType

FinancialRouteFromBusinessUnitName

FinancialRouteToBusinessUnitName

FinancialRouteNumber

UnitTransferPrice

UOM

CurrencyCode

19A N/A


1-4

https://www.ateam-oracle.com/using-oracle-bi-publisher-to-extract-data-from-oracle-sales-and-erp-clouds



InspectionBusinessEvent: Thisevent signalsInspectionBusiness israised.

IpEventId

- newValue

- oldValue

InspectionName

- newValue

- oldValue

ActionTaken

- newValue

- oldValue

19A N/A

Inventory Management



AdvanceShipmentNotice Event:Signals that anadvanceshipment noticecan be sent toan externalcustomer forthe shipment.

ShipToPartyId

ShipToPartyName

ShipToPartyNumber

ShipmentId

ShipmentName

R12 SOAP Service:ShipmentService

Operation:getAdvancedShipmentNoticeData

ASNCancellationEvent: Notifiesthat an ASN/ASBN line hasbeen cancelledin OracleFusionReceivingCloud.

AgentId

AgentUserName

HeaderInterfaceId

AsnType

AsnNumber

LineNumber

SupplierName

ShipmentHeaderId

ShipmentLineId

DropShipTransaction

SfoTransaction

BuyerManagedTransportation

ScoTransaction

IntegratedSystemCode

R13 18B SOAP Service:InboundShipmentService

Operation: findShipment


1-5



ASN CreationEvent: Notifiesthat an ASN/ASBN line hasbeen created inOracle FusionReceivingCloud.

AgentDetailsList

- AgentDetails

- - AgentId

- - AgentUserName

HeaderInterfaceId

AsnType

AsnNumber

SupplierName

ExpectedReceiptDate

ShippedDate

InvoiceNumber

ShipmentHeaderId

DropShipTransaction

SfoTransaction


ScoTransaction

IntegratedSystemCode

R11 SOAP Service:InboundShipmentService

Operation: findShipment

Backorder LineEvent: Signalsthat a shipmentline has beenback ordered.

ShipmentLine

SourceSystemId

TransportationShipment

TransportationShipmentLine

TransportationShipmentComplete

TradeComplianceScreened

CurrentBackorderQuantity

OriginalLineId

R13 17B SOAP Service:ShipmentLineService

Operation:GetBackorderLineData

CreateCorrectionTransactionEvent: Notifiesthat acorrectiontransaction iscreated inOracle FusionReceivingCloud.

TransactionType

GroupId

SfoTransaction

ScoTransaction

CorrectOnReceive

CorrectOnDeliver

CorrectOnRTV

WORelatedPOSchedule

R11 SOAP Service:ReceivingTransactionService

Operation: findTransaction

Create DeliverTransactionEvent: Notifiesthat a delivertransaction iscreated inOracle FusionReceivingCloud.

TransactionType

GroupId

ScoTransaction

SfoTransaction

WORelatedPOSchedule




1-6



CreateReceivingReceipt Event:Notifies that areceipt iscreated inOracle FusionReceivingCloud.

ShipmentHeaderId

ReceiptNum

ReceiptSourceCode

RcvOrganizationId

AsnType

AsnNumber

SfoTransaction

DropShipTransaction


ScoTransaction

GroupId

WORelatedPOSchedule

R11 SOAP Service:ReceiptService

Operation: findReceipt

Create ReturnTransactionEvent: Notifiesthat a return (tosupplier,customer,organization)transaction iscreated inOracle FusionReceivingCloud.

TransactionType

GroupId

SfoTransaction

ScoTransaction

DropShipTransaction

ReturnToReceiving

ReturnToVendor

ReturnToOrganization

ReturnToCustomer

WORelatedPOSchedule



ManifestRequest Event:Signals thatshipmentinformation canbe sent to thecarriermanifestingsystem todetermine rate,freight cost,and labels forthe shipment.

ShipmentList

- DeliveryId

- TransactionId

- DeliveryName

ActionCode

executionContext

eventType

R11 SOAP Service: ShipmentService

Operation:getManifestRequestData


1-7



Receipt AdviceEventNotification:Notifies that areceipt adviceis generated inOracle FusionReceivingCloud andavailable forexternalsystemsto process.

OrganizationId

OrganizationCode

GenerateProcessRequestId

ChangeProcessRequestId

PurchaseOrderHeaderId

PurchaseOrderLineId

PurchaseOrderLineLocationId

ASNHeaderId

IntransitShipmentHeaderId

IntransitShipmentLineId

TransferOrderHeaderId

TransferOrderLineId

RMAHeaderId

RMALineId

SupplierId

SupplierSiteId

CustomerId

ItemId

ReceivingLocationId

CarrierId

DueDate

Resent

R13 17B SOAP Service:ReceiptAdviceService

Operation:getReceiptAdviceDetails

ShipmentAdvice Event:Signals that theshipment isshipped and isready forinforming thesource systemwith theshippedinformation.

executionContext

EvenType

MsgType

- DeliveryId

- TransactionId

- DocumentNumber

- DeliveryName

- OSP

- Transportation Shipment

- TransportationShipmentComplete

- TradeComplianceScreened

- DocumentsGenerationComplete

R13 17B SOAP Service:ShipmentService

Operation:getShipmentAdviceData


1-8



ShipmentRequestGenerateEvent: Signalsthat shipmentline selectioncriteria ispublished forexternalsystems toprocess thelines.

pickBatchName R11 SOAP Service:ShipmentLineService

Operation:GenerateShipmentRequest

Standard CostExportedEvent: Signalsthat a standardcost is exportedfor a scenario.

DocumentTitle

DocumentIdentifier

DocumentName

RequestId

CostOrganization

CostBook

ScenarioType

EventDate

ScenarioName

R13 17C NA

Standard CostPublishedEvent: Signalsthat thestandard cost ispublished for ascenario.

ScenarioName

CostOrganization

CostBook

ScenarioType

EventDate

ScenarioEffectiveDate

ScenarioIdentifier

CostOrganizationIdentifier

CostBookIdentifier

RequestId

Action

R13 17C NA

TradeScreeningRequest Event:Signals torequest tradescreening for ashipment line.

ShipmentLine R13 17B SOAP Service:ShipmentLineService

Operation:getShipmentLineData


1-9



Transfer PricePublishedEvent: Signalsthat the transferprice ispublished for asales orderfulfillment line.

FulfillLineId

UnitTransferPrice

CurrencyCode

DeliveryId

DeliveryName

DeliveryDetailId

SourceTransactionId

SourceTransactionSystem

SourceTransactionNumber

SourceTransactionLineId

SourceTransactionLineNumber

OrderTypeCode

UomCode

R13 17C NA


1-10

Maintenance



CustomerAsset Created:Signals that acustomer assetis created.

AssetId

- newValue

- oldValue

AssetNumber

- newValue

- oldValue

ItemId

- newValue

- oldValue

ItemOrganizationId

- newValue

- oldValue

SerialNumber

- newValue

- oldValue

LotNumber

- newValue

- oldValue

Quantity

- newValue

- oldValue

CustomerId

- newValue

- oldValue

CustomerSiteId

- newValue

- oldValue

R13 17C SOAP Service:AssetService

Operation: getAsset


1-11



CustomerAssetRelationshipCreated:Signals that acustomer assetrelationship iscreated.

RelationshipId

- newValue

- oldValue

SubjectId

- newValue

- oldValue

SubjectAssetNumber

- newValue

- oldValue

RelationshipTypeCode

- newValue

- oldValue

ObjectId

- newValue

- oldValue

ObjectAssetNumber

- newValue

- oldValue

R13 17C SOAP Service:AssetRelationshipService

Operation:getAssetRelationship

CustomerAssetRelationshipDeleted:Signals that anassetrelationship isdeleted.

RelationshipId

- newValue

- oldValue

SubjectId

- newValue

- oldValue

SubjectAssetNumber

- newValue

- oldValue

RelationshipTypeCode

- newValue

- oldValue

ObjectId

- newValue

- oldValue

ObjectAssetNumber

- newValue

- oldValue

R13 17C SOAP Service:AssetRelationshipService

Operation:getAssetRelationship


1-12



CustomerAsset Updated:Signals that acustomer assetis updated.

AssetId

- newValue

- oldValue

AssetNumber

- newValue

- oldValue

ItemId

- newValue

- oldValue

ItemOrganizationId

- newValue

- oldValue

SerialNumber

- newValue

- oldValue

LotNumber

- newValue

- oldValue

Quantity

- newValue

- oldValue

ActiveEndDate

- newValue

- oldValue

CustomerId

- newValue

- oldValue

CustomerSiteId

- newValue

- oldValue

R13 17C SOAP Service:AssetService

Operation: getAsset


1-13



MaintenanceAsset Created:Signals that amaintenanceasset iscreated.

AssetId

- newValue

- oldValue

AssetNumber

- newValue

- oldValue

ItemId

- newValue

- oldValue

ItemOrganizationId

- newValue

- oldValue

SerialNumber

- newValue

- oldValue

LotNumber

- newValue

- oldValue

Quantity

- newValue

- oldValue

R13 17D SOAP Service:AssetService

Operation: getAsset


1-14



MaintenanceAsset Updated:Signals that amaintenanceasset isupdated.

AssetId

- newValue

- oldValue

AssetNumber

- newValue

- oldValue

ItemId

- newValue

- oldValue

ItemOrganizationId

- newValue

- oldValue

SerialNumber

- newValue

- oldValue

LotNumber

- newValue

- oldValue

Quantity

- newValue

- oldValue

ActiveEndDate

- newValue

- oldValue

R13 17D SOAP Service:AssetService

Operation: getAsset

Manufacturing



Print ProductLabel Event:Signals that aprint productlabel istriggered

WorkOrderNumber

WorkOrderId

OrganizationCode

OrganizationId

ItemNumber

InventoryItemId

OperationTransactionId

InvTransactions

- InvTransactionId

SerialNumbers

- SerialNumber

R13 18B NA


1-15

Manufacturing and Maintenance



Work OrderCreate: Signalsthat a workorder iscreated.

WorkOrderNumber

WorkOrderId

OrganizationCode

OrganizationId

EventType

R13 17B SOAP Service:WorkOrderEnrichService

Operation:getWorkOrderEnrich

Work OrderUpdate: Signalsthat a workorder isupdated.

WorkOrderNumber

WorkOrderId

OrganizationCode

OrganizationId

EventType

R13 17B SOAP Service:WorkOrderEnrichService

Operation:getWorkOrderEnrich

Order Management



Order StatusUpdated:Informs asubscriber thatan order statusor status of afulfillment linethat is part ofan order wasupdated.

EventCode

TransactionEntityInput

- EntityType

- TransactionEntityId

- StatusCodeNewValue

- StatusCodeOldValue

R12 SOAP Service:EventEnrichmentService

Operation:getEnrichmentDetails


1-16



Sales OrderNotification:Informs asubscriberabout asignificantdevelopmenton a salesorder. Thisevent occurswhen the orderstatus changes,the line statuschanges, thevalue of anattributechanges, afulfillment linesplits, or anexceptionoccurs, such asa jeopardy orhold.

EventCode

TransacttionEntityInput

- EntityType

- TransactionEntityId

- CompensationMessage

- CompensationStatus

- HoldInstanceId

- OrderedQuantity

- JeopartyPriority

- StatusCodeOldValue

- StatusCodeNewValue

-TransactionAttributeInformation

- - AttributeName

- - AttributeType

- - AttributeValue

R13 17B SOAP Service:DocumentService

Operation:getSalesOrderNotificationDetails

Sales OrderTradeComplianceScreening:Communicatesscreeningrequests to asystem thatmanages tradecompliance.

taskInstanceId

groupId

R13 17B SOAP Service:OrderFulfillmentRequestService

Operation:getOrderFulfillmentRequestDetails

Sales OrderTransportationPlanning:Communicatesfulfillmentrequests to atransportationplanningsystem.

taskInstanceId

groupId

R13 17B SOAP Service:OrderFulfillmentRequestService

Operation:getOrderFulfillmentRequestDetails


1-17

Product Lifecycle Management



Change OrderApproval Event:Signals that achange order isin approval.

ChangeId

- newValue

- oldValue

StatusType

- newValue

- oldValue

R13 18B SOAP Service:ChangeOrderService

Operation: getChangeOrder

Change OrderCompletedEvent: Signalsthat a changeorder iscompleted.

ChangeId

- newValue

- oldValue

StatusType

- newValue

- oldValue



Change OrderInterimApproval Event:Signals that achange order isin interimapproval.

ChangeId

- newValue

- oldValue

StatusType

- newValue

- oldValue



Change OrderOpen Event:Signals that achange order isopen.

ChangeId

- newValue

- oldValue

StatusType

- newValue

- oldValue



Change OrderScheduledEvent: Signalsthat a changeorder isscheduled.

ChangeId

- newValue

- oldValue

StatusType

- newValue

- oldValue

EventStatusType

- newValue

- oldValue

R13 17B SOAP Service:ProductDesignChangeOrderService



1-18

Product Master Data Management

Supported BusinessEvents


Item StructureComponent CreateEvent: Signals that anitem structurecomponent is created.

BillSequenceId

- newValue

- oldValue

ComponentSequenceId

- newValue

- oldValue

ObjName

- newValue

- oldValue

Pk1Value

- newValue

- oldValue

Pk2Value

- newValue

- oldValue

R12 SOAP Service:StructureService

Operation:findStructure

Item StructureComponent UpdateEvent: Signals that anitem structurecomponent isupdated.

BillSequenceId

- newValue

- oldValue

ComponentSequenceId

- newValue

- oldValue

ObjName

- newValue

- oldValue

Pk1Value

- newValue

- oldValue

Pk2Value

- newValue

- oldValue




1-19



Item Structure CreateEvent: Signals that anitem structure iscreated.

BillSequenceId

- newValue

- oldValue

CommonBillSequenceId

- newValue

- oldValue

AlternateBomDesignator

- newValue

- oldValue

ObjName

- newValue

- oldValue

Pk1Value

- newValue

- oldValue

Pk2Value

- newValue

- oldValue



Item Structure UpdateEvent: Signals that anitem structure isupdated.

BillSequenceId

- newValue

- oldValue

CommonBillSequenceId

- newValue

- oldValue

AlternateBomDesignator

- newValue

- oldValue

ObjName

- newValue

- oldValue

Pk1Value

- newValue

- oldValue

Pk2Value

- newValue

- oldValue



Item Bulk Load Event:Signals that items areimported.

RequestId

EntityType

R11 NA


1-20



Item Catalog CategoryAssignment ChangeEvent: Signals achange in the itemcatalog categoryassignment.

InventoryItemId

- newValue

- oldValue

OrganizationId

- newValue

- oldValue

CategorySetId

- newValue

- oldValue

RequestId

- newValue

- oldValue

TransactionType

- newValue

- oldValue

ItemNumber

- newValue

- oldValue

R11 SOAP Service:ItemService

Operation: findItem

Item Create Event:Signals that an item iscreated.

InventoryItemId

- newValue

- oldValue

OrganizationId

- newValue

- oldValue

OrganizationCode

- newValue

- oldValue

ItemNumber

- newValue

- oldValue

Description

- newValue

- oldValue

RequestId

- newValue

- oldValue

R11 SOAP Service:ItemService

Operation: findItem


1-21



Item PublicationEvent: Signals thatitems are published.

DocumentId

- newValue

- oldValue

Error Message

- newValue

- oldValue

PublicationJobStatus

- newValue

- oldValue

RequestId

- newValue

- oldValue

R13 17C NA

Item Update Event:Signals that an item isupdated.

InventoryItemId

- newValue

- oldValue

OrganizationId

- newValue

- oldValue

OrganizationCode

- newValue

- oldValue

ItemNumber

- newValue

- oldValue

Description

- newValue

- oldValue

RequestId

- newValue

- oldValue

R13 17B SOAP Service:ItemService

Operation: findItem


1-22



Product Upload StatusChange Event:Signals a statuschange in a productupload.

ProductUploadId

- newValue

- oldValue

ProductUploadName

- newValue

- oldValue

ProductUploadStatus

- newValue

- oldValue

SupplierId

- newValue

- oldValue

ProductSchedule.EmailAddress

- newValue

- oldValue

ProductSchedule.NotificationFlag

- newValue

- oldValue

MappingName

- newValue

- oldValue

ItemClassName

- newValue

- oldValue

BatchId

- newValue

- oldValue

CreationDate

- newValue

- oldValue

CreatedBy

- newValue

- oldValue

AssigneeUserName

- newValue

- oldValue

ImportOnDataLoad

- newValue

- oldValue

ScheduleId

- newValue

- oldValue

R11 NA


1-23

Purchasing


Event Payload First Release Service Callback

Purchase OrderEvent: Publishedwhen a purchaseorder is created,changed, finallyclosed, or reopened.

EventActionCode

POHeaderId

OrderNumber

SoldToLegalEntityId

SoldToLegalEntityName

RequisitioningBusinessUnitId

BuyerManagedTransportationFlg

InterfaceSourceCode

POChangeOrderSequence

ChangeOrderTypeCode

ImplementationDate

R13 17B SOAP Service:PurchaseOrderService

Operation:getPurchaseOrder

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

Cloud Product SupportedBusiness Event

Description Enable ByUsing

First ReleaseAvailable

AdvancedCollections

Strategy Closed Signals when thecollectionstrategyassociated to acustomer isclosed.

AutomaticallyInitiate or FulfillCollections Tasksin Third PartySystems feature

18C

AdvancedCollections

Strategy ExternalTask Opened

Signals when thecollectionstrategy assignedto a customer hasa task that shouldbe performed byan externalsystem and whenthat task isopened.

AutomaticallyInitiate or FulfillCollections Tasksin Third PartySystems feature

18C

Expenses Expense ReportAuditor Approved

Signals when theexpense report isapproved by theauditor.

ERP BusinessEvents REST API

19B

Expenses Expense ReportHeld

Signals when theexpense report isplaced on hold.


19B


1-24




Expenses Expense ReportManagerApproved

Signals when theexpense report isapproved by themanager.


19B

Expenses Expense ReportSubmitted

Signals when theexpense report issubmitted by theuser.


19B

FinancialsCommon Module

ERP IntegrationInbound

Signals when theimport bulk datais completedusing the ERPIntegration webservice.

ERP IntegrationsREST API

17D

FinancialsCommon Module

ERP IntegrationOutbound

Signals when theexport bulk datais completedusing the ERPIntegration webservice.

ERP IntegrationsREST API

17D

General Ledger AccountingPeriod Closed

Signals when ageneral ledgeraccounting periodis closed.


18C

General Ledger AccountingPeriod Opened

Signals when ageneral ledgeraccounting periodis opened.


18C

General Ledger AccountingPeriod Reopened

Signals when ageneral ledgeraccounting periodis reopened.


18C

General Ledger Journal BatchApproved

Signals when ajournal batch isapproved.


18C

General Ledger Journal BatchPostingCompleted

Signals when ajournal batch isposted.


18C

Payables Payables InvoiceApproved

Signals when aninvoice isapproved.

AP: EnableBusiness Eventsprofile option atthe site level

18C

Payables Payables InvoiceCancelled

Signals when aninvoice iscanceled


18C

Payables Payables InvoiceCreated

Signals when aninvoice iscreated.


18C


1-25




Payables Invoice HoldApplied

Signals when aninvoice hold isplaced.


18B

Payables Invoice HoldReleased

Signals when aninvoice hold isreleased.


18B

Payables Payables InvoiceValidated

Signals when aninvoice isvalidated online.


18C

Payables PayablesPayment Created

Signals when asingle payment iscreated.


18C

Payables PayablesPayment Voided

Signals when apayment isvoided.


19A

Payments Payment FileCreated

Signals when apayment file iscreated.

IBY: EnableBusiness Eventsprofile option atthe site level

18C

Receivables Credit CaseFolder Closure

Signals when acase folderwhose requesttype is CreditCheck Failure isclosed.

Enabled bydefault

18B

Receivables ReceivablesAutoinvoiceCompleted

Signals when anautoinvoice iscompleted.


19A

Receivables ReceivablesCredit MemoApplied

Signals when astandard creditmemo is createdand an onaccount creditmemo issuccessfullyapplied.


19A

Receivables ReceivablesCredit MemoCompleted

Signals when acredit memo issuccessfullycompleted.


19A

Receivables ReceivablesCredit MemoIncompleted

Signals when acredit memo isincomplete.


19A

Receivables ReceivablesInvoiceCompleted

Signals when aninvoice iscompleted.


18C


1-26




Receivables ReceivablesInvoiceIncompleted

Signals when aninvoice isincomplete.


19A

Receivables ReceivablesInvoice Paid

Signals when apayment isapplied to aninvoice.


18C

Receivables ReceivablesLockbox BatchCompleted

Signals when alockbox batchprocess iscompleted.


19A

Receivables Standard ReceiptApplied

Signals when astandard receiptis applied to atransaction forthe goodsreceived orservicesrendered.


19A

Receivables Standard ReceiptCreated

Signals when astandard receiptis created torecord paymentfrom a customerfor goodsreceived orservicesrendered.


18C

Receivables Standard ReceiptDeleted

Signals when astandard receiptis successfullydeleted.


19A

Receivables Standard ReceiptReversed

Signals when astandard receiptis reversed.


18C

Receivables Standard ReceiptUnapplied

Signals when astandard receiptis successfullyunapplied.


19A

RevenueManagement

RevenueContract BatchCreated

Signals whenrevenue contractsare created in abatch process.


19D

For detailed information about enabling business events, see the following:

• New Feature Opt-In in Using Functional Setup Manager

• About the REST APIs in REST API for Oracle Financials Cloud

• Overview of Public Business Events in Implementing Payables Invoice to Pay


1-27

http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=OAFSM2428879

https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=FARFA

https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=FAIPP3689517

Supported Project Portfolio Management Business EventsThe following Project Portfolio Management business events are supported. You cansubscribe to these events during adapter configuration in the Adapter EndpointConfiguration Wizard.

Work Area SupportedPublicEvent

Description Enabled ByDefault

FirstReleaseAvailable

CallbackService

ProjectManagement

ProjectDeliverableStatusChanges

Signals wheneverproject deliverablestatus or prioritychanges. Creating ordeleting a deliverabledoesn't generatesignals.

No 19A RESTService:DeliverablesMethod: Geta deliverable

TaskManagement

Project TaskProgressStatusChanges

Signals wheneverproject task progressstatus changes.Creating or deletingtasks doesn't generatesignals.

No 19A RESTService:ProjectPlansResource:Tasks

Operation:Get a task ofa project

TaskManagement

ProjectMilestoneCompletion

Signals whenever aproject milestone iscompleted.Completing financialtasks that are flaggedas milestones doesn'tgenerate signals.

No 19A RESTService:ProjectPlansResource:Tasks


ProjectFinancialManagement

PublishingFinancialProjectProgress

Signals wheneverfinancial projectprogress is published.

No 18C RESTService:ProjectProgressOperation:Get theprogress of aproject

ProjectFinancialManagement

FinancialProject PlanChanges

Signals whenever taskassignments arecreated or modified ina financial projectplan.

No 18C RESTService:ProjectPlansResource:Tasks



1-28

Work Area SupportedPublicEvent

Description Enabled ByDefault

FirstReleaseAvailable

CallbackService

ProjectFoundation

ProjectStatusChange

Signals whenever thestatus of a project planchanges.

No 17D RESTService:ProjectsOperation:Get a project

Detailed information about these events is provided. See Public Business Events inImplementing Project Financial Management and Grants Management and PublicBusiness Events in Implementing Project Execution Management.

Oracle ERP Cloud Adapter RestrictionsNote the following Oracle ERP Cloud Adapter restrictions.

• The SubmitJobwithOutput operation is being deprecated soon. It is recommendedthat you use the ExportBulkdata operation from Oracle ERP Cloud to submitBusiness Intelligence Publisher (BIP) jobs and receive a call back in return.

• Downloading files from Oracle WebCenter Content is not supported.

• Oracle Fusion Applications allows clients to access the public event catalog usingthe HTTP basic authentication scheme. When the client is not allowed tocommunicate with the catalog using this scheme, they receive the following error:Server redirected too many times (20). This occurs while testing the OracleCloud connection. You must file a service request with Oracle Fusion Applicationsto resolve this issue.

What Application Version Is Supported?For information about which application version is supported by this adapter, see theConnectivity Certification Matrix:

See Connectivity Certification Matrix.

Workflow to Create and Add an Oracle ERP CloudAdapter Connection to an Integration

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

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.

Create an Oracle ERP Cloud Adapter Connection

Chapter 1Oracle ERP Cloud Adapter Restrictions

1-29

https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=OAPFM3440944

https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=OAPEX3442085

https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=OAPEX3442085

https://www.oracle.com/technetwork/middleware/adapters/documentation/adaptercertificationmatrix0217-3613709.pdf

Step Description More Information

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.

Create Integrations and Add the Oracle ERP CloudAdapter Connection to an Integration

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

Map Data of Using Integrations in Oracle Integration

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

Manage Lookups of Using Integrations in OracleIntegration

5 Activate the integration. Manage Integrations of Using Integrations in OracleIntegration

6 Monitor the integration on thedashboard.

Monitor Integrations of Using Integrations in OracleIntegration

7 Track payload fields inmessages during runtime.

Assign Business Identifiers for Tracking Fields inMessages and Manage Business Identifiers forTracking Fields in Messages of Using Integrations inOracle Integration

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

Manage Errors of Using Integrations in OracleIntegration

Chapter 1Workflow to Create and Add an Oracle ERP Cloud Adapter Connection to an Integration

1-30

2Create an Oracle ERP Cloud AdapterConnection

A connection is based on an adapter. You define connections to the specific cloudapplications that you want to integrate.

Topics:

• Prerequisites for Creating a Connection

• Create a Connection

• Upload an SSL Certificate

• Refresh 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 Configure ConnectionSecurity.

See Oracle ERP Cloud.

For existing connectionscreated prior to the initialrelease of the simplifiedconnections page on 2/18/20,obtain the necessary OracleERP Cloud service catalogservice WSDL URL or eventcatalog URL. For newconnections created with theinitial release of the simplifiedconnections page on 2/18/20,the preconfiguration detailsdescribed in this section arenot required.

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

See Obtain the Oracle ERPCloud Service Catalog ServiceWSDL, Event Catalog URL, orInterface Catalog URL (ForExisting Connections Only).

2-1

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

Prerequisite Description For More Information

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

See Assign Required Roles toan Integration User.

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 Configure 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• Configure Oracle ERP

Cloud for EventSubscriptions (only fornew integrations that arebased on theERPBulkImportDataevent)

• Upload Files in Bulk andInsert Data into OracleERP Cloud ApplicationTables for NewIntegrations

Upload files to OracleWebCenter Content

The Oracle ERP CloudAdapter supports the loadingof files to Oracle WebCenterContent.

See Upload Files to OracleWebCenter Content.

Create custom businessevents

The Oracle ERP CloudAdapter supports the selectionof custom business events.

See Create Custom BusinessEvents.

Obtain the Oracle ERP Cloud Service Catalog Service WSDL, EventCatalog URL, or Interface Catalog URL (For Existing ConnectionsOnly)

The steps in this section are only required for existing connections created priorto the initial release of the simplified connections page on 2/18/20. For existingconnections, you are prompted to specify a service catalog service WSDL (foraccessing and configuring the inbound and outbound adapter to use either businessobjects or business services) in the ERP Services Catalog WSDL URL field andoptionally an event catalog URL (for accessing and configuring the inbound adapter touse event subscriptions) in the ERP Events Catalog URL field and interface catalog

Chapter 2Prerequisites for Creating a Connection

2-2

URL (for accessing and configuring the outbound endpoint using REST businessresources) in the Interface Catalog URL field.

Note:

For new connections created with the initial release of the simplifiedconnections page on 2/18/20, the preconfiguration details described inthis section are not required. All WSDLs and URLs are automaticallyidentified for you based on the Oracle ERP Cloud host name that you specifyin the ERP Cloud Host field on the Connections page.

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.

• Obtain the Service Catalog Service WSDL for Releases 10 Through 11

• Obtain the Service Catalog Service WSDL for Release 12

• Obtain the Event Catalog URL

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


2-3

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 theuser’s 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.


2-4

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.

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

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

Obtain 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


2-5

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

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

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

Obtain 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

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.

• Obtain the Service Catalog Service WSDL

• Obtain the Event Catalog URL

Obtain the Service Catalog Service WSDLTo 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-6

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

Obtain the Event Catalog URLStarting 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

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


2-7

Role Description

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

• Select Navigator > Tools > Security Console.

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


2-8

https://docs.oracle.com/en/cloud/saas/applications-common/r13-update17d/faser/provisioning-roles-to-application-users.html#FASER1780839

https://docs.oracle.com/en/cloud/saas/applications-common/r13-update17d/faser/provisioning-roles-to-application-users.html#FASER1780839

https://docs.oracle.com/en/cloud/saas/sales/r13-update17d/oaslm/toc.htm#_Toc468200728_1_12

https://docs.oracle.com/en/cloud/saas/sales/r13-update17d/oaslm/toc.htm#_Toc468200728_1_12

https://community.oracle.com/blogs/jack.desai/2017/11/14/oracle-integration-cloud-fusion-applications-security-requirements

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

Create Connections Based on the User RoleYou can create more than one service integration user account in Oracle FusionApplications for different Oracle Fusion Applications roles that exist to perform differenttasks and then create different Oracle Integration connections using those useraccounts.

For example, you can create multiple connections in Oracle Integration such as ERP1,ERP2, ERP3, and so on and associate each of these connections with a designatedaccount in Oracle ERP Cloud, such as user_integration_1 (general ledger),user_integration_2 (HCM), and user_integration_3 (projects). These actions createdifferent connections for invoking different Oracle ERP Cloud jobs using an OracleFusion Applications user account set up for that job.

Configure 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 password may expire periodically. Yourapplication administrator must contact the Oracle Integrationadministrator to get the refreshed user credentials. The applicationadministrator must update the CSF key when this password is refreshed.

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

• Create the CSF key name. The name must be a combination of the Oracle IdentityCloud Service service ID and the name of the integration instance.

1. In the upper right corner of Oracle Integration, click , then select About.

2. Copy the Identity Domain value (for example, idcs-638a2ce020e60c2881)and the Service Instance value (for example, oic1575).

3. Assemble the CSF key value with the identity domain first and the serviceinstance second (no space in between): idcs-638a2ce020e60c2881oic1575.

• Create the CSF key with the Oracle Integration user account with which you log into Oracle Integration and not the user name created when you subscribed toOracle 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.


2-9

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

2. Click Manage Security.

3. Add the CSF key name. The name must be a combination of the Oracle IdentityCloud Service service ID and the name of the integration instance.

4. Provide the username and password that you enter to log in to Oracle Integration.Do not enter the username and password created when you subscribed to OracleERP Cloud.

The Oracle Integration user must exist in Oracle Integration and have beenassigned the ServiceUser role.

The CSF key entry in the Oracle ERP Cloud infrastructure stores the OracleIntegration credentials used by Oracle ERP Cloud. When Oracle FusionApplications send outbound requests to Oracle Integration (at runtime), it sendsthe credentials (username and password) of this account for authentication.

5. Click Register.

Upload Files in Bulk and Insert Data into Oracle ERP CloudApplication Tables for New Integrations

When using an Oracle ERP Cloud Adapter connection in an existing integration, youmust satisfy the following prerequisites for the upload of files in bulk and the insertionof data into Oracle ERP Cloud application tables.

Upload Based on an ErpImportBulkData Event (New Integrations)

For new integrations based on the ERPBulkImportData event, you must create a CSFkey to subscribe to events. See Configure Oracle ERP Cloud for Event Subscriptions.

Upload Based on a Callback Integration and Version (Existing Integrations)

Note:

For existing callback-based integrations, you do not need to create a CSFkey to subscribe to events.

• 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. Only file-based data import (FBDI)-compliantjobs are supported for callbacks.

1. Create a user similar to the ERP Cloud Adapter connection user in the MyService Page. This user is linked to the Oracle Integration WebLogic securityrealm. The user name must exactly match the Oracle ERP Cloud user name.


2-10

The password and email address can be anything. Ensure that you select thecorrect roles for the Oracle ERP Cloud user in the Oracle ERP Cloudapplication. The user must have the SOAOperator and Integration roles.

2. Import the following certificates:

– In your browser, enter the 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 the X509 certificates section:

– Copy the first certificate string to a file.

Note:

For each certificate file that you create, add your certificate stringbetween the -----BEGIN CERTIFICATE----- and -----ENDCERTIFICATE----- lines for the certificate to be successfullyimported into Oracle Integration. For example:

-----BEGIN CERTIFICATE----- certificate_string-----END CERTIFICATE-----

Otherwise, you may receive an Invalid Certificate error.

– 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, import bothcertificates as Message Protection Certificate types and enter uniquealias names. See Upload an SSL Certificate.


2-11

– 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:

<job package name>,<job def name>,<Manifest file name>,<job parameters (comma separated)>

For example:

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

* 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 filename should be AP.properties and the third value in the manifestshould be the 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 fromthe other 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 targetschema (the target schema is the Oracle ERP Cloud bulk import schema).The FileName must be unique for every request.

Upload Files to Oracle WebCenter ContentIf you want to upload a file to Oracle WebCenter Content (Universal Content Manager)with the Oracle ERP Cloud Adapter, you must satisfy the following prerequisites.

• Create a PGP Public Key:

To upload encrypted files, a PGP public key is required. You must generate thePGP public key and save it for upload. The supported algorithm for the public keyis RSA for encryption and the key size must be 1024 bits in length.

The process for uploading files into Oracle ERP Cloud is:


2-12

– You encrypt files using the Oracle ERP Cloud public key.

– The data-loading process decrypts files using the Oracle ERP Cloud privatekey.

See subsection Generating the PGP Encryption Key Pair of Setting up Encryptionfor File Transfer: Procedure of Cloud Integrating with Oracle HCM Cloud.

• Configure Security and User Access

Once you have configured security groups and doc accounts for the file to upload,you can configure the Oracle ERP Cloud Adapter to upload the file to OracleWebCenter Content.

See Understanding Security and User Access of Administering Oracle WebCenterContent.

Create Custom Business EventsYou can create custom business events in Application Composer that are visible forselection when configuring the Oracle ERP Cloud Adapter as a trigger connection inthe Adapter Endpoint Configuration Wizard. You must access Application Composerthrough the Oracle Fusion Applications user interface. Select ERP and SCM Cloudfrom the Applications list in Application Composer to create the custom objects andpromote them as custom events to be consumed by the Oracle ERP Cloud Adapter.

See technical note 2535444.1 at My Oracle Support for instructions.

Create 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 navigation pane, click Integrations, then click Connections.

2. Click Create.

Note:

You can also create a connection in the integration canvas of:

• An orchestrated integration (See Define Inbound Triggers andOutbound Invokes.)

• A basic routing integration (See Add a Trigger (Source) Connection.)

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 2Create a Connection

2-13

https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=FAIHM1672917

https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=FAIHM1672917

https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=GUID-6F51C790-23CB-480E-A09E-CE007714A2CC

https://www.oracle.com/webfolder/technetwork/tutorials/tutorial/cloud/r13/wn/engagement/releases/19A/19A-engagement-wn.htm#F5090

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 Service Cloud (RightNow)Adapter as only 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.

Add a Contact EmailYou can add an optional contact email address for notifications.

1. In the Email Address field, enter an optional email address. You do not receiveautomatic notifications at this address.

2. In the upper right corner, click Save.

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

1. Click Configure Connectivity.


2-14

The Connection Properties dialog is displayed.The fields that are displayed are based on your version of Oracle Integration.

2. For new connections created with the initial release of the simplified connectionspage on 2/18/20, the ERP Cloud Host field is displayed. Enter the Oracle ERPCloud host name. For example:

https://customer_chosen_domain_name.fa.DC.oraclecloud.com

Note:

The Oracle ERP Cloud host name can easily be derived from the OracleERP Cloud login URL. For example: https://customer_chosen_domain_name.fa.DC.oraclecloud.com/fscmUI/faces/FuseWelcome

3. For existing connections created prior to the initial release of the simplifiedconnections page on 2/18/20, the URL fields are displayed. Specify the URLs touse in this integration.

• ERP Services Catalog WSDL URL

• ERP Events Catalog URL (optional)

• Interface Catalog URL (optional)

For information about obtaining the URL, see Obtain the Oracle ERP CloudService Catalog Service WSDL, Event Catalog URL, or Interface Catalog URL(For Existing Connections Only).

4. Click OK.

5. Configure connection security.

Configure 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. If you want to upload an encrypted file to Oracle WebCenter Content (UniversalContent Management (UCM), select the PGP Public Key for UCM Uploadcheckbox, then click Upload to upload the public key to encrypt the file. The PGPpublic key must already be created. See Upload Files to Oracle WebCenterContent.

Ensure that a unique filename is present in the upload request payload file. See Use a Unique File Name for the Upload Request Payload When using PGPEncryption.


2-15

4. Click OK.

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

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

If your adapter connection uses a WSDL, a dialog is displayed that prompts you toselect the type of connection testing to perform. Otherwise, this step is notapplicable.

• Select the 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 theWSDL. 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.

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

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

Upload 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, anexception is thrown. In that case, you must upload the appropriate certificate. Acertificate enables Oracle Integration to connect with external services. If the externalendpoint requires a specific certificate, request the certificate and then upload it intoOracle Integration.

To upload an SSL certificate:

1. In the navigation pane, click Integrations, then click the < arrow next to Designer.

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

Chapter 2Upload an SSL Certificate

2-16

4. In the Upload Certificate dialog box, select the certificate type. Each certificatetype enables Oracle Integration 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.

Refresh 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:

Note:

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

Chapter 2Refresh Integration Metadata

2-17

1. In the navigation pane, click Integrations, then 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 2Refresh Integration Metadata

2-18

3Add the Oracle ERP Cloud AdapterConnection to an Integration

When you drag the Oracle ERP Cloud Adapter into the trigger or invoke area of anintegration, the Adapter Endpoint Configuration Wizard appears. This wizard guidesyou through the configuration of the Oracle ERP Cloud Adapter endpoint properties.

These topics describe the wizard pages that guide you through configuration of theOracle ERP Cloud Adapter as a trigger or invoke in an integration.

Topics:

• Basic Info Page

• Trigger Request Page

• Trigger Response Page

• Invoke Actions Page

• Invoke Operations Page

• Invoke Response Page

• Summary Page

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

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 theconnection’s responsibilities. For example:This connection receives an inboundrequest to synchronize accountinformation with the cloudapplication.

3-1

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.

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

Select the specific type to receive as a request from Oracle ERP Cloud.

• Receive Business Events raised within ERP Cloud: Select to receive an eventsubscription raised by the Oracle ERP Cloud application as a request from OracleERP Cloud. This selection invokes the integration.

• Receive Callback Message upon Completion of FBDI bulk Import Jobsubmitted via another Integration: Select to configure a callback notificationresponse to send upon completion of the data import into the Oracle ERP Cloudapplication. The bulk data import process you select is received as a request thatstarts the integration.

• Receive Requests from ERP Cloud Applications (explicitly sent from GroovyScript or Business Logic): Select to receive a business object as a request fromthe Oracle ERP Cloud application. This selection invokes the integration.

Chapter 3Trigger Request Page

3-2

Note:

For existing integrations, your ability to select either a business object orevent subscription is based on the content of the WSDL file (for businessobjects) or event catalog URL (for business event subscriptions) youspecified on the Connections page during Oracle ERP Cloud Adapterconfiguration.For new integrations, the WSDL file and event catalog URL do not need tobe supplied.

Receive Business Events raised within ERP Cloud

Element Description

Business Event For Subscription 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.

Any custom business events that you createdand published in the Application Composerapplication are also available for selection.Custom events are identifiable by theirdescription.

Filter By Event Name Type the initial letters of the name to filter thedisplay of business event subscriptions.

Filter Expr for Business_Event_Name 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.

Event Description Displays a description of the selected businessevent.

Chapter 3Trigger Request Page

3-3

Receive Callback Message upon Completion of FBDI bulk Import Job submittedvia another Integration

Element Description

Download Options 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.

Select Bulk Data Import Process Select the bulk data import process to receiveas a request that starts the integration. Youcan also type the initial letters of the name tofilter the display of bulk data import processes.

Not seeing expected Bulk Data ImportProcesses?

If the process you want is not visible, thenverify the following:• Check the Oracle ERP Cloud user roles

assigned to the user. See AssignRequired Roles to an Integration User.

• Check whether the job is an FBDI job.See Bulk Import Troubleshooting Issues.

Description Displays a description of the selected bulkdata import process.

Receive Requests from ERP Cloud Applications (explicitly sent from GroovyScript or Business Logic)

Element Description

Select a Business Object Select the business object from the OracleERP Cloud application to receive as a requestthat starts the integration. A description of thebusiness object is displayed at the bottom ofthe page.

Filter by object name Type the initial letters of the name to filter thedisplay of business objects.

Trigger Response PageEnter the Oracle ERP Cloud operation and business object values that comprise thetrigger response for your integration.

Chapter 3Trigger Response Page

3-4

The Response page looks as follows:

Select the type of response appropriate to your business requirements:

• 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. (See Immediate (Synchronous) Response is Required for instructions.)

• 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. (See Response Type —Delayed (Asynchronous) Response is Required for instructions.)

• No response is required: You select None on the Response page because aresponse is not required. (See Response Type — None for instructions.)

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

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


3-5

Table 3-1 (Cont.) Response Type — Immediate (Synchronous) Response isRequired

Element Description

Description Displays the description of the selectedbusiness object.

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


3-6

Table 3-3 Response Type — None

Element Description

Response Type Select None.

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

Invoke Actions PageSelect the Oracle ERP Cloud invoke option for your integration. These options are onlydisplayed when you are configuring the Oracle ERP Cloud Adapter as an invokeconnection in an integration.

Element Description

What Would You Like to do with the FusionApps Adapter

• Query, Create, Update, or DeleteInformation: Provides the standardconfiguration path for selecting a businessobject or service. This option displays thestandard Operations and Responsepages. This is the default selection.

• Import Bulk Data into Oracle ERPCloud: Provides a scenario for loadingand orchestrating data from a secure FTPlocation 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.

• Send Files to ERP Cloud: Select toupload files to Oracle WebCenter Content(Universal Content Manager) in encryptedor unencrypted format.

Invoke Operations PageEnter the Oracle ERP Cloud invoke operation values for your integration.

See the appropriate section based on your selection on the Actions page:

• Create, Update, Delete, Read Business Object

• Import Bulk Data into ERP Cloud Application

• File Upload to WebCenter (UCM)

Chapter 3Invoke Actions Page

3-7

Create, Update, Delete, Read Business Object

If you selected Create, Update, Delete, Read Business Object on the Actions page,select the business object or service and the operation to perform on the selectedbusiness object or service.

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.

• Business (REST) Resource: Select tobrowse a list of available Oracle FusionApplications REST API resources. Thisoption is only available if you specified aninterface catalog URL in the InterfaceCatalog URL field on the ConnectionProperties page when configuring theOracle ERP Cloud Adapter.

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.

Select a Service Application(displayed if Business (REST) Resources isselected)

Select the service application to see thebusiness resources defined in the application.

Select a Business Resource(displayed if Business (REST) Resources isselected)

Select the parent business resource to use.You can then click Browse and configure achild resource to select the correspondingchild business resources of that parent to use.

Note: Existing integrations created prior to theintroduction of this feature can be edited toselect parent business resources and theircorresponding child business resources.

Chapter 3Invoke Operations Page

3-8

Element Description

Browse and configure a child response Click to access a page to select the following:• The parent and child business resources

of the selected parent business resource• The operation to perform on the parent

and child business resourcesAfter you click Ok, the link name changes toView and edit the configuration of a childresource.

Both the parent and child business resourcesare displayed on the Summary page.

To reset to your original selections, click thislink, then click Reset.

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.

Import Bulk Data into ERP Cloud Application

If you selected Import Bulk Data into ERP Cloud Application on the Actions page,select the job name to import, the job property name, and the type of log data forOracle ERP Cloud to extract. See External Data Integration Services for Oracle Cloud:Overview.


3-9

https://docs.oracle.com/en/cloud/saas/financials/18c/oefbf/External-Data-Integration-Services-for-Oracle-Cloud-Overview.html


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 following information is obtained with eachjob:• 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.

Note:

If import jobs donot appear in thelist, there may beseveral causes.See Jobs NotAppearing in theImport Jobs Liston theOperationsPage.

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.

File Upload to WebCenter (UCM)

If you selected File Upload to WebCenter (UCM) on the Actions page, select thesecurity group and doc account required for uploading the file.


3-10

Element Description

Security Group Select the security group in which to uploadthe file. A security group is a set of filesgrouped under a unique name. Every file inthe content server repository belongs to asecurity group. Access to security groups iscontrolled by permissions assigned to roles onthe content server. Roles are assigned tousers where they are maintained in OracleFusion Applications. The default securitygroup in Fusion Applications isFAFusionImportExport.

Doc Account Select the doc account to assign to the file. InFusion Applications, every content item has anaccount assigned to it. You must have theappropriate permission to the account such asread and/or write. The access to the documentis the intersection between accountpermissions and security group permissions.There are several Fusion Applicationsaccounts.

Encrypt the File Select this checkbox to encrypt the file beforeupload to UCM. To select this checkbox, youmust have selected to encrypt the file whenconfiguring the Oracle ERP Cloud Adapterconnection on the Connections page. See Configure Connection Security.

See Understanding Security and User Access of Administering Oracle WebCenterContent.

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

Element Description

Notification Mode Select an option for being notified of dataimport completion status. These options areconfigured in the Oracle ERP Cloudapplication. This information is sent fromOracle Integration to the Oracle ERP Cloudapplication.• 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

Chapter 3Invoke Response Page

3-11

https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=GUID-6F51C790-23CB-480E-A09E-CE007714A2CC

Element Description

Enable Callback Select to enable callback behavior for theimport job selected on the Operations page.When you select this option for newintegrations, the ErpImportBulkData eventof Oracle ERP Cloud is raised once the importjob completes.

When you select this option for existingintegrations, you must also provide thecallback integration and callback identifierdescribed in the fields below.

Integration Flow Identifier(This field is visible when using an Oracle ERPCloud Adapter connection in an existingintegration.)

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 only required to trigger asecond integration. Otherwise, this field can beleft blank. The inbound integration is expectedto handle callbacks from Oracle ERP Cloud.The integration must have an Oracle ERPCloud Adapter configured in the trigger(inbound) direction. You select As a Callbackon the Request page in the trigger direction.

Integration Flow Version(This field is visible when using an Oracle ERPCloud Adapter connection in an existingintegration.)

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

Summary PageYou can review the specified adapter configuration values 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. Click Cancel to cancelyour configuration details.

Chapter 3Summary Page

3-12

4Implement Common Patterns Using theOracle ERP Cloud Adapter

You can use the Oracle ERP Cloud Adapter to implement the following commonpatterns.

Topics:

• Configure Callbacks

• Upload a File to Oracle WebCenter Content

• Invoke an Endpoint Dynamically

• Invoke a File-Based Data Import (FBDI) Job

• Invoke a Non-File-Based Data Import (FBDI) Job

Configure CallbacksFor new integrations, you do not need to consume an explicit event when configuringthe Oracle ERP Cloud Adapter as a trigger connection on the Request page. Whenyou design a callback integration, you select the Receive Callback Message uponcompletion of FBDI bulk import job submitted via another integration option onthe Request page.

After selecting this option, you must select the specific bulk data import process forwhich the callback event is received. When this callback integration is activated, eventsubscription automatically occurs.

Once the import job completes, the event is raised by the Oracle ERP Cloudapplication. The Oracle ERP Cloud application then invokes the Oracle Integrationendpoint that is the callback integration.

Also ensure that the CSF key is created because this design is now event-based. See Configure Oracle ERP Cloud for Event Subscriptions.

Upload a File to Oracle WebCenter ContentYou can upload a file to Oracle WebCenter Content (Universal Content Manager) withthe Oracle ERP Cloud Adapter. The file to upload can be either encrypted orunencrypted. This section provides a high-level overview for performing this scenario.

To upload a file to Oracle WebCenter Content:

1. Create an Oracle ERP Cloud Adapter connection with the Invoke role. Duringconnection configuration, you can select to optionally encrypt the file to upload byselecting the PGP Public Key for UCM Upload checkbox.

4-1

2. Create an orchestrated integration.

3. Drag the Oracle ERP Cloud Adapter to the invoke part of the integration canvas.This invokes the Adapter Endpoint Configuration Wizard.

4. On the Actions page, select File Upload to WebCenter (UCM).

5. On the Operations page, select the following mandatory values:

• Security Group: Select the security group to which the file to upload belongs.A security group is a set of files grouped under a unique name. Every file inthe UCM server repository belongs to a security group. Access to securitygroups is controlled by permissions assigned to roles on the content server.Roles are assigned to users where they are maintained on Oracle FusionApplications. The default security group in Fusion ApplicationsFAFusionImportExport.

• Doc Account: Select the doc account for the file to upload. In FusionApplications, every content item has an account assigned to it. You must havethe appropriate permission to the account such as read and/or write. Access tothe document is the intersection between account permissions and securitygroup permissions.

Chapter 4Upload a File to Oracle WebCenter Content

4-2

6. If you selected to encrypt the file to upload on the Connections page in Step 1,select Encrypt the File.

7. Once the UCM file upload endpoint is saved, provide the reference to the file toupload to UCM.

You can also override the security group and doc account that you previously setby hard coding new values in the mapper that receive reference during runtime.

If file upload is successful, a document ID is returned. Use the document ID fordownstream processing.

8. Complete design of the integration.

Chapter 4Upload a File to Oracle WebCenter Content

4-3

Invoke an Endpoint DynamicallyYou can dynamically invoke a REST endpoint/URL at runtime without configuringadditional invoke connection or REST outbound details. As long as the Oracle ERPCloud REST APIs return a response with HATEOS links, you can use this feature bymapping the HATEOS link to the invoke connection. This feature is useful in situationsthat require invoking a REST endpoint dynamically or when the endpoint is not knownat design time. This feature is also useful in situations that require invoking multipleREST services, all of which accept the same input payload and return the same

Chapter 4Invoke an Endpoint Dynamically

4-4

response payload as configured for the outbound endpoint. For these cases, thisfeature eliminates the need to create multiple connections to invoke each RESTendpoint.

Note:

Note the following restrictions.

• The request and response schema must be the same as provided duringendpoint configuration.

• Template parameters are not supported while mapping these properties.

• The HTTP verb cannot be changed for the endpoint URL. For example, ifthe endpoint is configured to use POST, the outgoing request usesPOST even if the endpoint URI changes at runtime.

• Because the endpoint URL is determined at runtime, there is no facilityto test whether the security credentials provided during connectionconfiguration also work with the new endpoint URL. If you think theendpoint URL determined at runtime requires a different authorizationheader then the original URL, you may need to provide a mapping forthe authorization standard header.

This use case provides a high level overview of one way to design an integration thatuses dynamic endpoints. You retrieve child objects using the REST API (for example,Primary Address is a child object of the Account parent object). The integration isdesigned as follows.

• An initial invoke is configured to get the Account object by using the REST API.The response of this REST API does not provide the child objects. Instead, thereare HATEOS links to the child objects (that is, the Primary Address object).

• A second invoke uses the HATEOS links from the earlier response to makeanother invoke connection to the REST endpoint to fetch the child PrimaryAddress object using dynamic REST endpoint support.

To change the endpoint configuration at runtime, you map one or more of the variousproperties under the ConnectivityProperties target element.

1. Create an orchestrated integration.

2. Drag an adapter into the integration canvas as an trigger connection (it can be anyadapter).

3. Configure the adapter in the Adapter Endpoint Configuration Wizard.

4. Drag an initial Oracle ERP Cloud Adapter into the integration canvas as an invokeconnection.

5. Configure it to use the crmRestApp service application, the Account object(business resource), and the get operation.

The response of the first invoke connection contains a collection of HATEOS links,each pointing to a child object such as Primary Address.

6. In the mapper between the trigger adapter connection and the Oracle ERP CloudAdapter invoke connection, map source elements to target elements. For thisexample, a PartyNumber source element is passed to an id target element.


4-5

7. Add a for-each action to iterate between the HATEOS links. The value in theRepeating Element field is from the response object.

8. Add a switch action to get the HATEOS link corresponding to the PrimaryAddress object.

9. Drag the Oracle ERP Cloud Adapter into the switch action as the second invokeconnection.

10. Configure it to use the crmRestApp service application, the Primary Addressobject (business resource), and the getAll operation. This object uses dynamicREST endpoint support. The Primary Address is a collection of links. The getAlloperation is selected for getting all the HATEOS links.

11. In the mapper immediately before the second Oracle ERP Cloud Adapter invokeconnection, expand RestApi under ConnectivityProperties in the target section.

12. From the source section, map href to AbsoluteEndpointURI underConnectivityProperties. The ConnectivityProperties schema element supportsdynamic REST endpoints. The href element points to the Primary Address objectlink. The href element is invoked by the Oracle ERP Cloud Adapter.


4-6

13. If necessary, map other nodes under ConnectivityProperties. The runtime valuesprovided by these mappings dynamically configure the request.

You can also hover the cursor over these properties for brief descriptions.

Element Description

AbsoluteEndpointURI Represents the absolute endpoint URL thatthe REST Adapter invokes. Empty valuesare ignored. To route the request to anendpoint URL determined at runtime,provide a mapping for this element.AbsoluteEndpointURI takes firstprecedence among other URL-relatedproperties under ConnectivityProperties.

BaseUri The equivalent of the base URL providedduring connection configuration. Tosubstitute only the base URI and retain therest of the URL, provide a mapping for thiselement. The mapping is ignored ifAbsoluteEndpointURI has a nonemptyruntime value.

RelativeUri Forms the part of the endpoint URI betweenBaseUri and ?. The mapping has no effectif BaseUri has an empty runtime value orAbsoluteEndpointURI has a nonemptyruntime value. The runtime value must startwith a /.

Uri Use the various elements under this node tosubstitute runtime values for the specificparts of an endpoint URL.

Scheme Provide a mapping to change only thescheme of the endpoint URL. Supportedvalues are HTTP and HTTPS.

Host Provide a mapping to change only the Hostportion of the endpoint URL


4-7

Element Description

Port Provide a mapping to change only the portof the endpoint URL.

Query Provide a mapping to change only the queryportion of the endpoint URL. A query portionfollows the ?.

Path Provide a mapping to change only the pathportion of the endpoint URL. A Path is thepart of a URI between the hostname and ?.

Plugin The various properties under this nodeimpact the way the REST Adapter invokesthe endpoint URL.

PostQueryString When the runtime value is true and theHTTP verb is POST, the query stringparameters are sent using POST as formparameters. The default is false.

UseFormUrlEncoding When the runtime value is false, the RESTAdapter uses RFC 3986-compliant encodingto encode the query parameters. The defaultis true. This is the equivalent of setting thecustom header x-ics-use-x-www-form-urlencoded to false. See section “RFC3986 Support for Encoding QueryParameters” for more information on x-ics-use-x-www-form-urlencoded. x-ics-use-x-www-form-urlencoded takes precedencewhen both are set.

14. Drag an FTP Adapter to the switch action for writing the Primary Address objectresponse to a file on an FTP server.

15. In the mapper between the Oracle ERP Cloud Adapter and the FTP Adapter, mapthe Primary Address object details.

16. When complete, integration design looks as follows:


4-8

17. Activate and invoke the integration. The Oracle ERP Cloud Adapter invokes theendpoint URI determined at runtime.

Invoke a File-Based Data Import (FBDI) JobTo invoke an FBDI job, follow the steps described in this section.

1. Determine whether the job is an FBDI process. See File-Based Data Import forOracle Financials Cloud for a list of FBDI jobs.

2. To invoke and configure an FBDI job, select Import Bulk Data into Oracle ERPCloud on the Actions page of the Adapter Endpoint Configuration Wizard. See Invoke Actions Page.

3. Go to the Operations page of the wizard. See Invoke Operations Page.

4. Go to the Response page. The following functionality is provided:

• For new integrations based on the ErpImportBulkDataEvent event:Select the Enable Callback check box. The Oracle ERP Cloud Adapter hasbeen enhanced to enable raising the ErpImportBulkDataEvent event on theOracle ERP Cloud application when the import job completes. The IntegrationFlow Identifier and Version fields have been removed because the callbackintegration now subscribes to the ErpImportBulkDataEvent event.

• For older, existing callback-based integrations:Select the Enable Callback check box and continue to manually specifydetails in the Integration Flow Identifier and Version fields. TheErpImportBulkDataEvent event is not used.

Chapter 4Invoke a File-Based Data Import (FBDI) Job

4-9

https://docs.oracle.com/en/cloud/saas/financials/r13-update17d/oefbf/FBDIOverview.html


5. To invoke the FBDI job, you need a ZIP file consisting of a data file in CSV formatand a manifest/properties file that has job details such as job name and itsparameters.

The following documentation provides additional information:

• ERP Integration Services - Import Data (Overall generic bulk import process)

• Bulk Import (FBDI) - How to get job definition & package name includingparameters (How to get the job definition and parameter details of a selected job)

• Fusion Applications Security Requirements blog (Oracle Fusion Applicationssecurity requirements of the user used in the connection)

• ERP Integration Callback Implementation in Oracle Integration blog (Callback)

• Using External Data Integration Services for Oracle ERP Cloud

Video

Invoke a Non-File-Based Data Import (FBDI) JobTo invoke a non-FBDI job, follow the steps described in this section.

1. Determine whether the job is an FBDI process. See File-Based Data Import forOracle Financials Cloud.

2. If the job is non-FBDI, perform the following steps:

a. Generate the data file based on the template and upload it to OracleWebCenter Content (Universal Content Manager). Use eitherERPIntegrationService::uploadFileToUCM or the Universal Content ManagerAPI /fscmService/GenericSoapPort.

b. Invoke ERPIntegrationService::submitEssJobRequest.

c. Invoke ERPIntegrationService::getEssJobStatus to get the status of the job.You may need to invoke it multiple times to get the final status.

d. Invoke ERPIntegrationService::downloadEssJobExecutionDetails for the logs.

Chapter 4Invoke a Non-File-Based Data Import (FBDI) Job

4-10

https://cloudcustomerconnect.oracle.com/posts/4de059f07b

https://cloudcustomerconnect.oracle.com/posts/473fdc5877

https://cloudcustomerconnect.oracle.com/posts/473fdc5877

https://blogs.oracle.com/fmw/oracle-integration-cloud-oic-fusion-applications-security-requirements

https://blogs.oracle.com/fmw/erp-integration-callback-implementation-in-oracle-integration-cloud-oic

https://support.oracle.com/epmos/faces/DocumentDisplay?id=2102800.1

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



5Troubleshoot the Oracle ERP CloudAdapter

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

Topics:

• Bulk Import Troubleshooting Issues

• Business Event Troubleshooting Issues

• Oracle ERP Cloud Adapter Error Messages

• Reactivate Integrations when the Connection URL is Modified

• Use a Unique File Name for the Upload Request Payload When using PGPEncryption

• Import Payables Invoice Report Job is Not Triggered

• Oracle ERP Cloud Callback Not Received in Oracle Integration

• Error When Discovering REST Services through the Oracle ERP Cloud Adapter

• Oracle Universal Content Management (UCM) File Upload Failure

Additional integration troubleshooting information is provided. See TroubleshootOracle Integration in Using Integrations in Oracle Integration.

Bulk Import Troubleshooting IssuesThis section describes bulk import troubleshooting issues.

Topics:

• How to Pass an Interface Request ID to an Import Job in a Bulk Import Process

• Bulk Data Import Implementation Recommendations

• Create a Job Property File for the importBulkData Operation

• Error Response Received When Invoking a Bulk Import with the Oracle ERPIntegration WSDL

• Use the importBulkData Operation and its Parameters

• Import Bulk Data into ERP Cloud Application Option Must Be Reselected in anImported Integration

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

• Receive a Callback from an ExportBulkData Operation

• Configure the Callback for the ExportBulkData Operation

• Oracle ERP Cloud Callback About the Bulk Import Issue

5-1

How to Pass an Interface Request ID to an Import Job in a Bulk ImportProcess

To add a request ID ({req_id}) as a parameter in the manifest file/properties file, passthe request ID in a parameter list as {req_id}. This dynamically retrieves the loadrequest ID in Oracle ERP Cloud and enables the import process to continue.

Bulk Data Import Implementation RecommendationsIf you want to use the bulk data import feature with Oracle ERP Cloud, it isrecommended that you select the Import Bulk Data into Oracle ERP Cloud optionon the Actions page of the Adapter Endpoint Configuration Wizard, and not use theweb service APIs.

However, if you instead directly use the ERPIntegrationService web service (andimportBulkData operation) for bulk data imports, ensure that the properties for thejobOptions parameter are set to values. For example:

<jobOptions>ExtractFileType=ALL,InterfaceDetails=TO_DETERMINE<jobOptions>

The jobOptions parameter is required for all FBDI imports and is required to receivecallbacks.

Note that if you select the Import Bulk Data into Oracle ERP Cloud option on theActions page of the Adapter Endpoint Configuration Wizard, this task is not required.

See Using External Data Integration Services for Oracle ERP Cloud of External DataIntegration Services for Oracle Cloud: Overview.

Create a Job Property File for the importBulkData OperationYou can generate the job property file for each job to further simplify the requestpayload of the importBulkData operation.

See the following documentation for details:

1. See Using External Data Integration Services for Oracle ERP Cloud of ExternalData Integration Services for Oracle Cloud: Overview.

a. Scroll to the bottom and see the Oracle Support Services link under RelatedTopics: Using External Data Integration Services for Oracle ERP Cloud.

b. Scroll to the Attachments section at the bottom of the link and see Appendix12: Creating a Job Property File for the importBulkData Operation in the UsingExternal Data Integration Services guide appropriate to your Oracle FusionApplications release.

2. See Oracle Integration and ERP Cloud - How to get Job Name and Parameters ofERP Bulk Import Jobs.

Chapter 5Bulk Import Troubleshooting Issues

5-2





https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=389133729727403&id=2102800.1&_afrWindowMode=0&_adf.ctrl-state=qzrqy7lqf_151

https://blogs.oracle.com/fmw/oracle-integration-and-erp-cloud-how-to-get-job-name-and-parameters-of-erp-bulk-import-jobs

https://blogs.oracle.com/fmw/oracle-integration-and-erp-cloud-how-to-get-job-name-and-parameters-of-erp-bulk-import-jobs

Error Response Received When Invoking a Bulk Import with theOracle ERP Integration WSDL

If you receive an error when trying to perform a bulk import using the importBulkDataoperation of the ERP Integration Service WSDL, ensure that you are correctly usingthe Oracle ERP Cloud Adapter to perform this task.

See Invoke a File-Based Data Import (FBDI) Job.

Use the importBulkData Operation and its ParametersIf you use the importBulkData operation through the ERPIntegrationService webservice. InterfaceDetails is not mandatory as importBulkData should implicitly find outbased on job and package name. Is that not the case? However, ExtractFileType isrequired for callback process to zip log/out files and upload to UCM. If job parametersare incorrect, it should throw fault as job will fail to execute. However properties in<jobOptions> such as ExtractFileType is not a parameter and not mandatory. Weshould extend our troubleshooting section in our doc to include this. We should alsoenforce customer to use ERP adapter import wizard instead of SOAP adapter - theyare not getting any extra features by going through SOAP adapter with CRUD option.

See Using External Data Integration Services for Oracle ERP Cloud of External DataIntegration Services for Oracle Cloud: Overview.

Import Bulk Data into ERP Cloud Application Option Must BeReselected in an Imported Integration

If you import an integration using the bulk data import feature into another instance,the Import Bulk Data into ERP Cloud Application option on the Actions page of theAdapter Endpoint Configuration Wizard is not selected. Instead, the initial option onthis page is selected. You must open the Adapter Endpoint Configuration Wizard inedit mode, reselect the Import Bulk Data into ERP Cloud Application option, saveyour changes, and activate the integration. If you later re-import this integration intoanother instance, the Import Bulk Data into ERP Cloud Application option iscorrectly selected. This issue only occurs with the initial import.

Jobs Not Appearing in the Import Jobs List on the Operations PageIf you selected Import Bulk Data into ERP Cloud Application on the Actions page,you can specify the import job to import on the Operations page of the AdapterEndpoint Configuration Wizard. If the job does not appear in the Import Job Namelist, the causes may be as follows:

• Only File-Based Data Imports (FBDI)-compliant jobs are visible. FBDI jobs aredescribed in File-Based Data Imports of Cloud File Based Data Import for OracleFinancials Cloud.

• Your user account may not have the correct roles. See Assign Required Roles toan Integration User.

See Import Bulk Data into ERP Cloud Application.


5-3




Receive a Callback from an ExportBulkData OperationTo receive a callback from an ExportBulkData operation, you can also configureevents in the callback integration. An event is a good alternative if there are issueswhen using the ExportBulkData callback operation in the callback integration. Bothmethods are supported.

Configure the Callback for the ExportBulkData Operation

ExportBulkData operation behavior is different from ImportBulkData operationbehavior. The approach used with ImportBulkData to configure a callback integrationdoes not work with ExportBulkData.

To consume the callback received from ExportBulkData, you must configure theintegration as follows:

1. Create an integration with an event as a trigger (ensure that you create the CSFkey).

2. Subscribe to an Oracle ERP Cloud integration outbound event with the OracleERP Adapter. Do not add any filter; use the default.

3. Parse the payload to get the document ID.

{ "JOBS": [ { "JOBNAME": "TEST PO Extract Extract Job", "JOBPATH": "/oracle/apps/ess/custom/int", "REQUESTID": "9519", "STATUS": "SUCCEEDED", "DOCUMENTNAME": "ExportBulkData_TESTPOEXTACT_9519"

}, { "JOBNAME": "Upload Interface Error and Job Output File to Universal Content Management", "JOBPATH": "/oracle/apps/ess/financials/commonModules/shared/common/interfaceLoader", "REQUESTID": "9520", "STATUS": "SUCCEEDED", "DOCUMENTNAME": "ExportBulkData_TESTPOEXTACT_9519" } ], "SUMMARYSTATUS": "SUCCEEDED", "DOCUMENTID": "10174", "DOCUMENTNAME": "ExportBulkData_TESTPOEXTACT_9519"}

4. Use the SOAP Adapter to download the file from Universal Content Manager(UCM) using the above document ID.

5. Continue using the SOAP Adapter because it supports attachments.

6. In the integration that invokes the ExportBulkData operation, open the mapper.


5-4

7. Add EnableEvent=Y in the jobOptions element of the exportBulkData operation.

Oracle ERP Cloud Callback About the Bulk Import IssueIf Oracle Integration does not receive an Oracle ERP Cloud callback about the bulkimport, it is likely due to an incomplete prerequisite to using the adapter.

See Upload Files in Bulk and Insert Data into Oracle ERP Cloud Application Tables forNew Integrations.

Business Event Troubleshooting IssuesThis section describes business event troubleshooting issues.

Topics:

• Event Subscription Error Troubleshooting

• Business Events Being Sent to Deactivated Integrations

Event Subscription Error TroubleshootingTo 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 user account.

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

• The Oracle Integration instance changed. If this occurs, you must create a newCSF key.

Ensure that you carefully following the instructions in Configure Oracle ERP Cloud forEvent Subscriptions to correctly create the CSF key.

Business Events Being Sent to Deactivated IntegrationsOracle ERP Cloud business events to which you are subscribed in an integration arenot removed when the integration is deactivated/removed. Events continue to be sentto the integration instance. Use the FApps API to remove the subscriptions. You must

Chapter 5Business Event Troubleshooting Issues

5-5

identify the subscriptions related to integrations that are no longer active before youcan remove them.

• To get subscriptions, use the REST URL and the GET HTTP method:

http://server:port/soa-infra/PublicEvent/subscriptions/

Sample response:

{ "subscriptions": [ { "id": 101, "name":"{http://xmlns.oracle.com/apps/scm/doo/decomposition/DooDecompositionOrderStatusUpdateComposite/AggregatedBusinessEvent}AggregatedBusinessEvent", "filter": "<xpathExprxmlns:ns_2='http://xmlns.oracle.com/apps/scm/doo/common/events/service/'>$eventPayload/ns_2:SourceOrderSystem = 'LEG'</xpathExpr>", "endpointURL":"http://slc01fqy.us.oracle.com:7001/soa-infra/services/default/ PublicEventSubscriber/subscriberprocess_client_ep" }, { "id": 102, "name":"{http://schemas.oracle.com/events/edl/Bpel20EssJobEvents}EssJobRequest", "filter": "<xpathExprxmlns:ns2='http://schemas.oracle.com/events/edl/Bpel20EssJobEvents'>/ ns2:a/ns2:b < 200</xpathExpr>", "endpointURL": "http://my.service.com:9000/EssJob" } ]}

• To get a specific subscription, use the REST URL and the GET HTTP method:

http://server:port/soa-infra/PublicEvent/subscriptions/{id}

For example:

http://server:port/soa-infra/PublicEvent/subscriptions/102

Sample output:

{ "id": 102, "name":"{http://schemas.oracle.com/events/edl/

Chapter 5Business Event Troubleshooting Issues

5-6

Bpel20EssJobEvents}EssJobRequest", "filter": "/ns2:a/ns2:b < 200", "endpointURL": "http://my.service.com:9000/EssJob" }

• To manually delete subscriptions, use the REST URL and the DELETE HTTPmethod:


Sample input:

curl -X DELETE --user weblogic:passwordhttp://server:port/soa-infra/PublicEvent/subscriptions/102

• To update and activate/deactivate the subscriptions, use the REST URL and thePUT HTTP method:


Sample input:

{ "id": 102, "name":"{http://schemas.oracle.com/events/edl/Bpel20EssJobEvents}EssJobRequest", "filter": "/ns2:a/ns2:b < 200", "endpointURL": "http://my.service.com:9000/EssJob", "state" : true

• To activate/deactivate the subscription, use "state" : true/false.

Use a Unique File Name for the Upload Request PayloadWhen using PGP Encryption

If you select to upload a PGP public key on the Connections page, a unique filenamemust be present in the upload request payload file. If the same file name used foruploading is also used to load data into the Oracle ERP Cloud interface table, thesame name is detected in Oracle WebCenter Content (Universal ContentManagement (UCM) and the file is not loaded.

Oracle ERP Cloud Adapter Error MessagesNote the following Oracle ERP Cloud Adapter error messages and possible causes.

Chapter 5Use a Unique File Name for the Upload Request Payload When using PGP Encryption

5-7

Error Code Number Error Message Error Code Purpose

CA-ERP-001 Unable to verify the call-back message sent by ERP Cloud hence the call-back request sent by ERP Cloud is not processed. Please ensure the steps described in the link https://docs.oracle.com/en/cloud/paas/integration-cloud/erp-adapter/prerequisites-creating-connection.html#GUID-D4CF2D13-326D-41A2-A119-B932859C7041have been completed prior to executing the integration flow that submits bulk data importrequest to ERP Cloud.

When a callback message isnot processed due toprerequisites not beingexecuted.

CA-ERP-002 The user is not created in ICS/OIC. Please execute #1 in the pre-requisites link.

A specific exception when auser is not created.

CA-ERP-003 The certificates are not imported in ICS/OIC. Please execute #2 in the pre-requisiteslink

A specific exception whencertificates are not created.

Chapter 5Oracle ERP Cloud Adapter Error Messages

5-8

Error Code Number Error Message Error Code Purpose

CA-ERP-004 Unable to process the callback message due to incomplete payload sent by ERP Cloud.The payload sent by ERP Cloud application is not having Document ID and hence the bulk data import job specific report & log files could not be downloaded from ERP Cloud (UCM).

Please verify the payload sent by ERP Cloud.

You would want to visit the troubeshooting section here http://www.oracle.com/pls/topic/lookup?ctx=oic&id=ICSER-GUID-82650DE7-6A3B-4070-B149-03F1A5922681for probable solution.

The payload sent by ERP Cloud is as follows.

When documentID is NULL inthe callback payload.

Import Payables Invoice Report Job is Not TriggeredIf 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.

Chapter 5Import Payables Invoice Report Job is Not Triggered

5-9

Reactivate Integrations when the Connection URL isModified

Reactivate an integration when callbacks fail because subscriptions are not present inOracle ERP Cloud or there are misdirected callbacks from Oracle ERP Cloud toOracle Integration due to a change in the Oracle ERP Cloud URL used in the OracleIntegration connection. During reactivation, Oracle Integration resubscribes to theOracle ERP Cloud application.

Oracle ERP Cloud Callback Not Received in OracleIntegration

If you have configured a callback for FBDI-compliant import jobs, after the import jobcompletes processing, the Oracle ERP Cloud application should invoke the OracleIntegration endpoint that has the Oracle ERP Cloud Adapter in the trigger. This is thecallback that Oracle Integration receives from the Oracle ERP Cloud application.

If this callback is not received, verify the following steps.

• Verify the callback integration details in the integration where the import job isinvoked. See the Response page of the Adapter Endpoint Configuration Wizard.Also ensure that the callback integration is activated.

• Review the Oracle Integration server diagnostic logs exceptions.

– Security exception related to certificates

Caused by: oracle.wsm.security.SecurityException: WSM-00138 : The path to the certificate is invalidValidation failed for the certificate "Subject DN:- CN=service, DC=us, DC=oracle, DC=com, Serial Number:- 1456606801892, Issuer DN:-

Chapter 5Reactivate Integrations when the Connection URL is Modified

5-10

CN=CertGenCA,OU=FOR TESTING ONLY, O=MyOrganization, L=MyTown, ST=MyState, C=US"at oracle.wsm.security.jps.WsmKeyStore.throwFailMsgForCertPathValidation(WsmKeyStore.java:831)at oracle.wsm.security.jps.WsmKeyStore.validateCertificatePath(WsmKeyStore.java:798)at oracle.wsm.security.jps.WsmKeyStore.validateCertificatePath(WsmKeyStore.java:743)at oracle.wsm.security.policy.scenario.util.ScenarioUtils.verifyAssertionIssuerCert(ScenarioUtils.java:5263)... 42 moreCaused by: java.security.cert.CertPathValidatorException: Path does not chain with any of the trust anchorsat sun.security.provider.certpath.PKIXCertPathValidator.engineValidate(PKIXCertPathValidator.java:208)at java.security.cert.CertPathValidator.validate(CertPathValidator.java:279)at oracle.wsm.security.jps.WsmKeyStore.validateCertificatePath(WsmKeyStore.java:788)... 44 more

Solution: Import the certificates as message protection certificates. See Upload an SSL Certificate.

– Security exception related to user authentication.

The following exception is shown.

Caused by: javax.security.auth.login.FailedLoginException: [Security:090304]Authentication Failed: User CASEY.BROWN javax.security.auth.login.FailedLoginException: [Security:090302]Authentication Failed: User CASEY.BROWN denied

Solution: The user has not been created in Oracle Integration. See UploadFiles in Bulk and Insert Data into Oracle ERP Cloud Application Tables forNew Integrations.

– Exception-related to non-FBDI jobs.

Only FBDI-compliant jobs are supported. If you selected any non-FBDIcompliant job such as submitJobWithOutput, there is an exception in theserver diagnostic logs. This is a JSON parsing exception.

[2017-06-15T07:47:56.108+00:00] [ics_server2] [ERROR] [] [oracle.soa.adapter] [tid: [ACTIVE].ExecuteThread: '30' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: <anonymous>] [ecid:271d2252-d7d9-4763-8ddf-542eb528a062-000c07b6,0] [APP: Cloud Adapter

Chapter 5Oracle ERP Cloud Callback Not Received in Oracle Integration

5-11

Inbound Http App] Unexpected char=R[[javax.json.stream.JsonParsingException: Unexpected char=R

Solution: Only FBDI-compliant jobs are supported for bulk import. The FBDI-complaint jobs are described in File-Based Data Import for Oracle FinancialsCloud.

– No exception in the server diagnostic logs

If there is no exception in the Oracle Integration server diagnostic logs, verifythe following:

1. If the environment is for development, then the certificate must beimported in the Oracle ERP Cloud application.

2. Verify the certificate. It should be CA authorized as VeriSign Class 3Public Primary Certification Authority - G5.

3. Check for a connectivity issue between the Oracle ERP Cloud applicationand Oracle Integration.

Download the Oracle ERP Cloud logs or raise a service request to obtainthe logs and look for exceptions such as the following.

[2017-11-17T17:17:38.813+00:00] [FinancialCommonServer_1] [ERROR] [][oracle.webservices.jaxws] [tid: pool-34-thread-1] [userId: HGV_FIN] [ecid: 005NZ3JJuRhA9T3_RlP5id0002yy000005,1:56507] [APP: FinancialCommonApp#V2.0]

[FlowId: 0000LzAxe0DFc5g_pDL6iY1PzJyH00000v] Error while

Chapter 5Oracle ERP Cloud Callback Not Received in Oracle Integration

5-12



invoking endpoint"https://icsprod-axxxxxx.integration.us2.oraclecloud.com:443/integration/flowsvc/erp/RECVFEEDBACK/v01/" from client; Security Subject: HGV_FIN

Raise a service request. Some pointers where the issue may be are asfollows.

* Execute wget endpoint URL from the primary and secondary FINcommon servers and open a CX ticket if needed to troubleshoot.Check the proxy settings.

$ wget https://icsprod-a111111.integration.us2.oraclecloud.com/ics/faces/global

--2017-10-17 10:49:39-- https://icsprod-a111111.integration.us2.oraclecloud.com/ics/faces/globalResolving marlicsdev-a111111.integration.us2.oraclecloud.com... 111.11.1.11Connecting to marlicsdev-a111111.integration.us2.oraclecloud.com|111.11.1.18|:443...

If the output of the command only says connecting to, open aservice request to resolve the issue.

Error When Discovering REST Services through the OracleERP Cloud Adapter

You can receive the following error when trying to discover REST services through theOracle ERP Cloud Adapter.

If you do, verify that you also receive the error outside of Oracle Integration by runningthe curl command described in the Goal section of Doc ID 2576807.1 at My OracleSupport (MOS). If the error occurs, follow the steps in this MOS document to resolvethis issue.

An error occurred while loading the application catalog, ERROR: Exception while parsing the REST application catalog fscmRestApp. Error accessing the URL: https://hostname.oraclecloud.com:443/fscmRestApi/resources/latest/describe?metadataMode=minimal - received HTTP Response Code: 400; Reason Bad Request. This might be because REST APIs are not enabled on the application. Please contact your Application Administrator.

Chapter 5Error When Discovering REST Services through the Oracle ERP Cloud Adapter

5-13

https://support.oracle.com

https://support.oracle.com

Oracle Universal Content Management (UCM) File UploadFailure

Oracle UCM file upload may fail intermittently in the Oracle ERP Cloud Adapter. Thisis due to the need to clear the browser cache and cookies each time the integrationruns. As a workaround to performing this task each time, perform the following steps.

1. Edit the integration.

2. Open the mapper in edit mode for the Oracle ERP Cloud Adapter invokeconnection.

3. Map a unique filename value to the docTitle target element in the mapper.

For example, map the following:/$downloadToICS/DownloadFileToICSResponse/DownloadResponse/ICSFiles/ICSFile/Properties/filename to /FileUpload/docTitle

4. Save your changes and rerun the integration to resolve this issue.

Chapter 5Oracle Universal Content Management (UCM) File Upload Failure

5-14