1. Mobile Plugin Framework
  2. Configure a Plugin to Add to the Main Menu

Configure a Plugin to Add to the Main Menu

You can add plugins that are created as HTML5 applications to the Main menu. You cannot add native application plugins.

  1. Click Configuration > Forms & Plugins.
  2. Click Add Plugin.
  3. Complete these fields on the Add Plugin page:
    Field Name Description
    General Information section
    Name (English) A mandatory field defining the plugin name in the English language. The action or plugin appears under this name in the actual context.
    Name (other languages) Plugin name translations to other languages, if used.
    Label A mandatory field defining a unique action or plugin label.
    Entity Entity (activity, inventory, required inventory, resource, service request, user) to which the action or plugin is to be related. For example, if you select Inventory, the action will appear only in the contexts related to inventory. Leave the field blank for the action to be available in all contexts of all the entities.
    Visibility rules similar to The base action from which the plugin is to be derived, if needed. When a base action is selected, the resulting plugin functions per the same rules as the base action. The base action affects only the visibility of buttons and not the functioning of the plugin. It appears only in the contexts in which the base action appears and is shown or hidden according to the same visibility conditions. For example, if start_activity is selected as the base action for a plugin, the plugin is only be shown in the context of a pending activity when there is no started activity in the same route, similar to the Start action. The list of available base actions is filtered according to the Entity that is selected.
    Type

    The type of plugin you want to use. Select HTML5 application.

    This means, the plugin uses an external application to extend the functionality. The HTML5 plugin is a URL of an external resource that is opened in a new window or in an iframe.
    Fields for the HTML 5 Application Option
    Use Plugin API

    Determines whether you want the plugin to communicate with Oracle Fusion Field Service using the Plugin API. Clear this check box.

    When you do not use the Plugin API, the URL is opened in a new tab, window, or iframe. To interact with Oracle Fusion Field Service you must pass some data (such as activity id, resource name) to the plugin using the placeholders in the "POST Data" and "URL" fields.
    URL The path to a URL (for external plugins). This URL processes the HTML5 application and it runs the plugin in the entire browser window. The URL must start with the protocol (https). The URL must point to an external resource, which is opened either in a new window or inside Oracle Fusion Field Service in an iframe (if the “Tab or iframe layout” option is selected).
    POST Data The data that you want to be sent to the external plugin. You can use only User entity fields as placeholders.
    Disable plugin in offline Determines whether you want to disable the plugin when Oracle Fusion Field Service is offline. Clear this check box for the plugin to work in offline mode.
    Open in iframe Determines whether the plugin uses the iframe layout. If you clear the field, the plugin’s URL is opened in a new browser tab or window.
  4. Click Save.
    If you set the external plugin as the first item on the Main menu context layout, the menu item is displayed in the correct order. However, the plugin does not open when a user logs in to the application. Instead, a standard page or a plugin that you have created using the Plugin API Framework that is next in the order is opened.