using oracle e-business suite business events for integrations in

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

USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE

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.

[O.FOOTER] 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

1 | 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 Creating an Integration

o Adding Trigger and Invoke endpoints

o Create Mappings

o Assigning Business Identifier for Tracking

http://docs.oracle.com/cloud/latest/intcs_gs/ICSEA/T657359T661088.htm#8350227




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


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.


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.


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.


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.


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.

http://docs.oracle.com/cloud/latest/intcs_gs/ICSEA/T657359T661088.htm


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


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.

Oracle Corporation, World Headquarters Worldwide Inquiries

500 Oracle Parkway Phone: +1.650.506.7000

Redwood Shores, CA 94065, USA Fax: +1.650.506.7200

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

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

using oracle e-business suite business events for integrations in

Documents