|
Property Name
|
Description
|
Type
|
Values
|
|
SampleFieldDataType
|
specifies the data type of a Sample Data field
|
string
|
Number
Text File |
Detail
SampleFieldDataType
Use this Property to set the data type for a specific field in the Sample Data set.
This Property is used internally for identifying the data type of each field in the Sample Data set. It has been exposed to the designer for the sole purpose of overriding the type of filtering algorithm that is employed by an associated Filter Control Component.
By default the Descriptions Field associated with The Descriptions Panel and custom-defined fields associated with Generic Text Panels are all defined as having Text data types. This means that the raw value of these fields will be filtered using the preg_match PHP function. This default behaviour may not be desirable, if for example, the Sample Data field contains a reference to an external HTML or plaintext file or your Generic Text Panel data is numeric. The following table describes the types of filtering that are available for The Descriptions Panel and Generic Text Panel Sample Data fields.
|
SampleFieldDataType="Number"
|
The filter pattern string comprises of an inclusive numeric range defined by an optional lower value and an optional upper value and has the following format: [nLower] - [nUpper]. The raw value of the associated Sample Data field is matched if it falls within this range. See example...
|
|
|
|
|
SampleFieldDataType="Text"
|
The filter pattern string should be any regular expression recognised by the preg_match PHP function. The raw value of the associated Sample Data field is searched for a match by preg_match using the end-users' input filter pattern string. Note: By default the Pollstar100 Service pre-qualifies the pattern string as being case-insensitive.
|
|
|
|
|
SampleFieldDataType="File"
|
Causes the Pollstar100 Service to interpret the associated Sample Data field value as an external file pathname. If the file exists, then its entire contents are searched for a match by preg_match using the end-users' input filter pattern string. The filter pattern string should be any regular expression recognised by the preg_match PHP function. Note: By default the Pollstar100 Service pre-qualifies the pattern string as being case-insensitive.
|
Also see this handy hint.
Scope
This Property may be defined as an attribute of the XML tag corresponding to the following Components:
The Descriptions Panel
Generic Text Panels
Related Topics
Sample Field ID
Using Generic Components To Extend the UI
