# 业务数据 - Object: data

data对象基本上是一个JSON对象，您可以用访问JSON对象的方法访问他对象的所有数据，但增加和删除数据时略有不同。

您可以在表单或流程的各个嵌入脚本中，通过this来获取当前实例的业务数据，如下：

```javascript
var data = this.data;
```

## 业务数据相关操作

### \[property]

访问或修改data对象的数据。 

data数据用于存储表单获取的数据，所有属性都是动态的，其格式和访问方式都和JSON类似。在表单脚本中使用data对象，实现了data和表单可编辑元素的双向绑定。改变data对象，会自动更新表单元素，修改表单可编辑元素，也会自动修改data对象。

#### Syntax:

{% code title="Syntax:" %}

```javascript
var value = this.data.property;  //获取名为property的数据值
this.data.property = '123';   //将property的值修改为'123'
```

{% endcode %}

#### Return:

> any : 任何数据类型。

#### Examples 1:

获取流程文档的subject值：

{% code title="获取流程文档的subject值：" %}

```javascript
var subject = this.data.subject; 
```

{% endcode %}

#### Examples 2:

获取流程文档中的数据网格的值：

如有以下数据网格：

![](http://www.o2oa.net:20020/x_portal_assemble_surface/jaxrs/file/f39a1d05-31c9-44a8-ac87-616372ba7cd5/portal/dcd8e168-2da0-4496-83ee-137dc976c7f6/content)

其数据网格设计如下(数据网格id为：datagrid)：

![](http://www.o2oa.net:20020/x_portal_assemble_surface/jaxrs/file/91e0517b-90f5-4bf9-a87b-c3852c8bc747/portal/dcd8e168-2da0-4496-83ee-137dc976c7f6/content)

使用下面的脚本：

```javascript
var data = this.data.datagrid; 
```

获取到data的值如下：

```javascript
{
    "data": [
        {
            "amountCol": { "amount": "12000" },
            "countCol": { "number": "10" },
            "nameCol": { "name": "手机" },
            "priceCol": { "price": "1200" }
        },
        {
            "amountCol": { "amount": "15000" },
            "countCol": { "number": "5" },
            "nameCol": { "name": "电脑" },
            "priceCol": { "price": "3000" }
        }
    ],
    "total": {
        "amountCol": "27000",
        "countCol": "15"
    }
}
```

获取到数据网格中的其他数据：

```javascript
//获取数据网格中的第一条数据
var data = this.data.datagrid.data[0];

//获取数据网格中的第一条数据的 nameCol 列的值
var data = this.data.datagrid.data[0].nameCol.name;

//获取数据网格中的 amountCol 列的总计值
var data = this.data.datagrid.total.amountCol; 
```

修改数据网格中的数据：

```javascript
//修改数据网格中的第一条数据的 nameCol 列的值
this.data.datagrid.data[0].nameCol.name='平板电脑'; 
```

修改后数据网格中的数据为：

![](http://www.o2oa.net:20020/x_portal_assemble_surface/jaxrs/file/65a2c334-85cf-4304-8c2f-bf858109640f/portal/dcd8e168-2da0-4496-83ee-137dc976c7f6/content)

### add

为data对象添加一个数据节点。

#### Syntax:

{% code title="Syntax:" %}

```javascript
var newData = this.data.add(key, value, overwrite);
```

{% endcode %}

#### Arguments:

```javascript
> key :　（string or number）必选，要添加的新的数据节点名称或数组索引号
> value :　（string, number, array or JsonObject）必选，新的数据节点的值
> overwrite :　（boolean）可选，如果要添加的节点已经存在，是否覆盖。默认为 false
```

#### Return:

```
> any :　新添加的数据节点或原有的同名节点。
```

#### Examples:

```javascript
//为data添加一个名为"remark"值为"I am remark"的数据
this.data.add("remark", "I am remark");
//-------------------------------------------------------------------

//为data添加一个名为"person"的Object对象数据
var person = this.data.add("person", {});
person.add("name", "Tom");
person.add("age", 23);

//或者可以这样
var person = this.data.add("person", {name: "Tom", "age": "23"});
//-------------------------------------------------------------------

//为data添加一个名为"orders"的数组对象数据
var orders = this.data.add("orders", []);
orders.add({name: "phone", count: 5});
orders.add({name: "computer", count: 10});
orders[0].add("count", 10, true);  //将第一条数据的count修改为10

//或者可以这样
var orders = this.data.add("orders", [
    {name: "phone", count: 5},
    {name: "computer", count: 10}
]);

//将第一条数据修改为name为mobile; count为10
orders.add(0, {name: "mobile", count: 10}, true);
```

### del

删除data对象中一个指定的数据节点。

#### Syntax:

```javascript
var data = this.data.del(key);
```

#### Arguments:

```javascript
> key :　（string or number）必选，要删除的数据节点名称或数组索引号
```

#### Return:

```javascript
> data :　被删除数据节点的父节点
```

#### Examples:

```javascript
//删除data下名为"remark"的数据节点
this.data.del("remark");
//-------------------------------------------------------------------

//删除"person"的age数据节点
var person = this.data.add.person.del("age");
//-------------------------------------------------------------------

//删除"orders"数组对象中的第二条数据
this.data.orders.del(1);
```

### save

保存data对象

#### Syntax:

```javascript
this.data.save(callback);
```

#### Arguments:

```javascript
> callback :　（function）可选，保存成功后的回调函数
```

#### Return:

```
没有返回值
```

#### Examples:

```javascript
this.data.save(function(json){
    this.form.notice("save success!", "success")
});
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://o2oa.gitbook.io/course/liu-cheng-guan-li/qian-duan-kai-fa-api/ye-wu-shu-ju-object-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.