Home > Class Reference > ENSLIB namespace > %ZEN.Auxiliary.dataSet

%ZEN.Auxiliary.dataSet

class %ZEN.Auxiliary.dataSet extends %ZEN.Component.object

This class provides a way to assemble data that can be conveniently passed between the web client and the server. A dataSet object can contain 0-dimensional (scalar) data, 1-dimensional (list), 2-dimensional, or 3-dimensional data, as specified by its dimensions property.

Property Inventory (Including Private)

Method Inventory (Including Private)

Properties (Including Private)

property %data as %ZEN.Datatype.string (XMLPROJECTION = "NONE") [ Private , MultiDimensional ];
Array of data values within the dataSet.
Property methods: %dataDisplayToLogical(), %dataGet(), %dataIsValid(), %dataLogicalToDisplay(), %dataLogicalToOdbc(), %dataNormalize(), %dataSet()
property %labels as %ZEN.Datatype.string (XMLPROJECTION = "NONE") [ Private , MultiDimensional ];
Set of captions used as labels along the various dimensions of the dataSet.
The array of labels is indexed by dimension number and position within the dimension.
Property methods: %labelsDisplayToLogical(), %labelsGet(), %labelsIsValid(), %labelsLogicalToDisplay(), %labelsLogicalToOdbc(), %labelsNormalize(), %labelsSet()
property %size as %ZEN.Datatype.integer (MINVAL = 1, XMLPROJECTION = "NONE") [ Private , MultiDimensional ];
Size, indexed by dimension number, of each dimension.
Property methods: %sizeDisplayToLogical(), %sizeGet(), %sizeIsValid(), %sizeLogicalToDisplay(), %sizeLogicalToOdbc(), %sizeNormalize(), %sizeSet()
property clientData as %ZEN.Datatype.list (XMLPROJECTION = "NONE", ZENSETTING = 0);
Array of serialized data values going to and coming from the client.
Property methods: clientDataDisplayToLogical(), clientDataGet(), clientDataIsValid(), clientDataLogicalToDisplay(), clientDataLogicalToOdbc(), clientDataNormalize(), clientDataSet()
property clientLabels as %ZEN.Datatype.list (XMLPROJECTION = "NONE", ZENSETTING = 0);
Array of serialized label values going to and coming from the client.
Property methods: clientLabelsDisplayToLogical(), clientLabelsGet(), clientLabelsIsValid(), clientLabelsLogicalToDisplay(), clientLabelsLogicalToOdbc(), clientLabelsNormalize(), clientLabelsSet()
property clientSize as %ZEN.Datatype.list (XMLPROJECTION = "NONE", ZENSETTING = 0);
Array of serialized dimension size values going to and coming from the client.
Property methods: clientSizeDisplayToLogical(), clientSizeGet(), clientSizeIsValid(), clientSizeLogicalToDisplay(), clientSizeLogicalToOdbc(), clientSizeNormalize(), clientSizeSet()
property dimensions as %ZEN.Datatype.integer (MAXVAL = 3, MINVAL = 0, XMLPROJECTION = "NONE") [ InitialExpression = 0 ];
Number of dimensions within the dataSet.
Property methods: dimensionsDisplayToLogical(), dimensionsGet(), dimensionsIsValid(), dimensionsLogicalToDisplay(), dimensionsLogicalToOdbc(), dimensionsNormalize(), dimensionsSet()

Methods (Including Private)

method %Clear()
Delete data currently in the dataSet.
method %GetArray(Output pArray)
Copy the contents of this dataSet into a local array.
method %GetDimSize(dim As %Integer = 1) as %Integer
Return current size of a dimension.
method %GetDimensions() as %Integer
Get the number of dimensions within the dataSet.
method %GetLabel(n As %Integer = 1, dim As %Integer = 1) as %String
Get the value of a label at position n in dimension dim within the dataSet.
method %GetValue(d1 As %Integer = 1, d2 As %Integer = 1, d3 As %Integer = 1) as %String
Get the value of a cell within the dataSet.
method %OnDrawObjectProperties() as %Status
Called just before we serve property values to the client.
private method %OnNew(initvalue As %CacheString) as %Status
Inherited description: Constructor for Zen objects.
If subclasses override %OnNew, they should make sure to invoke this using #super.
method %OnObjectSynch() as %Status
Make sure client data is prepared.
method %OnZENDeserialize() as %Status
Deserialize additional values from the client.
method %Print()
Print out contents of this dataSet to the current device.
method %SerializeData(pDelim As %String = $C(5)) as %Status
Convert internal arrays to a serialized strings for use on the client.
method %SetArray(ByRef pArray, s1 As %Integer = 1, s2 As %Integer = 1, s3 As %Integer = 1)
Set the contents of this dataSet from a local array. The local array must have the same dimensionality as the dataSet and must have the correct number and type of subscripts.
The caller is also responsible for supplying the sizes of each dimension.
method %SetDimensions(dims As %Integer)
Set the number of dimensions within the dataSet. Changing the number of dimensions deletes the contents of the dataSet.
method %