Fusion Expenses Mobile

Training Session
19 May 2017

INTERNAL USAGE ONLY

NOT TO BE SHARED WITH

CUSTOMERS

FUSION EXPENSES MOBILE TRAINING SESSION 1

 Troubleshooting 101 - The Flowchart

Start

Verify the authentication

URLs

Verify configuration setup

Verify web service response

Contact development

End

FUSION EXPENSES MOBILE TRAINING SESSION 2

Authentication URLs:

• App supports FND based login and Single Sign On (SSO) login

• FND Login:

o Overview:

▪ Utilizes FND’s mLogin function to perform authentication

▪ To use this method of authentication, customers should append /OAR to the

instance URL and enter that string in Host URL field.

• E.g: http://rws3260536.us.oracle.com:8016/OAR

▪ For mLogin authentication mechanism, in the Login screen of the app,

customer should populate Host URL field, user name field and Password field.

o Troubleshooting:

▪ The value that customer enters into the Host URL field, is just a string, not a
URL! As part of troubleshooting, do not attempt to directly use that string!!

▪ The App, in the background, reformats above string into following URL. From
now, this URL string will be referred to as mLogin URL.
http://rws3260536.us.oracle.com:8016/OA_HTML/RF.jsp?function_id=mLogin

▪ Ask the customer to open mLogin URL in their Laptop/Desktop browser. A prompt
to enter username and password should appear.

FUSION EXPENSES MOBILE TRAINING SESSION 3

 ▪ Customer should enter the user name and password in the prompt. If the
authentication succeeds, they will see XML response such as following:

▪ If the authentication fails, they will see XML response such as following. Please
contact Development team in such cases.

<response>
<status>
<code>401</code>
<description>Invalid username/password</description>
</status>
<data>
<accessToken>-1</accessToken>
<accessTokenName />
<ebsVersion />
</data>
</response>

▪ Capture screenshots of the XML response.

▪ If the customer is seeing successful mLogin authentication in the Laptop/Desktop

browser, then, repeat the test in the device browser:

• iPhone/iPad: Safari Browser

• Any Android device: Chrome Browser

▪ Capture screenshots of the XML response from the device as well.

FUSION EXPENSES MOBILE TRAINING SESSION 4

 • SSO Login:

o Overview:

▪ Utilizes OAM based SSO authentication mechanism

▪ To use this method of authentication, customers should append /SSO to the

instance URL and enter that string in Host URL field.

• E.g: https://rws3270692.us.oracle.com:4443/SSO

▪ For this authentication mechanism, in addition to Host URL field, customer need
to populate a value for SSO URL field as well.

▪ The SSO URL field will take the value mentioned in Application Authenticate
Agent Profile option.

• E.g: https://rws3260326.us.oracle.com:4443/ebsauth_mobr7213/

▪ We also refer to this URL as AccessGate URL, for troubleshooting purposes.

▪ For SSO authentication mechanism, in the Login screen of the app, customer
should populate Host URL field, user name field and SSO URL field.

FUSION EXPENSES MOBILE TRAINING SESSION 5

 ▪ If Customer taps on the Login button, the App will open Oracle Access Manager
authentication page.

▪ Depending on their customization, customers may see seeded OAM

authentication page or customized authentication page.

FUSION EXPENSES MOBILE TRAINING SESSION 6

 ▪ Customer should enter the credentials and tap on Login button, for the OAM to
perform the authentication.

▪ If the authentication is successful, the sync procedure should automatically get

initiated.

▪ If the OAM authentication fails, the Customer will remain in the OAM
authentication page, till valid credentials are entered.

▪ If the OAM authentication succeeds and Sync process fails to initiate, then
following error message will be shown:

FUSION EXPENSES MOBILE TRAINING SESSION 7

 o Troubleshooting:

▪ The value that customer enters into the Host URL field, is just a string, not a
URL! As part of troubleshooting, do not attempt to directly use that string!!

▪ For troubleshooting issues with SSO authentication, we need two URLs:

• SSWA Instance URL

➡ E.g: https://rws3260326.us.oracle.com:4529

• AccessGate URL: Generally, this URL is mentioned in Application

Authenticate Agent profile option.

➡ E.g: https://rws3260326.us.oracle.com:4443/ebsauth_mobr7213/

▪ Step 1: Append login/sso to the AccessGate URL and ask the customer to open
the appended URL string in the Desktop/Laptop browser:

• E.g: https://rws3260326.us.oracle.com:4443/ebsauth_mobr7213/login/sso

▪ If the OAM-EAG setup is correct, the Oracle Access Manager web page should
open. Here, customer will see fields to put in their credentials.

▪ If the OAM web page fails to open, then, they need to verify their OAM-EAG
setup. Please open collaboration SR with ATG support.

▪ If there is an authentication failure in this screen, then, Customer need to verify

their user setup.

FUSION EXPENSES MOBILE TRAINING SESSION 8

 ▪ If the authentication is successful, they might see a blank screen or in cases,
where required EAG patches are not present, they might see a 404 - Not Found
message or a 500 - Internal server error message. Please proceed to the next
steps, in any of these cases.

▪ Capture screenshot of the response.

▪ Step 2: In the same browser session, append login/apps to the AccessGate URL
and ask the customer to open the appended URL string in the Desktop/Laptop
browser:

• E.g: https://rws3260326.us.oracle.com:4443/ebsauth_mobr7213/login/apps

▪ The customer might see a XML response as the output.

FUSION EXPENSES MOBILE TRAINING SESSION 9

 ▪ If the required EAG patches are not present, they might see a 404 - Not Found
message or a 500 - Internal server error message. Please proceed to the next
steps, in either of these cases.

▪ Capture the screenshot of the response.

▪ Step 3: Lastly, continuing the same browser session, ask the customer to open
the SSWA instance URL.

• E.g: https://rws3260326.us.oracle.com:4529

▪ If the setup is correct and if Step 1 (login/sso) and Step 2 (login/apps) are
implemented, the customer should be able to see the Responsibilities screen,
without any further prompts for credentials.

▪ Capture the screenshot of the response.

▪ If the customer is seeing successful authentication in the Laptop/Desktop

browser, then, repeat the test (Step 1, Step 2 & Step 3) in the device browser.
Capture screenshots of the responses from the device as well.

FUSION EXPENSES MOBILE TRAINING SESSION 10

Configuration Setup:

▪ Capture screenshots for all below items

▪ Details of the user (System Administrator -> Security -> User -> Define)

• A valid and an active Internet Expenses responsibility should be present for this user.

▪ Profile option: OIE Mobile Responsibility

• The value to this profile option should be set to a valid and active Internet Expenses
responsibility.

• The value can be set at the appropriate level.

• Once set, the App will function within the scope of that responsibility.

FUSION EXPENSES MOBILE TRAINING SESSION 11

 ▪ Details of the Internet Expenses responsibility (System Administrator -> Security ->
Responsibility -> Define)

• Search for the responsibility set to OIE Mobile Responsibility profile option.

• The responsibility should be active and should have a value set to the Menu field.
Note the name of the Menu.

• In Available From section, Oracle Self Service Web Applications should be selected.

▪ Details of Menu set to Internet Expenses responsibility (System Administrator ->

Application -> Menu)

• Search for the menu (User Menu Name) noted in the above step.

• The Expenses Mobile function should be set for Expenses Application Menu sub
menu under Expenses Home

• Below screenshot is just for illustration. Customers may have other Submenus and
Functions as part of their setup.

FUSION EXPENSES MOBILE TRAINING SESSION 12

 ▪ Details of Grant created for Expenses Mobile (Functional Administrator -> Security ->
Grant)

• For Fusion Expenses mobile to function in EBS environment, a valid and an active
grant should be created.

• Grantee Type should be set to All Users

• No value should be entered for Operating Unit and Responsibility fields.

• The menu name noted in the Details of the Internet Expenses responsibility step,
should be Menu Navigation Set.

▪ Details of user responsibilities from database

• Output of following queries should be analysed to see if any rows are getting
returned, indicating availability of valid Internet Expenses responsibility for the user

select fr.responsibility_id, fr.application_id from fnd_responsibility fr, fnd_user_resp_groups fu

where fu.user_id = (select USER_ID from fnd_user where user_name = :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;

select fr.responsibility_id, fr.application_id from fnd_responsibility fr, fnd_user_resp_groups fu

where fu.user_id = (select USER_ID from fnd_user where user_name = :1) and fr.responsibility_id
= fu.responsibility_id;

FUSION EXPENSES MOBILE TRAINING SESSION 13

Web service response:

▪ A Java program that simulates a web service call from the device.

▪ Useful in understanding, what data is being received by the device from the server

▪ Usage Procedure:

• Location of the java Diagnostics Zip Archive: http://www-apps.us.oracle.com/

~saprayag/ExpenseWebServiceTester/ExpenseWebServiceTester.zip

• When troubleshooting with the customer, support should download the Zip archive
and attach it to the SR.

• Customer should download the Zip archive on to their local machine (Desktop/
Laptop) and extract the the archive to some location.

E.g: /users/someuser/oiediagnostics/

• Navigate to that location

E.g: cd /users/someuser/oiediagnostics/

• In the folder, look for a file named details.txt. Open that file and replace details as
follows:

o Sample Host URL (http://samplehost.company.com:8080) with Actual Host

URL. Please make sure /OAR is retained at the end.

o Sample User Name (SAMUSR) with Actual User Name.

o Sample Password (welcome) with Actual Password.

• Run the command at Unix prompt or Command prompt:

java ExpensesMobilePerformance

• Verify that the correct host URL, user name and password details are picked up by
the Java Diagnostics application.

• The communication between the device and the server happens through XML.
Analyse the XML output and ensure that there are no errors or exceptions.

• By default, the Java diagnostics will execute the web service call for fetching the
settings information. If we need to test other web service calls, open details.txt
and replace details as follows, save the file, and re-run the Java command listed
above.

o Existing service name (FindProfileAttribute) with a new service name

(FindCurrencyRate)

FUSION EXPENSES MOBILE TRAINING SESSION 14

 • Supported web service names:

o FindProfileAttribute: Settings data

o FindCurrencyRate: Currency Exchange Rate

o FindTerritoryCurrency: Currency - Country Name mapping

o FindExpenseTemplate: Template and type information

o FindChildTypes: Parent and Child type mapping

o FindMobileExpenseReportApproval: Approval report data

o FindProjectTask: Project, Task, Award data

o FindDescriptiveFlex: Descriptive Flex Field data

o FindValueSets: Descriptive Flex Field Value set data

• Please capture the output, remove the password information and store it in a text
file.

Additional Troubleshooting Step (Only for Android):

• The Fusion Expenses Android app generates a file named expenses.txt, which will
contain the log statements captured during the execution of the App.

• In case of any issues with the Android app, this is a great place to start
troubleshooting.

• Connect the Android device to a Desktop/Laptop

• Check for any file explorer app on the Android device (such as "My Files" in Samsung
devices or "ES File Explorer" available in Playstore etc)

• After encountering login error or any other issue on the Expenses app, open the file
explorer app, and navigate to Device storage folder (or similar folder).

• Look for the Expenses.txt file

• If found, select that file and move to a convenient location which is accessible from
laptop to which device is connected.

• If not found, navigate to SD memory card folder and repeat the procedure.

FUSION EXPENSES MOBILE TRAINING SESSION 15

FUSION EXPENSES MOBILE TRAINING SESSION 16