Namespace: Consultingwerk.Framework.ExpressionParser
Class 
RuleExpressionHelper Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.Framework.ExpressionParser.RuleExpressionHelper

Inherits: Progress.Lang.Object


Navigate to: Methods | Constructors | Events | Properties | ProDatasets | Temp-Tables



Top Method Summary
Options Name Purpose
CHARACTER AblValueToLiteral (character, character) Converts a CHARACTER value into an ABL expression literal based on the data type of the source field
CHARACTER GetDateLiteral (date) Returns a DATE value as an ABL expression literal
CHARACTER GetDateTimeLiteral (datetime) Returns a DATETIME value as an ABL expression literal
CHARACTER GetDateTimeTzLiteral (datetime-tz) Returns a DATETIME-TZ value as an ABL expression literal
CHARACTER GetDecimalLiteral (decimal) Returns a DECIMAL value as an ABL expression literal
CHARACTER GetTokenNames (character) Returns the names of the tokens used in a rule expression
CHARACTER GetUnknownLiteral (character) Returns the unknown value of a data type as an ABL expression literal


Method Detail
Top

CHARACTER AblValueToLiteral (character, character)
Purpose: Converts a CHARACTER value into an ABL expression literal based on
the data type of the source field
Notes: The value is expected in the format of the STRING function in the
current session (as returned by GetFieldValues of the
SmartDataAdapter). LOGICAL, INTEGER and INT64 values are returned
as is, DATE, DATETIME, DATETIME-TZ and DECIMAL values are converted
into literals that do not depend on the session date and numeric
format (SCL-6186), all other values are quoted. The unknown value
is returned as the typed unknown literal of the data type
(SCL-6247, see GetUnknownLiteral)

Parameters:
pcValue CHARACTER
The CHARACTER representation of the value
pcDataType CHARACTER
The ABL data type of the source field
Returns CHARACTER
The ABL expression literal for the value
Top

CHARACTER GetDateLiteral (date)
Purpose: Returns a DATE value as an ABL expression literal
Notes: Returns a DATE function call with month, day and year, e.g.
date (12, 31, 2026), which does not depend on the session date
format. The unknown value is returned as the typed unknown DATE
literal (SCL-6247)

Parameters:
pdaValue DATE
The DATE value
Returns CHARACTER
The ABL expression literal for the value
Top

CHARACTER GetDateTimeLiteral (datetime)
Purpose: Returns a DATETIME value as an ABL expression literal
Notes: Returns a DATETIME function call with the date and the time in
milliseconds after midnight, e.g. datetime (date (12, 31, 2026), 36307123),
which does not depend on the session date format. The unknown
value is returned as the typed unknown DATETIME literal (SCL-6247)

Parameters:
pdtValue DATETIME
The DATETIME value
Returns CHARACTER
The ABL expression literal for the value
Top

CHARACTER GetDateTimeTzLiteral (datetime-tz)
Purpose: Returns a DATETIME-TZ value as an ABL expression literal
Notes: Returns a DATETIME-TZ function call with the date, the time in
milliseconds after midnight and the time zone offset in minutes,
e.g. datetime-tz (date (12, 31, 2026), 36307123, 60), which does not
depend on the session date format. The unknown value is returned
as the typed unknown DATETIME-TZ literal (SCL-6247)

Parameters:
pdtzValue DATETIME-TZ
The DATETIME-TZ value
Returns CHARACTER
The ABL expression literal for the value
Top

CHARACTER GetDecimalLiteral (decimal)
Purpose: Returns a DECIMAL value as an ABL expression literal
Notes: The literal uses the period as the decimal point and no group
separator, independent of the session numeric format. The unknown
value is returned as the typed unknown DECIMAL literal (SCL-6247)

Parameters:
pdeValue DECIMAL
The DECIMAL value
Returns CHARACTER
The ABL expression literal for the value
Top

CHARACTER GetTokenNames (character)
Purpose: Returns the names of the tokens used in a rule expression
Notes: Token names are returned as a comma delimited list of distinct
names in the order of their first occurrence. The name of a token
with an argument (e.g. ${instance.member}) is returned as
"instance.member", the name of a token without an argument
(e.g. ${member}) as "member"

Parameters:
pcExpression CHARACTER
The rule expression to parse
Returns CHARACTER
The comma delimited list of distinct token names
Top

CHARACTER GetUnknownLiteral (character)
Purpose: Returns the unknown value of a data type as an ABL expression
literal
Notes: SCL-6247. A bare ? literal has no data type: in the expression
evaluated by the AblExpressionEvaluator, ? = ?, true or ?,
false and ? and not ? raise "Incompatible data types in
expression or assignment. (223)". The typed unknown literal is an
inline conditional whose THEN branch only provides the data type,
e.g. (if false then today else ?) for a DATE value, so the unknown
value behaves as in compiled ABL (? = ? is true, true or ? is true,
comparisons and functions with ? return ?). DATETIME uses
datetime (today), as NOW returns a DATETIME-TZ value. CLOB and
LONGCHAR are typed as CHARACTER. For an empty or other data type
the bare ? literal is returned, as the type is not known

Parameters:
pcDataType CHARACTER
The ABL data type of the value
Returns CHARACTER
The typed unknown literal


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       09.11.2026 08:04:42