Scribd
Upload
2 views

Web Service Implementation of Oracle EBS Using Apache Tomcat ORDS and APEX

The document outlines a presentation on the implementation of Oracle EBS using Apache, Tomcat, ORDS, and APEX, held on May 15-16, 2019, in Cleveland, Ohio. It features speakers with extensive Oracle technology experience and covers project overview, architecture, testing processes, and the successful migration of Hyland OnBase to the cloud. Key partners include TTI Floor Care, Hyland, and Rackspace, with a focus on enhancing electronic document management and workflow integration.

Uploaded by

reach.rhea90
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
2 views

Web Service Implementation of Oracle EBS Using Apache Tomcat ORDS and APEX

The document outlines a presentation on the implementation of Oracle EBS using Apache, Tomcat, ORDS, and APEX, held on May 15-16, 2019, in Cleveland, Ohio. It features speakers with extensive Oracle technology experience and covers project overview, architecture, testing processes, and the successful migration of Hyland OnBase to the cloud. Key partners include TTI Floor Care, Hyland, and Rackspace, with a focus on enhancing electronic document management and workflow integration.

Uploaded by

reach.rhea90
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 37

Web Service

Implementation of Oracle
EBS Using Apache,
Tomcat, ORDS, & APEX

MAY 15 & 16, 2019

CLEVELAND PUBLIC AUDITORIUM, CLEVELAND, OHIO

WWW.NEOOUG.ORG/GLOC
About the speakers

• (David) Brian Hartwick


– Former IT Delivery Manager at TTI Floor Care NA
– Currently looking for next opportunity due to Cleveland office closure
– Hands-on technical IT manager who has been working with Oracle technology since 1998

– E-mail: [email protected]
– http://www.linkedin.com/in/brianhartwick

• Evelyn Bolton
– IT Tech Lead at TTI Floor Care NA
– IT professional with 25 years of Oracle development experience
– Currently working with Oracle EBS R12 and APEX v18

– E-mail: [email protected]
– https://www.linkedin.com/in/evelyn-bolton-aa66953b

• Extra thanks to Juan Rojas, IT Tech Lead at TTI Floor Care NA for his contributions to the project and presentation!
Agenda

• Project Overview
• Architecture and Solution
• Documentation and Development
• Testing Process
• Additional Notes and Reference
• Q&A
Principals and Partners

• About TTI Floor Care North America


– The largest floor care business in North America, owning
three of the biggest names in floor care (Hoover, Dirt Devil,
and Oreck)
• About Hyland
– Industry-leading content services platform and services
– Hyland Software's OnBase product integrates document
management, business process automation and records
management
• About Rackspace
– Leading provider of expertise and managed services across all
the major public and private cloud technologies
How does TTI use Hyland OnBase?

• Electronic Document Management


– Document Retention and Lookup
• Shipping Documentation (Bill of Lading, Pick Tickets)
• AR Customer Invoices
• Bank Reconciliation Files
• Historical Oracle eBusiness Suite Report Archiving
• Enterprise Enabled Workflow
– AP Invoice Approval
– Price Exception Approval
OnBase Workflow AP Invoice Approval – Web Client

• Users code invoices to correct GL account


OnBase Workflow AP Invoice Approval – Unity Client

• Users select vendor and web services GET retrieves vendor


information from Oracle EBS
Hyland OnBase Upgrade Project Overview

• Update and host an aged on-premises Hyland OnBase environment (v9)


to the latest release of the OnBase application stack (v18)
• The project including migrating the application database from Oracle to
Microsoft SQL Server, moving the application and data to the Hyland
Cloud, and implementing web services (REST/JSON) with connectivity to
our Oracle eBusiness Suite environment using Oracle Rest Data Services
(ORDS) with Apache, Apache Tomcat, and Oracle Application Express
(APEX)
• The project was successfully implemented on-time and under budget in
November 2018
Moving to the Hyland Cloud Documentation
Initial State Architecture
Existing Communication – ODBC and ADODB Connections

• Open Database Connectivity (ODBC)


– OBDC Oracle EBS database called
from OnBase Thick Client
• ActiveX Data Objects DB (ADODB)
– ADODB via Microsoft VB Scripts
called from OnBase Thick Client
– ADODB calls from Microsoft ASP Pages
called from the Web Client and Server
OBDC to Oracle EBS database via Client
ADODB via VB Scripts- External Files
ASP Web Pages – External Web Server
How do we move forward?

• Oracle REST Data Services (ORDS)


– A mid-tier Java application, ORDS maps HTTP(S) verbs (GET, POST,
PUT, DELETE, etc.) to database transactions and returns any
results formatted using JSON

F F
I I
Web R R
Service E E
W W
Request A A
L L
L L
Apache HTTPD Tomcat & ORDS Oracle APEX Oracle EBS
Final State Architecture
Apache Web Server

• Dedicated Front End Web Server


• Serve static and transfer request
to Tomcat
• Certificates and network rules
to secure channel
• Created individual config files
– HTTPS (SSL) -> Apache (external & internal)
– HTTP -> Apache & Tomcat
(internal for initial testing)

• Connecting to Tomcat via AJP


– AJP (Apache JServ Protocol) is basically a binary protocol that allows to reverse proxying requests from a FE Web
Server to a BE Application Server, effectively propagating all the needed information to make the Req-Res flow
continuing successfully
Apache Tomcat

• Dedicated Application Server


• Manage the HTTP request to JDBC calls
• Minimal configuration changes are required
– Ensure the AJP is enabled in the server.xml configuration file
Oracle Rest Data Services (ORDS)

• ORDS is a Java application that enables developers with SQL and


database skills to develop REST APIs for the Oracle Database
– Representational State Transfer (REST) is a software architectural style
that defines a set of constraints to be used for creating Web services
• ORDS maps HTTP(S) verbs (GET, POST, PUT, DELETE, etc.) to
database transactions and returns any results formatted using
JSON
– JSON (JavaScript Object Notation) is a lightweight data-interchange
format, language and data independent
• ORDS is included (and for no additional cost) with any Oracle
Database license
Apache Tomcat – ORDS Installation - Overview

• The Oracle Rest Data Services (ORDS) installation consists of unzipping the downloaded archive,
running the configuration command, and then deploying the ords.war file into the Tomcat web
applications folder
– 1. Unzip ORDS zip file
– 2. Run installation command line: java -jar ords.jar install advanced
– 3. In the prompts, select to not create the ORDS schema yet
– 4. Copy ords.war into webapps
– 5. Run ORDS schema installation (this step requires the SYS password)
– 6. If the APEX passwords have not been setup in step 3, run java -jar ords.war setup
– 7. Unzip images in webapps/i on the Tomcat server
– 8. Fix Tomcat conf/server.xml to allow some special characters on the URL

– 9. Create users via command line: java –jar ords.war user DEVONBASE “TTI API Client”
Apache Tomcat – ORDS Installation – Part One

• ORDS Installation Log Output Example


Apache Tomcat – ORDS Installation – Part Two

• ORDS Schema Installation Log Output Example


Apache Tomcat – ORDS Installation – Part Three

• Database Setup Log Output Example


Oracle APEX – Stand Alone Applications

• Leverage an existing APEX environment for connectivity


– User maintenance APEX application for a sales commission
application
– Reports and data extracts for finance and accounting teams
– “Peanut Butter Factory” – Sales allocation web application
Oracle APEX – Restful Data Services
Oracle APEX – Resource Handler
Leverage Existing APEX Packages – APEX_JSON

• Custom PL/SQL package for business logic can access built-in JSON
packages that are part of APEX
Oracle APEX - Privileges
Oracle eBusiness Suite

• Oracle APEX offers you a quick and highly productive way to extend
your Oracle E-Business Suite environment with almost no impact to
your existing implementation
• Our Oracle APEX server has limited access to the Oracle EBS via explicit
grants to a dedicated custom user/schema (XXAPEX_EBS_EXT)
– GRANT SELECT ON APPS.AP_INVOICES_ALL TO XXAPEX_EBS_EXT;
– GRANT SELECT ON APPS.AP_INVOICE_LINES_ALL TO XXAPEX_EBS_EXT;
– GRANT SELECT ON APPS.TTI_WS_AP_INVOICES_V TO XXAPEX_EBS_EXT;
– GRANT SELECT ON APPS.TTI_WS_AP_APPROVERS_V TO XXAPEX_EBS_EXT;
– GRANT SELECT ON APPS.TTI_WS_AP_VENDORS_V TO XXAPEX_EBS_EXT;
Documentation & Development – Existing Definitions

• We were able to leverage the existing queries and database calls to


provide a specification for the web services that we needed to develop
Existing SQL Query to Web Service Definition

We need the JSON!


Testing your web services - CURL

• CURL from the command line


– C:\obdebug\curl\bin>curl -u devonbase:XXXXXXXXXXXX
http://PRODAPACHE.XXX.ttifc.net/api/v1/wsh/pickslip?deliveryId=20412442

{
"pickslips":[
{
"DELIVERY_ID":20412442,
"ACCOUNT_NUMBER":"01384",
"PARTY_NAME":"AMAZON SUPPLY",
"SOURCE_HEADER_NUMBER":"10579254",
"TRIP_ID":11123582,
"ORGANIZATION_CODE":"ODC",
"ATTRIBUTE3_DATE":"2018-09-11T00:00:00Z",
"CUST_PO_NUMBER":"3ETTNNCY",
"ATTRIBUTE1":"00416830084820082",
"ATTRIBUTE4":"00416830084820075"
}
]
}
Testing your web services - Powershell

• Using Invoke-WebRequest
cmdlet, script many
connection tests and
capture JSON and timing
Testing your web services - Postman

• Use Postman to facilitate testing of your web services


– Support for authentication, header variables, scripts, etc.
– Essential tool for testing POST/PUT/DELETE
Demo of Working Final Solution
Additional Key References

• Oracle Database XE, APEX, ORDS, Tomcat and httpd on


CentOS 7: all-in-one guide – introduction by Denis Savenko
– https://dsavenko.me/oracledb-apex-ords-tomcat-httpd-centos7-
all-in-one-guide-introduction/
• Extending Oracle E-Business Suite Release 12 using Oracle
APEX by Oracle
– https://www.oracle.com/technetwork/developer-
tools/apex/learnmore/apex-ebs-extension-white-paper-
345780.pdf
Questions?

You might also like