主列表

# 主列表

# 开发准备

* 脚本必须使用ES5以下的语法规则编写

* 所有内容适用于主列表

# 取值

### 获取列表信息

```
dataTable.getDataTableInfo()

```

#### 输入参数：无

#### 返回内容：

| 参数 | 类型 | 含义 |
| --- | --- | --- |
| formCode | string | 表单code |
| appCode | string | 列表的appItemCode |

#### 返回数据样例：

```
{  
 formCode: 'xxx',  
 appCode: 'xxx'  
}

```

# 规则

### 隐藏主表按钮

```
dataTable.isHiddenButton(titles, hide)

```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| titles | array | 是 | 按钮名称 |
| hide | bool | 否 | 是否隐藏，默认false |

#### 返回内容：无

#### 返回数据样例：无

### 监听

### 添加按钮前置

```
dataTable.addButtonBefore(title, callback)  
```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| title | string | 是 | 按钮名称 |
| callback | function | 是 | 按钮功能实现前的回调函数 |

#### 返回内容：无

#### 样例：

```
dataTable.addButtonBefore(title, (datas, resolve) => {
  // `datas` 是列表勾选的数据
  // `resolve` 是按钮后续的动作，如果想继续执行按钮的动作就调用 `resolve()`
});
```

### 添加按钮后置

```
dataTable.addButtonAfter(title, callback)  
```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| title | string | 是 | 按钮名称 |
| callback | function | 是 | 按钮功能实现前的回调函数 |

#### 返回内容：无

#### 样例：

```
dataTable.addButtonAfter(title, resolve => {
  // `resolve` 是按钮后续的动作，如果想继续执行按钮的动作就调用 `resolve()`
});
```

# 数据处理

### 数据增加

```
dataTable.$dataHandler.addData(formCode, objectId, data, subData);

```

#### 输入参数：

| 参数 | | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| ~~datas~~ | | ~~array~~ | ~~是~~ | ~~列表数据~~ |
| formCode | | string | 是 | 表单Code |
| objectId | | string | 否 | 数据ID，guid格式。指定创建数据的数据ID，传空会默认生成一个ID |
| data | | object | 是 | 数据内容，key\-value形式。key是字段名，value是字段值 |
| subData | | array | 否 | 子表数据 |
|  | subCode | string | 是 | 子表code |
| datas | object | 是 | 子表数据，key\-value形式。key是字段名，value是字段值 |

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：

```
dataTable.$dataHandler.addData(
  "1a04ff66d02bbc01",
  "ecebf331-89ed-4135-b6cd-39715e15d222",
  {
    danxwb: "xxx",
    shuz: 12,
    riq: "2024-09-27",
    xial: 'xxx',
    xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
    fux: 'xxx,xxx',
    reny: '系统管理员',
    bum: '项目部',
    shic: 'xx分xx秒',
    jilxl: 'xxx/xxx',
    fuwb: '<h1>xxx</h1>',
    duox: 'test1,test2',
		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
    guanl: 'xxx',  //关联的值
    guanl_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215'  //key为关联字段名加_Id,值为关联数据的ObjectID
  },
  [
    {
      subCode: "1be0ad7b1e",
      datas: [
        {
          aaa: "aaa",
          shuz: 22,
          riq: "2024-09-27",
          xial: 'xxx',
          xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
          fux: 'xxx,xxx',
          reny: '系统管理员',
          bum: '项目部',
          shic: 'xx分xx秒',
          jilxl: 'xxx/xxx',
          fuwb: '<h1>xxx</h1>',
          duox: 'test1,test2',
      		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
          guanl: 'xxx',  //关联的值
          guanl_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215'  //key为关联字段名加_Id,值为关联数据的ObjectID
        },
        {
          bbb: "bbb",
          shuz: 32,
          riq: "2024-09-27",
          xial: 'xxx',
          xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
          fux: 'xxx,xxx',
          reny: '系统管理员',
          bum: '项目部',
          shic: 'xx分xx秒',
          jilxl: 'xxx/xxx',
          fuwb: '<h1>xxx</h1>',
          duox: 'test1,test2',
      		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
          guanl: 'xxx',  //关联的值
          guanl_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215'  //key为关联字段名加_Id,值为关联数据的ObjectID
        }
      ]
    },
    {
      subCode: "1ae5at7n71",
      datas: [
        {
          ccc: "ccc",
          xuhao: 1,
          shuz: 22,
          riq: "2024-09-27",
          xial: 'xxx',
          xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
          fux: 'xxx,xxx',
          reny: '系统管理员',
          bum: '项目部',
          shic: 'xx分xx秒',
          jilxl: 'xxx/xxx',
          fuwb: '<h1>xxx</h1>',
          duox: 'test1,test2',
      		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
          guanl: 'xxx',  //关联的值
          guanl_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215'  //key为关联字段名加_Id,值为关联数据的ObjectID
        },
        {
          ddd: "ddd",
          xuhao: 2,
          shuz: 22,
          riq: "2024-09-27",
          xial: 'xxx',
          xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
          fux: 'xxx,xxx',
          reny: '系统管理员',
          bum: '项目部',
          shic: 'xx分xx秒',
          jilxl: 'xxx/xxx',
          fuwb: '<h1>xxx</h1>',
          duox: 'test1,test2',
      		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
          guanl: 'xxx',  //关联的值
          guanl_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215'  //key为关联字段名加_Id,值为关联数据的ObjectID
        }
      ]
    }
  ]
).then(function(res) {
  // 新增成功
}).catch(function(error) {
  // 新增失败
});
```

### 数据删除

```
dataTable.$dataHandler.deleteData(formCode, ids); 
```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| formCode | string | 是 | 表单Code |
| ids | array | 是 | 要删除的列表数据id |

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：

```
const ids = [
  'xxx',
  'yyy'
];
dataTable.$dataHandler.deleteData(formCode, ids).then(res => {
  // 成功的回调
}).catch(error => {
  // 错误的回调
});
```

### 数据修改

```
dataTable.$dataHandler.updateData(formCode, objectId, data, subData)  
```

#### 输入参数：

| 参数 | | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| ~~dataMap~~ |  | ~~array~~ | ~~是~~ | ~~修改的所有数据~~ |
|  | ~~objectId~~ | ~~string~~ | ~~是~~ | ~~数据的Id~~ |
|  | ~~data~~ | ~~object~~ | ~~是~~ | ~~修改的数据~~ |
| formCode | | string | 是 | 表单Code |
| objectId | | string | 是 | 数据ID |
| data | | object | 是 | 数据内容，key\-value形式。key是字段名，value是字段值 |
| subData | | array | 否 | 子表数据 |
|  | subCode | string | 是 | 子表Code |
|  | datas | object | 是 | 子表数据，key\-value形式。key是字段名，value是字段值 |

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：

```
dataTable.$dataHandler.updateData(
  "1a04ff66d02bbc01",
  "ecebf331-89ed-4135-b6cd-39715e15d222",
  {
    danxwb: "xxx",
    shuz: 12,
    riq: "2024-10-08",
    xial: "xxx",
    xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
    fux: 'xxx,xxx',
    reny: '系统管理员',
    bum: '项目部',
    shic: 'xx分xx秒',
    jilxl: 'xxx/xxx',
    fuwb: '<h1>xxx</h1>',
    duox: 'test1,test2',
		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
    guanl: "xxx",
    guanl_Id: "1ad88d9d-52cb-4622-a292-c370fabac565",
  },
  [
    {
      subCode: "1be0ad7b1e",
      datas: [
      	{
        	aaa: "aaa",
        	shuz: 22,
          riq: "2024-10-08",
          xial: "xxx",
          xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
          fux: 'xxx,xxx',
          reny: '系统管理员',
          bum: '项目部',
          shic: 'xx分xx秒',
          jilxl: 'xxx/xxx',
          fuwb: '<h1>xxx</h1>',
          duox: 'test1,test2',
      		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
          guanl: "xxx",
          guanl_Id: "1ad88d9d-52cb-4622-a292-c370fabac565",
      	},
        {
        	bbb: "bbb",
        	shuz: 32,
          riq: "2024-10-08",
          xial: "xxx",
          xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
          fux: 'xxx,xxx',
          reny: '系统管理员',
          bum: '项目部',
          shic: 'xx分xx秒',
          jilxl: 'xxx/xxx',
          fuwb: '<h1>xxx</h1>',
          duox: 'test1,test2',
      		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
          guanl: "xxx",
          guanl_Id: "1ad88d9d-52cb-4622-a292-c370fabac565",
      	}
      ]
    },
    {
      subCode: "7d4g39fhr5",
      datas: [
      	{
        	ccc: "ccc",
        	xuhao: 1,
          riq: "2024-10-08",
          xial: "xxx",
          xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
          fux: 'xxx,xxx',
          reny: '系统管理员',
          bum: '项目部',
          shic: 'xx分xx秒',
          jilxl: 'xxx/xxx',
          fuwb: '<h1>xxx</h1>',
          duox: 'test1,test2',
      		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
          guanl: "xxx",
          guanl_Id: "1ad88d9d-52cb-4622-a292-c370fabac565",
      	},
        {
        	ddd: "ddd",
        	xuhao: 2,
          riq: "2024-10-08",
          xial: "xxx",
          xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
          fux: 'xxx,xxx',
          reny: '系统管理员',
          bum: '项目部',
          shic: 'xx分xx秒',
          jilxl: 'xxx/xxx',
          fuwb: '<h1>xxx</h1>',
          duox: 'test1,test2',
      		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
          guanl: "xxx",
          guanl_Id: "1ad88d9d-52cb-4622-a292-c370fabac565",
      	}
      ]
    }
  ]
).then(function(res) {
  // 更新成功
}).catch(function(error) {
  // 更新失败
});
```

### ~~数据查询~~

暂未实现

```
this.$mainTable.queryData(ids);  
```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| ids | string | 是 | 查询数据id |

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：

```

const ids = [
  'xxx',
  'yyy'
];
this.mainTable.deleteData(ids).then(res => {
  // 成功的回调
  // `res.Result` 是查询到的数据
}).catch(error => {
  // 错误的回调
});
```

# 其他

### ~~获取勾选数据~~

没有此方法

```
this.mainTable.getSelectedRowDatas()  
```

#### 请求参数：无

#### 返回内容：

| 参数 | 类型 | 含义 |
| --- | --- | --- |
| datas | array | 选中的列表数据 |

#### 样例：

```

const datas = this.mainTable.getSelectedRowDatas();  
// 数据处理  
```

### 刷新主列表

只刷新主列表不刷新页面

```
dataTable.onRefreshList()

```

#### 输入参数：无

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：

```
dataTable.onRefreshList().then(res => {
  // 成功的回调
}).catch(error => {
  // 失败的回调
})
```