Using Oracle E-Business Suite Business Events for Integrations in Integration Cloud Service Tutorial: Order to Manual Invoice O R A C L E T U T O R I A L J U N E 2 0 1 6
Disclaimer The following is intended to outline our general product direction. It is intended for information purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described for Oracle s products remains at the sole discretion of Oracle. USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
Table of Contents Disclaimer 1 Introduction 1 Use Case 1 Steps Overview 1 Assumptions & Notes 1 Prerequisites 2 Preparing EBS Order Management System 2 Preparing EBS Accounts Receivables System 2 Steps 3 Creating Connection for EBS Order Management 3 Creating Connection for Receivables 5 Importing Integration 7 Activating the Integration 7 Raising Business Event from EBS Order Management 8 Verifying the Invoice in EBS Accounts Receivables 9 [O.FOOTER] USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
Introduction This document describes an example of using Oracle E-Business Suite Adapter in Integration Cloud Service for outbound integrations from E-Business Suite (that is, inbound integrations to Integration Cloud Service).It describes the steps to import existing ICS integration built for this tutorial. Use Case This tutorial considers the use case: Create a draft manual Invoice in Receivables system when a Sales Order is booked in EBS Order Management. EBS Order Management raises business event oracle.apps.ont.oip.statuschange.update whenever the status of Sales Order is updated as part of business flow. It contains information about the Header Id, Status of Sales Order. For this example, we will create integration in Integration Cloud Service with EBS Order Management as Source system and EBS Accounts Receivables as Target system. We will use EBS Adapter to connect to EBS Order Management system whereas; we will use generic REST Adapter from ICS to connect to target Receivables system. ICS integration will subscribe to above business event. When there is a change in Sales Order status in EBS OM system, it will trigger ICS integration. For Booked Orders, integration will fetch the details of Sales Order from EBS OM instance and data will be used to create draft manual invoice in Receivables system. Steps Overview Overview of steps: Creating Connections Importing & Activating the Integration Executing the Integration Verifying the result Assumptions & Notes Assume that Oracle E-Business Suite Order Management and Oracle E-Business Suite Accounts Receivables are two different systems. Assume that REST Services are directly accessible from Integration Cloud Service. Hence for this example, ICS Connectivity Agent is not used. However, if EBS REST Services are behind corporate firewall, you can configure agent for EBS Connection for this tutorial. This document describes the steps to import ICS integration built for this tutorial. By importing the existing integration, you will be able to straightaway view and test the integration using your EBS instance (provided the below mentioned prerequisites are implemented). If you are interested in building the ICS integration from the beginning, refer following links for details: o o o o Creating an Integration Adding Trigger and Invoke endpoints Create Mappings Assigning Business Identifier for Tracking 1 Using oracle e-business suite business events for integrations in integration cloud service
Prerequisites Before starting this tutorial, you must have: Access to Oracle Integration Cloud Service (you may request for trial subscription from here, if you don t have one). Access to Oracle E-Business Suite Order Management & Accounts Receivables. Prepare Oracle E-Business Suite Order Management & Accounts Receivables systems for integration. Perform one-time setup tasks in both systems: Preparing EBS Order Management System 1. Refer Setup Tasks for Enabling the Oracle E-Business Suite Adapter: Ensure that EBS is configured for ISG REST Services and latest patches are applied as mentioned MOS 556540.1. This is a one-time setup step. Deploy Metadata Provider API with GET HTTP Verb for all the methods contained in the API. Provide service alias as provider. Grant access privileges to operations user for all methods in Metadata Provider API. Deploy Event Manager API with POST HTTP Verb for all the methods contained in the API. Provide service alias as subscription. Grant access privileges to operations user for all methods in Event Manager API. Deploy OE_ORDER_PUB (Process Order API) as REST Service. Grant access privileges to operations user for Get Order method in OE_ORDER_PUB. 2. Refer Setup Tasks for Using the Oracle E-Business Suite Adapter as a Trigger (Source) Connection, to: Store ICS user credentials in EBS database Vault. Import SSL certificate of ICS to EBS (if required). Set up proxy URLs in EBS (if required). 3. Apply patch 16998134:R12.ONT.B, if it is not already applied. 4. Ensure that the value of profile option: OM: Raise Status Change Business Event is set to Yes. Preparing EBS Accounts Receivables System 1. Configure EBS for ISG REST Services as mentioned in MOS 556540.1. 2. Deploy Invoice Creation API as REST Service (with alias invoice). 3. Grant access to operations user to Create Single Invoice method in Invoice Creation service. 2 USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
Steps Creating Connection for EBS Order Management 1. Log in to Oracle Integration Cloud Service. 2. Click Connections in Integration Cloud Service home page. 3. Click Create New Connection in Connections page. 4. Create Connection Select Adapter dialog appears. Enter Oracle E-Business Suite in Search bar. 5. Oracle E-Business Suite Adapter is filtered from the list of Adapters. Click Select. 6. New Connection Information dialog page appears. Enter Order Management as the connection name. 7. Ensure that Trigger and Invoke is selected as Connection Role. 8. Enter a meaningful description for this connection. 9. Click Create in New Connection Information dialog page. 3 USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
10. Connection Details page is displayed for Order Management connection. Click Configure Connectivity in Connection Properties section. 11. Enter connection URL of EBS Order Management instance as https://<ebs host name>:<port>. 12. Click OK. 13. Click Configure Security in Security section. 14. Enter operations as the username and its associated password in the Credentials dialog to access the EBS Order Management instance you specified earlier in the Connection Properties dialog. 15. Click OK. 16. Click Test to test the connection you just specified for Oracle E-Business Suite. 17. Click Save to save your connection. 4 USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
18. Click Exit Connection. 19. Oracle E-Business Suite connection "Order Management" now appears in the Connections page. Creating Connection for Receivables 1. We will use REST Adapter to connect to Receivables system. Click Create New Connection in Connections page. 2. Create Connection Select Adapter dialog appears. Enter REST in Search bar. 3. REST Adapter is filtered from the list of Adapters. Click Select. 4. New Connection Information dialog page appears. Enter Receivables as the connection name. 5. Select either Invoke or Trigger and Invoke as Connection Role. 5 USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
6. Enter a meaningful description for this connection. 7. Click Create in New Connection Information dialog page. 8. Click Configure Connectivity to open the Connection Properties dialog. 9. Select REST API Base URL as Connection Type. 10. Enter URL for Invoice REST Service in Receivables system. For example, http://<ebs host name>:<port>/webservices/rest/invoice. 11. Click OK. 12. Click Configure Security to open the Credentials dialog. 6 USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
13. Enter credentials to access Invoice REST Service. For example, enter operations as the username and its associated password in the Credentials dialog. 14. Click OK. 15. Click Test to test the connection you just specified for Oracle E-Business Suite. 16. Click Save to save your connection. 17. Click Exit Connection. 18. Oracle E-Business Suite connection "Receivables" now appears in the Connections page. Importing Integration 1. Navigate to Integrations Home page. 2. Click Import Integrations. 3. Browse and select Order to Invoice iar file (ORDER_TO_INVOICE_01.00.0000.iar). 4. Integration is successfully imported message is displayed. And, Order to Invoice integration is listed in Integrations home page. 5. Click integration name to view the imported integration. Note: Refer An Example of Using a Business Event as a Trigger (Source) in Integration. It describes the steps to create integration, add Trigger and Invoke endpoints and, define mappings. Activating the Integration 1. In the Integrations page, click Activate for the "Order to Invoice" integration that you imported earlier. 2. The Confirmation dialog appears. Click Yes for Are you sure you want to activate integration Order to Invoice? 3. "Order to Invoice" integration is now ACTIVE. 7 USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
Raising Business Event from EBS Order Management 1. Log in to Oracle E-Business Suite as the operations user who has access to Order Management Super User, Vision Operations (USA) responsibility. 2. Select Order, Returns and then Sales Order from the navigation menu to open the Sales Orders form. 3. In the Sales Orders form, select the Order Information tab. 4. Create a new Sales Order for customer "A.C. Networks. 5. Select the Line Items tab and add the following line item: Ordered Item: AS54888 Quantity: 1 UOM: Each 8 USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
Unit Price: Accept the populated unit price. Request Date: Accept the populated date (such as 14-MAY-2016) 6. Save this new order. This order is created with "Entered" status. 7. Click Book Order. The order status is now updated to "Booked". It internally raises a business event oracle.apps.ont.oip.statuschange.update which will trigger the integration. Verifying the Invoice in EBS Accounts Receivables 1. Log in to Oracle Accounts Receivables as the operations user who has access to Receivables, Vision Operations (USA) responsibility. 2. Select Transactions and then Transactions from the navigation menu. 3. Search for the invoice transaction by transaction number. Note: Header ID of Sales Order from Order Management was mapped to transaction number of Invoice. 4. Invoice would be found in Oracle Accounts Receivables for A.C. Networks for corresponding Sales Order. 9 USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
Oracle Corporation, World Headquarters Worldwide Inquiries 500 Oracle Parkway Phone: +1.650.506.7000 Redwood Shores, CA 94065, USA Fax: +1.650.506.7200 C O N N E C T W I T H U S blogs.oracle.com/oracle facebook.com/oracle twitter.com/oracle oracle.com Copyright 2016, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without our prior written permission. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0116 Using Oracle E-Business Suite Business Events from Integration Cloud Service June 2016 Author: Rekha Ayothi