Oracle Fusion Expenses iOS/Android App for Internet

Expenses (Doc ID 1625446.1)

To
Bottom

In this Document
Purpose
Details
Change Record
References

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 pre-requisites 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. No password is

required.

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
January 1,

Description
Updated iOS app version to 4.0.3

2016
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 Added Android Screen Shot to Deployment

Updated following sections for Android:

March 19, 2015

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