Oracle E-Business Suite mobile Login component provides a sample mobile app that lets you use as a reference implementation. It implements various features of the Login component that are described earlier for Oracle E-Business Suite Mobile Apps Release 9.x and Earlier only. It does not apply to Oracle E-Business Suite Mobile Apps Release 10.x.
To better understand the sample app, this appendix includes the following topics:
The sample app implements the following features in Oracle E-Business Suite as a sample only for developers to use as a reference. This app should not be deployed against a production environment.
Notifications
This feature provides the ability to view open notifications in the current user's worklist. This feature is not the same as in the Approvals app (Oracle Mobile Approvals for Oracle E-Business Suite). This is an implementation that uses its own REST service implementation to show the list of all OPEN notifications in the user's worklist. This feature requires the following two pages:
Notifications.amx
This page invokes the Application Module REST service /webservices/rest/mobileamsample/notifications
.
Details.amx
This page invokes the PL/SQL REST service /webservices/rest/mobileplsqlsample/notificationdetails
.
Status Monitor
This feature provides the ability to search for workflow processes on Oracle E-Business Suite and review the status of the activities within the process. This feature requires the following pages:
SMSearch.amx
This is a search page that a user enters search criteria for workflow processes.
WFTypeLOV.amx
This page implements a LOV (List of Values) to search for workflow item types. This LOV invokes the Application Module REST service /webservices/rest/mobileamsample/wfTypes
. The LOV is invoked from the search page.
SMList.amx
This page displays a list of workflow items that match the search criteria. For each workflow item, the status is also shown. This page invokes the Application Module REST service /webservices/rest/mobileamsample/wfItems
.
SMDetails.amx
This page displays the complete list of runtime activities within a workflow item and the status of each in the order of their implemenation. This page invokes the Application Module REST service /webservices/rest/mobileamsample/itemActivities
.
Settings
This feature is implemented as part of the sample app. However, this page only shows how you can integrate your app-specific Settings screen with the Login component's default features, such as responsibility picker, connection details, and diagnostics.
About
The About page is part of the Login component. You need to add the About feature to Springboard and it is not required to make any changes.
Sign Out
The Sign Out feature is part of the Login component. Similar to the About feature, you need to add the Sign Out feature to Springboard and it is not required to make any changes.
Apart from providing several built-in features through the Login component, the sample app implements the following patterns that you can refer to and use in your mobile apps:
Simple search
Advanced search
Pagination
LOV (List of Values)
Messages
Barcode scanner
The sample app includes the following components:
REST APIs that are required by the sample app to fetch data from Oracle E-Business Suite
Oracle Mobile Application Framework project of the sample app that uses the REST APIs to fetch data from Oracle E-Business Suite
Before you run the sample app, ensure that you perform the following tasks:
Enable the REST interfaces used by the sample app through the following steps:
Ensure that Oracle E-Business Suite Integrated SOA Gateway (ISG) is set up correctly and the REST service framework is enabled, as described in Configuring Oracle E-Business Suite REST Services and Implementing Oracle E-Business Suite REST Services.
Important: If the REST service framework is not enabled, patches for the sample app REST services cannot be applied successfully.
Note: Configuring Oracle E-Business Suite REST services provided through ISG is also required if you use Oracle E-Business Suite REST APIs for custom app development. However, it is not required if you use standard Oracle E-Business Suite mobile apps installed from the Apple App Store or Google Play, or apps provided to users through enterprise distribution.
Ensure you have applied the following patches for the REST services that the sample app uses:
Note: These two patches are included in all product family patches which are consolidated into the Oracle E-Business Suite level patches. See: Applying Patches for Mobile Apps Built with Oracle E-Business Suite Mobile Foundation Release 9.1 and Release 9.0, Oracle E-Business Suite Mobile Apps Administrator's Guide, Release 12.1 and Release 12.2.
For Oracle E-Business Suite Release 12.1.3, apply patch 21316087:R12.FND.B.
For Oracle E-Business Suite Release 12.2, apply patch 21316087:R12.FND.C.
These patches contain the following information:
Sample REST service implementations
Application definition metadata for the sample app
A mobile app access role for the sample app
Log in to Oracle E-Business Suite as a user who has the Integration Administrator role (or the Integration Repository Administrator role in Oracle E-Business Suite 12.1.3 and 12.2.3). Select the Integrated SOA Gateway responsibility and the Integration Repository link from the navigation menu.
Select "Product Family" from the View By drop-down list in the Integration Repository.
Expand the "Applications Technology" folder, then the "Application Object Library" folder, and then select "Mobile Sample".
This retrieves the following APIs that the sample app uses.
Mobile Sample AM Interface
Mobile Sample PL/SQL Interface
Organization Picker
For each interface that the sample app uses, perform the following tasks:
Select the Grants tab.
Create security grants for all the operations contained in the selected interface so that the users who will be running the sample app can access these operations.
For more information on creating security grants, refer to Managing Grants for Interfaces with Support for SOAP and REST Web Services, Administering Native Services, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.
Select the REST Web Service tab.
Enter the following information for each interface:
Service Alias: Specify service alias information for each selected interface:
Mobile Sample AM Interface - mobileamsample
Mobile Sample PL/SQL Interface - mobileplsqlsample
Organization Picker - mobileorgsample
Verb: Select "POST" as the HTTP verb for each selected interface.
Click Deploy to deploy each selected interface as a REST service.
For more information about deploying REST services, refer to Chapter 3 Administering Native Services, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.
The REST interfaces are now ready to be used by the sample mobile app.
Enable the sample app by configuring the app in Oracle E-Business Suite:
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 navigation menu.
Locate the sample mobile app in the Search Mobile Applications page by entering the following information:
Application Name: EBS Sample App
Application Bundle ID: com.oracle.ebs.atg.mbl.Sample
Enable and configure the sample app by clicking the Configure icon.
If desired, specify configuration parameter values for the sample app.
For information on configuring a mobile app, refer to Configuring the Mobile Apps on the Oracle E-Business Suite Server, Oracle E-Business Suite Mobile Apps Administrator's Guide, Release 12.1 and 12.2.
Assign the sample app access role (role code UMX|FND_MBL_SAMPLE_ROLE
) to responsibilities through the following steps:
Identify one or two responsibilities that are already available to the Oracle E-Business Suite users using which you plan to log in to the sample app.
Assign the sample app access role to those responsibilities.
For information on assigning the role to responsibilities, refer to Setting Up Mobile App Access to Responsibilities, Oracle E-Business Suite Mobile Apps Administrator's Guide, Release 12.1 and 12.2.
Deploying and Running the Sample App
Unzip the sample app and open it in Oracle JDeveloper that is already set up to run Oracle Mobile Application Framework applications. Deploy the sample app to either an iOS Simulator or Android Emulator and test it.
Please note that the Developer mode is disabled for the sample app by default. Therefore, when you run it, you are required to accept the End User License Agreement and enter the Server URL for the Oracle E-Business Suite environment where you have enabled the REST APIs and configured the app.