Building Mobile Applications For Oracle E-Business SuiteMohamed Mostafa, 12 March 2017

Option 1: Build EBS Mobile Application using ICS and MCS as backend

Build EBS Application using ICS and MCS as backend• Prerequisites:• Oracle EBS ISG configured and WADL is accessible.• Oracle EBS API’s are deployed as REST Webservices.• ICS Connectivity Agent is installed on the same network of

EBS instance.• Oracle Integration Cloud Service(ICS) account obtained

and active.• Oracle Mobile Cloud Services(MCS) account obtained and

active.

Build EBS Mobile Application using ICS and MCS as backend

Solution Architecture

Prepare EBS instance only for R12.0 to 12.2.X• First you need to apply some patches and do

some configuration in order to enable integrated SOA gateway in oracle EBS

• For EBS 12.0 to 12.1.1 please follow steps in (Doc ID 815196.1).

• For EBS 12.1.3 please follow steps in (Doc ID 556540.1) and (Doc ID 1454409.1)

• For EBS 12.2.x please follow steps in (Doc ID 1311068.1)

Deploy EBS APIs as Webservices• After configuring ISG, you need to search for

required APIs.

Deploy EBS APIs as Webservices• After locating API, select and press deploy to

deploy as a webservice then make sure that service WADL is accessible.

Deploy EBS APIs as Webservices• For custom PL/SQL APIs

you need first to do annotation for it then import it to IREP in order to use it in ISG, please refer to  'Integrated SOA Gateway Developer's Guide‘ for more details.

Get ICS account and configure Connectivity Agent• You can visit http://cloud.oracle.com to buy or ask for a

trail account for Integration Cloud Services.

• After getting a valid account you need to configure ICS users and roles, for more information please visit this link.

• ICS allows you to connect to oracle EBS through connectivity agent without making a hole in your enterprise firewall which maximize security and minimize risks.

Get ICS account and configure Connectivity Agent• After Login to ICS dashboard navigate to Designer-

> Agents, then create new connectivity Agent.

Get ICS account and configure Connectivity Agent• Download Connectivity Agent and install it on the

same network of oracle EBS.• For more details about agent groups and

installation steps visit this link.

Configure ICS EBS Adapter Connection• Oracle E-Business Suite Adapter from Integration Cloud

Service provides native and secure connectivity to Oracle E-Business Suite instance. It lets you create integrations with EBS public integration interfaces. the EBS Adapter supports: • EBS R12.1.3, R12.2.3, R12.2.4 and R12.2.5 for earlier EBS releases

please use Oracle DB Adapter Instead.• PL/SQL-based REST Services for outbound integrations from ICS

(also called inbound integrations to EBS).• Business Events and XML Gateway Messages for inbound

integrations to ICS (also called outbound integrations from EBS).• Custom interfaces registered in Integration Repository.• Connectivity via an on-premise Agent. If EBS REST Services are

directly accessible from ICS, on-premise Agent need not be configured. 

Oracle Mobile Cloud Service (MCS)• MCS is a powerful Mobile Backend as a Service (MBaaS),

built from the ground up to be a modern cloud service. It is built using industry standards, allowing your company to leverage existing skills, thereby saving time and money.

• To help simplify mobile app development, Mobile Cloud Service provides these built-in APIs • Push Notification• Data Offline / Sync• Mobile User Management• Analytics• Mobile Storage• Device Management

Configure Oracle Mobile Cloud Services

Get MCS account and Define users and Roles• You can visit http://cloud.oracle.com to buy or ask

for a trail account for Mobile Cloud Services.• After getting a valid account you need to

configure MCS users and roles, for more information please visit this link.

Create Mobile Backend and Security Realm• Start by creating a security Realm and add the mobile

application users or follow this link for more information about Enterprise Single Sign-On in MCS.

• Navigate to Mobile Backend and create a back end for the mobile application.

• Use the security Realm with the mobile backend.

Create MCS Connectors to ICS Integrations• Navigate to Connectors and start create

connectors to ICS integrations.• There are four types of connectors in MCS for

more information about how to use it please check Connector APIs.• REST Connector APIs• SOAP Connector APIs• ICS Connector APIs• Fusion Applications Connector APIs

Create MCS Custom APIs and add the APIs to mobile backend.• Navigate to APIs-> New API and start create

custom APIs using the connectors created for ICS integrations.

• Add the created APIs to the mobile backend to be consumed from the mobile application.

Create MCS Custom APIs and add the APIs to mobile backend.• Navigate to APIs-> New API and start create

custom APIs using the connectors created for ICS integrations.

• Add the created APIs to the mobile backend to be consumed from the mobile application.

Create Mobile Application Consuming Oracle MCS Backend• There are many approached to build mobile

application one of them is to use oracle JET.• Oracle JavaScript Extension Toolkit (JET) empowers

developers by providing a modular open source toolkit based on modern JavaScript, CSS3 and HTML5 design and development principles.

• Oracle JET will not be discussed in the presentation but to get more information about it please visit this Link.

• Oracle Mobile Application Framework(MAF) is another approach to build rich enterprise mobile application which is the scope of this presentation.

Build Mobile Application Using Oracle MAF

• Oracle Mobile Application Framework (Oracle MAF) is a hybrid mobile framework that enables developers to rapidly develop single-source applications and deploy to Apple's iOS, Google's Android, and Microsoft Windows 10 platforms.

• Oracle MAF leverages Java, HTML5 and JavaScript to deliver a complete MVC framework with declarative user interface definition, device features integration and built-in security.

• Oracle MAF provides a visual and declarative development experience and maximizes code reuse resulting in faster development of mobile applications.

Oracle Mobile Application Framework

Build Mobile Application Using Oracle MAF• The last step in this integration is to create a MAF application that

accesses the custom API exposed on the MCS mobile backend. Access is simplified by using the Oracle MAF MCS Utility (mafmcsutility.jar). In MCS, client SDKs exist for Android, iOS, Windows, JavaScript and Xamarin. The MAF MCS Utility is not an official SDK, but provides similar functionality for MAF application developers.

• For testing you can download and install the MAF MCS Tester App for more information please watch Oracle Mobile Cloud Service: Setup MAF MCS Tester App – YouTube.

• Before creating our custom mobile application, we'll get everything we need to integrate MCS. We can get mafmcsutility.jar in MAF public samples (e.g., C:\Oracle\Middleware\Oracle_Home\jdeveloper\jdev\extensions\oracle.maf\Samples) or download it from: https://blogs.oracle.com/mobile/entry/maf_mcs_utility_patch_for

Build Mobile Application Using Oracle MAF• After we have the library,

we are ready to start building the application:• To create the application,

click File -> New -> Application.• In the gallery, select Mobile

Application Framework Application and click OK. In the next popup, choose the location where you want to place the application and the name of the application. After setting those values, click Finish.

• Add mafmcsutility.jar to the ApplicationController project by going to the Libraries and Classpath menu in Project Properties.

Build Mobile Application Using Oracle MAF• Create a REST Connection

• We also have to provide a REST Connection in this method:

• In the Application Navigator, go to Application Resources.

• Right click on Connections node.

• Search for REST Connection.In the Edit REST Connection dialog, fill the form with the connection name (in this case, MCS) and with the base URL of the mobile backend that we get in MCS.

Build Mobile Application Using Oracle MAF• Create the DataControl

• Create a Java class called MCSDataControl.java. We are going to add some methods from the sample application provided for the MAF MCS Utility.• prepareMCSAccess: This method creates a mobile backend object that represents a

mobile backend in MCS. Provide the following information about the mobile backend in MCS:• Mobile Backend Id• Anonymous key• Application key• The REST connection we have just created (marked in red, below)

Build Mobile Application Using Oracle MAF• For more information on using Oracle MAF MCS Utility please visit

PCS, MCS and MAF Integration.

• Another very good tool is the A-Team Mobile Persistence Accelerator (AMPA).

• AMPA is a lightweight persistence and data synchronization framework, and is available on GitHub under open source license . AMPA eases the consumption of RESTful services, in particular those coming from MCS, and provides a complete persistence layer that allows you to use the mobile application in offline mode. You can read and write data while not connected to the internet, and synchronize any pending data changes later when you are online again. The design-time wizards that are integrated with JDeveloper enable you to build a fully functional mobile application within minutes, for more information please watch Building Oracle MAF Application with Offline Sync against Oracle Mobile Cloud Service.

Option 2: Build EBS Mobile Application using Oracle SOA, Service Bus, API Gateway and Oracle MCS as backend

Build EBS Mobile Application using Oracle SOA, Service Bus, API Gateway and Oracle MCS as backend• Prerequisites:• Oracle EBS ISG configured and WADL is accessible.• Oracle EBS API’s are deployed as REST webservices.• Oracle Weblogic.• Oracle SOA.• Oracle Service Bus.• Oracle API Gateway is installed and configured.• Oracle Mobile Cloud Services(MCS) account obtained and

active.

Build EBS Mobile Application using Oracle SOA, Service Bus, API Gateway and Oracle MCS as backendSolution Architecture

Oracle API Gateway• Oracle API Gateway is a standards-based, policy-

driven, standalone software security solution that provides first line of defense in Service-Oriented Architecture (SOA) environments

• There are many advantages that OAG can provide :• Authentication, Authorization (Leverages existing LDAP like

Oracle Access Manager)• XML Acceleration, Throttling, Caching, Protocol translation

(REST to SOAP and vice versa), Dynamic routing, SLA enforcement.• Identity Propagation and Credential Mapping , Filter

threatening content (XML Bombs, DOS Attacks, Virus)

Thank You!