XML Gateway Inbound Purchase Orders to Oracle Order

XML Gateway: Inbound Purchase Orders to Oracle Order Management – A Technical Overview Jason Morrill NCOAUG Training Day February, 2008 NCOAUG Training Day Feb, 2008

Jason Morrill Background l l l Oracle Technical consultant with O 2 Works 12 years experience extending, enhancing and customizing Oracle Applications. Contact information: – – 2 jmorrill@o 2 works. com 414 -559 -8944 NCOAUG Training Day - Feb, 2008

Agenda l l l l 3 What is XML Gateway? Why use XML Gateway? Components of XML Gateway Overview of XML Gateway Architecture Overview of Oracle’s XML Message Designer Walk through the setups for XML Gateway Overview of XML Gateway Execution Engine NCOAUG Training Day - Feb, 2008

What is XML Gateway? l l l 4 Oracle XML Gateway is the XML message enabler for the Oracle E-Business Suite. XML Gateway provides an generic framework to send information as an outbound transaction or to receive the information as an inbound transaction between Trading Partners and the Oracle e-Business Suite. Oracle XML Gateway uses the message propagation feature of Oracle Advanced Queuing to integrate with the Oracle Transport Agent to deliver messages to and receive messages from business partners. NCOAUG Training Day - Feb, 2008

Why use XML Gateway? l l l 5 XML Gateway is Event Based, Real-Time. Messages tend to be based on a single transaction. Oracle XML Gateway supports all DTD (Document Type Definition) based XML standards. (File Formats based on a standards body) Flexible enough to accommodate all your Trading Partners. Oracle XML Gateway creates or consumes standards compliant XML messages without the use of a 3 rd Party translator. NCOAUG Training Day - Feb, 2008

Components of XML Gateway • Message Designer • A wizard-guided, repository-based tool used to create XML message maps • The Message Designer can support map creation for any business document as long as the document conforms to a Document Type Definition (DTD). • Modify the Oracle prebuilt message maps • Create your own message maps based on a (DTD) • XML Gateway Execution Engine • Picks up messages (orders) from the inbound transaction queue • Validates message as well-formed XML per the DTD • Executes the message map • Sends business event to predefined workflow process 6 NCOAUG Training Day - Feb, 2008

Components cont… • XML Gateway Setups • Steps consist of setting Profile Options and performing setups using the admin forms within the XML Gateway Responsibility. • Other Products Interfacing with Execution Engine • Oracle Transport Agent (OTA) for message delivery. Ø Lightweight messaging platform for transmitting documents. • Oracle Advanced Queuing for message propagation, and queue management. Ø Message Queues - ECX_INBOUND – Holds all messages that enter the process through the Transport Agent or are placed directly on the queue by an API ØTransactions Queues – ECX_IN_OAG_Q – Holds inbound messages that originated from ECX_INBOUND. Message are enqueued by Workflow Ø Error Queues – WF_ERROR – Gateway error sent to Sys Admin or Trading Partner • Oracle Workflow Business Event System to publish and subscribe to business events (Calls Order Import to Process Inbound Order) 7 NCOAUG Training Day - Feb, 2008

XML Gateway – Architecture § Transport Agent API delivers message to inbound queue § Advanced Queuing Processes Message to Execution Engine. § Workflow Business Event System calls Order Import to process order that has been placed in Order Import Interface tables by the Execution Engine and message map. 8 NCOAUG Training Day - Feb, 2008

XML Gateway – Business Event 9 NCOAUG Training Day - Feb, 2008

XML Gateway – Subscription 10 NCOAUG Training Day - Feb, 2008

Message Designer – Step 1 11 NCOAUG Training Day - Feb, 2008

Build Message Map – Step 2 12 NCOAUG Training Day - Feb, 2008

Build Message Map – Step 3 13 NCOAUG Training Day - Feb, 2008

Build Message Map – Step 4 14 NCOAUG Training Day - Feb, 2008

Build Message Map – Step 5 15 NCOAUG Training Day - Feb, 2008

Build Message Map – Step 6 16 NCOAUG Training Day - Feb, 2008

Build Message Map – Step 7 17 NCOAUG Training Day - Feb, 2008

Build Message Map – Step 8 18 NCOAUG Training Day - Feb, 2008

Build Message Map – Step 9 19 NCOAUG Training Day - Feb, 2008

Build Message Map – Step 10 20 NCOAUG Training Day - Feb, 2008

Finished! You are now ready to modify your attributes. 21 NCOAUG Training Day - Feb, 2008

Source Definition 22 NCOAUG Training Day - Feb, 2008

Target Definition 23 NCOAUG Training Day - Feb, 2008

Level Mapping 24 NCOAUG Training Day - Feb, 2008

Element Mapping 25 NCOAUG Training Day - Feb, 2008

Map Action Editor • Pre-Process - A preprocess action is executed before the message is created or consumed. The Create Global Variable action is an example of a preprocess action. The variable must be defined before you can use it. • In-process – The action is executed during message creation or consumption. The Math and String Functions are examples of in-process actions used to perform a computation or to manipulate a value. • Post Process - A post process action is executed after the message is created or consumed. The Insert into Database Table action is an example of a post process action. The row cannot be inserted into the database until all the data for the row has been processed. 26 NCOAUG Training Day - Feb, 2008

Loading Map and DTD to Database Perform the following steps to load the map and its DTD to the XML Gateway Repository for use by the Execution Engine 27 Object Name Object Type Command Order. dtd DTD java oracle. apps. ecx. loader. Load. DTDTo. Clob apps_password auohsmwac 27. oracleoutsourcing. com: 10710: DMWACI Order $XBOL_TOP/xml/x. CBL 35/Order. dtd map_name. xgm MAP java oracle. apps. ecx. loader. Load. Map apps_password auohsmwac 27. oracleoutsourcing. com: 10710: DMWACI $XBOL_TOP/xml/map_name. xgm NCOAUG Training Day - Feb, 2008

Define System Profile Options 28 NCOAUG Training Day - Feb, 2008

Profile Options – Con’t… • ECX: Log File Path - Log File Path where the XML messages and runtime log are stored (Required) • ECX: Maximum XML Size - Specifies the maximum size of an outbound XML document (Not Required) • ECX: Server Time Zone – The time zone in which the database server is running (Required) • ECX: System Administrator Email Address – XML Gateway System Administrator e-mail address (Required) • ECX: XML Suppress Empty Tags – Suppresses Empty Tags in XML file • ECX: XML Validate Flag - Specifies whether an outbound document should continue to be parsed by the engine after the ECX: Maximum XML Size has been met. • ECX: XSLT File Path – Set to the same as the ECX: Log File Path 29 NCOAUG Training Day - Feb, 2008

Define Transaction – Purchase Order Inbound 30 NCOAUG Training Day - Feb, 2008

Define Transaction – Con’t… The ONT/POI transaction is a seeded within Oracle XML Gateway and requires no additional setup. Values are as follows… • • • 31 Party – Customer Transaction Type – ONT Transaction Sub. Type – POI Transaction Description – Purchase Order Inbound Standard Code – OAG Direction – In External Transaction Type – PO External Transaction Subtype – Process Queue – APPS. ECX_IN_OAG_Q NCOAUG Training Day - Feb, 2008

Trading Partner Setup 32 NCOAUG Training Day - Feb, 2008

Trading Partner Setup – Con’t… 33 NCOAUG Training Day - Feb, 2008

Trading Partner Setup – Con’t… The Trading Partner Setup is the component that will enable a message to be processed through the XML Gateway engine. The Trading Partner setup form is used to… • Enable messages for the trading partner by identifying the internal and external transaction and transaction subtype codes, and the XML standard associated with the message. • Access the Trading Partner User setup form (Security) • Access the Trading Partner Code Conversion form • Select a Message Map for the trading partner • Define Source Trading Partner Location Code. This is your trading partner’s location code (PARTY_SITE_ID) because they are the source of the XML message. 34 NCOAUG Training Day - Feb, 2008

Trading Partner Setup – Con’t… • Set your level of document confirmation. Document Confirmation is the indicator for the confirmation level that this Trading Partner would like to send or receive a confirmation. 35 NCOAUG Training Day - Feb, 2008

Trading Partner Setup – Con’t… Code Conversion - The Oracle XML Gateway code conversion function provides a method to cross-reference the codes defined in Oracle E-Business Suite to codes used by your trading partners. 36 NCOAUG Training Day - Feb, 2008

XML Gateway Execution Engine l The XML Gateway Execution Engine can process messages properly after the following. • • • 37 Message maps are created and loaded into the repository along with their associated DTDs Trading Partners are defined. Code Conversions are defined. Transactions are defined. Oracle Workflow Business Event System events are published by the Oracle E-Business Suite and subscriptions to those events are defined. (Already done with seeded Transaction Types) Engine and listeners are started. (The XML Gateway listeners are actively polling for interested events. The Execution Engine will begin processing once Oracle Workflow Business Event System detects an outbound transaction to be processed, or that an inbound message has arrived on the queue) NCOAUG Training Day - Feb, 2008

What does the Execution Engine Do? l During processing the XML Gateway Execution Engine performs the following tasks. • • • 38 Dequeue message from inbound queue. Uses the XML Parser to validate the inbound message to determine if it is well-formed and valid based on the DTD stored in the DTD directory. Gets the message map from the repository that is defined for the transaction type. Executes the message map. Applies Actions and Code Conversions. Detects and reports processing errors. NCOAUG Training Day - Feb, 2008

XML Message Process Flow 39 NCOAUG Training Day - Feb, 2008

Summary l Oracle XML Gateway has a number of valuable features that allow you to: • • • 40 Employ a common, standards-based approach for XML integration between the Oracle E-Business Suite and third party applications, both inside and outside of your enterprise. Develop custom maps using the Message Designer for message processing. Employ a variety of transaction types and subtypes to facilitate inbound and outbound messaging. NCOAUG Training Day - Feb, 2008

THANK YOU Questions and Answers Presenter: Jason Morrill jmorrill@o 2 works. com Contact: 414 -559 -8944 O 2 Works LLC Dallas – Chicago - Denver NCOAUG Training Day Feb, 2008

Sources • • • 42 XML Gateway User’s Guide, Release 11 i Part No. B 1066503 Oracle XML Gateway 11 i Datasheet. Understanding the Oracle Transport Agent Messaging Protocol, An Oracle White Paper NCOAUG Training Day - Feb, 2008