User Guide: SDKs > VoltMX Iris SDK > Invoking an Object Service > Data Transfer Objects > voltmx.sdk.dto.DataObject Class
voltmx.sdk.dto.DataObject Class
This class represents a data object in the Object Service. An instantiation of this class is required as a parameter in many methods of the OnlineObjectService Class and the OfflineObjectService Class.
Constructors
The voltmx.sdk.dto.DataObject class has one constructor.
voltmx.sdk.dto.DataObject(string objectName)
| Parameter | Type | Description |
|---|---|---|
| objectName | string | Name of object defined in the object service |
Methods
The voltmx.sdk.dto.DataObject class includes the following methods.
- addChildDataObject(child)
- addField(fieldName, value)
- setOdataUrl(URL)
- setRecord(record)
- setSelectQueryObject(queryObject)
addChildDataObject(child) Method
Adds another DataObject as a child.
Signature
addChildDataObject(child)
Parameters
| Parameter | Type | Description |
|---|---|---|
| child | voltmx.sdk.dto.DataObject | The DataObject to be added as a child |
addField(fieldName, value) Method
Adds a field in the data object.
Signature
addField(fieldName, value)
Parameters
| Parameter | Type | Description |
|---|---|---|
| fieldName | string | The name of the field being added. |
| value | string | The value of the added field |
setOdataUrl(URL) Method
Specifies the Odata URL.
Signature
setOdataUrl(URL)
Parameters
| Parameter | Type | Description |
|---|---|---|
| URL | string | The Odata URL to set. |
setRecord(record) Method
Specifies a record in the data object.
Signature
setRecord(record)
Parameters
| Parameter | Type | Description |
|---|---|---|
| record | JSON object | The record to be set. |
setSelectQueryObject(queryObject) Method
Sets the specific query object to be used in the query.
Signature
setSelectQueryObject(queryObject)
Parameters
| Parameter | Type | Description |
|---|---|---|
| queryObject | voltmx.sdk.dto.SelectQuery | The object that contains the query. |
Example
// **Simple Object**
var dataObject = new voltmx.sdk.dto.DataObject("ObjectName");
var record = {};
record["field1"] = "value1";
record["field2"] = "value2";
record["field3"] = "value3"; //sets the record to the dataObject
dataObject.setRecord(record);
// **Complex Object*
var parentDataObject = new voltmx.sdk.dto.DataObject("parentObject");
var record = {};
record["field1"] = "value1";
record["field2"] = "value2";
record["field3"] = "value3";
//sets the record to the parent.
parentDataObject.setRecord(record);
var childDataObject = new voltmx.sdk.dto.DataObject("childObject");
var record = {};
record["field4"] = "value3";
record["field5"] = "value5";
record["field6"] = "value6"; //sets the record to the child
childDataObject.setRecord(record);
parentDataObject.addChildDataObject(childDataObject); // **Adding OdataUrl**
var dataObject = new voltmx.sdk.dto.DataObject("objectName");
dataObject.setOdataUrl("$filter=fieldname eq value");