关于宜搭
宜搭是阿里巴巴自研的低代码应用构建平台,通过可视化拖拽的方式,传统模式下需要 2 周才能完成开发的应用,用宜搭 2 小时就能完成。
宜搭提供了大量的图形化的开发组件,用户通过拖拽和配置,无需代码或仅需少量代码就能快速完成应用的搭建。
在宜搭的应用中,我们可以通过以下几类页面来配合完成完整的业务场景需求的解决。
界面介绍
编辑界面左侧
主界面
- 注意1:通知人员类型为按页面内人员通知,该人员所属控件需为成员组件,否则通知不到。
- 注意2:触发条件若为页面指定内容变化,意思是该页面修改时才会通知。
表单入门
用于存储或收集数据,通过权限配置实现不同角色人员能够拥有不同的对数据增删改查、以及字段操作等权限。
表单拥有常用控件:文本、下拉选项、级联、地址、富文本等。
界面左侧为常用控件,右侧为控件设置。
右侧可做控件的基础设置,如标题修改、控件状态、默认值、默认格式、数据校验等。
流程表单入门
通过审批流程完成特定的业务,例如请假、报销等需要多级审批的场景。
基础界面与表达几乎一致。
审批流程设置:可在此设置审批条件、审批人等。
- 注意1:审批人可指定人员、指定角色等,若需要指定页面选择的的人员,需要将人员选择的控件变为成员组件,然后在变量中选择。
自定义页面入门
通过低代码搭建展现或其他任何类型的自定义页,借助数据源或更丰富的组件实现应用Portal、复杂业务场景页。
与表单界面几乎一致,增加了控件和相应的模版。
主要用于复杂页面JS编写和相对自定义的功能操作。
常用远程API
- 根据条件搜索表单实例详情列表 /v1/form/searchFormDatas.json
注意该接口会受页面设置的权限控制(管理员除外)。
使用例子:/dingtalk/web/APP_xxxxxxx/v1/form/searchFormDatas.json
其中APP_xxxxxxx为应用ID,在下图所标识处查看。
固定查询参数:
formUuid:表单ID,在下图所标识处查看
可用查询参数:
1、currentPage:当前页
2、pageSize:每页记录数,必须大于0,默认10不能大于100
3、createFrom、createTo:createFrom和createTo两个时间构造一个时间段。查询在该时间段创建的数据列表,字符串格式,且为yyyy-MM-DD格式(或者精确到秒yyyy-MM-DD HH:mm:ss)。若查询当天,则为2021-07-21 00:00:00 和 2021-07-21 23:59:59
4、searchFieldJson:根据表单内组件值查询。查询字段为控件ID,需要自行转成JSON格式,例如:
searchFieldJson: JSON.stringify({
textField_kptm408g: record.textField_kptm408g, // 关爱对象
textField_kptl384g: record.textField_kptl384g, // 监护人
}),
在页面内单独使用为:
this.dataSourceMap['getGADXData'].load({
formUuid: 'FORM-7xxxxxxx',
searchFieldJson: JSON.stringify({
textField_kptm408g: record.textField_kptm408g,
textField_kptl384g: record.textField_kptl384g,
}),
pageSize: 10,
currentPage: 1
}).then(res => {
// 成功请求后操作
})
- 根据搜索条件获取实例详情列表 /v1/process/getInstances.json
获取流程表单数据接口,使用方法与上一个几乎一致,如果需要判断流程进行到哪一步,则根据instanceStatus字段判断。(RUNNING,TERMINATED,COMPLETED,ERROR。
分别代表:运行中,已终止,已完成,异常。)
页面JS操作API
根据文档所提供的API操作即可,需注意,使用API的时候,该代码需要位于被绑定的动作函数中,不可单独使用。
例如一个按钮绑定了click事件A,在A中的this.$('fieldId').setValue(value)
才会生效,如果只是单独写一个A事件而没有被任何动作绑定,该操作会报错。
参考链接:
1、宜搭使用手册:https://www.yuque.com/yida/support
2、宜搭平台接口:https://www.yuque.com/yida/support/aql605
3、宜搭页面API:https://www.aliwork.com/developer/API