manual

1.表间数据关联

从一个表单或者流程页面，自动加载其它表单或者流程的明细数据，自动填充到当前页面指定组件内

前言

两个准备工作，整个应用仅仅配置一次。上线前请切换生产地址，通过数据源配置方案仅修改一次即可

提供应用的 code 和 secret：【应用设置】➜【应用数据】➜【应用编码】|【应用秘钥】

在数据源添加致拓库地址，ZTOOL_LIB 公共库地址：https://aliwork.zitoo.com.cn/zTool/zTool.min.js

效果

demo 页面

场景：通过下拉条件关联目标单据值

方案：支持多条件查询，支持查询后数据过滤，支持查询和明细赋值默认值：将src设置为空

进阶：可实现一表查询更新多明细；多个明细来自多个数据源；主表更新主表：兼容一些当前页面需要公式或者数据联动情况【若需要作为联动条件，需要修复】；明细加载主表数据

参数

全局编码命名规则说明：

cur即current，通常指当前页面内组件ID；
src即source，通常值源表页面内组件ID；
def即default，通常指默认值，默认值优先级低于来源表数据

一些必填字段情况说明：

formId：来源数据的表单 Id，格式为 FORM-xxxx，可在应用设置或者直接打开目标页面，在地址栏粘贴
conditions：查询条件，格式为 [{ src: "", cur: "", def: "" }];，def 优于 src, src 和 cur 均需要传入组件ID，支持多条件查询
funcFilter：明细集合数据过滤方法，若不需要过滤则置空。格式为 detail => detail["compId"] == ""

一些非必填选配字段说明：

compId：报错的提示到输入框，若不传入则报错会以 toast 方式进行提示。报错提示在输入框，可阻断提交【建议配置】
isForm：数据查询是否来自表单，流程数据通过表单方式亦能查询【通常不需要配置】
errMsg：查询失败报错提示优先使用接口报错，若查询为空，默认提示为 未查询到匹配数据【通常不需要配置】

案例

打开页面的 js 功能，复制如下代码，按需选择

//---------------------- common ----------------------//

// 致拓工具库: 库地址存储于 dp 在数据页面全局共享, dp 在页面加载后才有值
function loadAliworkSDK(ctx = window.LeGao.getContext()) {
  const src = ctx.dp.getValue("ZTOOL_LIB");
  const script = document.createElement('script');
  script.setAttribute('type', 'text/javascript');
  script.setAttribute("src", src);
  document.body.appendChild(script);
  script.onload = () => _zToolOnload(ctx);
}

//---------------------- private ----------------------//

// 加载即调用方法请在此处进行调用
async function _zToolOnload(ctx) {
  zTool.aliworkInitParams()
  // 效验操作组权限：提交态
  if (zTool._checkSubmitEnv()) { }
}

//【3.红色都是需要匹配的】明细查询和赋值
async function _queryAndUpdateCompData(ctx) {
  //【3.1.多条件查询】表单查询条件：src 来源表条件组件Id，cur 当前表条件组件ID，def 默认值优先级低于来源表数据
  const conditions = [{
    src: "textField_kfnjmfq2",
    cur: "selectField_kfnjp1cu",
    def: ""
  }];
  const resList = await zTool._queryFormOrProcess(ctx, { formId: "FORM-JHYJNJSVPXGLZXSE43HQV9M8XE7U2UHXM00JKB3", /** 数据来源表Id */ conditions, compId_tip: "selectField_kfnjp1cu", /** 非必填：报错的提示到输入框，可阻断提交 */ })
  //【3.2.1.多明细更新】明细组件Id映射表: src 来源明细表内组件ID，cur 当前明细表内组件ID，def 默认值优先级低于来源表数据
  const props1 = [{
    // 名称
    src: "textField_kfnjmfq4",
    cur: "selectField_kkny9ed5",
  },];
  zTool._updateCompDetailFromDetail(ctx, { resList, props: props1, compId_detail_src: "tableField_kfnjmfq3", /** 来源表明细组件Id */ compId_detail_cur: "tableField_kfnjmfq3" /** 当前明细的compId */ }, { funcFilter: null, /** 过滤方法条件：detail => detail["textField_kfnjmfq4"] == "条件" */ })
  //【3.2.2.多明细更新】明细组件Id映射表: src 来源明细表内组件ID，cur 当前明细表内组件ID，def 默认值优先级低于来源表数据
  const props2 = [{
    // 名称
    src: "textField_kfnjmfq4",
    cur: "textField_kknt6uqk",
  },];
  zTool._updateCompDetailFromDetail(ctx, { resList, props: props2, compId_detail_src: "tableField_kfnjmfq3", /** 来源表明细组件Id */ compId_detail_cur: "tableField_kknt6uqo" /** 当前明细的compId */ }, { funcFilter: null, /** 过滤方法条件：detail => detail["compId"] == "条件" */ })
  //【3.3.主表更新】组件Id映射表: src 来源表内组件ID，cur 当前表内组件ID，def 默认值优先级低于来源表数据
  const mains1 = [{
    // 主表赋值1
    src: "textField_kfnjmfq2",
    cur: "textField_kkoslg5n",
  },];
  zTool._updateCompMainFromMain(ctx, { resList, mains: mains1 })

  //【3.4.明细加载主表】组件Id映射表: src 来源表内组件ID，cur 当前表内明细组件ID，def 默认值优先级低于来源表数据
  const mains2 = [{
    // 主表赋值1
    src: "textField_kfnjmfq2",
    cur: "textField_kkou7cb4",
  },];
  zTool._updateCompDetailFromMain(ctx, { resList, props: mains2, compId_detail_cur: "tableField_kkou7cb3" /** 当前明细的compId */ }, { funcFilter: null, /** 过滤方法条件：main => main["compId"] == "条件" */ })
}

//---------------------- event ----------------------//

// 【1.将事件绑定到页面】页面节点加载渲染完毕
export function didMount(ctx) {
  // 加载致拓工具库: dp & 初始化
  loadAliworkSDK(ctx)
}

//---------------------- event ----------------------//

// 【2.将事件绑定到查询条件】当查询条件发生变更
export function onContractChange(ctx) {
  // 匹配查询和赋值
  _queryAndUpdateCompData(ctx)
}

2.服务变更流程

服务可执行宜搭公有云接口文档所有服务，也可调用后台开发提供的接口服务

前言

若是单据页面，可直接提供高级公式执行更新操作。流程单据不支持高级公式，可通过服务来完成。变更发起者可以是流程也可以是单据

// 用于明细更新后返回：兼容用户不修改情况下操作 zTool._assembleDetailForKeyValue(ctx, "", "textareaField_kis8c0n5", details) // 用于明细内组件变更：兼容用户修改同步明细数据 zTool._assembleDetailForKeyValue(ctx, "tableField_kfnjmfq3", "textareaField_kis8c0n5")