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

of 91 /91
Oracle® Cloud Using the Oracle ERP Cloud Adapter with Oracle Integration E85427-32 February 2020

Author: others

Post on 13-Jul-2020

17 views

Category:

Documents


0 download

Embed Size (px)

TRANSCRIPT

  • 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

    PrefaceAudience vi

    Documentation Accessibility vi

    Related Resources vi

    Conventions vii

    1 Understand the Oracle ERP Cloud AdapterOracle 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 ConnectionPrerequisites 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 IntegrationBasic 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 AdapterConfigure 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 AdapterBulk 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=docacchttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacchttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infohttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infohttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trshttp://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.comhttps://www.oracle.com/pls/topic/lookup?ctx=oic&id=ICSUG-GUID-1A01B559-8A46-4D9E-8313-E5400C3A0C9Bhttps://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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-4

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

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    InspectionBusinessEvent: Thisevent signalsInspectionBusiness israised.

    IpEventId

    - newValue

    - oldValue

    InspectionName

    - newValue

    - oldValue

    ActionTaken

    - newValue

    - oldValue

    19A N/A

    Inventory Management

    SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-5

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    BuyerManagedTransportation

    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

    R11 SOAP Service:ReceivingTransactionService

    Operation: findTransaction

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-6

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    CreateReceivingReceipt Event:Notifies that areceipt iscreated inOracle FusionReceivingCloud.

    ShipmentHeaderId

    ReceiptNum

    ReceiptSourceCode

    RcvOrganizationId

    AsnType

    AsnNumber

    SfoTransaction

    DropShipTransaction

    BuyerManagedTransportation

    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

    R11 SOAP Service:ReceivingTransactionService

    Operation: findTransaction

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-7

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-8

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-9

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-10

  • Maintenance

    SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-11

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-12

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-13

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-14

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    SupportedBusinessEvents

    Event Payload First Release Callback Service

    Print ProductLabel Event:Signals that aprint productlabel istriggered

    WorkOrderNumber

    WorkOrderId

    OrganizationCode

    OrganizationId

    ItemNumber

    InventoryItemId

    OperationTransactionId

    InvTransactions

    - InvTransactionId

    SerialNumbers

    - SerialNumber

    R13 18B NA

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-15

  • Manufacturing and Maintenance

    SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-16

  • SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-17

  • Product Lifecycle Management

    SupportedBusinessEvents

    Event Payload First Release Callback Service

    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

    R13 18B SOAP Service:ChangeOrderService

    Operation: getChangeOrder

    Change OrderInterimApproval Event:Signals that achange order isin interimapproval.

    ChangeId

    - newValue

    - oldValue

    StatusType

    - newValue

    - oldValue

    R13 18B SOAP Service:ChangeOrderService

    Operation: getChangeOrder

    Change OrderOpen Event:Signals that achange order isopen.

    ChangeId

    - newValue

    - oldValue

    StatusType

    - newValue

    - oldValue

    R13 18B SOAP Service:ChangeOrderService

    Operation: getChangeOrder

    Change OrderScheduledEvent: Signalsthat a changeorder isscheduled.

    ChangeId

    - newValue

    - oldValue

    StatusType

    - newValue

    - oldValue

    EventStatusType

    - newValue

    - oldValue

    R13 17B SOAP Service:ProductDesignChangeOrderService

    Operation: getChangeOrder

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-18

  • Product Master Data Management

    Supported BusinessEvents

    Event Payload First Release Callback Service

    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

    R12 SOAP Service:StructureService

    Operation:findStructure

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-19

  • Supported BusinessEvents

    Event Payload First Release Callback Service

    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

    R12 SOAP Service:StructureService

    Operation:findStructure

    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

    R12 SOAP Service:StructureService

    Operation:findStructure

    Item Bulk Load Event:Signals that items areimported.

    RequestId

    EntityType

    R11 NA

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-20

  • Supported BusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-21

  • Supported BusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-22

  • Supported BusinessEvents

    Event Payload First Release Callback Service

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-23

  • Purchasing

    Supported BusinessEvents

    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.

    ERP BusinessEvents REST API

    19B

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-24

  • Cloud Product SupportedBusiness Event

    Description Enable ByUsing

    First ReleaseAvailable

    Expenses Expense ReportManagerApproved

    Signals when theexpense report isapproved by themanager.

    ERP BusinessEvents REST API

    19B

    Expenses Expense ReportSubmitted

    Signals when theexpense report issubmitted by theuser.

    ERP BusinessEvents REST API

    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.

    ERP BusinessEvents REST API

    18C

    General Ledger AccountingPeriod Opened

    Signals when ageneral ledgeraccounting periodis opened.

    ERP BusinessEvents REST API

    18C

    General Ledger AccountingPeriod Reopened

    Signals when ageneral ledgeraccounting periodis reopened.

    ERP BusinessEvents REST API

    18C

    General Ledger Journal BatchApproved

    Signals when ajournal batch isapproved.

    ERP BusinessEvents REST API

    18C

    General Ledger Journal BatchPostingCompleted

    Signals when ajournal batch isposted.

    ERP BusinessEvents REST API

    18C

    Payables Payables InvoiceApproved

    Signals when aninvoice isapproved.

    AP: EnableBusiness Eventsprofile option atthe site level

    18C

    Payables Payables InvoiceCancelled

    Signals when aninvoice iscanceled

    AP: EnableBusiness Eventsprofile option atthe site level

    18C

    Payables Payables InvoiceCreated

    Signals when aninvoice iscreated.

    AP: EnableBusiness Eventsprofile option atthe site level

    18C

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-25

  • Cloud Product SupportedBusiness Event

    Description Enable ByUsing

    First ReleaseAvailable

    Payables Invoice HoldApplied

    Signals when aninvoice hold isplaced.

    AP: EnableBusiness Eventsprofile option atthe site level

    18B

    Payables Invoice HoldReleased

    Signals when aninvoice hold isreleased.

    AP: EnableBusiness Eventsprofile option atthe site level

    18B

    Payables Payables InvoiceValidated

    Signals when aninvoice isvalidated online.

    AP: EnableBusiness Eventsprofile option atthe site level

    18C

    Payables PayablesPayment Created

    Signals when asingle payment iscreated.

    AP: EnableBusiness Eventsprofile option atthe site level

    18C

    Payables PayablesPayment Voided

    Signals when apayment isvoided.

    AP: EnableBusiness Eventsprofile option atthe site level

    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.

    ERP BusinessEvents REST API

    19A

    Receivables ReceivablesCredit MemoApplied

    Signals when astandard creditmemo is createdand an onaccount creditmemo issuccessfullyapplied.

    ERP BusinessEvents REST API

    19A

    Receivables ReceivablesCredit MemoCompleted

    Signals when acredit memo issuccessfullycompleted.

    ERP BusinessEvents REST API

    19A

    Receivables ReceivablesCredit MemoIncompleted

    Signals when acredit memo isincomplete.

    ERP BusinessEvents REST API

    19A

    Receivables ReceivablesInvoiceCompleted

    Signals when aninvoice iscompleted.

    ERP BusinessEvents REST API

    18C

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-26

  • Cloud Product SupportedBusiness Event

    Description Enable ByUsing

    First ReleaseAvailable

    Receivables ReceivablesInvoiceIncompleted

    Signals when aninvoice isincomplete.

    ERP BusinessEvents REST API

    19A

    Receivables ReceivablesInvoice Paid

    Signals when apayment isapplied to aninvoice.

    ERP BusinessEvents REST API

    18C

    Receivables ReceivablesLockbox BatchCompleted

    Signals when alockbox batchprocess iscompleted.

    ERP BusinessEvents REST API

    19A

    Receivables Standard ReceiptApplied

    Signals when astandard receiptis applied to atransaction forthe goodsreceived orservicesrendered.

    ERP BusinessEvents REST API

    19A

    Receivables Standard ReceiptCreated

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

    ERP BusinessEvents REST API

    18C

    Receivables Standard ReceiptDeleted

    Signals when astandard receiptis successfullydeleted.

    ERP BusinessEvents REST API

    19A

    Receivables Standard ReceiptReversed

    Signals when astandard receiptis reversed.

    ERP BusinessEvents REST API

    18C

    Receivables Standard ReceiptUnapplied

    Signals when astandard receiptis successfullyunapplied.

    ERP BusinessEvents REST API

    19A

    RevenueManagement

    RevenueContract BatchCreated

    Signals whenrevenue contractsare created in abatch process.

    ERP BusinessEvents REST API

    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

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    1-27

    http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=OAFSM2428879https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=FARFAhttps://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

    Operation:Get a task ofa project

    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

    Operation:Get a task ofa project

    Chapter 1Oracle ERP Cloud Adapter Capabilities

    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=OAPFM3440944https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=OAPEX3442085https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=OAPEX3442085https://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.

    Chapter 2Prerequisites for Creating a Connection

    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.

    Chapter 2Prerequisites for Creating a Connection

    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

    Chapter 2Prerequisites for Creating a Connection

    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.

    Chapter 2Prerequisites for Creating a Connection

    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.

    Chapter 2Prerequisites for Creating a Connection

    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.

    Chapter 2Prerequisites for Creating a Connection

    2-8

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

    Chapter 2Prerequisites for Creating a Connection

    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.

    Chapter 2Prerequisites for Creating a Connection

    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.

    Chapter 2Prerequisites for Creating a Connection

    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:

    ,,,

    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:

    Chapter 2Prerequisites for Creating a Connection

    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=FAIHM1672917https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=FAIHM1672917https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=GUID-6F51C790-23CB-480E-A09E-CE007714A2CChttps://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.

    Chapter 2Create a Connection

    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.

    Chapter 2Create a Connection

    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, including

    processing 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 t