Filtering expressions

Filtering expressions

Overview

OrangeML introduces four tags to filter some part of an OrangeML pages : <if>, <choose>, <when> and <otherwise>. These tags use filtering expression that must use the following syntax:

property = 'string_value'
or 
property != 'string_value'
or 
property = integer_value
or 
property != integer_value
or 
property &lt; integer_value
or 
property &lt;= integer_value
or 
property &gt; integer_value
or 
property &gt;= integer_value
or 
property contains 'string_value'
or 
property not-contains 'string_value'

It is possible to test several properties in a single expression using the “or” logical operator like this:

property1 = 'value1' or property2 != 'value2' or property3 = 'value3'

The current version of the platform supports only the OR logical operator. However, it's possible to find workaround for NOT by using the appropriate comparaison and for AND by nesting <if> and/or <choose>, as follows:

<if test="property1 = 'value1'">
 <if test="property2 = 'value2'">
  This content is displayed only if (property='value1') and (property2 = 'value2')
 </if>
</if>

The name of the properties more or less follow the CCPP syntax used in UAProf.

Three UAProf components are considered

HardwarePlatform contains attributes that describe the hardware characteristics of the terminal, including type of device, display size, etc.
SoftwarePlatform identifies the operating environment of the device.
NetworkCharacteristics describes network infrastructure such as bearer information.

When a property is specific to OrangeML, the name of its component is prefixed with Orange (e.g. HardwarePlatform becomes OrangeHardwarePlatform)

Important: These expressions are case sensitive.

Important: Don't forget the quote (') for the string values

HardwarePlatform

Property name	Description	Possible values
CCPP/OrangeHardwarePlatform/CustomerValueProposition	The Customer Value Proposition¹⁾ associated to the device by Orange	fun_communities, quality_communicator, ultimate_entertainment, ultimate_productivity, ultimate_simplicity
CCPP/OrangeHardwarePlatform/DeviceCategory	The device category as a numeric value, as follows: 0: WML device 1: small XHTML device (i.e. < 176px) 2: medium XHTML device (i.e. < 240px or not EDGE and not 3G or no DOML support) 3: high-end XHTML device (i.e. >= 240px, 3G/Edge, DOML support) 4: touchscreen device 5: IPhone-like device	0,1,2,3,4 or 5
CCPP/OrangeHardwarePlatform/GalleryEnabled	Yes if the device is in the gallery pool, no otherwise	yes, no
CCPP/OrangeHardwarePlatform/ScreenCapability	This filtering property is now deprecated. It's still supported, but you should use DeviceCategory instead.	1,2,3,4 or 5
CCPP/OrangeHardwarePlatform/UsableWidth	The usable width of the screen in pixels (i.e. the total width of the screen, minus the width of the vertical scrollbar, if any)	Any positive integer
CCPP/OrangeHardwarePlatform/UsableWidthChar	The usable width of the screen in chars (i.e. the total width of the screen, minus the width of the vertical scrollbar, if any).	Any positive integer
CCPP/OrangeHardwarePlatform/SmartEnabled	Yes if the device is in the OFR “Smart” pool, no otherwise	yes, no

NetworkCharacteristics

Property name	Description	Possible values
CCPP/NetworkCharacteristics/CurrentBearerService	The current bearer	GPRS, CSD, UMTS²⁾
CCPP/OrangeNetworkCharacteristics/CurrentPortalVersion	The current version of the portal	SmartphoneOI, SmartphoneVideo, SmartphoneNonVideo
CCPP/OrangeNetworkCharacteristics/HROptionEnabled	Yes if the user has subscribed the bearer is HSDPA no otherwise	yes, no

SoftwarePlatform

Audio capabilities

Property name	Description	Possible values
CCPP/OrangeSoftwarePlatform/AudioEnabled	Yes if the device support audio, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/AudioDownloadEnabled	Yes if the device support audio download, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/AudioStreamingEnabled	Yes if the device support audio streaming, no otherwise	yes, no

Video capabilities

Property name	Description	Possible values
CCPP/OrangeSoftwarePlatform/VideoEnabled	Yes if the device support video, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/VideoDownloadEnabled	Yes if the device support download, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/VideoForwardLockingEnabled	Yes if the device support forward locking, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/VideoProgressiveEnabled	Yes if the device support progressive download, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/VideoStreamingEnabled	Yes if the device support streaming, no otherwise	yes, no

DOML capabilities

Property name	Description	Possible values
CCPP/OrangeSoftwarePlatform/DOMLEmbeddedVideoEnabled	Yes if the device supports embedded video, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/DOMLCarouselEnabled	Yes if the device supports carousels, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/DOMLDropDownEnabled	Yes if the device supports dropdown <div> and <block>, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/DOMLSectionTabsEnabled	Yes if the device supports tabs <block>, no otherwise	yes, no

Other capabilities

Property name	Description	Possible values
CCPP/SoftwarePlatform/JavaPlatform	The list of Java technologies supported by the device. This is a “bag” type property that supports only the “contains” and “not-contains” operator. Unfortunatly this property is not properly maintained currently and cannot be used…	'MIDP', 'EGE', etc.
CCPP/OrangeSoftwarePlatform/DTMFInMakeCallEnabled	Yes if the device supports "make call" facility (whatever the protocol used) and if DTMF are supported in a communication initialized by this “make call”, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/EmbeddedApplications	The list of applications that are embedded in the device. This is a “bag” type property that only supports the “contains” and “not-contains” operator. If an application is contained in EmbeddedApplications, it's obviously included in SupportedApplication (cf. below)	'NAVGPS', 'FLASHCODE', 'MCAST', 'ACCESDIRECT', 'OWL', 'PVPLAYER', 'ORANGEPHOTO'
CCPP/OrangeSoftwarePlatform/FileUploadEnabled	Yes if the device supports file upload, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/HRCapabilityEnabled	Yes if the device supports “High Resolution” (i.e. HSDPA), no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/MakeCallEnabled	Yes if the device supports "make call" facility (whatever the protocol used), no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/MailtoEnabled	Yes if the device supports "mailto" facility, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/RingtonePolyEnabled	Yes if the device supports polyphonic ring-tones, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/RingtoneHifiEnabled	Yes if the device supports HiFi ring-tones, no otherwise	yes, no
CCPP/OrangeSoftwarePlatform/SupportedApplications	The list of applications that are supported by the device. This is a “bag” type property that supports only the “contains” and “not-contains” operator.	'NAVGPS', 'FLASHCODE', 'MCAST', 'ACCESDIRECT', 'OWL', 'PVPLAYER', 'ORANGEPHOTO'
CCPP/OrangeSoftwarePlatform/SupportedServices	The list of Orange portal services that are supported by the device. This is a “bag” type property that supports only the “contains” and “not-contains” operator.	'Actu', 'Sport'

¹⁾ The Customer Value Proposition (or CVP) is the Orange marketing segmentation of the devices based on the (supposed) main usage of the device.

²⁾ The 'UMTS' value means that the bearer is UMTS or EDGE

See also