Changing the Default Browser Detection

Use

Unified Rendering browser detection supports more browsers than those that are supported in the Product Availability Matrix (PAM). Administrators can specify whether users are permitted to run Web Dynpro ABAP applications only in browsers supported in PAM, or also in browsers supported by Unified Rendering browser detection. The default setting allows Web Dynpro ABAP applications to be run also in browsers that are supported by Unified Rendering browser detection but not supported in PAM.

Procedure

There are two ways to change the default browser detection:

1. Application parameter WDALLOWEDUSERAGENTS

If you want to specify that users can only run Web Dynpro ABAP applications in browsers supported in PAM, use application parameter WDALLOWEDUSERAGENTS.

More information: Application Parameters and URL Parameters

2. Implementation of a Business Add-In (BAdI)

A BAdI allows you to activate specific browsers to run applications in. This also functions for browsers that are not recognized by Unified Rendering browser detection.

Follow the procedure below:

  1. Implement BAdI WD_BADI_USER_AGENT_DETECTION, and create BAdI interface IF_WD_BADI_USER_AGENT.

    For more information about BAdI implementation, see Business Add-Ins (BAdIs).

  2. In the BAdI you can change the attributes of the two parameter groups, lightspeed_info and user_agent_info. You can parse the user agent string yourself and change the browser settings. The tables below describe the attributes and their values.

    • Attributes of lightspeed_info

      Attribute

      Data Type of Attribute

      Description and Possible Values

      supported

      abap_bool

      • X for supported:

        Browser is fully supported

      • X for tolerated:

        Browser is not supported by PAM, but is tolerated anyway.

      • No value for supported or tolerated:

        Browser is neither supported nor tolerated.

      tolerated

      abap_bool

      platform

      string

      Operating system

      • WINDOWS

      • X11

      • iOS

      • Java

      • unknown

      renderEngineName

      string

      Name of rendering engine

      • AppleWebKit

      • Opera

      • MSIE

      • Gecko

      • Java

      renderEngineVersion

      string

      Version of rendering engine

      loadOnDemand

      abap_bool

      • X: Javascript files of LightSpeed objects are loaded

      • No status displayed: Javascript files of LightSpeed objects are not loaded

      renderingMode

      string

      HTML rendering mode

      • QUIRKS

      • STANDARDS

      renderer

      string

      Renderer

      • sf3 (Safari)

      • ie6 (Internet Explorer)

      • ff1 (Firefox)

      LAFServiceDevice

      string

      The look and feel (LAF) service provides the URL for the themes (stylesheets and images).

      • sf3 (Safari)

      • ie6 (Internet Explorer)

      • nn7 (Firefox)

    • Attributes of user_agent_info

      Attribute

      Data Type

      Description and Possible Values

      id

      string

      Any unique ID

      browser

      string

      Browser name

      • Chrome

      • Safari

      • Firefox

      • MSIE

      version

      string

      Browser version

      platform

      string

      Operating system

      • WINDOWS

      • X11

      • IOS

      • Java

      • unknown

      mobile

      abap_bool

      • X

      • No value specified

      osName

      string

      Operating system group

      • Android

      • Windows NT

      • IOS (iPad, iPhone)

      • MacOS

      • Linux

      osVersion

      string

      Version of operating system group

      engineName

      string

      Name of rendering engine

      • AppleWebKit

      • Opera

      • MSIE

      • Gecko

      • Java

      engineVersion

      string

      Version of rendering engine

Example

For tests, component WDR_TEST_USER_AGENT_INFO is provided in the system.