Create a mobile UI rule to apply styling or field calculations for your mobile UI elements.

Before you begin

Role required: admin

Procedure

  1. Navigate to All > System Mobile > Mobile UI > Mobile UI Rules.
  2. In the Mobile UI Rules list, select New.
  3. In the Mobile UI Rule form, fill in the fields.
    Table 1. Mobile UI Rule form
    FieldValue
    Name Name of the mobile UI rule.
    Active Whether the mobile UI rule is active.
    Condition

    Condition under which the mobile UI rule is used. The rule executes if the condition evaluates as true. Mobile UI rules with no condition always evaluate as true.

    To use a field in a condition, the field must be displayed on the mobile card, or it must be added to the Card fields tab on the card [sys_sg_view_config] record for that card. If the field is a reference field, you can also access information in the related record using dot-walking. See Dot-walking to data in related tables.

    Conditions can also use variables defined in the mobile scratchpad. These variables are created and evaluated using the script in the Mobile Scratchpad Script field in the card [sys_sg_view_config] record.

    Javascript in the Mobile Scratchpad script fieldMobile UI Rule condition using a scripted condition
    Note: For details on the operators available for your condition, see Operators available for filters and queries.
    Parent Table The parent table that the mobile UI rule applies to. Select either:
    • Input Form Screen
    • Mobile View
    Parent The input form screen or mobile view record to which your mobile UI rule is applied.
    Triggers The condition that triggers the mobile UI rule. Select one or both of the following options.
    • onLoad: The mobile UI rule triggers when the record loads.
    • onChange: The mobile UI rule triggers when the record is changed.
    • onUserAction: The mobile UI rule triggers when the user performs the specified action.
      Note: To use the onUserAction trigger, a User Action Id must be associated with the UI rule.
    User Action Id A unique value that identifies this action record. It is needed to associate the action with a UI rule.
    Order Order in which the mobile UI rule executes. If there are multiple rules affecting the same element, the rules execute according to this value. Lower numbered rules execute before higher numbered rules.
    Reverse If False

    When this field is selected, the mobile UI rule actions are reverse if the condition evaluates as false.

    Important: When this field is selected for high order mobile UI rules, it inactivates prior rules that address the same target and operation.
  4. Select Submit

What to do next

After creating your mobile UI rule, you must create mobile UI rule actions to execute when your rule is used.