Skip Navigation
Expand
Configure Plugins to call native map applications in Oracle Field Service (OFS)
Answer ID 10467   |   Last Review Date 02/28/2022

How can OFS call OS native map applications?

Environment:

Oracle Field Service (OFS)

Assumptions:

  • Activities must have a valid address that could be resolved into GPS coordinates
  • User must have enough privileges to create/configure Plug-in and User Types

Resolution:

The following configuration intends to help you to configure your OFS instance to call OS native map applications using GPS coordinates from an activity using the custom action link configuration functionality.

Create Plug-in

1. On Configuration screen, click on Forms & Plug-in
2. Inside Forms & Plugins configuration screen, find the option Add Plugin
3. Select the option to Add Plug-in
4. On General tab, fill the required fields as follows:
  • Action name. Example: Get Directions.
  • Label. Example: gps_directions.
  • Entity. Select Activity.
  • Visibility rules similar to. Select navigation_native_app
  • Type. Select Native application.
Configure each native application to be called accordingly
 
By selecting the type Native application, a box to for the configuration of each native application will be displayed. It needs to be filled with the appropriate information for each native application as following. 
 
Android
 
Native application name: Android
Browser user agents mask: *Android*
URL template: geo:0,0?q={acoord_y},{acoord_x}
 
iOS
 
Click on Add link located at the bottom of the tab Plugin details and fill the empty fields of the added form with the following information:
 
Native application name: iOS
Browser user agents mask: *(?:iPad|iPod|iPhone)*
URL template: http://maps.apple.com/?q={acoord_y},{acoord_x}
 
Others
 
Click on link Add located at the bottom of the Plugin details tab and fill the empty fields of the added form with the following information:
 
Native application name: Other
Browser user agents mask: *
URL template: https://maps.google.com/?q={acoord_y},{acoord_x}
 
Observation 1: Since you selected the entity Activity on General tab, the placeholders {acoord_y} and {acoord_x} will use such coordinates to generate the URL that will be called in each of the cases above.

Observation 2: The aforementioned URLs are from third-party companies outside of Oracle, and may change without any notice. Oracle does not support functionality based of these third-party functions.
 
Configure the new Plugin on User Type
 
Select a User Type of your choice and go to the Screen Configuration tab. Expand Application Screens.
 
  • For Mobility and Application screens, select the context Edit/View Activity:
 
1. On the left side of the Visual Form Editor, drag and drop the a new element Button on screen top menu. 
2. Click in the button you just dropped and click on pencil to edit the Standard action screen.
3. On first field of the popup window that was just opened, select "Plugins".
4. Find the plugin you have just created
5. Click OK.
6. Click Save.
 
 
  • Configure visibility rule to avoid maps application to be called when there's no coordinates available:
 
In any of the mentioned screens, select the directions action link by clicking on the item on configuration screen. Go to visibility configuration and add the condition "Coordinate Status in (equal) found".