1. 使用场景

在用户方收集了一批用户信息表，填写表单后，希望可以直观的对数据进行管理，以往我们可以使用创建数据管理页来实现，然而数据管理页会稍微有一些局限性，不能直接对数据进行修改新增等操作，那么这时，我们可以使用自定义页面中的表格组件来实现，将数据进行展示后，可以对其操作列进行编辑，从而实现增删改查的效果

2. 实现功能

2.1 调用接口处理数据展示到表格中

2.1.1 在数据源处增加远程数据源

参考文档：根据条件搜索表单实例详情列表

（1） 调用根据条件搜索表单实例详情列表接口

接口配置如图：

（2）请求返回数据在 didFetch 函数中处理，处理后的格式可以参考表格右侧「编辑代码」里面的格式，需要的每一条数据都要是一个对象，统一放到一个数组里面，最后返回的是一个对象，对象中有三个属性，其中一个属性是 data ，对应的值是处理好的数组

PS: 如果返回的数据是 proxy 形式，可以使用 JSON.parse(JSON.stringify(proxy 属性的数据 ))

function didFetch(content) {
  // content.b = 1; 修改返回数据结构中的 b 字段为1
  const value = [];
  const data = content.data.map((item)=>{
    let arr={
      name: item.formData.textField_hr9o6eq,
      sex: item.formData.textField_62lufhf,
      age: item.formData.textField_0nibhpr,
      study: item.formData.textField_97okczu,
      work: item.formData.textField_456c4b7,
      instid: item.formInstId
    }
    value.push(arr);
    console.log(arr);
  })

  let result ={
    "data" : value,
    "currentPage" : content.currentPage,
    "totalCount" : content.totalCount
  }
  return result; // 重要，需返回 content
}

2.1.2 在表格数据源中绑定远程数据源

配置如图：

2.1.3 修改数据主键值

 表格中每行数据唯一，因此配置实例 id 作为唯一标识，将数据主键值配置为获取的实例 id 

表格属性设置数据主键

2.1.4 绑定数据源后，需配置分页功能，在表格属性中添加动作事件，加载数据源

2.1.5 视频展示

2.2 新增数据

参考文档： 新增表单实例

2.2.1 在数据源处添加远程数据源，调用新增表单实例接口

接口配置如图：

2.2.2 添加弹窗组件，配置新增内容的组件到弹窗中

配置如图：

添加对话框组件

2.2.3 在「顶部操作 >> 操作条」添加新增的操作按钮，给按钮添加弹窗事件，其中使用 this.$(fieldId).show() 来展示对话框，括号中填入的为对话框的唯一标识符

export function onActionBarItemClick() {
   this.$('dialog_kp3mxni9').show()
  }

2.2.4 添加对话框点击确认时执行函数，点击确认后，执行 Insert 远程数据源调用接口在表单中插入数据，由于自定义页面本身不具备存储数据功能，因此需要做延时操作重新加载获取表单实例接口的远程数据源，使得插入数据后直接将新数据展示出来

export function onOk() {
  const data1 = {
    "textField_hr9o6eq" : this.$('textField_kp3mxnia').getValue(),
    "textField_62lufhf" : this.$('textField_kp3mxnib').getValue(),
    "textField_0nibhpr" : this.$('textField_kp3mxnic').getValue(),
    "textField_97okczu" : this.$('textField_kp3mxnie').getValue(),
    "textField_456c4b7" : this.$('textField_kp3mxnid').getValue()
  }
  const param = {
    formUuid :"FORM-HC9660C1TGFQ8927Y6905OPBO30Y1I9YOD3PKH",
    appType :"APP_J587XYX1VEUP7XTTIJVV",
    formDataJson : JSON.stringify(data1)
  }
  this.dataSourceMap["insert"].load(param).then(res => {
    this.utils.toast({
      title: '新增成功',
      type: 'success',
      size:'large',
    });
  }) 
  this.$('dialog_kp3mxni9').hide();
  setTimeout(()=>{
    this.dataSourceMap['getDatas'].load();
  },2000);

  console.log('onOk');
}

2.2.5 视频展示

2.3 跳转详情页面查看详情

2.3.1 配置操作列中的详情操作项

如图所示：

2.3.2 使用 this.utils.router.push(path, params?, blank?, isUrl?) 配置参数，跳转到详情页中，参考代码如下：

export function onActionClick(rowData) {
   const id = rowData.instid;
   this.utils.router.push('https://www.aliwork.com/APP_J587XYX1VEUP7XTTIJVV/formDetail/FORM-HC9660C1TGFQ8927Y6905OPBO30Y1I9YOD3PKH',{formInstId: id},true,true)
    console.log(rowData);
  }

2.3.3 视频展示

2.4 删除数据

参考文档：  删除表单实例

2.4.1 数据源处加远程数据源，调用删除表单实例接口

接口配置如图：

2.4.2 添加删除操作列

2.4.3 配置动作事件，需加载 Delete 数据源，调用删除表单实例接口，并配置延时在删除后重新调用查询表单实例接口，将数据加载展示，参考代码如下：

export function onDeleteClick(rowData) {
    const id = rowData.instid;
    const param2 = {
      formInstId : id ,
    }
    this.dataSourceMap['Delete'].load(param2).then(res =>{
      this.utils.toast({
        title: "删除成功",
        type : "success",
        size:"large"
      });
      setTimeout(() =>{
        this.dataSourceMap['getDatas'].load();
      },2000);
    })
    console.log(rowData);
  }

2.4.4 视频展示

2.5 编辑修改数据

参考文档：更新表单实例

2.5.1 在数据源处添加远程数据源，调用修改表单组件值的接口

接口配置如图：

2.5.2 新增编辑操作列以及保存操作列，由于编辑后会进入编辑态，因此需要将保存按钮放置在编辑态中

配置如图：

2.5.3 添加编辑事件，参考代码如下

export function onTableRowEdit(rowData, action, table) {
  console.log(rowData);
  return table.editRow(rowData);
}

2.5.4 添加保存事件，在保存事件中加载 Update 数据源，调用接口，并配置延时在修改后重新调用查询表单实例接口，将新数据加载展示，参考代码如下：

export function onTabeRowSave(rowData, action, table) {
  console.log(rowData, action, table);
  return table.saveRow(rowData).then((...args) => {
    console.log(args);
    const id =  rowData.instid;
    const somejson = {
      "textField_hr9o6eq" : args[0].name,
      "textField_62lufhf": args[0].sex,
      "textField_0nibhpr": args[0].age,
      "textField_97okczu": args[0].study,
      "textField_456c4b7": args[0].work
    }
  const param3 = {
    formInstId :args[0].instid,
    updateFormDataJson: JSON.stringify(somejson)
  }
    this.dataSourceMap['Update'].load(param3).then(res => {
      this.utils.toast({
        title: "修改成功",
        type: "success",
        size: "large"
      });
      setTimeout(() => {
        this.dataSourceMap['getDatas'].load();
      }, 2000);
    })
  });
}

2.5.5 视频展示

2.6 实现表格搜索功能

2.6.1 在数据源处增加变量数据源，并在远程数据源 getDatas 配置变量参数

（1）配置变量数据源 page 及 searchKey

（2）在远程数据源 getDatas 配置变量参数；并将变量数据源 searchKey 作为查询数据的参数 searchFieldJson

{
  searchFieldJson: JSON.stringify({
    textField_456c4b7: state.searchKey
  }),
  formUuid: "FORM-HC9660C1TGFQ8927Y6905OPBO30Y1I9YOD3PKH",
  currentPage: state.page,
  pageSize: 10
}

2.6.2 在配置的分页动作事件中，给变量数据源赋值，当搜索时触发，变量数据源赋值后，搜索符合 searchFieldJson 条件的数据

export function onFetchData(params) {
  // 如果是搜索的话翻页重置到 1
  if (params.from  === 'search') {
    params.currentPage = 1;
  }

  // 如果你需要把表格查询条件保存起来，可以取消下一行注释，并添加一个 params 的变量类型数据源
  // this.setState({ tableParams: params });
  // 如果使用远程接口作为表格数据源，理论上你只需要将下方的“dataSourceName”改为实际的数据源名称即可
  // this.dataSourceMap['getDatas'].load(params);
  this.setState({
    searchKey: params.searchKey,
    page: params.currentPage
  })
}

2.6.3 视频展示

3. 常见问题

3.1 当页面加载完成时，控制台报 “500” 错误，提示 “参数校验失败 formUuid 或 formInstId ”，是什么原因导致的？

答：由于insert，update等数据源是在点击操作列按钮时进行加载，而创建数据源后，未关闭自动加载，导致页面打开后自动加载数据源时参数校验失败。

宜搭为了更好的优化宜搭使用手册内容和质量，占用您3-5分钟时间，辛苦填写一下文档反馈问卷。文档反馈问卷是匿名提交，同时问卷信息仅用于宜搭文档体验反馈收集，感谢您对宜搭的支持！点此填写调研问卷