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

How can OFS call OS native map applications?

Environment:

Oracle Field Service (OFS) 19.B+

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.
  • Interface. Select Mobility.
  • 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.

After switching to the mentioned, set field type to Native application and you will be able to observe that there is a box with an empty form that 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. Select Legacy Manage or the 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 the action to edit the Standard action screen.
3. On first field of the popup window that was just opened, select "Plugins".
4. On our example we defined gps_directions. Select the action you just created on Screen field.
5. Click OK.
6. Click Save.
 
  • For Legacy Manage, select the context Add activity/Activity details.
 
1. Scroll the left panel to the bottom and find the Buttons area, click the option Click to add.
2. On "Screen type" field, select Plugins.
Add the plugin you just created searching by name or label. Now you can select the proper plugin and click OK.
 
  • Visibilities 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".