Navigation functions enable you to define simple ways for end users to navigate
within the mobile platform, for example, navigating to a record from a field on another
record.
Before you create a navigation function, you should have a source applet and a
destination applet for your navigation.
Role required: admin
-
In Studio, navigate to .
-
Click the pop-out icon (
).
-
In the Navigations list, click Create a new
navigation.
-
In the Properties section, in the Name field, type a
name for the navigation.
Because you can reuse navigations, use a name that you can easily
identify.
-
In the Description field, provide a description for your
navigation function.
-
In the Destination Type field, select whether you are
navigating to an applet or applet launcher.
-
In the Destination field, select the applet or applet
launcher you want to navigate to.
Depending on the destination screen selected in your
Destination field, you might need to include
parameter settings.
-
In the Context field, select whether the action should
be available for a specific or global context. For an applet launcher, select
Global.
-
Set the Available Offline option to determine whether the navigation function
is available offline.
The applet and the application containing the navigation function must be
marked as available offline for the navigation function to work offline. For
more information on offline mode, see
Mobile offline mode for Agent.
-
If you added a destination applet that has a parameterized data item, in the
Parameter Setting section, update the redirection parameter fields.
-
Click the value in the parameter name field.
-
Complete the parameter settings.
Note that some of the fields vary depending on the value you select
for the Type field.
Table 1. Redirection parameter form
Field |
Description |
Destination UI parameter |
The name of the parameter you created for the
data item. If the parameter
Type value is
User Input, use a
user-friendly name. |
Type |
Source of information for the parameter. The
available options are:
- Field: The parameter
gets the information from a field on a table.
- Constant: The parameter
uses a constant value.
- Source UI
parameter
|
Source field |
Source for the parameter. This field appears only
if Field is the redirection
parameter type. The table defined in the data item
determines the available fields. |
Constant value |
Value to appear for the data item parameter. This
field appears only if
Constant is the redirection
parameter type. |
Source UI parameter |
UI parameter for the source screen. This field
appears only if Source UI
Parameter is the redirection parameter
Type value. |
-
Click Save.
-
In the Advanced Configurations section, determine the display conditions and
the roles required for the navigation function.
For example, you could define a different function or action for the same
button according to user roles.
-
Select a table in the
Display Conditions section.
-
In the condition builder, select filter conditions to limit when the
navigation function is available.
For example, if you want users to be able to navigate to a problem
from an incident form, you can configure the navigation function to
appear only when the problem field has a value.
-
Add the roles that can use the navigation function to the Select Roles
section in the Roles Permission section.
-
Click Save.
After you create a navigation function, you must associate
it with a specific location in the mobile app. For more information, see Associate a function with a location in the app.