Docs.bmc.com will undergo a brief maintenance outage 27 March 2025. The site will be unavailable for ten minutes starting at 6:30 AM CDT/5 PM IST.

Setting user preferences and CCS parameters for Progressive Web Applications


As an AR administrator, you can set preferences for web clients and Progressive Web Applications (PWA) users by using the AR System User Preference form. You can make settings for each user such as logging, locale-based settings, and so on, for better control of  AR System behavior as well as better user experience. 


To set the user preferences for Progressive Web Applications

  1. Log into Action Request System and open the AR System User Preference form.
    Applications >  AR System Administration > AR System Administration Console > User Preferences > My User Preferences.
  2. Set any of the following PWA-related user preferences:

    Tab

    Area Name

    Option

    Description

    Logging

    Client

    Active Links

    Enables logging of active
    links on the client. 

    Server

    API

    Enables logging of APIs running on the server.

    Filter

    Enables logging of filters on the
    server.

    Database

    Enables logging of database activity.

    Progressive View

    Date Field Display Settings

    Date field display.png

    Date Display Mode

    • Use System Defined
    • Absolute
    • Relative

    Use System Defined displays the date in the format specified by the arsystem.pwa_date_field_display_mode CCS parameter.
    To learn more about this CCS parameter, see Configuring date and time formats.

    Absolute displays the full date and time when the record was created.

    Relative displays the elapsed time since the record was created. 

    Start Day of Week

    Sets the specified day as the first day of the week.

    For a complete list of user preferences, see Setting-centralized-preferences-with-the-AR-System-User-Preference-form.

  3. Click Save.

To set centralized configuration settings parameters for Progressive Web Applications

The centralized configuration forms store the configuration settings. You can modify the settings by using the AR System Configuration Generic UI form. The settings are case- and space-sensitive. For more information, see Updating-configuration-settings-by-using-the-AR-System-Configuration-Generic-UI-form. For the entire list of configuration settings that are used in AR System, see Configuration-settings.

Best practice
We recommend that you use the AR System Configuration Generic UI form to modify the configuration settings. Do not use the ar.cfg file to modify the configuration settings on the AR System Configuration Generic UI form.

  1. In a browser, open the AR System Administration Console, and click System > General > Centralized Configuration.
  2. In the AR System Configuration Generic UI form, from the Component Name list, select the component to which you want to add a setting.
  3. Click Add.
  4. Enter the name of the setting that you want to add and then enter its value. 
    The following table lists the PWA-related settings available in centralized configuration:

    Setting

    Description

    Server group configuration

    Maps to

    arsystem.pv_menu_debounce_time

    (Component name: arsystem.bmc.arsys.midtier)

    On progressive view enabled forms, determine the wait time interval in milliseconds for sending expand menu call after entering Autokey stroke in a menu.

    Default value: 500 


    Yes

    AR System Administration Console > System > General > Centralized Configuration

    useARUserPreferenceForLocalization

    (Component type: arsystem.bmc.arsys.midtier)

    Use the locale set in the User Preference form as the first priority for the forms with progressive views enabled. The language the application users see is based on this setting.

    Valid values:

    • true
    • (Default) false

    ARS user preference-lcale.png

    Example use case:
    Apex Global wants to make sure all the employees see the same language in the Progressive Web Application irrespective of the geography they log in from. Set this parameter to true to set the language of the Progressive Web Application according to the setting for User Locale in the User Preference form. Therefore, Apex Global implements a uniform locale-based experience to all its employees.

    Yes

    AR System Configuration Generic UI form.  

    useARUserPreferenceForTimezone

    (Component type: arsystem.bmc.arsys.midtier)

    Use the time zone set in the User Preference form as the first priority for the forms with progressive view enabled. The time zone that the application users see is based on this setting.

    Valid values:

    • true
    • (Default) false

    AR system user preference-Locale.png

    Example use case:
    Apex Global wants to make sure all the employees see the same time zone and time settings in the Progressive Web Application irrespective of the geography they log in from. Set this parameter to true to set the time zone of the Progressive Web Application according to the setting for Time Zone in the User Preference form. Therefore, Apex Global implements a uniform experience to all its employees.

    Yes

    AR System Configuration Generic UI form.  

    useARUserPreferenceForDateTimeFormat

    (Component type: (Component name arsystem.bmc.arsys.midtier-DockerMTClusterUser))

    Use the date and time format set for Display Date/Time Style (Web) in the User Preference form as the first priority for the forms with Progressive View enabled. The date and time format that the application users see is based on this setting.

    date time user preferences.png

    Valid values:

    • Custom
    • Short
    • Long

    To learn more abut the values, see Web-client-preferences.

    Yes

    AR System Configuration Generic UI form.  

    pv.enable_attachment_on_delete_confirmation

    (Component name: arsystem.bmc.arsys.midtier > arsystem.bmc.arsys.midtier-DockerMTClusterUser)


    Enables display of a confirmation message when users remove an attachment on Progressive Web Application (PWA) screens.

    The default value for this option is false, which means the application does not display a message when attachments are removed. As an administrator, you can set this option to true to enable confirmation messages when PWA users remove attachments. 


    Yes

    AR System Configuration Generic UI form  

    For a complete list of configuration settings, see Configuration settings.

  5. Click Apply.
  6. Click Close.