System and Environment

Even though the EPCF provides browser abstraction and runs on any supported browser, in many cases an application needs detailed information about the client computer system and environment.

When the browser connects to the server via the HTTP protocol, the User-Agent field is contained in the HTTP Request header. To retrieve certain details, such as the operating system or the numerical version of the user agent, you need to parse this field. To avoid this, use the EPCF getUAPlatform, getUAType and getUAVersion methods that return detailed information about the operating system, browser type and major browser version in a unified format.

In many cases, an application is composed of multiple browser windows and frames. The EPCF assigns a unique identifier to any browser window. The assigned identifier remains unchanged even when the content of the window is refreshed. The EPCF also supports an ability to run the SAP Portal nested in other, non-SAP portal pages, which means you cannot rely on the top frame reference. The getSAPTop method returns the generic topmost frame reference, regardless of whether the portal is running in a separate or window or nested in another window.

For the complete API reference, see System API .