Official Content

The ClientInformation external object contains a set of properties intended to provide access to the client machine information (browser or device) where the application is running.

ClientInformationexternalobject-Location_png ClientInformationStructure_png

Properties

Note: Only the AppVersionCode and AppVersionName properties apply to the Angular generator.

Id property

Returns an acceptable device identifier in most implementations.
Read more at ClientInformation.Id property.

OSName property

Returns the operating system name running on the device.

Return value VarChar(40). Returned values are: "iPad", "iPhone", "iPod" and "Android".
Parameters None

OSVersion property

Returns the version of the operating system running on the device.

Return value VarChar(40). The returned value format depends on the operating system.
Parameters None

Language property

Returns the device language.

Return value Character(20) with '<locale>,<language>' format (e.g. 'en-US,en').
Parameters None


A possible use case, for example, is to measure the number of devices accessing the application that lack language settings not provided by the application. In this way, priorities can be established to make the application international.

Note that the application will be automatically displayed in the language more appropriate for the user, depending on the device language and the languages available on the Knowledge Base. The GetLanguage function must be used to determine programmatically the language used to display the application.  

DeviceType property

Returns the Device Type.

Return value One of the possible values of the "SmartDeviceType" Enumerated Domain: Android, Apple, Web
Parameters None

PlatformName property

Returns the platform name of the device as completely as possible.

Return value VarChar(128). The platform name is composed of three device features (OS, Type, and Size). See below a table with the possible device features. 
Parameters None


Device features

OS Type Size
Android Phone  
Tablet 7''
10''
Apple iPad  
iPhone  

PlatformName property value sample: Android Tablet 10"

AppVersionCode property

Returns the version number of the application set in the Android Version Code property, Apple Version Code property, or Web Frontend Version Code property (according to your platform).

&AppVersionCode = ClientInformation.AppVersionCode

AppVersionName property

Returns the version name of the application set in the Android Version Name property, Apple Version Name property, or Web Frontend Version Name property (according to your platform).

&AppVersionName = ClientInformation.AppVersionName

ApplicationId property

Returns the application identifier. This is the package name in the case of Android applications and the bundle identifier in the case of Apple applications.

Note: This property is available since GeneXus 16 upgrade 7.

Methods

It does not have any.

Events

It does not have any.

Scope

Generators: Android, Apple, Angular

Last update: April 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant