%ZEN.Auxiliary.dataBag
deprecated class %ZEN.Auxiliary.dataBag 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 dataBag object contains a set of name-value pairs. This is used internally by the MVC classes.Property Inventory
Method Inventory
- %Clear()
- %CopyFromModel()
- %CopyToModel()
- %GetArray()
- %GetLabel()
- %GetType()
- %GetValue()
- %OnDrawObjectProperties()
- %OnObjectSynch()
- %OnZENDeserialize()
- %SerializeData()
- %SetValue()
- clear()
- getDimSize()
- getPropertyCount()
- getPropertyLabel()
- getPropertyName()
- getPropertyType()
- getSeriesCount()
- getSeriesLabel()
- getValue()
- getValueByPosition()
- getValuesAsArrays()
- getValuesAsObject()
- setProperty()
- setValue()
- setValueByPosition()
Properties
property %data as %ZEN.Datatype.string (XMLPROJECTION = "NONE") [ MultiDimensional ];
Array of data values within the dataBag, indexed by series and property name.
Property methods: %dataDisplayToLogical(), %dataGet(), %dataIsValid(), %dataLogicalToDisplay(), %dataLogicalToOdbc(), %dataNormalize(), %dataSet()
property %labels as %ZEN.Datatype.string (XMLPROJECTION = "NONE") [ MultiDimensional ];
Array of labels within the dataBag, indexed by property name.
Property methods: %labelsDisplayToLogical(), %labelsGet(), %labelsIsValid(), %labelsLogicalToDisplay(), %labelsLogicalToOdbc(), %labelsNormalize(), %labelsSet()
property %types as %ZEN.Datatype.string (XMLPROJECTION = "NONE") [ MultiDimensional ];
Array of data types within the dataBag, indexed by property name.
Property methods: %typesDisplayToLogical(), %typesGet(), %typesIsValid(), %typesLogicalToDisplay(), %typesLogicalToOdbc(), %typesNormalize(), %typesSet()
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 seriesCount as %ZEN.Datatype.integer (MINVAL = 1, XMLPROJECTION = "NONE", ZENSETTING = 0) [ InitialExpression = 1 ];
Number of data series held within the dataBag.
Property methods: seriesCountDisplayToLogical(), seriesCountGet(), seriesCountIsValid(), seriesCountLogicalToDisplay(), seriesCountLogicalToOdbc(), seriesCountNormalize(), seriesCountSet()
Methods
method %Clear()
Delete data currently in the dataBag.
method %CopyFromModel(pModel As %ZEN.DataModel.DataModel) as %Status
Fill the contents of this dataBag from the given DataModel
method %CopyToModel(pModel As %ZEN.DataModel.DataModel) as %Status
Copy the contents of this dataBag into the given DataModel.
method %GetArray(Output pArray)
Copy the contents of this dataBag into a local array.
Get the label for a property within the dataBag.
Get the type of a property within the dataBag.
Get the value of a property within the dataBag.
Note that this can return a literal value, an object value (oref), or $$$ZENMISSING if the given property is not in the model.
Note that this can return a literal value, an object value (oref), or $$$ZENMISSING if the given property is not in the model.
method %OnDrawObjectProperties() as %Status
Called just before we serve property values to the client.
method %OnObjectSynch() as %Status
Make sure client data is prepared.
method %OnZENDeserialize() as %Status
Deserialize additional values from the client.
Convert internal arrays to a serialized strings for use on the client.
Set the value of a property within the dataBag.
clientmethod clear() [ Language = javascript ]
Clear contents of this dataBag.
clientmethod getDimSize(dim) [ Language = javascript ]
dataSet API
Return the number of items in the specified dimension.
(dim is 1,2, or 3). The size of the first dimension is defined by the number of properties in the dataBag.
The size of the second dimension is defined by number of data series in the dataBag. The dataBag does not support a third dimension.
(dim is 1,2, or 3). The size of the first dimension is defined by the number of properties in the dataBag.
The size of the second dimension is defined by number of data series in the dataBag. The dataBag does not support a third dimension.
clientmethod getPropertyCount() [ Language = javascript ]
Return the number of properties within this dataBag.
clientmethod getPropertyLabel(n) [ Language = javascript ]
Return the label of a property within this dataBag given its ordinal
(0-based) position.
clientmethod getPropertyName(n) [ Language = javascript ]
Return the name of a property within this dataBag given its ordinal
(0-based) position.
clientmethod getPropertyType(n) [ Language = javascript ]
Return the type code of a property within this dataBag given its ordinal
(0-based) position.
clientmethod getSeriesCount() [ Language = javascript ]
Return the number of data series within this dataBag.
clientmethod getSeriesLabel(n) [ Language = javascript ]
Return the label of a dataSeries within this dataBag given its ordinal
(0-based) position.
clientmethod getValue(property, series) [ Language = javascript ]
Return the data value associated with a given property name.
If there is no property with the name, property, return null.
clientmethod getValueByPosition(n, series) [ Language = javascript ]
Return the data value at the given ordinal position.
If n is out of range, return null.
series is 0-based.
series is 0-based.
clientmethod getValuesAsArrays() [ Language = javascript ]
This is a specialized variant of getValueByPosition() that
return the data in this bag as an array of arrays (used
by charts).
clientmethod getValuesAsObject(series) [ Language = javascript ]
Return the values in this dataBag as a zenProxy object.
If there is more than one data series, series
specifies which one to use.
Return null if there are no properties in the dataBag.
Return null if there are no properties in the dataBag.
clientmethod setProperty(property, value, value2) [ Language = javascript ]
Set the value of a named property.
clientmethod setValue(property, value, series) [ Language = javascript ]
Set the data value for the given property.
series is 0-based.
series is 0-based.
clientmethod setValueByPosition(value, n, series) [ Language = javascript ]
Set the data value at the given ordinal position.
series is 0-based.
series is 0-based.
Inherited Members
Inherited Properties
- %condition
- %import
- %includeFiles
- %page
- %resource
- aux
- composite
- id
- index
- name
- onupdate
- parent
- tuple
- visible
- window
Inherited Methods
- %AddToSaveSet()
- %Attr()
- %BindExport()
- %ClassIsLatestVersion()
- %ClassName()
- %ConstructClone()
- %DispatchClassMethod()
- %DispatchGetModified()
- %DispatchGetProperty()
- %DispatchMethod()
- %DispatchSetModified()
- %DispatchSetMultidimProperty()
- %DispatchSetProperty()
- %DrawHTML()
- %DrawJSStrings()
- %Eval()
- %EvalC()
- %Extends()
- %ForceClientRender()
- %GetEventHandlers()
- %GetParameter()
- %GetXMLName()
- %IsA()
- %IsModified()
- %MakeId()
- %New()
- %NormalizeObject()
- %ObjectModified()
- %OnAddToPageAfter()
- %OnAddToPageBefore()
- %OriginalNamespace()
- %PackageName()
- %QuoteValue()
- %QuoteValueL10N()
- %RemoveFromSaveSet()
- %Self()
- %SerializeObject()
- %SetModified()
- %ValidateObject()
- XMLDTD()
- XMLExport()
- XMLExportToStream()
- XMLExportToString()
- XMLNew()
- XMLSchema()
- XMLSchemaNamespace()
- XMLSchemaType()
- findElement()
- fireOnUpdateEvent()
- getProperty()
- getSettings()
- getType()
- invokeSuper()
- isOfType()
- makeId()
- onCreate()
- onDelete()
- onSerialize()
- onloadHandler()
- onunloadHandler()
- onupdateHandler()
- render()
- renderContents()
- renderSVG()