Oracle Fusion Expenses iOS/Android App for

Internet Expenses (Doc ID 1625446.1)

APPLIES TO:
Oracle Internet Expenses - Version 12.1.3 and later
Information in this document applies to any platform.

PURPOSE
Oracle Fusion Expenses is an iOS/Android app for Expense Report Entry
and Approval.
The app is compatible with both Fusion Expenses and EBS Expenses (OIE).
This document has details on how the app can be configured and used
with Oracle EBusiness Suite.

DETAILS
Release Information
The app can be used on Release 12.1.3 and above. Please see the prerequisites and deployment instructions in this document for more
information on specific patches.
On an iPhone the app can be installed on iOS 6 and above.
On Android the app can be installed on 4.0.3 or above.
Technology Components
The app contains two parts, the app that can be downloaded from the App
Store and deployed on the device and the corresponding data services,
delivered as a patch to be applied on the middle tier.
Pre-Requisites:
Mandatory
1. Mobile Device

iOS 6 or above

Android 4.0.3 or above

2. Oracle Applications Release 12.1.3 or above

3. Patch

Patch 21030421:R12.OIE.B on 12.1.3. No password is

required.

Patch 21030421:R12.OIE.C on 12.2.3 and above. Submit a

new Service Request with Oracle Support to request the
required password.

Deployment:
There is no setup required to deploy the services apart from applying the
patch and to stop and start middle tier.
1. After the pre-requisite patches are installed, stop and start the
middle tier.
2. The function "Expenses Mobile" is added to the seeded Expenses
Entry Menu (Expenses Main Menu). If there are any custom menus
being used, this function has to be added to them. The function can
also be used to restrict access by excluding it from responsibilities.
3. Install Oracle Fusion Expenses

For iOS, install Oracle Fusion Expenses version 4.0.3 from the
App Store.

For Android, install Oracle Fusion Expenses version 1.3 from

Google Play.

4. Start VPN if required by the setup.

5. Open the app.
6. Agree to the Legal Terms
7. Enter the host URL in the format http(s)://<host>:<port>/OAR
8. Enter a user-name and password.
9. After a successful sync, the app will show

Steps to Debug Expenses Mobile App Failures

1. Login Issues
Pre-Requisite Checks:
1. Open the url http(s)://<your-instance>:<

port>/OA_HTML/RF.jsp?function_id=mLogin
2. A basic authentication login dialog should appear

3. If the above dialog is not seen, please check the pre-requisites

mentioned on the patch or contact Oracle Support.
Expenses Mobile App depends on the function "Expenses Mobile", this
function is added to the seeded Expenses Menu. If the customer has a
custom menu, this function has to be added to their custom menu. It is
expected that this function is available only under one responsibility that
the user has, if the user has multiple Expenses responsibilities and all of
them have this function, a grant has to be created for the user following
the steps mentioned below. Expenses Mobile will pickup the first
responsibility it finds, the order is random.

Steps to create a grant (Only in the case where the user has
access to the function Expenses Mobile from multiple
responsibilities):
1. Login to the application as sysadmin.
2. Choose Functional Administrator Responsibility
3. Under the Security Tab, click on Create Grant

4. Enter a name and description for the grant.

5. Select All Users or Specific User for the grantee type (depending on

the requirement). Click Next

6. Select Expenses Main Menu (Or your custom menu which has the
function Expenses Mobile), Click Next

7. Review and Finish.

8. Stop and Start Middle Tier.
Debugging Steps:
Run the following query
select fr.responsibility_id, fr.application_id from fnd_responsibility fr,
fnd_user_resp_groups fu where fu.user_id = :1 and fr.menu_id in (select
m.menu_id from fnd_menu_entries m, fnd_form_functions f where
m.function_id = f.function_id and f.function_name =
'OIE_MOBILE_EXPENSES') and fr.responsibility_id = fu.responsibility_id and
rownum = 1;
Replace :1 with the FND_USER ID of the user using the app, for example if
JFROST is the user, FND_USER ID can be obtained by using the query
select * from fnd_user where user_name = 'JFROST';
Note: The above query should return a row. If it does not, either the
function "Expenses Mobile" is removed from all the menus or there is a
custom menu being used and it does not have the function "Expenses
Mobile".
Note: If the above steps do not help, please contact Oracle Support with

the FND Log using the steps mentioned in "Generating FND Log" section
2. All Other Issues:
1. Login fails with Server version incompatible error, for all users
Compile menus in the system, clear middle tier cache.
2. The App crashes after a specific step
Contact Oracle Support with the complete steps to replicate the crash.
3. Sync fails
Contact Oracle Support with the FND Log using the steps mentioned in
"Generating FND Log" section
4. Expense Report is always saved on the server even when there are no
validation failures.
Run the following queries and get us the output, replace :1 with the
report_header_id of the report that is failing.
select * from ap_expense_report_headers_all where report_header_id =
:1
select * from ap_expense_report_lines_all where report_header_id = :1
select * from ap_exp_report_dists_all where report_header_id = :1
5. Contact Oracle Support with the FND Log using the steps mentioned in
"Generating FND Log" section
3. Generating FND Log:
1. Enable FND Log at the statement level for the user who has the issue
2. Run the following query and note the value
select max(log_sequence) from fnd_log_messages
3. Replicate the issue on the device
4. Run the following query and note the value
select max(log_sequence) from fnd_log_messages
5. Run the following queries and export the results in to an excel, send us
the excel
5.1 select * from fnd_log_messages where log_sequence between :1
and :2
Note: Replace :1 with the value from Step 2 and :2 with the value
from Step 4.
5.2 select * from fnd_log_messages where log_sequence between :1

and :2 and module like '%Expense%'

Note: Replace :1 with the value from Step 2 and :2 with the value
from Step 4.

Change Record
Date

Description

January 1,
2016

Updated iOS app version to 4.0.3

October 13,
2015

Updated iOS app version to 4.0.2, Android app version to

1.3, and updated patch for Release 12.2 and above to
21030421:R12.OIE.C

August 6,
2015

Updated Android app version to 1.2

July 21, 2015 Updated iOS app version to 4.0.1

June 26, 2015 New UI implemented for 4.0 therefore removed iOS
version 3.1 screen shot
June 19, 2015 Updated iOS app version to 4.0 and updated patch for
Release 12.1.3 to 21030421:R12.OIE.B
March 20,
2015
March 19,
2015

Added Android Screen Shot to Deployment

Updated following sections for Android:

Title

Purpose

Release Information

Mandatory Pre-requisites

Deployment

Updated Mandatory Pre-requisites to include the following

changes for Patch:

Added Patch 20325531 for Rel 12.1.3

Changed Rel 12.2.3 to 'Rel 12.2.3 and above'

Corrected Note in Generate FND Log step 5.1 and 5.2 from
'...with the value from Step 5' to be '...with the value from
Step 4'
September
11, 2014

Updated patch numbers from 18179553 to 18598191 to

reflect new patches for Oracle Fusion Expenses Mobile app
for R12 - Ver 3.1.0

X -------------------------------------------------------------------------------------------------------------X