宜搭基础入门

2021-07-21 本文已影响0人 SA_Arthur

关于宜搭

宜搭是阿里巴巴自研的低代码应用构建平台，通过可视化拖拽的方式，传统模式下需要 2 周才能完成开发的应用，用宜搭 2 小时就能完成。
宜搭提供了大量的图形化的开发组件，用户通过拖拽和配置，无需代码或仅需少量代码就能快速完成应用的搭建。
在宜搭的应用中，我们可以通过以下几类页面来配合完成完整的业务场景需求的解决。

宜搭基础功能

界面介绍

编辑界面左侧

大纲树：可以在这查看页面组件的层级和相关。

组件库：可以在这找到常用控件和高级控件。

数据源：可以在这里设置远程API和需要用到的变量。

动作面板：可以在这写入页面需要的相关代码，或控件绑定的动作函数。

多语言文案：可在这设置多语言。

主界面

数据管理：可查看已添加的数据，批量导入/导出等。

页面设置：可做基础设置操作、权限设置、消息通知等。

可在此做页面查看、提交等操作的权限，以及页面评论、打印等功能的关闭与开启。

消息通知：可在此操作提交、修改后的消息通知。

注意1：通知人员类型为按页面内人员通知，该人员所属控件需为成员组件，否则通知不到。
注意2：触发条件若为页面指定内容变化，意思是该页面修改时才会通知。

分享设置：可在此查看页面地址等。

表单入门

用于存储或收集数据，通过权限配置实现不同角色人员能够拥有不同的对数据增删改查、以及字段操作等权限。

主界面

编辑界面

表单拥有常用控件：文本、下拉选项、级联、地址、富文本等。
界面左侧为常用控件，右侧为控件设置。
右侧可做控件的基础设置，如标题修改、控件状态、默认值、默认格式、数据校验等。

表单存入数据库字段名称

控件-高级-动作设置：可根据控件设置动作函数。

表单提交前和提交后的一些动作设置

页面加载完成和关闭时动作设置，可在左侧动作面板写入代码

下拉控件可以在这里设置数据联动或是关联其他表单

流程表单入门

通过审批流程完成特定的业务，例如请假、报销等需要多级审批的场景。

流程表单详情

基础界面与表达几乎一致。
审批流程设置：可在此设置审批条件、审批人等。

注意1：审批人可指定人员、指定角色等，若需要指定页面选择的的人员，需要将人员选择的控件变为成员组件，然后在变量中选择。
审批节点

审批节点编辑：编辑审批节点。

编辑审批节点

自定义页面入门

通过低代码搭建展现或其他任何类型的自定义页，借助数据源或更丰富的组件实现应用Portal、复杂业务场景页。

编辑界面

主界面

与表单界面几乎一致，增加了控件和相应的模版。
主要用于复杂页面JS编写和相对自定义的功能操作。

常用远程API

根据条件搜索表单实例详情列表 /v1/form/searchFormDatas.json
注意该接口会受页面设置的权限控制（管理员除外）。
使用例子：/dingtalk/web/APP_xxxxxxx/v1/form/searchFormDatas.json
其中APP_xxxxxxx为应用ID，在下图所标识处查看。
应用ID

固定查询参数：
formUuid：表单ID，在下图所标识处查看

表单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