Mobile Apps Admin Guide E64384
Mobile Apps Admin Guide E64384
Mobile Apps Admin Guide E64384
September 2017
Oracle E-Business Suite Mobile Apps Administrator's Guide, Release 12.1 and 12.2
Copyright © 2015, 2017, Oracle and/or its affiliates. All rights reserved.
Contributing Author: Tushar Abedin, Tahir Ahmad, Prasad Akkiraju, Hadi Alatasi, Sugathan Aravindan,
Prasanna Athota, Srinivasa Rao Atla, John Brazier, Hubert Ferst, Sunil Ghosh, Erik Graversen, Sri Ramya
Inturi, Clara Jaeckel, Anupam Johri, Jeanne Lowell, Saritha Merugu, Sanyukta Palod, Chidananda Pati,
Balakrishna Pulivarthi, Arun Purushothaman, Tirupathi Rao PVS, Esteban Rodriguez, Vijay Shanmugam,
Dilbagh Singh, Ryoji Suzuki, Sukanya Tadepalli, Venkatakalpanarani Thota, Arvin Tjen, Erik Wu, Ice Yu
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,
any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are
"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-
specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the
programs, including any operating system, integrated software, any programs installed on the hardware,
and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No
other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
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.
This software or hardware and documentation may provide access to or information about content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services unless
otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates
will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party
content, products, or services, except as set forth in an applicable agreement between you and Oracle.
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Oracle customers that have purchased support have access to electronic support through My Oracle Support.
For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.
com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
Contents
Preface
iii
.....................................................................................................................................2-58
Step 3: Allowing Apps to Access Local Contacts.........................................................2-59
Setting Up Maps................................................................................................................ 2-62
Support for Barcodes......................................................................................................... 2-64
Additional App-Specific Setup...............................................................................................2-66
Communicating Mobile App Information to Users............................................................... 2-67
5 Advanced Configurations
Overview................................................................................................................................... 5-1
Demilitarized Zone (DMZ)....................................................................................................... 5-1
Secure Communication with HTTPS........................................................................................5-2
Single Sign-On (SSO)............................................................................................................... 5-7
iv
Troubleshooting Tips on the Mobile Client......................................................................... 6-6
Directing Users to Obtain Connection Details and Download Updates from the Server
.......................................................................................................................................6-6
Troubleshooting Tips for Oracle E-Business Suite Mobile Apps................................... 6-9
Troubleshooting Tips on the Oracle E-Business Suite Server.............................................6-19
Troubleshooting Tips on the Oracle E-Business Suite Server...................................... 6-19
Troubleshooting Tips on Configuring Apps With the Apps SSO Login Authentication
Type............................................................................................................................ 6-21
Troubleshooting Tips for Push Notifications...............................................................6-23
v
G Associated Products in My Oracle Support
Associated Products in My Oracle Support............................................................................. G-1
vi
Send Us Your Comments
Oracle E-Business Suite Mobile Apps Administrator's Guide, Release 12.1 and 12.2
Part No. E64384-11
Oracle welcomes customers' comments and suggestions on the quality and usefulness of this document.
Your feedback is important, and helps us to best meet your needs as a user of our products. For example:
• Are the implementation steps correct and complete?
• Did you understand the context of the procedures?
• Did you find any errors in the information?
• Does the structure of the information help you with your tasks?
• Do you need different information or graphics? If so, where, and in what format?
• Are the examples correct? Do you need more examples?
If you find any errors or have any other suggestions for improvement, then please tell us your name, the
name of the company who has licensed our products, the title and part number of the documentation and
the chapter, section, and page number (if available).
Note: Before sending us your comments, you might like to check that you have the latest version of the
document and if any concerns are already addressed. To do this, access the new Oracle E-Business Suite
Release Online Documentation CD available on My Oracle Support and www.oracle.com. It contains the
most current Documentation Library plus all documents revised or released recently.
Send your comments to us using the electronic mail address: [email protected]
Please give your name, address, electronic mail address, and telephone number (optional).
If you need assistance with Oracle software, then please contact your support representative or Oracle
Support Services.
If you require training or instruction in using Oracle software, then please contact your Oracle local office
and inquire about our Oracle University offerings. A list of Oracle offices is available on our Web site at
www.oracle.com.
vii
Preface
Intended Audience
Welcome to Release 12.1 and 12.2 of the Oracle E-Business Suite Mobile Apps
Administrator's Guide.
This guide assumes you have a working knowledge of the following:
• The principles and customary practices of your business area.
This documentation assumes familiarity with Oracle E-Business Suite. It is written for
the technical consultants, implementers and system integration consultants who
oversee the functional requirements of these applications and deploy the functionality
to their users.
If you have never used Oracle E-Business Suite, we suggest you attend one or more of
the Oracle E-Business Suite training classes available through Oracle University.
See Related Information Sources on page x for more Oracle E-Business Suite product
information.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=docacc.
ix
through My Oracle Support. For information, visit http://www.oracle.
com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=trs if you are hearing impaired.
Structure
1 Introduction to Oracle E-Business Suite Mobile Apps
2 Setting Up the Mobile Apps
3 Setting Up Push Notifications for Mobile Apps
4 Administering the Mobile Apps
5 Advanced Configurations
6 Diagnostics and Troubleshooting
A Integrating Oracle E-Business Suite Mobile Apps with Enterprise Mobility Management
(EMM) Solutions
B Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases
C Mobile App Access Roles
D Mobile App Module Names
E Application Definition Metadata
F Setting Up and Using the Supported Languages
G Associated Products in My Oracle Support
• Release Notes - For information about changes in this release, including new
features, known issues, and other details, see the release notes for the relevant
product, available on My Oracle Support.
x
• Oracle Electronic Technical Reference Manual - The Oracle Electronic Technical
Reference Manual (eTRM) contains database diagrams and a detailed description of
database tables, forms, reports, and programs for each Oracle E-Business Suite
product. This information helps you convert data from your existing applications
and integrate Oracle E-Business Suite data with non-Oracle applications, and write
custom reports for Oracle E-Business Suite products. The Oracle eTRM is available
on My Oracle Support.
Related Guides
You should have the following related books on hand. Depending on the requirements
of your particular installation, you may also need additional manuals or guides.
Oracle Alert User's Guide
This guide explains how to define periodic and event alerts to monitor the status of
your Oracle E-Business Suite data.
Oracle Diagnostics Framework User's Guide
This manual contains information on implementing and administering diagnostics tests
for Oracle E-Business Suite using the Oracle Diagnostics Framework.
Oracle E-Business Suite Concepts
This book is intended for all those planning to deploy Oracle E-Business Suite Release
12.2, or contemplating significant changes to a configuration. After describing the
Oracle E-Business Suite architecture and technology stack, it focuses on strategic topics,
giving a broad outline of the actions needed to achieve a particular goal, plus the
installation and configuration choices that may be available.
Oracle E-Business Suite CRM System Administrator's Guide
This manual describes how to implement the CRM Technology Foundation (JTT) and
use its System Administrator Console.
Oracle E-Business Suite Developer's Guide
This guide contains the coding standards followed by the Oracle E-Business Suite
development staff. It describes the Oracle Application Object Library components
needed to implement the Oracle E-Business Suite user interface described in the Oracle
E-Business Suite User Interface Standards for Forms-Based Products. It provides information
to help you build your custom Oracle Forms Developer forms so that they integrate
with Oracle E-Business Suite. In addition, this guide has information for customizations
in features such as concurrent programs, flexfields, messages, and logging.
Oracle E-Business Suite Maintenance Guide
This guide explains how to patch an Oracle E-Business Suite system, describing the
adop patching utility and providing guidelines and tips for performing typical patching
operations. It also describes maintenance strategies and tools that can help keep a
system running smoothly.
Oracle E-Business Suite Mobile Apps Developer's Guide, Release 12.1 and 12.2
xi
This guide describes how to develop enterprise-distributed mobile apps by using
mobile application archive (MAA) files and how to implement corporate branding. It
also explains how to implement push notifications for supported mobile apps, and how
to implement Oracle E-Business Suite REST services to develop custom mobile apps by
using the Login component from Oracle E-Business Suite Mobile Foundation or using
any mobile app development framework if desired.
Oracle E-Business Suite Security Guide
This guide contains information on a comprehensive range of security-related topics,
including access control, user management, function security, data security, secure
configuration, and auditing. It also describes how Oracle E-Business Suite can be
integrated into a single sign-on environment.
Oracle E-Business Suite Setup Guide
This guide contains information on system configuration tasks that are carried out
either after installation or whenever there is a significant change to the system. The
activities described include defining concurrent programs and managers, enabling
Oracle Applications Manager features, and setting up printers and online help.
Oracle E-Business Suite User's Guide
This guide explains how to navigate, enter and query data, and run concurrent requests
using the user interface (UI) of Oracle E-Business Suite. It includes information on
setting preferences and customizing the UI. In addition, this guide describes
accessibility features and keyboard shortcuts for Oracle E-Business Suite.
Oracle E-Business Suite User Interface Standards for Forms-Based Products
This guide contains the user interface (UI) standards followed by the Oracle E-Business
Suite development staff. It describes the UI for the Oracle E-Business Suite products and
how to apply this UI to the design of an application built by using Oracle Forms.
Oracle Workflow Administrator's Guide
This guide explains how to complete the setup steps necessary for any product that
includes workflow-enabled processes. It also describes how to manage workflow
processes and business events using Oracle Applications Manager, how to monitor the
progress of runtime workflow processes, and how to administer notifications sent to
workflow users.
Oracle Workflow Developer's Guide
This guide explains how to define new workflow business processes and customize
existing Oracle E-Business Suite-embedded workflow processes. It also describes how
to configure message metadata for Oracle Mobile Approvals for Oracle E-Business Suite
and how to define and customize business events and event subscriptions.
Oracle Workflow User's Guide
This guide describes how users can view and respond to workflow notifications and
monitor the progress of their workflow processes.
xii
Do Not Use Database Tools to Modify Oracle E-Business Suite Data
Oracle STRONGLY RECOMMENDS that you never use SQL*Plus, Oracle Data
Browser, database triggers, or any other tool to modify Oracle E-Business Suite data
unless otherwise instructed.
Oracle provides powerful tools you can use to create, store, change, retrieve, and
maintain information in an Oracle database. But if you use Oracle tools such as
SQL*Plus to modify Oracle E-Business Suite data, you risk destroying the integrity of
your data and you lose the ability to audit changes to your data.
Because Oracle E-Business Suite tables are interrelated, any change you make using an
Oracle E-Business Suite form can update many tables at once. But when you modify
Oracle E-Business Suite data using anything other than Oracle E-Business Suite, you
may change a row in one table without making corresponding changes in related tables.
If your tables get out of synchronization with each other, you risk retrieving erroneous
information and you risk unpredictable results throughout Oracle E-Business Suite.
When you use Oracle E-Business Suite to modify your data, Oracle E-Business Suite
automatically checks that your changes are valid. Oracle E-Business Suite also keeps
track of who changes information. If you enter information into database tables using
database tools, you may store invalid information. You also lose the ability to track who
has changed your information because SQL*Plus and other database tools do not keep a
record of changes.
xiii
1
Introduction to Oracle E-Business Suite
Mobile Apps
Overview
Oracle E-Business Suite mobile apps enable users to perform needed tasks or take action
on Oracle E-Business Suite transactions from mobile devices including iOS and Android
smartphones. For example, users can handle approval requests through the mobile app
for approvals or perform time entry on the mobile app for timecards. Users can
download these apps from the Apple App Store and Google Play. To use the apps,
users must be licensed for the base products, with mobile services configured on the
Oracle E-Business Suite server. To find Oracle E-Business Suite mobile apps, search for
the keywords "Oracle America EBS" in the Apple App Store and Google Play.
This guide describes how to set up an Oracle E-Business Suite instance to support
connections from these mobile apps. It also describes common administration tasks for
viewing mobile app installation and usage metrics, as well as logging and
troubleshooting information for Oracle E-Business Suite mobile apps.
Note: This guide does not apply to the following mobile apps that are
not developed based on Oracle E-Business Suite Mobile Foundation,
except where specifically noted:
• Oracle Fusion Expenses (see Document 1625446.1)
• For the list of available Oracle E-Business Suite mobile apps, see the Oracle E-
Business Suite Mobile Apps, Release 12.1 and 12.2 Documentation Index, My Oracle
Support Knowledge Document 1641772.1.
• To share ideas with Oracle related to mobile apps, see My Oracle Support
Knowledge Document 1641772.1, Oracle E-Business Suite Product Enhancement
Request to My Oracle Support Community FAQ.
The initial releases of our mobile apps were distributed in English only. From the
mobile apps developed with Oracle E-Business Suite Mobile Foundation Release 4.0, the
apps are available in the following languages: Brazilian Portuguese, Canadian French,
Dutch, English, French, German, Italian, Japanese, Latin American Spanish, Simplified
Chinese, and Spanish. Specifically, these mobile apps include:
• Version 1.3.x or version 1.0.x for Person Directory and Learning apps, with Oracle
E-Business Suite Mobile Foundation Release 4.0
• Version 1.4.x, version 1.1.x for Person Directory and Learning apps, or version 1.0.x
for Discrete Quality Manager, Process Quality Manager, and Self-Service Human
Resources, with Oracle E-Business Suite Mobile Foundation Release 5.0
• Version 1.5.0, version 1.2.0 for Person Directory and Learning apps, version 1.1.0 for
Discrete Quality Manager, Process Quality Manager, and Self-Service Human
Resources apps, or version 1.0.0 for mobile Yard app with Oracle E-Business Suite
Mobile Foundation Release 6.0
• Version 1.6.0, version 1.3.0 for Person Directory and Learning apps, version 1.2.0 for
Discrete Quality Manager, Process Quality Manager, and Self-Service Human
Resources apps, or version 1.1.0 for mobile Yard app with Oracle E-Business Suite
Mobile Foundation Release 7.0
For information on using these languages, see Setting Up and Using Supported
Languages, page F-1.
Oracle E-Business Suite mobile apps are compatible with both Release 12.1.3 and
Release 12.2.3 and onwards, as well as iOS 9.0 or higher and Android 4.4 or higher.
Users can run the mobile apps on any devices that are capable of running iOS 9.0 or
higher. Oracle E-Business Suite primarily tests its iOS mobile apps with iPhones, iPod
Touches, and iPads.
In general, users can run Android mobile apps on any devices that are capable of
running Android 4.4 or higher. Android device manufacturers often customize their
Android distributions. Due to the degree of Android fragmentation, Oracle E-Business
Suite cannot perform comprehensive device-specific certifications for this platform.
Oracle strongly encourages all customers to test candidate mobile devices with their
mission-critical Oracle E-Business Suite product flows before deploying those devices
broadly to their end users. Oracle E-Business Suite primarily tests its Android mobile
apps with Samsung Galaxy and Google Nexus devices. Reported issues that cannot be
reproduced on Samsung or Google devices will be analyzed on a one-on-one basis and
may need additional assistance from the device vendors first.
Oracle E-Business Suite mobile apps are developed using Oracle Mobile Application
Framework (Oracle MAF), as well as additional components specific to Oracle E-
Business Suite provided through the Oracle E-Business Suite Mobile Foundation.
Different versions of the mobile apps may require different configuration steps on the
Sizing Requirements
Because there are different product combinations, different user profiles, and different
configurations, there is no one sizing answer for all hardware platforms. Some
hardware vendors have sizing worksheets that model the CPU and memory
requirements of Oracle E-Business Suite on their hardware. The most reliable strategy to
ensure that the hardware is sized appropriately is to install a test environment, and then
conduct a benchmark test with a configuration, product mix, and user load that
simulates your own current and expected workloads. These conditions can help verify
performance before you install your production-ready environment. An alternative is to
ask Oracle Consulting Services or your hardware vendor to find another Oracle E-
Business Suite system running a product mix and user profile similar to yours.
General Sizing Guidelines
When planning your Oracle E-Business Suite mobile app deployment, consider the
following:
• You can support 150 to 180 mobile users per 2 GB of JVM heap.
• The initial heap size (Xms) and maximum allocated heap (Xmx) should both be set
to 2 GB per 150 to 180 users.
• One JVM is allocated per 2 CPUs in general. This is an actual CPU core rather than a
logical core.
• Use JVMs with a maximum of 4 GB, and scale for more users by using additional
JVMs. The benefits are:
• Garbage collection (GC) activity is easily balanced (automatically) with
multiple JVMs.
• Each instance will be able to utilize a separate connection pool. In essence, you
need to maintain a balance between the allocated JVM heap size per instance
and the available connection pool for that instance.
Setup Overview
Before letting the mobile users download and use an app, you need to perform
administrative tasks on the Oracle E-Business Suite server for your app. These tasks
include installing server patches, configuring the mobile app, granting the app access
role to responsibilities, completing additional setup tasks such as device integration if
required for your app, and validating the server URL before communicating the
information to the users.
The following diagram illustrates these high level setup tasks for the administrators to
perform on the server. Once the server-side setup is complete, the mobile users can start
to download and use the app on the go.
2. Configuring the Mobile Apps on the Oracle E-Business Suite Server, page 2-15
Note: Ensure that you run AutoConfig after applying the consolidated
product family patch for Oracle E-Business Suite Release 12.1. In Oracle
E-Business Suite Release 12.2, when you apply patches using the adop
(AD Online Patching) utility, adop runs AutoConfig by default.
To support the "Apps SSO Login" authentication (previously known as "Web SSO")
from Oracle E-Business Suite Mobile Foundation Release 4.0, you must also apply
required patches and perform additional setup tasks to enable the feature. See:
Additional Setup Tasks to Enable Apps SSO Login Authentication Security, page 2-33.
Tasks and Patches Required for Mobile Apps Built with Oracle E-Business Suite
Mobile Foundation Release 7.0
This section describes the patch information and tasks required for the mobile apps that
are built with Oracle E-Business Suite Mobile Foundation Release 7.0. Perform the
required tasks to apply prerequisite patches in the following sequence:
1. Performing Conditional Pre-Install Tasks, page 2-3
2. Applying Patches for Mobile Apps Built with Oracle E-Business Suite Mobile
Foundation Release 7.0, page 2-4
For information on prerequisite patches for earlier Oracle E-Business Suite Mobile
Foundation releases, see Product Family Patches for Earlier Oracle E-Business Suite
Mobile Foundation Releases, page B-1.
Oracle E-Business Suite Required only if you plan to Oracle Mobile Maintenance
Release 12.2 and 12.1.3 implement Oracle Mobile "Disconnected" feature uses
Maintenance for Oracle E- the Oracle Mobile Field
• Oracle Mobile Business Suite Service Multiplatform
Maintenance for Oracle framework, which does not
E-Business Suite require Oracle Lite and it
should be uninstalled.
Step 2: Applying Patches for Mobile Apps Built with Oracle E-Business Suite Mobile
Foundation Release 7.0
Important: If you install or upgrade your apps to the version built with
Oracle E-Business Suite Mobile Foundation Release 7.0, then you must
apply the server-side prerequisites through one of the methods
described in this section.
Starting from Oracle E-Business Suite Mobile Foundation Release 7.0, you can apply the
server-side patches in either of the following ways based on your needs:
• Apply the Oracle E-Business Suite level patch for your Oracle E-Business Suite
release
Oracle E-Business Suite Level Patches for Oracle E-Business Suite Mobile Foundation
Release 7.0
• Apply the product family level patch for your Oracle E-Business Suite release
If you plan to apply the patches only for the relevant product families, rather than
for all product families, use this approach to apply the patches for your Oracle E-
Business Suite mobile apps.
For example, if you use the Supplier Invoices and Timecards approval types in the
Approvals app, and you are upgrading only the Approvals app to the version built
with Oracle E-Business Suite Mobile Foundation 7.0, then you can apply the Oracle
E-Business Suite level consolidated patch for all product families. Alternatively, you
can apply only the relevant product family patches for your Oracle E-Business Suite
release level, in this case the Oracle Financials product family patch for Supplier
Invoices approvals and the Oracle Human Resources product family patch for
Timecard approvals.
The following table lists the product family and the corresponding product family
level consolidated patches for each app:
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
See: Oracle E-
Business Suite
Mobile Apps
Developer's
Guide, Release
12.1 and 12.2.
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Supplier
Invoices
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Timecard
approvals)
• Oracle Mobile
Timecards for
Oracle E-
Business Suite
• Oracle Mobile
Learning for
Oracle E-
Business Suite
• Oracle Mobile
Person
Directory for
Oracle E-
Business Suite
• Oracle Mobile
Self-Service
Human
Resources for
Oracle E-
Business Suite
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Quoting
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Requisition
approvals)
• Oracle Mobile
iProcurement
for Oracle E-
Business Suite
• Oracle Mobile
Procurement
for Oracle E-
Business Suite
• Oracle Mobile
Project
Manager for
Oracle E-
Business Suite
Oracle Supply Chain • Oracle Mobile Patch 24383271:R12. Merge and apply the
Management Approvals for SCM_PF.B: SCM following patches
(scm_pf) Oracle E- -12.1 Consolidated using the command:
Business Suite Patch For Mobile
• Patch 26571092:
(for Inventory Applications
approvals) Foundation V7 R12.EAM.C
• • Patch 24383496:
Oracle Mobile
Approvals for R12.SCM_PF.C:
Oracle E- SCM -12.2
Business Suite Consolidated
(for Product Patch For
Information Mobile
approvals) Applications
Foundation V7
• Oracle Mobile
adop
Approvals for phase=apply
Oracle E- patches=2657109
Business Suite 2,24383496
merge=yes
(for Order
Management
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for
Maintenance
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Service
Contracts
approvals)
• Oracle Mobile
Discrete
Production
Supervisor for
Oracle E-
Business Suite
• Oracle Mobile
Discrete
Quality
Manager for
Oracle E-
Business Suite
• Oracle Mobile
Inventory for
Oracle E-
Business Suite
• Oracle Mobile
Maintenance
for Oracle E-
Business Suite
• Oracle Mobile
Process
Production
Supervisor for
Oracle E-
Business Suite
• Oracle Mobile
Process Quality
Manager for
Oracle E-
Business Suite
• Oracle Mobile
Product
Information for
Oracle E-
Business Suite
• Oracle Mobile
Project
Manufacturing
for Oracle E-
Business Suite
• Oracle Mobile
Sales Orders
for Oracle E-
Business Suite
Prerequisites:
• Oracle E-
Business Suite
Release 12.2.3
• R12.SCM_PF.C.
Delta.4
• R12.AD.C.Delta.
9 & R12.TXK.C.
Delta.9
Oracle E-Business Suite Required for all Oracle E- • Release 12.2 and 12.1.3:
Release 12.2 and 12.1.3 Business Suite mobile apps, Patch 26000442
with Oracle E-Business Suite
• Oracle E-Business Suite Mobile Foundation Release
Mobile Foundation 7.0, connected to Oracle E-
Release 7.0 Online Help Business Suite Release 12.1.3
or Release 12.2
To implement Oracle seeded APIs for custom app development, the following patches
are available in Oracle E-Business Suite Mobile Foundation 7.1 for the APIs associated
with the Oracle Mobile Self-Service Human Resources for Oracle E-Business Suite
mobile app for Pay Information, Pay Simulator, and Change Pay:
• For Oracle E-Business Suite 12.2: patch 26831849:R12.PER.C
For more information about these APIs, see My Oracle Support Knowledge Document
2312158.1, FAQ for Accessing the Payslip and Pay Simulator REST APIs.
For implementation information on using these APIs, see: Implementing Oracle E-
Business Suite REST Services, Oracle E-Business Suite Mobile Apps Developer's Guide,
Release 12.1 and 12.2.
• Enabling and Setting Up Multiple Mobile Apps Using a Script, page 2-38
Note: This setup is a one-time process for each app. You can enable and
set up each app individually through the Mobile Applications Manager
UI pages or set up multiple apps simultaneously using a script.
After the initial setup, you can update the configuration parameters if
necessary. If the configuration is changed after the initial setup is
complete and loaded to a user's app, starting from the Oracle E-
Business Suite Mobile Foundation Release 7.0, the updated parameters
will be automatically downloaded to the app every five logins. See
Directing Users to Obtain Connection Details and Download Updates
from the Server, page 6-6.
The Oracle E-Business Suite mobile apps connectivity options can be illustrated in the
following diagram:
Enabling a Mobile App Individually and Specifying the Configuration Through the UI
Pages
To access Oracle E-Business Suite Mobile Applications Manager UI pages, log in to
Oracle E-Business Suite as a user who has the Mobile Applications Manager
responsibility.
Select the Mobile Applications Manager responsibility and choose the Applications
link from the navigator. The Search Mobile Applications page appears.
This Search Mobile Applications page is the entry point to access the application
definition details for each Oracle E-Business Suite mobile app. After performing a
search, a user who has the Mobile Applications Administrator role can perform the
following tasks from the search result table:
• View and validate the configuration for an app by clicking the Configuration File
icon.
See: Viewing and Validating Your Mobile App Configuration, page 2-30.
• View the device installation information for a mobile app by clicking the number of
users link either for iOS or Android.
See: Viewing Your Mobile App Installation Details, page 4-2.
• (Optional) Configure the required setup tasks for the Push Notification System by
clicking the Push Configuration button.
See: Configuring Oracle E-Business Suite Mobile Foundation Push Notification
System, page 3-10.
2. Select the Mobile Applications Manager responsibility and choose the Applications
link from the navigator.
3. In the Search Mobile Applications page, enter desired search criteria and click the
Search button. The page displays the mobile apps that match the search criteria in
the search result table.
Note: The Users and App Usage columns are available in Oracle E-
Business Suite Mobile Foundation 5.0 for viewing user installation
and app usage information. See: Viewing Mobile App Installation
and Usage Metrics, page 4-1.
For metadata information that you can enter in the search criteria to locate your
desired app, see Appendix C: Application Definition Metadata, page E-1.
4. Click the Configure icon for the mobile app that you want to configure from the
search result table.
5. Review the app details in the Configure Mobile Applications page. If the selected
app is not configured, change the status to "Enabled".
• Enabled: This allows you to configure the app against Oracle E-Business Suite.
• Disabled: The app was configured previously but is currently disabled. This
prevents any further configuration on the app against Oracle E-Business Suite.
If an app was configured successfully prior to setting its status to "Disabled",
the app will continue to work.
• Not Configured (default): The app's definition was just installed on the server
and it is not configured yet.
Supporting Apps Local Login for Local Authentication and Apps SSO Login for
Remote Authentication from Oracle E-Business Suite Mobile Foundation Release
4.0
With the "Connection Settings" category, the authentication type value ("Apps Local
Login" or "Apps SSO Login") for the selected app is displayed in the Sub Category
field. This value is predefined or selected during the app registration.
Oracle E-Business Suite mobile apps support the following authentication scenarios:
• Apps Local Login (default) - for local authentication
Apps Local Login is the default type for a mobile app to authenticate mobile
users locally. When this type is selected for a mobile app, the mobile app users
are authenticated locally against the Oracle E-Business Suite server.
The authentication type value determines the configuration parameters
required to set for your mobile app. For example, when "Apps Local Login" is
selected as the type, three associated parameters, that is, Session Timeout, Idle
Timeout, and Service Endpoint, are displayed in the Configuration Parameters
region.
For information on setting configuration parameters for the Apps Local Login
authentication type, see Configuring Parameters for the Apps Local Login
Authentication Type, page 2-23, as described in step 8.
You can override the default Apps Local Login type by selecting a desired
authentication type, such as "Apps SSO Login", from the Sub Category drop-
down list when needed. After the change, the parameters corresponding to the
selected authentication type will be loaded and displayed in the Configuration
Parameters region.
• You must apply required patches and perform additional setup tasks to
enable this feature.
See: Additional Setup Tasks to Enable Apps SSO Login Authentication
For information about single sign-on, see Single Sign-On (SSO), page 5-7.
For information on setting configuration parameters for the Apps SSO Login
authentication type, see Configuring Parameters for the Apps SSO Login
Authentication Type, page 2-26, as described in step 8.
For troubleshooting information, see: Troubleshooting Tips on Configuring
Apps with Apps SSO Login Authentication Type, page 6-21.
Note: The Sub Category field for mobile app authentication type is
available from Oracle E-Business Suite Mobile Foundation Release
4.0. In releases earlier than Oracle E-Business Suite Mobile
Foundation Release 4.0, the Sub Category field is not shown and
"Apps Local Login" is the only supported authentication type for
Oracle E-Business Suite mobile apps.
• Custom Oracle E-Business Suite mobile apps developed using the Login
component from Oracle E-Business Suite Mobile Foundation
If the selected app is one of the above supported apps, a mobile applications
developer can add the "Push Notifications" category while registering and defining
the application definition metadata for this app. For information on adding the
"Push Notifications" category during the app registration, see the Oracle E-Business
Suite Mobile Apps Developer's Guide, Release 12.1 and 12.2.
For information on setting the parameters for push notifications, see Configuring
Parameters for Push Notifications, page 2-28.
In order to receive push notifications from your mobile devices, ensure to complete
7. In the Configuration Categories region, optionally choose the Show link next to the
"Connection Settings" or "Push Notifications" category to display the parameters
corresponding to the selected authentication type or the parameters for the push
notifications. You can modify these parameter values for the configuration. If you
want to proceed with the default parameter values, skip the next step 8, and go to
step 9.
From Oracle E-Business Suite Mobile Foundation Release 4.0, what configuration
parameters are required to be included in the configuration file for the app depends
on the selected authentication type in the Sub Category field. If the selected app is
also enabled with push notifications, the relevant parameter settings for push
notifications are also included in the configuration file.
Configuring Parameters for the Apps Local Login Authentication Type
If the default "Apps Local Login" type (previously known as "HTTP Basic") is used
as the authentication type to authenticate users locally, update the following
parameter values:
• You can optionally override the default value by selecting an override type
and entering a corresponding override value.
• Constant: Enter a constant URL for your Oracle E-Business Suite
instance in the Override Value field.
• Profile Option: If you are storing the URL for your Oracle E-Business
Suite instance in a profile option, then you can enter the internal name
of that profile option in the Override Value field. In this case the
current value of the specified profile option will be used as the server
host URL.
Note: The "Apps SSO Login" type is previously known as the "Web
SSO" type.
• Select "Apps SSO Login" as the authentication type if you want
to delegate authentication to Oracle Access Manager based on a
protected Login URL.
• SSO Login URL (LoginURL): This is the login server URL that challenges the
user to authenticate with Oracle Access Manager (OAM).
If the URL is valid, a mobile app displays the login screen where a user enters
the credentials for user validation through Oracle Access Manager (OAM).
This parameter value can be obtained in the following ways:
• The default value for this parameter is the current value of "%
APPS_AUTH_AGENT%/login/sso".
• You can optionally override the default value by selecting an override type
and entering a corresponding override value.
• Constant: Enter a constant URL for your Oracle E-Business Suite
instance in the Override Value field.
• Profile Option: If you are storing the URL for your Oracle E-Business
Suite instance in a profile option, then you can enter the internal name
of that profile option in the Override Value field. In this case the
current value of the specified profile option will be used as the SSO
Login URL.
• SSO Logout URL (LogoutURL): This is the server-side URL that logs out a
mobile user by terminating the server session from Oracle Access Manager.
The default value for this parameter is the current value of "%
• SSO Login Success URL (LoginSuccessURL): This is the URL that indicates the
user has logged in successfully.
To determine the correct value for this parameter, navigate to the configured
SSO Login URL in a web browser session and then submit valid login
credentials. The URL that you are re-directed to after successful login is your
SSO Login Success URL.
Please note that this URL can be the same as the SSO Login URL. In this release,
the same URL is used for this SSO Login Success parameter and the SSO Login
URL parameter, and it is the current value of "%APPS_AUTH_AGENT%
/login/sso".
• SSO Login Failure URL (LoginFailureURL): This is the URL to redirect a user
to a login failure page after the authentication fails from the login page. This
parameter is reserved for future use.
9. Click the Apply button (or the Save and Generate Files button in Oracle E-Business
Suite Mobile Foundation releases earlier than Release 3.0). This action saves the
selected authentication type and relevant configuration parameters you specified to
the database to be used to generate the configuration file ebs-mobile-config.
xml during the initial launch of the app. When an app is launched for the first time,
the selected authentication type along with the configuration parameters including
the parameter settings for push notifications if available will be loaded to the app to
connect to an Oracle E-Business Suite instance, invoke configuration service to
download configuration data, and invoke Oracle E-Business Suite services with the
selected authentication type.
To validate the configuration, click the Configuration File icon from the search result
table. See: Viewing and Validating Your Mobile App Configuration, page 2-30.
On the client side, once the configuration file is downloaded from the server to the
mobile app during the initial login, it will be parsed to retrieve the configuration
parameters. The app user can view the downloaded parameters and connection details
from the mobile app in the device.
Mobile apps may have configuration updates after the initial launch. For example, an
administrator changes the timeout values or the service endpoint for an app, or an app's
server-side patch provides additional features that require the user to check for updates
as described in the patch readme. Starting from the Oracle E-Business Suite Mobile
Foundation Release 7.0, each app periodically checks for configuration updates and
automatically downloads them to the app from the Oracle E-Business Suite server.
Additionally, the user can still manually check if any new updates from the server are
required in the app if necessary. See Directing Users to Obtain Connection Details and
Initiate Server Updates, page 6-6.
Note that if the selected app is configured with push notifications, the relevant
parameter settings are also displayed as part of the configuration file.
Additionally, you can validate the configuration by accessing the configuration service
URL through a web browser. See Validating the Configuration, page 2-42.
• Distributions Region
This region describes the information about service version and distribution
• Configuration Region
If the selected mobile app is enabled and configured, this region displays the
configuration details for the selected app. It includes the desired authentication
type and the associated configuration parameters for the app.
If the app can be enabled with push notifications, this region may also include the
push notifications related parameters.
To update the selected mobile app details, click the Update button. See: Updating Your
Mobile App Definition, Oracle E-Business Suite Mobile Apps Developer's Guide, Release 12.1
and 12.2.
Additional Setup Tasks to Enable the Apps SSO Login Authentication Security
To support the "Apps SSO Login" (previously known as "Web SSO") authentication
type for remote authentication from Oracle E-Business Suite Mobile Foundation Release
4.0, in addition to integrating Oracle E-Business Suite with Oracle Access Manager for
single sign-on, you must perform additional setup tasks to enable the feature.
This section includes the following topics:
• Setup Tasks to Enable the Apps SSO Login Authentication Security, page 2-33
• Testing the Setup for the Apps SSO Login Authentication Security, page 2-37
Additionally, see Troubleshooting Tips on Configuring Apps With the Apps SSO Login
Authentication Type, page 6-21.
2. Deploy the Oracle E-Business Suite AccessGate application by following the setup
and configuration instructions in My Oracle Support Knowledge Document
1484024.1, Integrating Oracle E-Business Suite Release 12 with Oracle Access Manager
11gR2 (11.1.2) using Oracle E-Business Suite AccessGate.
2. Under the Launch Pad tab, navigate to Access Manager and then select
3. Select the identifier for your WebGate from the application domain search
result table.
7. Click Apply.
You should be able to access the newly-created public resource and verify the
functionality.
2. Import the root-CA certificates from the Oracle HTTP Server (OHS) wallet and
Oracle TLS CA certificates into the truststore of the managed server where the
Oracle E-Business Suite AccessGate application is deployed.
For information on obtaining private keys, digital certificates, and trusted
certificate authority (CA) certificates, see Configuring Identity and Trust, Oracle
Fusion Middleware Securing Oracle WebLogic Server.
2. Deploy the Oracle E-Business Suite AccessGate application by following the setup
and configuration instructions in My Oracle Support Knowledge Document
1576425.1, Integrating Oracle E-Business Suite Release 12.2 with Oracle Access Manager
11gR2 (11.1.2) using Oracle E-Business Suite AccessGate.
If you have already deployed an earlier version of the Oracle E-Business Suite
AccessGate application, refer to section 8.2 Oracle E-Business Suite AccessGate
Upgrade, My Oracle Support Knowledge Document 1576425.1.
If your Oracle E-Business Suite instance is TLS enabled and Oracle Access Manager
(OAM) configured, perform the following tasks:
1. Import the root-CA certificates from the OHS wallet into the truststore of the
OAEA managed server where the Oracle E-Business Suite AccessGate
application is deployed, if the root-CA certificates have not already been
imported.
2. If your Oracle Fusion Middleware version is earlier than 11.1.1.9, then you must
enable JSSE TLS in the Oracle E-Business Suite context file. Use Oracle
Applications Manager to update the Oracle E-Business Suite context file.
Prerequisites: Review My Oracle Support Knowledge Document 1617461.1,
Applying the Latest AD and TXK Release Update Packs to Oracle E-Business Suite
Release 12.2, and follow the instructions to apply the required codelevel of AD
and TXK for your system.
1. Log in to Oracle E-Business Suite as a system administrator.
3. Select the application tier context file, and choose Edit Parameters.
7. Enter a reason for the update, such as Enabling JSSE TLS. Then choose the
OK button.
8. Execute AutoConfig and restart all application tier services. For more
information about AutoConfig, see: Technical Configuration, Oracle E-
Business Suite Setup Guide.
Testing the Setup for the Apps SSO Login Authentication Security
To successfully log in to an Oracle E-Business Suite mobile app configured with the
Apps SSO Login security, you need to ensure successful HTTP(s) communication from
the Oracle E-Business Suite AccessGate managed server to the Oracle E-Business Suite
server.
1. Validate the communication by executing the following WGET command from the
managed server where the Oracle E-Business Suite AccessGate application is
deployed:
wget -d http(s)://<ebs_host>:<ebs_port>/OA_HTML/RF.jsp?
function_id=mLogin
2. Network port from the current managed server to Oracle E-Business Suite web
entry is NOT restricted.
2. Use the -D settings for setting up proxy host and port through the System
properties in JAVA_OPTIONS:
• For the HTTP protocol communication:
-Dhttp.proxyHost
-Dhttp.proxyPort
2. To configure all the Oracle E-Business Suite mobile apps at the same time, set the
attribute ConfigureAll in the Applications.xml file to Y at the root element
(applications) level. Otherwise, leave the ConfigureAll attribute to N and set the
Configure attribute to Y at the applications level for each particular app that you
want to configure.
• If you set the ConfigureAll attribute to Y, and set the "Configure" attribute to
N for an app at the application level, the ConfigureAll attribute set to Y at the
root element will override the value set at the Configure attribute and will
configure all the Oracle E-Business Suite mobile apps.
Note that the ConfigureAll attribute with its value set to Y at the root
element level only configures all the apps whose definitions exist in the
instance. If the definition of an app, (for example, the Timecards app) does not
exist in that instance, even thought you set the ConfigureAll attribute to Y,
only those apps that are defined in the instance will be configured, and the
Timecards app will not be configured. An appropriate message would be
shown as the output of the script indicating the result.
3. For each app you want to configure, change the status from the default
"NOT_CONFIGURED" to "ENABLED".
Note: If the select attribute for the "WEB_SSO" type (Apps SSO
Login) is set to Y, you must set the select attribute for the
"HTTP_BASIC" type to N. If both types are set to Y, then the
following errors may occur:
[java] There are two Authentication types selected for
the Application, <name> (such as EBS Approvals).
[java] There can be only one type of authentication
selected while configuring <name>.
5. Set each parameter type attribute to one of the following values only.
• SERVER_DEFAULT: The default value of the parameter is used to configure
the app. For example, 28800 is the server default for Session Timeout
parameter.
• CONSTANT: A constant override value is used to replace the default value for
the parameter. In this situation, provide a value for that parameter, such as a
constant URL for your Oracle E-Business Suite instance as a constant value for
the APPS_MOBILE_AGENT parameter.
The options listed above are the same as those are shown in the Configuration
Parameters region if you configure the app from the Mobile Applications Manager
UI pages.
6. After completing the changes in the template file Applications.xml, execute the
following command from the folder where the template file is placed to initiate the
configuration process.
ant -f EBSMblConfigApps.xml
If any validation error occurs during the configuration process, the error
information will be reported in the command line. Additionally, an error log file
EBSMblConfigError.log is created in the same directory to capture other types
of errors. You can use the generated log file to trace and troubleshoot the errors if
needed.
When the process is completed successfully, you can verify the configuration details
as described in Validating the Configuration, page 2-42 or validate the
configuration from the Mobile Applications Manager UI pages.
2. Copy the configuration service URL you just constructed and paste it into a
browser window. The configuration file is uploaded and displayed in the
browser window.
Please note that in Oracle E-Business Suite Mobile Foundation releases earlier
than Release 4.0, after you paste the configuration service URL into a browser
window, it is required to validate the Oracle E-Business Suite user name and
password before the configuration service uploads the configuration file to the
browser window.
3. Verify the content to ensure that the configuration file for your mobile app is
valid, well-formed XML, and validate that the configuration parameter values
are the same values as configured from the Mobile Applications Manager UI
2. Install an app on a mobile device and verify if the server URL is accessible through
the configuration screen in the mobile app by performing the following
configuration steps:
1. Enter the server URL in the following format: http(s)://<hostname>:
<port>
2. Check whether the configuration on the device was successful by logging into
the app and verifying that you can access the app content.
Please note the difference between the full configuration service URL used for
validation in step 1 in this section and the server URL shared with the app users.
For more information about the configuration steps in earlier Oracle E-Business Suite
Mobile Foundation releases, see Oracle E-Business Suite Mobile Foundation Release
Update History, Oracle E-Business Suite Mobile Foundation Release Notes, My Oracle
Support Knowledge Document 1642431.1.
Note: Oracle Mobile Approvals for Oracle E-Business Suite does not
have an app-specific access role required for users to access the app.
For Oracle E-Business Suite mobile apps, responsibility selection is based on the
combination of user role and mobile app. If the mobile app access role is assigned to a
single responsibility, then the responsibility is automatically set and selected for a user
using that mobile app. If a user has more than one responsibility to which the mobile
app access role is assigned, then those responsibilities will be displayed for selection.
Please note that it is not required to create or assign any new responsibility to users to
use mobile apps. For information on the app-specific access roles, see Appendix A:
Mobile App Access Roles, page C-1.
2. Select the User Management responsibility and navigate to the Roles and Role
Inheritance page.
4. In the search results table, click the "View In Hierarchy" icon for your responsibility.
Note that the codes for responsibilities start with FND_RESP, while the codes for
roles start with UMX.
5. In the Role Inheritance Hierarchy, click the Add Node icon for your responsibility.
Oracle User Management displays the next role hierarchy page with a message
informing you that the role you select will be inherited. In this page, either search or
expand nodes until you find the app-specific access role that you want to add to the
responsibility. Use the Quick Select icon to choose that role.
6. Oracle User Management then displays the initial page again, with a confirmation
message at the top. On this page, verify that the custom UMX role appears
underneath the responsibility. You may need to expand one or more nodes to
display the UMX role under the responsibility. Any other inherited roles appear as
well.
7. When you add the role to the responsibility, you must also update the associated
grant for the app-specific access roles to reference the specific responsibility as the
security context. You need a separate grant for each responsibility to which you are
8. In the Grants Table at the end of the page, if this is the first responsibility to which
you are adding to the role, click the Update icon for the grant you want to update. If
this is the second responsibility or more to which you are adding the role, click the
Duplicate icon for the grant instead of the Update icon. In the duplicate grant, you
must provide a unique name for the grant.
If you want to use the app-specific access role with more than one responsibility, you
must have a separate grant with a security context corresponding to each responsibility.
You can also add grants for a given role as a separate process, rather than while you are
adding the role to the responsibility. To do so, perform the following steps:
1. In the User Management responsibility, navigate to the Roles and Role Inheritance
page.
3. Click the Update icon for your role to navigate to the Update Role page.
4. In the Grants Table at the end of the page, click the Duplicate icon for the grant you
want to duplicate.
6. In the Security Context region, enter the name of the additional responsibility to
which you are adding the app-specific access role. Enter the name of a shipped
responsibility from the table above, or, if you are using a custom responsibility,
enter the name of that custom responsibility.
For more information, see the Oracle E-Business Suite Security Guide.
If your mobile app integrates with person contact cards and you would like to show the
contact information within the context of the app, perform the setup tasks described in
this section:
1. Step 1: Setting Up a Qualifier, page 2-48
2. Step 2: Scheduling the "HR Mobile Utils Person Data Full Synch" Concurrent
Program, page 2-58
2. Step 1.2: Identifying the Flexfield Structure for Your Business Group, page 2-50
3. Step 1.3: Enabling the Qualifier for the Flexfield Segment, page 2-53
4. Step 1.4: Adding the "HR Mobile Utils Person Data Full Synch" Concurrent
Program to a Request Group, page 2-55
2. Select the Application Developer responsibility. Choose the Flexfield link, then the
Key link, and then the Register link from the navigator. This displays the Key
Flexfields window.
3. In the Key Flexfields window, search for the flexfield with the title "Job Flexfield"
and the application name "Human Resources".
4. Click the Qualifiers button. Enter the following case sensitive information in the
Flexfield Qualifiers window and then save.
• Name: Mobile
• Prompt: Mobile
• Ensure that the Global, Required, and Unique check boxes are not selected
Step 1.2: Identifying the Flexfield Structure for Your Business Group
Perform the following steps to identify the flexfield structure for your business group:
1. Log in to Oracle E-Business Suite as a user who has the HRMS Manager
responsibility.
2. Select the HRMS Manager responsibility. Choose the Work Structures link, then the
Organization link, and then the Description link from the navigator.
3. In the Find Organization window, query your business group in the Name field,
such as "Vision Corporation". Click the Find button. This displays the Organization
window for the selected organization.
4. In the Organization Classifications region, select "Business Group" and click the
Others button.
7. The complete Business Group Info window is displayed. This is the structure for
the Job Flexfield for your business group. Copy the value in the Job Flexfield
Structure field. This value will be used later to locate the flexfield that you want to
qualify.
2. In the Key Flexfield Segments window, search for the flexfield with the application
name "Human Resources" and the flexfield title that you obtained from the Job
Flexfield Structure field described in Step 1.2: Identifying the Flexfield Structure for
Your Business Group, page 2-50, such as "Job Flexfield".
3. In the Structures region, select the Job Flexfield and then deselect the Freeze
Flexfield Definition check box. This allows you to update the selected Job Flexfield
definition. Click the Segments button. This displays the Segments Summary
window for the selected Job Flexfield.
4. Select the segment you want to qualify and click the Flexfield Qualifiers button.
5. Select the qualifier "Mobile" and then select the Enabled check box to enable the
selected qualifier for this segment. Save your work.
Step 1.4: Adding the "HR Mobile Utils Person Data Full Synch" Concurrent Program to a Request Group
Perform the following steps to add the "HR Mobile Utils Person Data Full Synch"
concurrent program to a request group, and then run the program for the first time:
Note: Ensure that you have applied the patches for your app. The "HR
Mobile Utils Person Data Full Synch" concurrent program should then
be automatically created.
For patch information for each app, see Applying Prerequisite Patches,
page 2-2.
1. Log in to Oracle E-Business Suite as a user who has the System Administrator
responsibility. For example, log in as SYSADMIN.
2. Select the System Administrator responsibility. Choose the Security link, then the
Responsibility link, and then the Define link from the navigator. This displays the
Responsibilities window.
3. In the Responsibilities window, search for the responsibility, such as "US Super
HRMS Manager", that you want to run the "HR Mobile Utils Person Data Full
Synch" concurrent program.
4. In the Request Group region, record the value of the request group Name field
which in this example is "US SHRMS Reports & Processes" for the "US Super HRMS
Manager" responsibility. Close the window.
5. From the navigator, select the Security link, then the Responsibility link, and then
the Request link. This displays the Request Groups window.
6. In the Request Groups window, search for the request group name "US SHRMS
Reports & Processes" you recorded earlier in the Group field.
7. In the Requests region, click the New icon to add the "HR Mobile Utils Person Data
Full Synch" concurrent program to this security group. Save your entry and close
the window.
8. From the navigator, select the Requests link and then the Run link. This displays
the Submit Request window.
9. Enter the "HR Mobile Utils Person Data Full Synch" concurrent program as the
request name.
10. Select "Person Card" as the Process Name parameter. Click OK and Submit to
execute the request for the first time. This concurrent request refreshes the related
HR tables with the person data.
Step 2: Scheduling the "HR Mobile Utils Person Data Full Synch" Concurrent Program
After adding the "HR Mobile Utils Person Data Full Synch" concurrent program to a
request group and executing the concurrent request for the first time, you can schedule
the concurrent request be run at the desired frequency to refresh the related tables with
the latest person data.
Note: Unlike iOS mobile users, Android users do not have the option to
choose whether or not to grant an app permission to access the local
contacts on the devices. While installing an app from Google Play,
users must grant the following permissions to the app:
• From the PRIVACY section: read phone status and identity, receive
text messages (SMS), modify your contacts, read your contacts,
modify or delete the contents of your USB storage, read the
contents of your USB storage, and find accounts on the device
• From the Device Access section: full network access, and view
network connections
If a user does not grant these permissions, then the app will not be
installed.
After installing the app, users can review the permissions by tapping
Settings, then App Name, and then Permissions on their Android
devices.
For example, Oracle Mobile iProcurement for Oracle E-Business Suite requests the
permission to access the user's local contacts on the iOS device as shown below:
Note: iOS mobile users can modify the setting that determines whether
the app can access local contacts at any time by tapping Settings, then
Privacy, and then Contacts on their iOS devices.
On Android devices, and if the user gives permission on an iOS device, the app will
fetch the person information from the local contacts along with the enterprise
information from Oracle E-Business Suite as shown below.
Note: Saving person contacts will not save the person's image to local
contacts on the Android devices. The app on Android always displays
the images for the person contacts from enterprise contacts. If the image
of an enterprise contact is not present, then the app displays the person
contact only without the image on the Android devices.
Note: Oracle E-Business Suite mobile apps use the email address for an
enterprise contact to determine whether the enterprise contact matches
any existing local contact on the device.
Please note that if the setup tasks for person contact cards are not performed properly,
depending on how your app is integrated with person contact cards, either the app
page that includes person contact (such as the Requisition page shown above) shows a
Setting Up Maps
Mobile Apps Integrated with Maps
The following Oracle E-Business Suite mobile apps integrate with maps:
• Oracle Mobile Learning for Oracle E-Business Suite (Google Maps)
• Oracle Mobile Person Directory for Oracle E-Business Suite (Google Maps)
• Oracle Mobile Product Information for Oracle E-Business Suite (Google Maps)
• Oracle Mobile Self-Service Human Resources for Oracle E-Business Suite (Google
Maps)
For example, Oracle Mobile Product Information for Oracle E-Business Suite presents
the supplier information and its geographical location in a Google map as shown below.
Note: Any use of this map is subject to Google's Privacy Policy and not
Oracle's Privacy Policy.
Oracle Mobile Maintenance for Oracle E-Business Suite presents the asset information
and its geographical location in an Oracle map as shown below.
For example, Oracle Mobile Maintenance for Oracle E-Business Suite uses barcode
scanning to capture data for assets, work orders, and work requests.
• Data Matrix
• UPC E
• UPC A
• EAN 8
• EAN 13
• Code 128
• Code 39
• Oracle Mobile Maintenance for Oracle E-Business Suite (for the "Disconnected"
functionality)
For the list of Oracle E-Business Suite mobile apps mentioned here, see the Oracle E-
Business Suite Mobile Apps, Release 12.1 and 12.2 Documentation Index, My Oracle Support
Knowledge Document 1641772.1.
If you modify the topology of your Oracle E-Business Suite server in a way that
changes the server URL, then you must inform the app users of the new URL. The
users must update the server URL in the device settings from the mobile home page
to trigger the reconfiguration process for the app.
Note that in Oracle E-Business Suite Mobile Foundation Release 2.0, a modification
entered in the iOS device settings will not trigger the reconfiguration process. To
connect the mobile app to a different server, mobile users must uninstall the mobile
app and then install it again. See the Oracle E-Business Suite Mobile Foundation
Release Update History, Oracle E-Business Suite Mobile Foundation Release Notes, My
Oracle Support Knowledge Document 1642431.1.
Please note that Oracle tests the client app and server patch
combinations with N-1 policy where N is the latest Oracle E-
Business Suite mobile app release that contains both the
corresponding client app version and the associated server patches.
The latest client app version is expected to work with one previous
version of the server patches. However, Oracle strongly
recommends that you keep both the server and client versions the
same in order to leverage the latest app features.
For required patch information for each Oracle E-Business Suite
Mobile Foundation release, refer to Applying Prerequisite Patches
on the Oracle E-Business Suite Server, page 2-2.
If neither ebs-mobile-config.xml nor connections.xml can
be found, then an error appears indicating that this mobile app is
not currently configured on the server.
Overview
This chapter explains the concept and architecture of Oracle E-Business Suite Mobile
Foundation Push Notification System (or the Push Notification System thereafter) and
the required configuration tasks to enable this feature for the supported mobile apps.
Specifically, this chapter includes the following topics:
• Understanding Oracle E-Business Suite Mobile Foundation Push Notification
System, page 3-1
• Setting Up and Enabling Push Notifications for Oracle E-Business Suite Mobile
Apps, page 3-5
To better understand these components and how the system works to deliver push
notifications, the following diagram illustrates the high level architecture of the Push
Notifications System:
Push notifications can be sent from the server to supported mobile apps using the
following flows:
• A Mobile App Registers to Receive Push Notifications
In order for the Oracle E-Business Suite server to send push notifications to mobile
devices, it needs a list of mobile users, the apps that those users have installed, and
the unique IDs corresponding to the apps on each user's device where the
notifications will be sent.
• Step 1: A mobile user launches a mobile app.
• Step 3: When the user signs in to the app, the mobile app invokes the Oracle E-
Business Suite REST API called "Push Register" (mPushRegister) to register
the push token or registration ID with Oracle E-Business Suite Mobile
Foundation for that user and the mobile app.
• Step 4: Oracle E-Business Suite invokes the MCS "Register Device" REST API (
/mobile/platform/devices/register) to propagate the push token or
registration ID from Oracle E-Business Suite to Oracle Mobile Cloud Service
The same user can install the same app on multiple devices. A registration is
created for each installation of the app to receive push notifications.
• Step 6: The Push Notification System builds the notification payload targeted
for that user and the app, and enqueues the payload to the
FND_MBL_NOTIFICATION_OUT queue.
• Step 8: Oracle Mobile Cloud Service delivers the notification to all registered
devices for that Oracle E-Business Suite user through the corresponding
platform's push notification service, such as APNs for iOS and FCM for
Android.
Please note that Oracle E-Business Suite only delivers one push notification for the
user of a given app to Oracle Mobile Cloud Service. If the user had installed the
same app on multiple devices, Oracle Mobile Cloud Service delivers the same
notification to all the devices for that user.
Setting Up and Enabling Push Notifications for Oracle E-Business Suite Mobile Apps
To set up the Push Notification System and enable the mobile apps, you need to
perform the following setup tasks:
1. Setting Up a FCM Project for Android Push Notifications Only (Optional), page 3-
6
2. In the Project Settings, record the values of the Server Key and Sender ID for Cloud
Messaging.
You will use the Sender ID and Server Key you recorded here when creating the
Android mobile client in Oracle Mobile Cloud Service. See: Creating Mobile Clients,
page 3-7.
You will use the same Sender ID when configuring the Push Notification System in
the Mobile Push Notification Configuration page. See: Configuring Oracle E-
Business Suite Mobile Foundation Push Notification System, page 3-10.
2. Create a mobile backend to be used specifically for Oracle E-Business Suite push
notifications.
For more information, see Mobile Backends, Oracle Cloud Using Oracle Mobile Cloud
Service (https://docs.oracle.com/en/cloud/paas/mobile-cloud/mcsua/mobile-
backends.html).
2. Click the menu icon to open the side menu. Select Application, and then Client
Management. Create a client for each Oracle E-Business Suite mobile app
distribution.
For example, if you would like to receive push notifications for both iOS and
Android distributions of an enterprise-distributed Approvals app, you have to
register one client each for each platform.
3. When creating a client, use correct Bundle ID or Package Name that has been used
to deploy your mobile app.
• Package Name (Android): The Package Name used in the deployment profile to
create the Android app.
• Android: Use the values of Sender ID and Server Key you recorded earlier for
the Firebase project.
For information on obtaining the project number and the Server Key, see:
Setting Up a FCM Project for Android Push Notifications Only (Optional), page
3-6.
5. Associate each client with the mobile backend that you created earlier for Oracle E-
Business Suite.
See: Creating a Mobile Backend, page 3-7.
For more information about client management, see Client Management, Oracle Cloud
Using Oracle Mobile Cloud Service (https://docs.oracle.com/en/cloud/paas/mobile-
cloud/mcsua/client-management.html).
2. Click the menu icon to open the side menu. Select Application, and then Mobile
User Management.
4. Create a user who will be used to register this MCS backend with Oracle E-Business
Suite.
6. The user created in the MCS backend appears with a default role associated with
the MCS instance.
For example, the default role is Default
(mcsinst_MobileEnvironment_Default_1_0_Realm).
These two roles described here are important for Oracle E-Business Suite to connect to
this Oracle Mobile Cloud Service instance to deliver push notifications.
For more information, see Mobile User Management, Oracle Cloud Using Oracle Mobile
Cloud Service (https://docs.oracle.com/en/cloud/paas/mobile-cloud/mcsua/mobile-user-
management1.html).
2. Open the mobile backend you created earlier for Oracle E-Business Suite. Select the
Settings page.
3. Under Access Keys, enable the "HTTP Basic" authentication by turning the switch to
ON.
When switched to ON, the access keys that you need are displayed.
4. Record the following information that will be used later in Configuring Oracle E-
Business Suite Mobile Foundation Push Notification System, page 3-10.
• Mobile Backend ID under HTTP Basic
Once the setup is complete, you are ready to configure the Push Notification System to
connect to Oracle Mobile Cloud Service.
Perform the following tasks to configure the Push Notification System and required
component parameters:
1. Specify the following information to enable the Push Notification System:
• Push Notification System: Enabled
2. In the Mobile Cloud Service (MCS) Parameters region, enter the following
information for Oracle Mobile Cloud Service:
Note: For the MCS Backend ID, URL, Username, and Password
fields, use the information you recorded earlier while enabling the
HTTP Basic authentication in Oracle Mobile Cloud Service, See:
• MCS Backend ID: Enter the value that you recorded earlier when creating the
MCS backend for Oracle E-Business Suite push notifications.
See: Creating a Mobile Backend, page 3-7.
• MCS Backend URL: Specify the desired URL for Oracle Mobile Cloud Service.
• MCS Username: Enter the Mobile Cloud Service user who has appropriate
notification user roles.
MCS credentials are used by the Push Notifications System to connect to Oracle
Mobile Cloud Service to register devices and send push notifications. The MCS
user must have the following roles assigned:
• Mobile Notifications (mcsinst Mobile Notifications)
• Default (mcsinst_MobileEnvironment_Default_1_0_Realm)
If the MCS credentials are invalid or if required roles are not granted to the user
in Oracle Mobile Cloud Service, the configuration will fail.
For information on creating a mobile user with MCS credentials, see: Creating
an Oracle Mobile Cloud Service User Account, page 3-8.
• Android Sender ID: Enter the Sender ID used to create the Android push
notification profile when creating the Android client in Oracle Mobile Cloud
Service. See: Creating Mobile Clients, page 3-7.
In order for the Push Notification System to work correctly, the following Service
Components should be running.
• Workflow Java Deferred Agent Listener - Processes business events to synchronize
device registrations for push notifications from Oracle E-Business Suite to Oracle
Mobile Cloud Service.
Log in to Oracle E-Business Suite as a user who has the System Administrator
responsibility. Select the Oracle Applications Manager link, and then Workflow
Manager to ensure these two components are running.
Note: If an app can be enabled with push notifications, during the app
registration, a developer can define the application definition metadata
by adding the "Push Notifications" category along with the relevant
parameters in the Configuration Details page for the app. See:
Registering Your Mobile App, Oracle E-Business Suite Mobile Apps
Developer's Guide, Release 12.1 and 12.2.
After the registration, you can enable the app and update the push
notifications parameters if desired in the Configure Mobile
Applications page.
3. Search for the app that supports push notifications. For example, select the
enterprise-distributed Approvals app called XXX_APPROVALS.
4. Click the Configure icon for the selected app XXX_APPROVALS that you want to
configure with push notifications from the search result table.
The Configure Mobile Applications page appears.
6. Expand the "Push Notifications" category by clicking the Details icon. Enter the
following values:
Additionally, after configuring the mobile app, you can invoke the configuration service
corresponding to that mobile app and confirm the following values:
• Android Sender ID
This value is the same as the following:
• Android Sender ID: It is used to set up the Oracle E-Business Suite Mobile
Foundation Push Notification System. See: Configuring Oracle E-Business Suite
Mobile Foundation Push Notification System, page 3-10.
• Push Status
This should be ENABLED for the mobile app to successfully receive push
notifications.
Overview
This chapter describes various administrative tasks that you would perform to better
understand how your app is currently installed and used. It includes the following
topics:
• Viewing Mobile App Installation and Usage Metrics, page 4-1
Note: These features are available from Oracle E-Business Suite Mobile
Foundation Release 5.0 and are only available for users who have the
Mobile Applications Administrator role. Users who have the Mobile
Applications Developer role cannot find the Users and App Usage
columns from the search result table.
To view user installations and usage metrics for an app, select the Mobile Applications
Manager responsibility and choose the Applications link from the navigator. The
Search Mobile Applications page appears.
Perform the following tasks to view user installation and app usage information:
• Click the number of users link for iOS or Android to view the installation
information for a desired app.
See: Viewing Your Mobile App Installation Details, page 4-2.
• Click the App Usage icon to view the mobile usage information.
See: Viewing Your Mobile App Usage, page 4-4.
The installation details include the name of the users who have installed the app (such
as "EBS Approvals"), last login date and time, app version, device or platform
information (either iOS or Android, depending on your selection from the Users
column in the search result table), device OS version, and device model information
(such as iPhone, iPad, or Android).
In the Filter Criteria region, you can further refine the result by modifying the following
fields for the same app or obtain the information for a different app.
• Application: This field is automatically displayed with your selected app name
from the search result table.
If you want to view the user installations for a different app, select a desired app
from the Application drop-down menu.
• User Name: Specify a desired user name if you want to view the installation for that
user.
You can click Export to export all the data to an Excel spreadsheet if desired.
Click the Return to Application Search link to return back to the Search Mobile
Applications page.
For information on viewing app usage information, see Viewing Your Mobile App
Usage, page 4-4.
In the Filter Criteria region, enter the following information to view the app usage
information:
• Application: This field is automatically displayed with your desired app name.
Select a different name if you want to view the usage information for another app.
• Range: Enter a numeric number in the text box as the time range, and select a
desired range unit, such as "hours" or "days". For example, obtain the number of
logins for an app within the last 47 hours or the last 24 days.
Please note that if "hours" is selected as the range unit, the number you specify in
the text box should be less than "48" hours. Otherwise, an error message appears.
After you modify the filter criteria and click Go, the app usage information is displayed
in a table with the app login date and login count.
To export the data to an Excel spreadsheet, click Export.
Click the Return to Application Search link to return back to the Search Mobile
Applications page.
Important: The "Mobile Metrics Purge Program" only purges the mobile
app usage data. The data for user installations will not be purged.
To access this concurrent program, log in to Oracle E-Business Suite as a user who has
the System Administrator responsibility. Select Concurrent, and then Requests from
the navigation menu.
In the Submit Request window, select "Mobile Metrics Purge Program" as the Name
from the drop-down list.
After you select "Mobile Metrics Purge Program" as the concurrent program name, the
Parameters window appears. Specify a number of days in the Retention Age in Days
field to indicate the desired days that you intend to retain the data. All the app usage
data that is older than the specified days will be purged.
For example, if you desire to keep the data within the last 30 days, then enter "30" in the
Retention Age in Days field. The app usage data stored in the database older than the
last 30 days will be removed, but the data for user installations remains intact and will
not be purged.
After you specify the information in the Parameters window and click OK, the specified
Click Submit to submit your concurrent request and start the process of purging the
app usage data based on the specified parameter.
Overview
This chapter describes requirements for using advanced configurations with Oracle E-
Business Suite mobile apps. It includes the following sections:
1. Demilitarized Zone (DMZ), page 5-1
• For DMZ configuration instructions on Oracle E-Business Suite Release 12.2, see My
Oracle Support Knowledge Document 1375670.1.
Note: For any responsibility to which you have assigned the mobile
app access role, as described in Setting Up Mobile App Access to
Responsibilities, page 2-45, to allow mobile users to access the
responsibility from an external node in a DMZ configuration, set the
Additionally, when setting up the configuration file for your mobile app, ensure that
the value of the Service Endpoint parameter (or the Server Host URL parameter in
Oracle E-Business Suite Mobile Foundation releases earlier than Release 2.1) is set to
your external web entry point.
For information on configuring your mobile app, see Enabling a Mobile App
Individually and Specifying the Configuration Through the UI Pages, page 2-16.
Note: If you use the Configure Mobile Applications page to set up the
configuration parameters, note that the value for the Service Endpoint
parameter defaults to the current value of the
APPS_FRAMEWORK_AGENT profile option. However, if you are
accessing this page from your intranet, then the current value of the
APPS_FRAMEWORK_AGENT profile option will be your internal web
entry point. In this case, to allow access from mobile apps to Oracle E-
Business Suite over the Internet, you must manually specify an
override value for the Service Endpoint parameter to set it to the
external web entry point.
3. Upload the certificate file to an internal server where your mobile users can
access from their mobile devices.
4. Ask your mobile users to install required Oracle E-Business Suite mobile apps.
5. Open the certificate file from the internal server using the mobile device's web
browser.
• For iOS devices, use Safari web browser to open the certificate file.
• For Android devices, use Chrome web browser to open the certificate file.
6. When prompted, select the Oracle E-Business Suite mobile app to open the
certificate file with so that it is imported into that app.
8. Repeat the tasks from step 5 to step 7 for each Oracle E-Business Suite mobile
app that should connect to that server.
Note: For Oracle Mobile Learning for Oracle E-Business Suite, apart
from importing the certificate with extension .servercert to the
app, download and install the original certificate <ca-cert-
filename>.cer to the device's user truststore (not system
truststore) in order to play the course content.
String inputLine;
while ((inputLine = in.readLine()) != null)
System.out.println(inputLine);
in.close();
}
}
3. Compile Url.java using the following command, assuming that you have Java 8
JDK installed in the ~/jdk1.8/directory:
$ ~/jdk1.8/bin/javac Url.java
4. Run Url.class using the following commands, assuming that you have Java 8
JDK installed in the ~/jdk1.8/directory:
$ ~/jdk1.8/jre/bin/java -Dhttps.protocols=TLSv1 Url https:
//ebs.example.com:4443/robots.txt
Replace the sample input URL in this example with the specific URL for your
Oracle E-Business Suite TLS endpoint.
If HTML content is returned as the result after you execute these commands,
then the TLS handshake is successful. If the following exceptions appear
instead, then the TLS certificate on the server is not recognized by the JDK 8
Please note that these exceptions could also happen for a trusted certificate if
the certificate chain is incomplete.
2. Validate that the Oracle E-Business Suite TLS endpoint presents the complete
certificate chain.
Please note that even if the Oracle E-Business Suite TLS endpoint is configured with
a certificate from a commercial CA, the TLS handshake could still fail. Use the
following steps to verify if the server presents the full certificate chain where the
CA's certificate is present:
1. Connect to the TLS endpoint using openssl with the -showcerts option:
openssl s_client -connect ebs.example.com:4443 -showcerts
Alternatively, use the following commands for more condensed results:
openssl s_client -connect ebs.example.com:4443 -showcerts
2>/dev/null | sed '/BEGIN CERT/,/END CERT/d' | sed -n
'/^Certificate chain/,/^---/ p'
These commands should display the complete certificate chain and the actual
certificate content. For example,
• The certificate chain is displayed as 0 -> 1.
• The condensed version of the actual certificate chain content can be:
2. Ensure that the displayed certificate chain refers to a root CA whose certificate
exists in the mobile client's truststore. In addition, ensure that the last certificate
states that this root CA is its issuer.
For a list of root CAs trusted by the mobile client, see Migrating to New cacerts
File for SSL in MAF 2.x.x, Oracle Mobile Application Framework Installing Oracle
Mobile Application Framework.
3. Ensure that you not only configure the server certificate, but also provide the
certificates of any intermediate CAs.
Note: The "Apps SSO Login" type corresponds to the "Web SSO"
authentication server type used in Oracle Mobile Application
Framework.
• For both browser-based applications and mobile apps, Oracle E-Business Suite
certifies the form-based challenge method only.
• If you encounter issues during the configuration of Oracle Access Manager with
alternative authentication mechanisms, you may contact Oracle Support for
diagnosing issues related to Oracle Access Manager.
• Authenticating users locally with the "Apps Local Login" (previously known as
"HTTP Basic") authentication type
For mobile apps that are configured with the default "Apps Local Login"
authentication type for authenticating users locally against the Oracle E-Business
Suite server, passwords must be stored in Oracle E-Business Suite.
If user passwords are externally stored and are not accessible which indicates that
your instance is single sign-on enabled, configure your app with the "Apps SSO
Login" authentication type instead.
For more information about configuring your apps with these authentication scenarios,
see Enabling and Configuring a Mobile App Individually, page 2-19.
Overview
This chapter describes how to enable logging and diagnostics features as well as how to
troubleshoot possible issues from the mobile client and the server. It includes the
following sections:
• Enabling the Logging and Diagnostics Features, page 6-1
• Client logging
To better understand these logging and auditing features, this section includes the
following topics:
• Enabling Server Logging, page 6-2
Note: Use the app-specific REST service module names to set the FND:
Debug Log Module profile option. These module names are listed in
Appendix B: Mobile App Module Names, page D-1.
For information on enabling the logging and diagnostics features, refer to the Oracle E-
Business Suite Maintenance Guide.
Retrieving Server Logs
To retrieve the server logs recorded for your mobile app, perform the following steps:
1. Log in to Oracle E-Business Suite as the SYSADMIN user. Select the System
Administrator (or System Administration) responsibility and choose the Oracle
Applications Manager link and then the Logs link from the navigation menu.
2. In the Search System Logs page, click the Advanced Search button.
• Module: Enter the REST service module name of the mobile app.
4. Execute the search to retrieve and download the desired server logs.
• For Oracle E-Business Suite Mobile Foundation Release 2.0, set this profile
option to "MOBILE".
Note that the same logging profile options are used to enable the server and client
logging, as well as the REST service auditing. It is recommended that you use the
following sequence when troubleshooting both server and client code at the same time.
1. Turn on the server logging to obtain log statements written by REST services. For
information on setting profile options for server logging, see Enabling Server
Logging, page 6-2.
2. Direct the app user to turn on diagnostics logging on the mobile client.
3. Direct the app user to reproduce the issue that invokes the REST services.
Log statements from the REST services should be recorded. However, the server
cannot receive the client log file at this point.
4. Set the profile options as described in this section for the user to receive the client
log file.
The client and server logging can happen at the same time when an issue is being
reproduced. However, to upload the log file, the profile options should be changed
to receive the log file after the issue is reproduced.
5. Request the mobile app user to upload the log file from the mobile client to the
server.
6. Retrieve the REST service log statements based on the profile options set in step 1.
7. Retrieve the mobile client log file uploaded based on profile options set in step 4.
4. In the Diagnostics screen, tap the Upload icon on the top right corner. This displays
the upload screen where app users can upload the log files recorded for the app to
the Oracle E-Business Suite server.
5. You can then download the uploaded log files from the Oracle E-Business Suite
server.
To retrieve client logs, follow the steps described in Enabling Server Logging, page
6-2. However, use the following search criteria to locate the client logs:
• User: Enter the mobile app user name.
• For Oracle E-Business Suite Mobile Foundation Release 2.1 and onwards,
enter your Application Bundle Id as the Module name.
For information on Application Bundle Id for each mobile app, see
Appendix C: Application Definition Metadata, page E-1.
Please note that if the FND: Diagnostics profile option is enabled for a user, the
complete error stack from the service invocation failure appears. Otherwise, only a
simple error message is shown instead.
Note: The option of retrieving client logs directly from iOS devices is
not available.
1. Use a file browser app on Android. For example, My Files, ES File Explorer.
2. Look for files that start with the app name. For example, Approvals.txt,
Approvals_bak.txt.
3. Attach these files to an email through your preferred email app and upload to
Oracle Support.
Note: The REST service payloads can be logged for auditing only when
the server logging is also enabled.
If the REST service auditing feature is not required, you can choose to
enable the server logging only. See Enabling Server Logging, page 6-2.
2. Set the following server logging profile options for the app users:
• FND: Debug Log Enabled (AFLOG_ENABLED)
Set this profile option to Yes to enable the debug logging.
If you want to use both logs and auditing to troubleshoot an issue with the
underlying REST services, set the FND: Debug Log Level profile option to
STATEMENT and set the FND: Debug Log Module profile option as described in
this section.
Troubleshooting Tips
This section includes the following troubleshooting information on potential problem
symptoms and corresponding solutions.
• Troubleshooting Tips on the Mobile Client, page 6-6
For information about each app's definition metadata that may help identify the app in
various troubleshooting processes, see Appendix C: Application Definition Metadata,
page E-1.
If you contact Oracle Support about an app, specify the associated product name for
that app. See Appendix E: Associated Products in My Oracle Support, page G-1.
• Troubleshooting Tips for Oracle E-Business Suite Mobile Apps, page 6-9
Directing Users to Obtain Connection Details and Download Updates from the Server
In Oracle E-Business Suite Mobile Foundation Release 2.1 or later releases, while trying
to diagnose and troubleshoot issues encountered on the mobile client, you can direct
users to obtain the server connection details from their mobile devices and check if any
new updates from the server are required.
Perform the following steps to obtain the connection details and initiate server updates:
2. The Connection Details screen displays the server URL field and the Server
Configuration region.
• Server URL field: This is the URL value entered by the mobile user during the
initial launch of the app. This value is retrieved from the local database in the
device.
Please note that if the mobile user wants to reconfigure the app to a different
Oracle E-Business Suite instance after the initial setup is complete, the user can
change the server URL value by tapping the Change URL button. The app
displays the device's Settings screen where the user can update the server URL
directly.
Additionally, the user can navigate to the device's Settings screen to change the
server URL if desired:
• From the iOS device's Settings screen, tap Settings, then App Name, and
then Server URL.
• From the Android devices with the app open, tap Settings, then Settings or
Preferences, and then Server URL.
• Server Configuration region: This region displays the parameter values in the
configuration file downloaded from the server.
• Last Updated: The date and time when the app was last updated.
• Session Timeout: The number of seconds that a user can remain logged in
to the app.
• Idle Timeout: The number of seconds that the app can remain idle.
This field appears only when the "Apps Local Login" (previously known as
"HTTP Basic") authentication type is selected for your app.
• Service Version: The internal version of the mobile services used by the
app, obtained from the app's definition metadata. For example, 1.0.0.
3. Direct users to check if any new updates from the server are required for the app.
Starting from Oracle E-Business Suite Mobile Foundation Release 7.0, Oracle E-
Business Suite mobile apps automatically download the mobile app configuration
updates from the Oracle E-Business Suite server. Users no longer need to initiate a
download manually within an app. Instead, each app periodically checks for
updates (once every five times the app is restarted) and downloads them to
synchronize with the configuration details defined on the Oracle E-Business Suite
server. However, if required, users can still initiate the manual update by tapping
the Sync icon as in the previous releases.
Direct users to follow the instructions on the mobile device to continue the updates
from the server. For example, a user must restart the app to apply the updates if
either one of the following attributes from the server is different from the value in
the device:
• service endpoint
• authentication type (Oracle E-Business Suite Mobile Foundation Release 4.0 and
onwards only)
If only the timeout values need to be updated, the user can choose to continue using
the app without restarting it immediately. In this case the updates will be applied
the next time the app is launched.
Issue Tip
For a mobile app built with Oracle E-Business Ensure that your mobile app can perform a
Suite Mobile Foundation 7.0, when a user successful TLS handshake with the Oracle E-
enters a server URL in a mobile device using Business Suite TLS endpoint.
HTTPS, if the TLS certificate is untrusted and
1. Validate that the JDK 8 client can connect
cannot be recognized by the mobile app, the
following error message may appear: to the Oracle E-Business Suite TLS
endpoint.
"Unable to make a secure
connection to the Oracle E- 2.
Business Suite server. Please Check the list of root CAs trusted by the
verify the TLS setup for the app mobile client. Refer to Migrating to New
and the server." cacerts File for SSL in MAF 2.4.0, Oracle
Mobile Application Framework Installing
Oracle Mobile Application Framework.
For a mobile app built with Oracle E-Business Ensure that your mobile app can perform a
Suite Mobile Foundation releases earlier than successful TLS handshake with the Oracle E-
7.0, when a user enters a server URL in a Business Suite TLS endpoint.
mobile device using HTTPS, if the TLS
1. Validate that the JDK 8 client can connect
certificate is untrusted and cannot be
recognized by the mobile app, the following to the Oracle E-Business Suite TLS
error message may appear: endpoint.
"Unable to connect to the Oracle 2. Validate that the Oracle E-Business Suite
E-Business Suite server. Please
enter a valid server URL." TLS endpoint presents the complete
certificate chain.
After a user enters valid user credentials in the Ensure that the Server URL used by the user
standard login screen, the app displays the to configure the app matches the Oracle E-
loading indicator for a few seconds and then Business Suite web entry URL. Otherwise,
redirects the user back to the login screen. Oracle E-Business Suite server might reject the
REST requests from the mobile app which will
result in redirecting the user to the login
screen.
When a user initiates the check for updates To resolve the issue, apply the following patch
process by tapping Settings from the mobile for your release:
app navigation menu, then tapping
• For Oracle E-Business Suite 12.1.3, apply
Connection Details, and then tapping the
Sync icon in the Connection Details screen, patch 21643419:R12.FND.B
the user is redirected to the login screen. After
logging in to the app, the user is taken to the • For Oracle E-Business Suite 12.2, apply
default landing screen. patch 22046560:R12.FND.C
The same issue also occurs if a user tries to It is recommended that you apply this patch
navigate to a different feature after the app after the corresponding consolidated product
has idle timed out, the user is redirected to the family patch for your app to avoid the issue.
login screen. After the user logs in to the app,
instead of taking the user to the desired screen
before the timeout, the app redirects the user
to the default landing screen.
The configuration server URL is not accessible Verify that AutoConfig was run after you
when tested from a web browser. An HTTP applied the appropriate consolidated patch for
404 error appears. your Oracle E-Business Suite release.
After a user enters valid user credentials in the The cause of the issue could be either that the
standard login screen after the configuration HTTP server is down or the login server was
screen, the following error occurs: not installed and set up during installation of
the appropriate patch on your Oracle E-
The login server is not reachable.
Business Suite server.
A mobile user fails to log in to an app. When Perform the following steps to resolve the
an administrator tests the standalone mLogin issue:
REST service by entering the URL http(s):
1. Verify if AOLJRestServlet exists in the
//<hostname>:<port>OA_HTML/RF.jsp?
function_id=mLogin or tests the following file:
configuration service URL http(s):
• For Oracle E-Business Suite Release
//<hostname>:<port>OA_HTML/RF.jsp?
function_id=mConfig&bundleId=<appl 12.2.x, locate the servlet in the
ication bundle id>&file=ebs- $OA_HTML/WEB-INF/web.xml file.
mobile-config.xml, one of the following
errors occurs: • For Oracle E-Business Suite Release
Resource/rest NOT found 12.1.3, locate the servlet in the
INST_TOP/ora/10.1.3
or /j2ee/oacore/application-
deployments/oacore/html/ori
HTTP 500 Internal server error on-web.xml file.
After a user enters user credentials in the To resolve the issue, ensure that the user
standard login screen after the configuration enters a valid user name and password. Verify
screen, the following error occurs: the user name is still valid in the system and
reset the password if required.
Invalid username/password. If the
problem persists, please contact
your system administrator
After a user enters valid user credentials in the This is due to invalid configuration data, such
standard login screen after the configuration as invalid service endpoint, in the
screen, the following error occurs: downloaded configuration file.
One or more parameters downloaded To resolve the issue, ensure that a valid
from the server are invalid.
service endpoint is specified in the Configure
The same error can also occur after the user Mobile Applications page while setting up the
initiates the check for updates process by mobile app.
tapping Settings from the mobile app
navigation menu, then tapping Connection
Details and then tapping the Sync icon in the
Connection Details screen.
After a user enters valid user credentials in the To resolve the issue, ensure that there is no
standard login screen after the configuration server or network connection issue.
screen, the following error occurs:
After a user logs in to an app, while on the This issue is a known limitation in Oracle
landing page of the app, the user leaves the MAF, where after the idle period exceeds the
device idle for a period of time beyond the value set in the Idle Timeout parameter, when
value set in the Idle Timeout parameter the user accesses the Springboard, the app
(default value is 7200 seconds). When the user does not automatically display the login
attempts to open the Springboard from the screen.
landing page, a blank page appears with a
lock. To resolve the issue, close the Springboard
and access other links in the landing page. The
user should be redirected to the login screen.
A mobile user may find that the date and time This difference occurs because the mobile app
information in the mobile device is different displays the time zone and date and time
from that in the desktop pages. information based on the settings specified in
the mobile client's Settings screen. Tap
Settings, then General, and then Date & Time
in the iOS mobile Settings screen or tap
Settings and then Date & Time in the
Android Settings screen to set your
preferences.
After modifying the Server URL through the If the user removed the previous URL in the
iOS mobile Settings screen (tap Settings, then device settings but did not enter a new URL,
App Name, and then Server URL) or the then no value is shown for the Server URL
Android device's Settings screen (tap Settings, field.
then Settings or Preferences, and then Server
URL), the user closes and restarts the app. The
app displays the page with the message "The
server URL has changed.", but the Server URL
field is blank.
During the initial configuration of an app, Ensure the server URL is valid by performing
after a mobile user enters a server URL and the following steps:
taps Get Started, the following error message
1. Check if the user has entered http:// or
appears:
https:// as appropriate for accessing
Please enter a valid URL. your Oracle E-Business Suite server.
During the initial configuration of an app, This message appears because the required
after a mobile user enters a server URL and Oracle E-Business Suite Mobile Foundation
taps Get Started, the following error message patches have not been applied on the Oracle
appears: E-Business Suite server to which the app is
connecting.
This mobile application is not
currently configured on this
Apply the patches described in Applying
server.
Prerequisite Patches, page 2-2 in order for the
user to proceed through the page where the
server URL value is entered.
After a user enters valid user credentials in the The app may be already configured but the
standard login screen after the configuration status is set to "Disabled".
screen, the following error occurs:
In order for the apps to successfully access the
Configuration Error - This mobile configuration files, set the status of the app to
application is not currently
"Enabled". For information on configuring
enabled on this server. Please
close the application. Oracle E-Business Suite mobile apps, see
Configuring the Mobile Apps on the Oracle E-
Business Suite Server, page 2-15.
After entering a new Server URL through the After changing the server URL, the user must
Connection Details page in Oracle E-Business restart the app to initiate the reconfiguration
Suite Mobile Foundation Release 3.0 or later flow.
releases, or through the mobile Settings screen
(tap Settings, then App Name, and then
Server URL from the iOS Settings screen or
tap Settings, then Settings or Preferences,
and then Server URL from the Android
Settings screen), the user returns to the app.
The app still connects to the previous Oracle
E-Business Suite instance.
A user taps Settings from the mobile app If the app is connected to Oracle E-Business
navigation menu, then taps Connection Suite Mobile Foundation releases earlier than
Details to display the Connection Details Release 2.1, the Sync icon is automatically
screen. However, the Sync icon is not shown. hidden. This Sync icon is shown only if the
server is configured for Oracle E-Business
Suite Mobile Foundation Release 2.1 or later
releases.
After a user enters valid user credentials in the This error indicates that the app's status is
standard login screen after the configuration "Not Configured". This means the
screen, the following error occurs: administrator has not yet configured the app
with appropriate configuration parameters or
Configuration Error - This mobile
application is not currently has not completed a mandatory setup
configured on this server. Please required to use the mobile app.
close the application.
For information on setting the configuration
(For Oracle E-Business Suite Mobile parameters for your mobile app, see
Foundation Release 2.1 or later) Configuring the Mobile Apps on the Oracle E-
Business Suite Server, page 2-15.
After a mobile user enters a valid server URL This message indicates that the app is unable
in the Server URL screen, and then enters his to access the configuration service URL.
or her user name and password in the login Perform the following steps to resolve the
screen, the following message appears: issue:
Issue Tip
After applying the appropriate patch for your Perform the following steps to resolve the
Oracle E-Business Suite release, the Mobile issue:
Applications Manager responsibility is still
1. Make sure the concurrent manager is
not visible for SYSADMIN user by default.
running.
Users need to access the Mobile Applications The SYSADMIN user is granted the Mobile
Manager responsibility. Applications Manager responsibility by
default.
After you select the Mobile Applications Ensure all the prerequisite patches required
Manager responsibility and the Applications for your mobile apps are applied. If the
link from the navigation menu and perform a desired applications still do not appear in the
search in the Search Mobile Applications search result table, contact Oracle Support.
page, no mobile applications are listed in the
search result table.
Troubleshooting Tips on Configuring Apps With the Apps SSO Login Authentication Type
This section describes the troubleshooting tips that are particularly related to configure
mobile apps with the Apps SSO Login (previously known as "Web SSO") authentication
type.
For information about configuring apps with the Apps SSO Login authentication type,
see:
• Configuring Parameters for the Apps SSO Login Authentication Type, page 2-26
• Additional Setup Tasks to Enable Apps SSO Login Authentication Security, page 2-
33
Troubleshooting Tips
Perform the following tasks to validate and troubleshoot potential issues for
configuring mobile apps with the Apps SSO Login type:
1. Verify prerequisite configuration for Oracle E-Business Suite, Oracle Access
Manager (OAM), and Oracle Directory Services integration
1. Navigate to the application login page through a web browser. Verify the login
redirects to Oracle Access Manager as configured during the Oracle E-Business
Suite integration with Oracle Access Manager, and the same LDAP user that
will be using a mobile app can log in successfully to Oracle E-Business Suite
framework based applications.
2. Verify after successful login and rendering of the Oracle E-Business Suite Home
2. Test the configured "SSO Login URL", "SSO Login Success URL", and "SSO
Logout URL" parameters
1. Navigate to the configured SSO Login URL through a web browser. After the
login, the browser should return a protected page successfully (Status 200
OK). The URL for this page must be the same as the configured SSO Login
Success URL.
Note: The "SSO Login URL" and "SSO Login Success URL"
parameters relate to each other. The values of these two
parameters can be the same.
2. Navigate to the configured SSO Login URL through a web browser. For
example, http://<hostname>:<port>/accessgate/login/sso.
Expected result: Redirect to the OAM login page. Login successful after
specifying the LDAP user name and password.
After the login, the resource http://<hostname>:
<port>/accessgate/login/sso shows with no error message. This
resource must be the configured "SSO Login Success URL" parameter value.
Note: The "SSO Login URL" and "SSO Login Success URL"
parameter values can be the same.
2. Collect log files for Oracle E-Business Suite AccessGate, Oracle E-Business Suite
oacore, and the OAM server.
Refer to My Oracle Support Knowledge Document 1077460.1, Troubleshooting
Oracle Access Manager and Oracle E-Business Suite AccessGate, on how to generate
Oracle E-Business Suite AccessGate logs.
• Troubleshooting Tips for Common Setup Issues on the Oracle E-Business Suite
Server, page 6-24
For more information about push notifications, see Setting Up Push Notifications for
Mobile Apps, page 3-1.
Issue Tip
A mobile app user is not able to receive push Provide the following instructions to the
notifications in the mobile device, while other mobile user to change the device settings:
users of the same app do not have this issue.
• For the iOS devices
1. Tap Settings.
Troubleshooting Tips for Common Setup Issues on the Oracle E-Business Suite Server
The following table describes the common setup issues, possible causes, and
corresponding solutions in the Oracle E-Business Suite Mobile Foundation Push
Notification System:
A mobile user has installed Possible Cause 1: For the Before deploying the mobile
the mobile app that supports mobile app developed using app, a developer needs to
push notifications. When the Oracle Mobile Application enable the push plugin by
user signs in to the app, no Framework and Oracle E- selecting the PushPlugin
record is created in the Business Suite Mobile check box in the associated
FND_MBL_NOTIF_REGISTRA Foundation Login maf-application.xml file.
TIONS table for the user's app Component, the push plugin See: Enabling the Push
is not enabled. Plugin, Oracle E-Business Suite
For a mobile app to receive
Mobile Apps Developer's Guide,
push notifications, the push
Release 12.1 and 12.2.
token (iOS) or registration ID
(Android) should be stored in Once the push plugin is
Oracle E-Business Suite. enabled, deploy the app and
test it again.
Same issue as the described Possible Cause 2: When the If the device is not connected
above mobile device is launched, the to the Internet, the mobile
device is not connected to the device cannot connect to its
Internet. corresponding push
notification service. For
example, an iOS device
connects to APNs to receive
push token and an Android
device connects to FCM to
receive registration ID.
3. Sign in to Oracle E-
Business Suite and check
again.
Same issue as the described Possible Cause 3: When the You can invoke the Oracle E-
above mobile app invokes the Business Suite REST API
Oracle E-Business Suite REST mPushRegister from a
API mPushRegister after REST client, such as
the user signs in, it fails. Advanced REST Client, to
verify if it can successfully
create a record in the
FND_MBL_NOTIF_REGISTRA
TIONS table.
Same issue as the described Possible Cause 4: The Push You need to ensure the Push
above Notification System is not Notification System is
enabled and configured with configured properly.
valid Oracle Mobile Cloud
1. Log in to Oracle E-
Service (MCS) credentials. If
this configuration is not Business Suite as a user
completed, push notification who has the Mobile
registrations are not Applications Manager
synchronized with MCS. As a responsibility. Click the
result, push notifications are Push Configuration
not sent to users. button to open the
Mobile Push Notification
Configuration page.
For information on
configuring global push
notifications, see Configuring
Oracle E-Business Suite
Mobile Foundation Push
Notification System, page 3-
10.
A mobile user has installed Android Sender ID and To resolve the issue, perform
the mobile app that supports Server Key are not set up the following tasks:
push notifications. When the correctly.
1. Go to the Firebase
user signs in to the app, no
record is created in the console (https:
FND_MBL_NOTIF_REGISTRA //console.firebase.
TIONS table for the user's google.com). Open the
Android app project created for the
Android push
notifications and record
the Sender ID and Server
Key values.
• Android Sender ID
in the Mobile Push
Notification
Configuration page
See: Configuring
Oracle E-Business
Suite Mobile
Foundation Push
Notification System,
page 3-10.
• Sender ID:
Ensure the
correct "Sender
ID" value is
entered.
When you submit the Mobile This issue may occur due to Use the following steps to
Push Notification either one of the following: resolve this issue:
Configuration page with MCS
• The MCS user name, 1. Check the OACORE logs
credentials, an error occurs
indicating that the credentials password, backend ID, or to see if the REST service
are invalid. URL is invalid. invocation failed with
TLS handshake when
• The MCS user does not Oracle E-Business Suite
have the "Default" and invoked the MCS URL
"Mobile Notifications" for validation.
roles assigned in the
Oracle Cloud My 2. If yes, download MCS
Services portal. URL's CA certificate and
import the certificate to
• Oracle E-Business Suite the truststore in Oracle E-
to MCS REST service Business Suite.
invocation failed due to
For instructions on
TLS handshake.
importing the certificates
to the truststore in Oracle
E-Business Suite, see
Fixing the SSL
Handshake Error, page 6-
45.
Push notification registration Possible Cause 1: This issue To resolve this issue, ensure
STATUS for a user in the may occur due to either one the following tasks are in
FND_MBL_NOTIF_REGISTRA of the following: place:
TIONS table is "READY".
However, it is not changing to • The Push Notification • The Push Notification
"REGISTERED". System is not enabled System is configured
and configured with properly.
valid MCS credentials.
1. Log in to Oracle E-
• Business Suite as a
Oracle E-Business Suite
user who has the
to MCS REST service
Mobile
invocation failed due to
Applications
TLS handshake.
Manager
responsibility. Click
the Push
Configuration
button.
4. To support Android
push notifications,
make sure you enter
a valid Android
Sender ID value.
Same issue as described Possible Cause 2: This issue Although the business event
above. could also be caused by either oracle.apps.mobile.
of the following: foundation.push.synch
for synchronization is enabled
• The business event used by default, ensure that the
to synchronize the event and the subscription are
registration from Oracle enabled using the Oracle
E-Business Suite to Workflow Business Event
Oracle Mobile Cloud user interface through the
Service is not enabled. Workflow Administrator
Web Applications
• The Workflow Java responsibility.
Deferred Agent Listener
Additionally, the business
is not running.
event is processed through
the WF_JAVA_DEFERRED
queue. You need to log in to
Oracle E-Business Suite, select
the Oracle Applications
Manager link, and then
Workflow Manager to ensure
the Workflow Java Deferred
Agent Listener is running.
Same issue as described Possible Cause 3: The Use the following steps to
above. invocation of MCS REST ensure the correct distribution
service from Oracle E- is selected for the mobile app:
Business Suite to register the
1. Log in to Oracle E-
mobile device failed because
there is no client registered on Business Suite as a user
MCS corresponding to the who has the Mobile
Oracle E-Business Suite Applications Manager
mobile app distribution. responsibility.
• Android
Deployment Bundle
ID: Enter the same
Package Name used
to package the
Android app. Make
sure in MCS, an
Android client is
created with the
same Package Name.
• iOS Deployment
Bundle Id: Enter the
same Application
Bundle ID used to
package the iOS app.
Make sure in MCS,
an iOS client is
created with the
same Application
Bundle ID.
A push registration with Possible Cause 1: The You can check the notification
status REGISTERED is found possible root causes can be: status:
for a user, but the push
• On Oracle E-Business • If the notification status is
notifications are not delivered
to the mobile device. Suite, the MCS Push "QUEUED" in the
Notification Agent FND_MBL_NOTIFICATIO
service component is not NS table, verify and
running. ensure that the service
component MCS Push
• Notification Agent is
On MCS, the notification
running.
could not be delivered to
APNs or FCM for
• If the status is "SENT"
delivery to the mobile
device. indicating that Oracle E-
Business Suite has sent
the notification to MCS,
log in to MCS to check
the API log and confirm
MCS has delivered the
notification to APNs for
an iOS device, and FCM
for an Android device.
Same issue as the described Possible Cause 2: The To resolve the issue, you need
above possible causes can be: to log in to the Oracle
Workflow Business Event
• The push notification user interface through the
business event associated Workflow Administrator
with the mobile app is Web Applications
not enabled. responsibility.
Each app has its own • Verify the push
business event. For notification business
example, the Approvals event for the mobile app
app with enterprise is Enabled.
distribution uses
business event oracle. •
apps.mobile. Verify the business event
approvals.push. is added to the business
event. event group.
For information on
adding an event to the
event group, see Adding
the Push Notification
Business Events to the
Push Notification
System's Event Group,
Oracle E-Business Suite
Mobile Apps Developer's
Guide, Release 12.1 and
12.2.
Same issue as the described Possible Cause 3: The user Although a valid registration
above uninstalled the app and then appears in the
reinstalled it again. However, FND_MBL_NOTIF_REGISTRA
for the new installation, the TIONS table, if the user
registration is not yet created uninstalled the app that
in Oracle E-Business Suite. created this registration,
Oracle E-Business Suite does
not know the app has been
uninstalled, so the
registration remains in the
table.
Same issue as the described Possible Cause 4: MCS is For each valid record in the
above unable to deliver the push FND_MBL_NOTIF_REGISTRA
notifications. TIONS table with status
REGISTERED, the
corresponding registration
should be found in MCS. Use
the following steps to
validate:
1. Log in to your Oracle
Mobile Cloud Service
instance.
• Service: iOS or
Android
• Username: <EBS
username>@<EBS
system guid>.
<EBS DB SID>
Id or Android
Package Name used
to create the mobile
client.
A push registration with MCS removed the entry from A push notification will not
status REGISTERED is found its registration because it was be delivered to the device if
for a user, but it is not found unable to deliver notifications the user uninstalled the app
in the MCS's Manage Devices to the device. after the registration was
page. created earlier.
Push notification is delivered Possible causes for this issue When a registration is created
to the device, but it is not can be: in the
translated to the preferred FND_MBL_NOTIF_REGISTRA
• The user's mobile device TIONS table, the user's device
language set in the user's
mobile device. language preference is locale is captured in the
not installed or DEVICE_LANG column in ISO
supported by Oracle E- format, such as en-US, ko-
Business Suite mobile KR, etc. It can be translated to
apps. the languages supported by
Oracle E-Business Suite
• The user has installed the mobile apps and the
same app in multiple notification messages can be
devices and each device translated by the server code
has a different language that triggers the push
setting. notification messages.
3. Removing the Registration Using the mPushRegister REST API, page 6-41
• <accessToken>yOs211ukBqP9eHxt0Tys9NEMjz</accessToken>
3. Use these values to form the Cookie header to be used in subsequent REST
requests. For example,
Cookie: ebstest=yOs211ukBqP9eHxt0Tys9NEMjz
• Cookie: ebstest=yOs211ukBqP9eHxt0Tys9NEMjz
• HTTP Payload:
<params>
<param name="Action">REGISTER</param>
<param name="Platform">ANDROID</param>
<param name="App Bundle Id">com.oracle.ebs.atg.owf.
Approvals</param>
<param name="Push Token">xlokcgsflkgjfslkgjlksfgjlfk-dummy</param>
<param name="Device Lang">en-US</param>
</params>
Note: The "App Bundle Id" parameter should be the same as the
one used to register the mobile app in the Mobile Applications
Manager UI page. This is the same value used in the Id field of
maf-application.xml in the MAF application.
2. In the HTTP response of REGISTER action, note the JSESSIONID cookie in the
Set-Cookie header.
This will be passed later in the REST request to remove the registration to make
sure the HTTP session is reclaimed on the server.
• Cookie: ebstest=yOs211ukBqP9eHxt0Tys9NEMjz;
• JSESSIONID=7241d58abb3b22da97dc6f5f501e51d8dfeea83f726fa590
d46e1e17dbca6883.e3eNaN0Lb30Pe34KahaLb3mTchb0;
• HTTP Payload:
<params>
<param name="Action">DEREGISTER</param>
<param name="Platform">ANDROID</param>
<param name="App Bundle Id">com.oracle.ebs.atg.owf.
Approvals</param>
<param name="Push Token">xlokcgsflkgjfslkgjlksfgjlfk-dummy</param>
<param name="Device Lang">en-US</param>
</params>
2. Note that the JSESSIONID cookie from the REGISTER action is used here.
If this mPushRegister API works, the mobile app with the given App Bundle Id
should be able to register successfully.
3. Checking the Oracle Mobile Cloud Service REST API, page 6-46
Step 1: Examining Any Synchronization Issues from Oracle E-Business Suite to Oracle
Mobile Cloud Service
After a mobile app registers with Oracle E-Business Suite, if the setup tasks performed
in Oracle Mobile Cloud Service are successful, the status of the registration should be
changed from "READY" to "REGISTERED". If it is not changed to "REGISTERED", you
2. Following are possible errors reported by Oracle Mobile Cloud Service when the
registration is synchronized from Oracle E-Business Suite to Oracle Mobile Cloud
Service.
• HTTP 401
• Check the MCS user name and password registered in Oracle E-Business
Suite.
The MCS credentials are validated at the time of configuration. Most likely
the credentials are still valid.
• Check if the MCS user has the "Mobile Notifications" and "Default – (MCS
backend realm)" roles assigned.
• HTTP 400
• Check if the mobile client is registered on Oracle Mobile Cloud Service with
appropriate deployment bundle Id.
• HTTP 500
• Check if the Oracle Mobile Cloud Service instance is accessible.
Note: This is the same value entered in the MCS Backend URL field
when configuring the Push Notification System. See: Configuring
Oracle E-Business Suite Mobile Foundation Push Notification
System, page 3-10.
2. Click the Padlock icon next to the URL in a web browser (such as in Firefox) or use
browser-specific steps to export the CA certificate for the MCS endpoint to a local
certificate file.
• HTTP Headers:
• Content-Type: application/json; charset=UTF-8
• Oracle-Mobile-Backend-ID: 74c474c4-7b46-4n9d-bb43-
04bff2dc8585
• HTTP Payload:
{
"notificationToken":"APA91bEhhr-D7rWtxfb3v-
nl_FKf2WAWOeZzc2xd6ebXNuoezbf3biyqKofYAhOZ3Ilv-
lUaql09PKkCsi2gVpSDd2K6yIF_RpVPeua2nKojw7G4zogYCZXJuoub18iIvK-
0k0YOg95PRvVpaNEymLKr0MWmxLtubQ",
"notificationProvider":"GCM",
"user":"[email protected]",
"mobileClient":{
"id":"com.oracle.ebs.atg.wf.Approvals",
"version":"1.5.0",
"platform":"ANDROID"
}
}
Note: The "user" attribute could be any string value when testing
this API directly. Oracle Mobile Cloud Service does not validate the
"user" attribute against any user repository.
The "mobileClient" and "id" attributes should be the same
values used to create the mobile client in Oracle Mobile Cloud
Service.
The following steps describe an example of invoking the REST service directly using
Advanced REST Client:
1. Invoke the Oracle Mobile Cloud Service REST API from the REST client.
2. Use the same MCS username and password registered with Oracle E-Business
Suite.
3. Enter the payload information. Make sure to use the correct Oracle Mobile Cloud
Service Backend ID (Oracle-Mobile-Backend-ID) that is used to configure the
Oracle E-Business Suite Mobile Foundation Push Notification System.
See: Configuring Oracle E-Business Suite Mobile Foundation Push Notification
System, page 3-10.
4. In the Advanced REST Client, you can click the Edit icon for the Authorization
header to enter the Basic Auth user name and password. The tool automatically
encodes it to Base64.
5. This should return HTTP 201 Created to indicate the device registration with
Oracle Mobile Cloud Service was successful.
Note if you used a dummy value, you could clear it from Oracle Mobile Cloud
Service or leave it as is.
Overview
Oracle is an Independent Software Vendor (ISV) member of the AppConfig
Community. The AppConfig Community provides tools and best practices to secure,
configure, deploy, and manage mobile enterprise apps. Oracle E-Business Suite mobile
apps are built using Oracle Mobile Application Framework (MAF). Oracle MAF
applications are compatible with AppConfig-based Enterprise Mobility Management
(EMM) integration, using native frameworks that are made available through operating
systems (iOS and Android).
This appendix provides guidance on integrating Oracle E-Business Suite mobile apps
with EMM solutions based on AppConfig standards.
Integrating Oracle E-Business Suite Mobile Apps with Enterprise Mobility Management (EMM) Solutions A-1
Compatibility of Oracle E-Business Suite Mobile Apps with AppConfig EMM Providers
Oracle E-Business Suite mobile apps are expected to work with any EMM provider that
supports common AppConfig standards provided by operating system vendors. Oracle
does not explicitly certify permutations of Oracle E-Business Suite mobile app releases
with given EMM providers and their releases. Oracle may test selected Oracle E-
Business Suite mobile apps with selected AppConfig-compliant products, including
VMware AirWatch. Oracle does not conduct comprehensive tests between all available
Oracle E-Business Suite mobile app releases and all AppConfig-compliant products.
Support
Oracle Support does not have access to third-party EMM AppConfig products and is
unable to reproduce or investigate AppConfig compatibility issues directly. Oracle
Support will ask customers to validate if the reported issue reproduces without third-
party EMM integration in order to determine if the issue is specific to the third-party
EMM solution. Issues with AppConfig-based configurations should be first reported to
the affected EMM provider. The EMM provider may engage Oracle for interoperability
issues between Oracle MAF and the third-party EMM solution as needed.
Overview
This chapter lists the server-side patches required for Oracle E-Business Suite mobile
apps in the releases earlier than Oracle E-Business Suite Mobile Foundation Release 7.0.
These patches include consolidated product family patches and conditionally required
patches if needed.
The prerequisite patches for Oracle E-Business Suite Mobile Foundation releases are
described as follows:
• REST API Patches for Custom App Development in Oracle E-Business Suite Mobile
Foundation Release 6.1, page B-2
• Product Family Patches for Oracle E-Business Suite Mobile Foundation Release 6.0,
page B-4
• Product Family Patches for Oracle E-Business Suite Mobile Foundation Release 5.0,
page B-14
• Product Family Patches for Oracle E-Business Suite Mobile Foundation Release 4.0,
page B-23
• Product Family Patches for Oracle E-Business Suite Mobile Foundation Release 3.0,
page B-31
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-1
REST API Patches for Custom App Development in Oracle E-Business
Suite Mobile Foundation Release 6.1
Starting from Oracle E-Business Suite Mobile Foundation Release 6.1, Oracle provides
APIs corresponding to portions of the Oracle E-Business Suite mobile apps'
functionality. These APIs are available in the Oracle Integration Repository where you
can search, view, and deploy them as REST services for your custom app development.
See: Implementing Oracle E-Business Suite REST Services, Oracle E-Business Suite Mobile
Apps Developer's Guide, Release 12.1 and 12.2.
The following table lists the apps that provide APIs corresponding to their functionality
and the patches to apply to make those APIs available in your Oracle E-Business Suite
instance.
Patches for Oracle Seeded Mobile APIs for Oracle E-Business Suite Mobile Foundation
Release 6.1
Mobile App Name Associated Patch for Oracle Associated Patch for Oracle
E-Business Suite 12.1.3 E-Business Suite 12.2
*See Footnote 1
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-3
Mobile App Name Associated Patch for Oracle Associated Patch for Oracle
E-Business Suite 12.1.3 E-Business Suite 12.2
Footnote 1: The following patches are available in Oracle E-Business Suite Mobile
Foundation Release 7.1 for additional APIs associated with Oracle Mobile Self-Service
Human Resources for Oracle E-Business Suite:
• For Oracle E-Business Suite 12.1.3: patch 26831849:R12.PER.B
For more information about these APIs, see My Oracle Support Knowledge Document
2312158.1, FAQ for Accessing the Payslip and Pay Simulator REST APIs.
Conditional Post-Install Patches for Oracle Seeded Mobile APIs in Oracle E-Business Suite
Mobile Foundation Release 6.1
Oracle E-Business Suite for Required for all the Oracle E- • Release 12.2: Patch
Release 12.2 and 12.1.3 Business Suite mobile apps 25488435:R12.OWF.C
that have the associated APIs
available for use in custom • Release 12.1.3: Patch
app development for Oracle 25488435:R12.OWF.B
E-Business Suite
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-5
Oracle E-Business Suite Server-Side Product Family Patches for Oracle E-Business Suite
Mobile Foundation Release 6.0
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Supplier
Invoices
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Timecard
approvals)
• Oracle Mobile
Timecards for
Oracle E-
Business Suite
• Oracle Mobile
Learning for
Oracle E-
Business Suite
• Oracle Mobile
Person
Directory for
Oracle E-
Business Suite
• Oracle Mobile
Self-Service
Human
Resources for
Oracle E-
Business Suite
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-7
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Quoting
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Requisition
approvals)
• Oracle Mobile
iProcurement
for Oracle E-
Business Suite
• Oracle Mobile
Procurement for
Oracle E-
Business Suite
• Oracle Mobile
Project Manager
for Oracle E-
Business Suite
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-9
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Product
Information
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Order
Management
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for
Maintenance
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Service
Contracts
approvals)
• Oracle Mobile
Discrete
Production
Supervisor for
Oracle E-
Business Suite
• Oracle Mobile
Discrete Quality
Manager for
Oracle E-
Business Suite
• Oracle Mobile
Inventory for
Oracle E-
Business Suite
• Oracle Mobile
Maintenance for
Oracle E-
Business Suite
• Oracle Mobile
Process
Production
Supervisor for
Oracle E-
Business Suite
• Oracle Mobile
Process Quality
Manager for
Oracle E-
Business Suite
• Oracle Mobile
Product
Information for
Oracle E-
Business Suite
• Oracle Mobile
Project
Manufacturing
for Oracle E-
Business Suite
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-11
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
• Oracle Mobile
Sales Orders for
Oracle E-
Business Suite
Prerequisites:
Oracle E-Business
Suite Release 12.2.3
and R12.SCM_PF.C.
Delta.4
Conditional Post-Install Patches for Mobile Apps with Oracle E-Business Suite Mobile
Foundation Release 6.0
Oracle E-Business Suite Required for all Oracle E- • Release 12.2 and 12.1.3:
Release 12.2 and 12.1.3 Business Suite mobile apps, Patch 23634170
with Oracle E-Business Suite
• Oracle E-Business Suite Mobile Foundation Release
Mobile Foundation 6.0, connected to Oracle E-
Release 6.0 Online Help Business Suite Release 12.1.3
or Release 12.2
Oracle E-Business Suite Required for all Oracle E- • Release 12.2: Patch
Release 12.2 and 12.1.3 Business Suite mobile apps, 24432372:R12.FND.C
with Oracle E-Business Suite
Mobile Foundation Release • Release 12.1.3: Patch
6.0, connected to Oracle E- 24432372:R12.FND.B
Business Suite Release 12.1.3
or Release 12.2
Oracle E-Business Suite Required only for developing • Release 12.2: Apply the
Release 12.2 and 12.1.3 custom mobile apps for Oracle patches for REST services
E-Business Suite listed in Section B:
• Develop custom mobile Configuring Oracle E-
apps for Oracle E- Business Suite REST
Business Suite Services, My Oracle
Include Oracle E- Support Knowledge
Business Suite REST Document 1311068.1
services provided
• Release 12.1.3: Apply the
through Oracle E-
Business Suite Integrated patches for REST services
SOA Gateway (ISG) listed in My Oracle
Support Knowledge
Document 1998019.1
Oracle E-Business Suite Required only if you want to • Release 12.2: Patch
Release 12.2 and 12.1.3 develop custom mobile apps 21316087:R12.FND.C
and run the sample app
• Develop custom mobile against Oracle E-Business • Release 12.1.3: Patch
apps for Oracle E- Suite 21316087:R12.FND.B
Business Suite
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-13
Additional Information: To develop custom apps for Oracle E-Business
Suite, you need to download the following client-side patch for Oracle
E-Business Suite Release 12.1.3 and Release 12.2:
• Patch 23737987 - Oracle E-Business Suite Mobile Foundation (Login
component) Release 6.0
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Supplier
Invoices
approvals)
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-15
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Timecard
approvals)
• Oracle Mobile
Timecards for
Oracle E-
Business Suite
• Oracle Mobile
Learning for
Oracle E-
Business Suite
• Oracle Mobile
Person
Directory for
Oracle E-
Business Suite
• Oracle Mobile
Self-Service
Human
Resources for
Oracle E-
Business Suite
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Quoting
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Requisition
approvals)
• Oracle Mobile
iProcurement
for Oracle E-
Business Suite
• Oracle Mobile
Procurement for
Oracle E-
Business Suite
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-17
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Product
Information
approvals)
Note: The
Product
Information
approvals
was
previously
known as
Item
Changes
approvals in
Oracle E-
Business
Suite Mobile
Foundation
Release 4.0.
• Oracle Mobile
Approvals for
Oracle E-
Business Suite
(for Order
Management
approvals)
• Oracle Mobile
Approvals for
Oracle E-
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-19
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
Business Suite
(for
Maintenance
approvals)
• Oracle Mobile
Discrete
Production
Supervisor for
Oracle E-
Business Suite
• Oracle Mobile
Discrete Quality
Manager for
Oracle E-
Business Suite
• Oracle Mobile
Inventory for
Oracle E-
Business Suite
• Oracle Mobile
Maintenance for
Oracle E-
Business Suite
• Oracle Mobile
Process
Production
Supervisor for
Oracle E-
Business Suite
• Oracle Mobile
Process Quality
Manager for
Oracle E-
Business Suite
• Oracle Mobile
Product
Information for
Oracle E-
Business Suite
• Oracle Mobile
Project
Manufacturing
for Oracle E-
Business Suite
• Oracle Mobile
Sales Orders for
Oracle E-
Business Suite
Apply any additional conditionally required post-install patches from the following list
for your apps, with Oracle E-Business Suite Mobile Foundation Release 5.0:
Conditional Post-Install Patches for Mobile Apps with Oracle E-Business Suite Mobile
Foundation Release 5.0
Oracle E-Business Suite Required for all Oracle E- • Release 12.2 and 12.1.3:
Release 12.2 and 12.1.3 Business Suite mobile apps, Patch 22659481
with Oracle E-Business Suite
• Oracle E-Business Suite Mobile Foundation Release
Mobile Foundation 5.0, connected to Oracle E-
Release 5.0 Online Help Business Suite Release 12.1.3
or Release 12.2
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-21
Oracle E-Business Suite Requirement Patch Information
Release or Mobile App
Name
Oracle E-Business Suite Required for Oracle Mobile • Release 12.2: Patch
Release 12.2 and 12.1.3 Sales Orders for Oracle E- 22861368:R12.ONT.C
Business Suite if the base
• Oracle Mobile Sales language is not English (US) • Release 12.1.3: Patch
Orders for Oracle E-
22861368:R12.ONT.B
Business Suite
Oracle E-Business Suite Required only for developing • Release 12.2: Apply the
Release 12.2 and 12.1.3 custom mobile apps for Oracle patches for REST services
E-Business Suite listed in Section B:
• Develop custom mobile Configuring Oracle E-
apps for Oracle E- Business Suite REST
Business Suite Services, My Oracle
Include Oracle E- Support Knowledge
Business Suite REST Document 1311068.1
services provided
• Release 12.1.3: Apply the
through Oracle E-
Business Suite Integrated patches for REST services
SOA Gateway (ISG) listed in My Oracle
Support Knowledge
Document 1998019.1
Oracle E-Business Suite Required only if you want to • Release 12.2: Patch
Release 12.2 and 12.1.3 develop custom mobile apps 21316087:R12.FND.C
and run the sample app
• Develop custom mobile against Oracle E-Business • Release 12.1.3: Patch
apps for Oracle E- Suite 21316087:R12.FND.B
Business Suite
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-23
Oracle E-Business Suite Server-Side Product Family Patches for Oracle E-Business Suite
Mobile Foundation Release 4.0
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
Oracle E-Business • Oracle Mobile Apply the product Apply the product
Suite Applications Approvals for family patches for the family patches for the
Technology (atg_pf) Oracle E- approval types you approval types you
Business Suite want to use, as shown want to use, as shown
in subsequent rows in in subsequent rows in
this table. this table.
Oracle Financials • Oracle Mobile Patch 20518386:R12. Merge and apply the
(fin_pf) Approvals for FIN_PF.B: FIN - 12.1 following patches
Oracle E- Consolidated Patch using the command:
Business Suite For Mobile
• Patch 20843806:
(for Expense Applications
approvals) Foundation V4 R12.FND.C
• • 20518468:R12.
Oracle Mobile
Approvals for FIN_PF.C: FIN -
Oracle E- 12.2
Business Suite Consolidated
(for Supplier Patch For Mobile
Invoices Applications
approvals) Foundation V4
adop phase=apply
patches=20843806
,20518468
merge=yes
Oracle Human • Oracle Mobile Patch 20518387:R12. Merge and apply the
Resources (hr_pf) Approvals for HR_PF.B: HR - 12.1 following patches
Oracle E- Consolidated Patch using the command:
Business Suite For Mobile
• Patch 20843806:
(for Recruitment Applications
approvals) Foundation V4 R12.FND.C
• • 20518464:R12.
Oracle Mobile
Approvals for HR_PF.C: HR -
Oracle E- 12.2
Business Suite Consolidated
(for Timecard Patch For Mobile
approvals) Applications
Foundation V4
• Oracle Mobile
adop phase=apply
Timecards for patches=20843806
Oracle E- ,20518464
Business Suite merge=yes
• Oracle Mobile
Learning for
Oracle E-
Business Suite
• Oracle Mobile
Person Directory
for Oracle E-
Business Suite
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-25
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
Oracle Procurement • Oracle Mobile Patch 20518405:R12. Merge and apply the
(prc_pf) Approvals for PRC_PF.B: PRC - 12.1 following patches
Oracle E- Consolidated Patch using the command:
Business Suite For Mobile
• Patch 20843806:
(for Purchase Applications
Order approvals) Foundation V4 R12.FND.C
• • 20518485:R12.
Oracle Mobile
Approvals for PRC_PF.C: PRC -
Oracle E- 12.2
Business Suite Consolidated
(for Requisition Patch For Mobile
approvals) Applications
Foundation V4
• Oracle Mobile
adop phase=apply
iProcurement for patches=20843806
Oracle E- ,20518485
Business Suite merge=yes
• Oracle Mobile
Procurement for
Oracle E-
Business Suite
Oracle Projects (pj_pf) • Oracle Mobile Patch 20518354:R12. Merge and apply the
Project Manager PJ_PF.B: PJ - 12.1 following patches
for Oracle E- Consolidated Patch using the command:
Business Suite For Mobile
• Patch 20843806:
Applications
Foundation V4 R12.FND.C
• 20518456:R12.
PJ_PF.C: PJ - 12.2
Consolidated
Patch For Mobile
Applications
Foundation V4
adop phase=apply
patches=20843806
,20518456
merge=yes
Oracle Supply Chain • Oracle Mobile Patch 20518353:R12. Merge and apply the
Management Approvals for SCM_PF.B: SCM -12.1 following patches
(scm_pf) Oracle E- Consolidated Patch using the command:
Business Suite For Mobile
• Patch 20843806:
(for Item Applications
Changes Foundation V4 R12.FND.C
approvals)
• 20518445:R12.
• Oracle Mobile SCM_PF.C: SCM
Discrete -12.2
Production Consolidated
Supervisor for Patch For Mobile
Oracle E- Applications
Business Suite Foundation V4
• adop phase=apply
Oracle Mobile patches=20843806
Inventory for ,20518445
Oracle E- merge=yes
Business Suite
• Oracle Mobile
Maintenance for
Oracle E-
Business Suite
• Oracle Mobile
Process
Production
Supervisor for
Oracle E-
Business Suite
• Oracle Mobile
Product
Information for
Oracle E-
Business Suite
• Oracle Mobile
Project
Manufacturing
for Oracle E-
Business Suite
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-27
Product Family Mobile App Name Patch for Oracle E- Patch for Oracle E-
Business Suite Business Suite 12.2
12.1.3
• Oracle Mobile
Sales Orders for
Oracle E-
Business Suite
Apply any additional conditionally required post-install patches from the following list
for your apps, with Oracle E-Business Suite Mobile Foundation Release 4.0:
Note: Apply the following patches for creating custom apps with
Oracle E-Business Suite Mobile Foundation Release 4.1:
Please note that if you have already applied the patches for Oracle E-
Business Suite Mobile Foundation Release 4.0 on the server to deploy
Oracle E-Business Suite mobile apps from a public app store, such as
Apple App Store or Google Play, it is perfectly safe to upgrade the
server to the Mobile Foundation Release 4.1. The mobile apps
corresponding to the apps with Oracle E-Business Suite Mobile
Foundation Release 4.0 will continue to work as expected.
If you would like to develop custom mobile apps on Oracle E-Business
Suite Mobile Foundation Release 4.1, refer to Setting Up Development
Environment, Oracle E-Business Suite Mobile Apps Developer's Guide,
Release 12.1 and 12.2.
Conditional Post-Install Patches for Mobile Apps with Oracle E-Business Suite Mobile
Foundation Release 4.0
Oracle E-Business Suite 12.1.3 Required if your app connects Patch 21881376:R12.FND.B
to Oracle E-Business Suite
12.1.3
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-29
Oracle E-Business Suite Requirement Patch Information
Release or Mobile App
Name
Oracle E-Business Suite 12.1.3 Required if you use Oracle Patch 21671565:R12.AP.B
Mobile Approvals for Oracle
• Oracle Mobile Approvals E-Business Suite (Supplier
for Oracle E-Business Invoices approvals only) for
Suite (Supplier Invoices Oracle E-Business Suite 12.1.3
approvals only)
Oracle E-Business Suite 12.2 Required if your app connects Patch 21881376:R12.FND.C
to Oracle E-Business Suite
12.2
Oracle E-Business Suite 12.2 Required if you use Oracle Patch 21566332:R12.ENG.D
Mobile Approvals for Oracle
• Oracle Mobile Approvals E-Business Suite (Item
for Oracle E-Business Changes approvals only) for
Suite (Item Changes Oracle E-Business Suite 12.2
approvals only)
Oracle E-Business Suite 12.2 Required if you use Oracle Patch 21671565:R12.AP.C
Mobile Approvals for Oracle
• Oracle Mobile Approvals E-Business Suite (Supplier
for Oracle E-Business Invoices approvals only) for
Suite (Supplier Invoices Oracle E-Business Suite 12.2
approvals only)
Oracle E-Business Suite Server-Side Product Family Patches for Oracle E-Business Suite
Mobile Foundation Release 3.0
• Patch 20049349:R12.
HR_PF.B: HR - 12.1.3
Consolidated Patch For
Mobile Applications
Foundation V3
Product Family Patches for Earlier Oracle E-Business Suite Mobile Foundation Releases B-31
Product Family Oracle E-Business Suite Oracle E-Business Suite
12.1.3 12.2
Apply the additional conditionally required post-install patches from the following list
for your apps:
Conditional Post-Install Patches for Mobile Apps with Oracle E-Business Suite Mobile
Foundation Release 3.0
Oracle E-Business Suite 12.1.3 Required if your app connects Patch 21643419:R12.FND.B
to Oracle E-Business Suite
12.1.3
Oracle E-Business Suite 12.2 Required if your app connects Patch 22046560:R12.FND.C
to Oracle E-Business Suite
12.2
Overview
Oracle E-Business Suite mobile apps use access roles to protect mobile app data from
unauthorized access. The appendix describes the information about the seeded mobile
app access roles and the REST services permission sets.
• Mobile App Access Roles, page C-1
Oracle Mobile Yard for Oracle YMS ADF Mobile App Access UMX|UNMX|MBL|YMS_M
E-Business Suite BL_ADF_APP_ACCESS
Oracle Mobile Yard for Oracle YMS Mobile ADF App REST YMS_MBL_ADF_REST_SERV
E-Business Suite Services ICES
The following table lists the application definition metadata for each mobile app:
Overview
Supported Languages
From Oracle E-Business Suite Mobile Foundation Release 4.0, Oracle E-Business Suite
mobile apps are available in the following languages only, although other languages are
listed in the app stores, such as Apple App Store:
• Version 1.4.x, version 1.1.x for Person Directory and Learning apps,
or version 1.0.x for Discrete Quality Manager, Process Quality
Manager, and Self-Service Human Resources, with Oracle E-
Business Suite Mobile Foundation Release 5.0
• Version 1.5.0, version 1.2.0 for Person Directory and Learning apps,
version 1.1.0 for Discrete Quality Manager, Process Quality
Manager, and Self-Service Human Resources apps, or version 1.0.0
for mobile Yard app with Oracle E-Business Suite Mobile
Foundation Release 6.0
• Version 1.6.0, version 1.3.0 for Person Directory and Learning apps,
version 1.2.0 for Discrete Quality Manager, Process Quality
Manager, and Self-Service Human Resources apps, or version 1.1.0
for mobile Yard app with Oracle E-Business Suite Mobile
Foundation Release 7.0
• Canadian French
• Dutch
• English
• French
• German
• Italian
• Japanese
• Simplified Chinese
• Spanish
Note that the initial releases of our mobile apps were distributed in English only.
Note: For iOS mobile devices, set the same language for the iOS
language and the preferred language. Using different languages for the
iOS language and the preferred language could result in mixture of
these languages in the UI pages where UI labels are shown in the
language set for the iOS language, but the language data from Oracle E-
Business Suite is shown in the preferred language.
Dutch Dutch *
English English *
French French *
German German *
Italian Italian *
Japanese Japanese *
Note: * indicates you can set the language for any country or region
except for the region or country used by its variant language. For
example, you can set the language French for France or Swiss except
Canada because Canada uses Canadian French.
The following table lists the Android mobile device locale settings:
If your Oracle E-Business Suite environment supports multiple languages and you set
your mobile device language to a language that is supported by Oracle E-Business
Suite, but not by Oracle E-Business Suite mobile apps, then the data retrieved from the
Oracle E-Business Suite server will be displayed in the mobile device specified
language. However, the user interface labels within the app will appear in English.
If you set your mobile device language to a language that is neither supported by
Oracle E-Business Suite nor enabled in your Oracle E-Business Suite environment, then
the data coming from the Oracle E-Business Suite server will be displayed in the Oracle
E-Business Suite base language.
Note: Before you begin the configuration, ensure that you understand
how OAM handles the languages in the login page, and then properly
configure the default language which is used, if OAM cannot determine
the device language. See: Selecting a Language for Oracle Access
Management Login, Oracle Fusion Middleware Administrator's Guide for
Oracle Access Management.
Japanese ja-JP
Spanish es-ES
3. Repeat the previous step 2 for the all languages you plan to use. For example,
Oracle Mobile Project Manager for Oracle E- • Oracle E-Business Suite Release 12.1.3:
Business Suite Oracle Project Management
Oracle Mobile Process Quality Manager for Oracle Process Manufacturing Product
Oracle E-Business Suite Development
Oracle Mobile Self-Service Human Resources • For Self-Service Human Resources: Oracle
for Oracle E-Business Suite Self-Service Human Resources
Oracle Mobile Supply Chain Applications for Oracle Mobile Application Server
Oracle E-Business Suite