Namespace: Consultingwerk.CommonUi
Class 
UnboundValues Copy to Clipboard
Parent classes:
Progress.Lang.Object
Consultingwerk.Framework.Base.GenericDictionary
Consultingwerk.CommonUi.UnboundValues

Inherits: Consultingwerk.Framework.Base.GenericDictionary
Implements: Consultingwerk.Framework.Base.IArrayList, Consultingwerk.Framework.Base.IEnumerable, Consultingwerk.Framework.Base.ISupportsListChanged, Consultingwerk.Framework.Base.ISupportsListHash


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



Top Method Summary
Options Name Purpose
Consultingwerk.IPrimitiveHolder Add (character, IPrimitiveHolder) Adds an item to the generic Dictionary
AddHolderToJsonObject (JsonObject, character, IPrimitiveHolder) Adds a single holder value to the JsonObject
Consultingwerk.IPrimitiveHolder AddWhenNotContained (character, IPrimitiveHolder) Adds an item to the generic Dictionary
CHARACTER BuildKey (character, character) Returns the dictionary key for a field of a container
LOGICAL ContainsValue (character) Returns whether the dictionary holds a value for the given key
Consultingwerk.CommonUi.UnboundValues FromJsonObject (JsonObject) Returns an UnboundValues dictionary populated from a JsonObject
CHARACTER GetCharacterValue (character) Returns the value for the given key as a CHARACTER value
DATETIME-TZ GetDateTimeTzValue (character) Returns the value for the given key as a DATETIME-TZ value
DATETIME GetDateTimeValue (character) Returns the value for the given key as a DATETIME value
DATE GetDateValue (character) Returns the value for the given key as a DATE value
DECIMAL GetDecimalValue (character) Returns the value for the given key as a DECIMAL value
Consultingwerk.IPrimitiveHolder GetHolder (character) Returns the holder for the given key
INT64 GetInt64Value (character) Returns the value for the given key as an INT64 value
INTEGER GetIntegerValue (character) Returns the value for the given key as an INTEGER value
Consultingwerk.IPrimitiveHolder GetItem (character) Retrieves an item from the generic Dictionary
Consultingwerk.IPrimitiveHolder GetItemOrNull (character) Retrieves an item from the generic Dictionary
LOGICAL GetLogicalValue (character) Returns the value for the given key as a LOGICAL value
DATE ParseIsoDate (character) Returns the DATE value of an ISO 8601 date or date/time string
INTEGER ParseIsoMTime (character) Returns the time of day of an ISO 8601 date/time string in milliseconds
CHARACTER ResolveKey (character) Returns the key of the dictionary matching the given key
Consultingwerk.IPrimitiveHolder SetValue (character, character) Stores a CHARACTER value for the given key
Consultingwerk.IPrimitiveHolder SetValue (character, date) Stores a DATE value for the given key
Consultingwerk.IPrimitiveHolder SetValue (character, datetime) Stores a DATETIME value for the given key
Consultingwerk.IPrimitiveHolder SetValue (character, datetime-tz) Stores a DATETIME-TZ value for the given key
Consultingwerk.IPrimitiveHolder SetValue (character, decimal) Stores a DECIMAL value for the given key
Consultingwerk.IPrimitiveHolder SetValue (character, int64) Stores an INT64 value for the given key
Consultingwerk.IPrimitiveHolder SetValue (character, integer) Stores an INTEGER value for the given key
Consultingwerk.IPrimitiveHolder SetValue (character, IPrimitiveHolder) Stores a value for the given key
Consultingwerk.IPrimitiveHolder SetValue (character, logical) Stores a LOGICAL value for the given key
Progress.Json.ObjectModel.JsonObject ToJsonObject () Returns the dictionary as a JsonObject

Top Constructor Summary
Options Name Purpose
UnboundValues () Constructor for the UnboundValues class

Top Property Summary
Options Name Purpose
CHARACTER KeySeparator


Method Detail
Top

Consultingwerk.IPrimitiveHolder Add (character, IPrimitiveHolder)
Purpose: Adds an item to the generic Dictionary
Notes:

Parameters:
pcKey CHARACTER
The key value
poItem Consultingwerk.IPrimitiveHolder
And item of the Lists member type
Returns Consultingwerk.IPrimitiveHolder
The item that was added to the List
Top

AddHolderToJsonObject (JsonObject, character, IPrimitiveHolder)
Purpose: Adds a single holder value to the JsonObject
Notes: Emits the JSON type matching the holder type, the unknown value
is emitted as a JSON null

Parameters:
poJson Progress.Json.ObjectModel.JsonObject
The JsonObject to add the value to
pcKey CHARACTER
The name of the JSON property
poHolder Consultingwerk.IPrimitiveHolder
The holder carrying the value
Top

Consultingwerk.IPrimitiveHolder AddWhenNotContained (character, IPrimitiveHolder)
Purpose: Adds an item to the generic Dictionary
Notes:

Parameters:
pcKey CHARACTER
The key value
poItem Consultingwerk.IPrimitiveHolder
And item of the Lists member type
Returns Consultingwerk.IPrimitiveHolder
The item that was added to the List
Top

CHARACTER BuildKey (character, character)
Purpose: Returns the dictionary key for a field of a container
Notes: When the container name is unknown or empty, the plain field
name is returned

Parameters:
pcContainerName CHARACTER
The name of the container (e.g. the viewer) hosting the field
pcFieldName CHARACTER
The name of the field
Returns CHARACTER
The dictionary key
Top

LOGICAL ContainsValue (character)
Purpose: Returns whether the dictionary holds a value for the given key
Notes: Unlike ContainsKey this method also resolves an unqualified key

Parameters:
pcKey CHARACTER
The key of the value
Returns LOGICAL
Logical value indicating if a value for the key is present
Top

Consultingwerk.CommonUi.UnboundValues FromJsonObject (JsonObject)
Purpose: Returns an UnboundValues dictionary populated from a JsonObject
Notes: The holder type is derived from the JSON type of the value:
a JSON string becomes a CharacterHolder, a boolean a
LogicalHolder and a number an IntegerHolder or DecimalHolder.
A JSON null becomes a CharacterHolder holding the unknown value,
which allows a frontend to explicitly clear a field. Nested
objects and arrays are not supported and are skipped.

Parameters:
poJson Progress.Json.ObjectModel.JsonObject
The JsonObject to read the values from
Returns Consultingwerk.CommonUi.UnboundValues
The UnboundValues dictionary
Top

CHARACTER GetCharacterValue (character)
Purpose: Returns the value for the given key as a CHARACTER value
Notes: Returns the unknown value when no entry matches the key

Parameters:
pcKey CHARACTER
The key of the value
Returns CHARACTER
The CHARACTER value
Top

DATETIME-TZ GetDateTimeTzValue (character)
Purpose: Returns the value for the given key as a DATETIME-TZ value
Notes: Returns the unknown value when no entry matches the key or the
value can not be converted

Parameters:
pcKey CHARACTER
The key of the value
Returns DATETIME-TZ
The DATETIME-TZ value
Top

DATETIME GetDateTimeValue (character)
Purpose: Returns the value for the given key as a DATETIME value
Notes: Returns the unknown value when no entry matches the key or the
value can not be converted

Parameters:
pcKey CHARACTER
The key of the value
Returns DATETIME
The DATETIME value
Top

DATE GetDateValue (character)
Purpose: Returns the value for the given key as a DATE value
Notes: Returns the unknown value when no entry matches the key or the
value can not be converted

Parameters:
pcKey CHARACTER
The key of the value
Returns DATE
The DATE value
Top

DECIMAL GetDecimalValue (character)
Purpose: Returns the value for the given key as a DECIMAL value
Notes: Returns the unknown value when no entry matches the key or the
value can not be converted

Parameters:
pcKey CHARACTER
The key of the value
Returns DECIMAL
The DECIMAL value
Top

Consultingwerk.IPrimitiveHolder GetHolder (character)
Purpose: Returns the holder for the given key
Notes: Resolves unqualified keys, returns the unknown value when no
entry matches

Parameters:
pcKey CHARACTER
The key of the value
Returns Consultingwerk.IPrimitiveHolder
The IPrimitiveHolder or the unknown value
Top

INT64 GetInt64Value (character)
Purpose: Returns the value for the given key as an INT64 value
Notes: Returns the unknown value when no entry matches the key or the
value can not be converted

Parameters:
pcKey CHARACTER
The key of the value
Returns INT64
The INT64 value
Top

INTEGER GetIntegerValue (character)
Purpose: Returns the value for the given key as an INTEGER value
Notes: Returns the unknown value when no entry matches the key or the
value can not be converted

Parameters:
pcKey CHARACTER
The key of the value
Returns INTEGER
The INTEGER value
Top

Consultingwerk.IPrimitiveHolder GetItem (character)
Purpose: Retrieves an item from the generic Dictionary
Notes: CAST's the element from the underlying Progress.Lang.Object

Parameters:
pcKey CHARACTER
The key of the item to retrieve
Returns Consultingwerk.IPrimitiveHolder
The item of the Lists member type
Top

Consultingwerk.IPrimitiveHolder GetItemOrNull (character)
Purpose: Retrieves an item from the generic Dictionary
Notes: CAST's the element from the underlying Progress.Lang.Object
This method does not fail when the key is not valid

Parameters:
pcKey CHARACTER
The key of the item to retrieve
Returns Consultingwerk.IPrimitiveHolder
The item of the Lists member type
Top

LOGICAL GetLogicalValue (character)
Purpose: Returns the value for the given key as a LOGICAL value
Notes: Returns the unknown value when no entry matches the key or the
value can not be converted

Parameters:
pcKey CHARACTER
The key of the value
Returns LOGICAL
The LOGICAL value
Top

DATE ParseIsoDate (character)
Purpose: Returns the DATE value of an ISO 8601 date or date/time string
Notes: Returns the unknown value when the value is not in the ISO 8601
representation, so that the caller can fall back to the session
date format

Parameters:
pcValue CHARACTER
The value to parse
Returns DATE
The DATE value or the unknown value
Top

INTEGER ParseIsoMTime (character)
Purpose: Returns the time of day of an ISO 8601 date/time string in
milliseconds
Notes: Returns 0 when the value carries no time portion

Parameters:
pcValue CHARACTER
The value to parse
Returns INTEGER
The time of day in milliseconds
Top

CHARACTER ResolveKey (character)
Purpose: Returns the key of the dictionary matching the given key
Notes: Returns the key itself when the dictionary contains it. An
unqualified key (a key without the container name) matches the
key whose field name part is equal, but only when that field
name is unique across the containers - an ambiguous field name
resolves to the unknown value rather than to an arbitrary one of
the candidates. Returns the unknown value when no entry matches.

Parameters:
pcKey CHARACTER
The key to resolve
Returns CHARACTER
The key of the matching dictionary entry or the unknown value
Top

Consultingwerk.IPrimitiveHolder SetValue (character, character)
Purpose: Stores a CHARACTER value for the given key
Notes:

Parameters:
pcKey CHARACTER
The key of the value
pcValue CHARACTER
The value to store
Returns Consultingwerk.IPrimitiveHolder
The holder that was stored
Top

Consultingwerk.IPrimitiveHolder SetValue (character, date)
Purpose: Stores a DATE value for the given key
Notes:

Parameters:
pcKey CHARACTER
The key of the value
pdaValue DATE
The value to store
Returns Consultingwerk.IPrimitiveHolder
The holder that was stored
Top

Consultingwerk.IPrimitiveHolder SetValue (character, datetime)
Purpose: Stores a DATETIME value for the given key
Notes:

Parameters:
pcKey CHARACTER
The key of the value
pdtValue DATETIME
The value to store
Returns Consultingwerk.IPrimitiveHolder
The holder that was stored
Top

Consultingwerk.IPrimitiveHolder SetValue (character, datetime-tz)
Purpose: Stores a DATETIME-TZ value for the given key
Notes:

Parameters:
pcKey CHARACTER
The key of the value
pdtzValue DATETIME-TZ
The value to store
Returns Consultingwerk.IPrimitiveHolder
The holder that was stored
Top

Consultingwerk.IPrimitiveHolder SetValue (character, decimal)
Purpose: Stores a DECIMAL value for the given key
Notes:

Parameters:
pcKey CHARACTER
The key of the value
pdeValue DECIMAL
The value to store
Returns Consultingwerk.IPrimitiveHolder
The holder that was stored
Top

Consultingwerk.IPrimitiveHolder SetValue (character, int64)
Purpose: Stores an INT64 value for the given key
Notes:

Parameters:
pcKey CHARACTER
The key of the value
piValue INT64
The value to store
Returns Consultingwerk.IPrimitiveHolder
The holder that was stored
Top

Consultingwerk.IPrimitiveHolder SetValue (character, integer)
Purpose: Stores an INTEGER value for the given key
Notes:

Parameters:
pcKey CHARACTER
The key of the value
piValue INTEGER
The value to store
Returns Consultingwerk.IPrimitiveHolder
The holder that was stored
Top

Consultingwerk.IPrimitiveHolder SetValue (character, IPrimitiveHolder)
Purpose: Stores a value for the given key
Notes: Replaces the value when the key is already present

Parameters:
pcKey CHARACTER
The key of the value
poValue Consultingwerk.IPrimitiveHolder
The value to store
Returns Consultingwerk.IPrimitiveHolder
The value that was stored
Top

Consultingwerk.IPrimitiveHolder SetValue (character, logical)
Purpose: Stores a LOGICAL value for the given key
Notes:

Parameters:
pcKey CHARACTER
The key of the value
plValue LOGICAL
The value to store
Returns Consultingwerk.IPrimitiveHolder
The holder that was stored
Top

Progress.Json.ObjectModel.JsonObject ToJsonObject ()
Purpose: Returns the dictionary as a JsonObject
Notes: The values are emitted as plain JSON values (string, number,
boolean, null) so that a web frontend can consume them without
knowing about the ABL holder classes. Date and datetime values
are emitted in the ISO 8601 representation of the JSON parser.

Returns Progress.Json.ObjectModel.JsonObject
The JsonObject with one property per dictionary entry


Constructor Detail
Top

UnboundValues ()
Purpose: Constructor for the UnboundValues class
Notes:



Property Detail
Top

CHARACTER KeySeparator

Returns CHARACTER


©2006-2026 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       16.08.2026 16:55:41