两篇秘籍即可搞定宜搭开发-基础功

宜搭开发快速上手手册

1 页面搭建流程：

1.1 普通表单搭建（使用情况最多的）

1.创建方法：

一般我们选择的方式是新建一个空白页面，当然你也可以选择从模板新建，根据你自己的喜好来进行创建，如果有模板对你开发减少，就选择直接使用就行，如果没有就直接像我一样选择空白页面进行创建。

创建的方式也是很简单的，这样直接就创建完成了。

2.创建出来的页面：

• 首先给你的表进行命名
• 这里是你的组件库
• 接下来你就可以根据你自己的业务逻辑去构建你的表单了

3.常用组件：

3.1 单行文本组件：

单行文本组件使用起来是最无脑的，最简单的。

所有组件的对应的属性，你可以根据你自己的业务去调整。

• 标题：即对应的组件上面的标题
• 占位提示：即你输入框的提示语
• 状态：即你可以控制组件的对应状态，一般我们会用普通，只读，隐藏

对于校验来说我们一般来说使用最多的是控制它必填或者非必填

当然这里我们也可以用自定义函数来实现我们的不同业务场景。

3.2 多行文本组件：

对于多行文本组件来说我们使用最多的是控制它多行文本的高度。其它的内容其实和单文本组件一样。

3.3 数值组件：

对于数值组件来说我们使用最多的几个属性是：默认值，单位，以及控制它的小数位数，千位分隔。

3.4 单选组件：

对于单选组件来说我们使用最多的是对于它的选项的设置。但是我的建议是如果选项是静态的不是动态维护的我们可以直接无脑使用这个组件，但是如果你的业务场景里面选项是动态的，你会发现有时候你的这个单选选项会有延迟，你动态维护了之后它不会立马就出现，所以就现在而言，我推荐使用下拉单选组件来替代单选组件。

至于动态的业务场景请看下一篇文章，这一篇文章只是告诉读者如何快速上手宜搭，下面文章会把我目前所有遇到的业务场景罗列出来并告诉读者实现的方式和方法。

3.5 复选组件：

其实复选呢也可以直接利用下拉复选组件进行替代。

3.6 日期组件：

日期组件其实我们在平常的开发之中我们使用也是比较多的，在上手手册里面其实是非常简单的，但是我们需要注意的是赋值，集成自动化以及在调用接口联调等等业务逻辑时候的使用情况以及方法。

3.7 日期区间组件：

日期区间组件其实我们在平常的开发之中相对日期组件来说使用就没有那么多了，日期区间组件其实我们就是在报表页面中以及计算两个时间段的差值会比较多。

3.8 成员组件：

成员组件的属性这里有一点就是多选模式，这里的多选模式呢其实就是可以选择多个成员，但是我这里其实是不建议你选择多选模式的，因为这样的话你会发现有很多限制，比如说导入的时候格式需要去注意，然后在使用集成自动化的时候也有很多限制，包括在动作面板即 js 代码的时候也会出现使用起来不方便。 所以综上所述，我推荐你使用子表单+成员组件（单选模式）：

这个在导入的时候就跟正常的组件使用起来是一样了，其实最大的方便还是在于集成自动化，因为现目前阶段宜搭并没有实现多条数据在循环体里面去做数据流动的逻辑处理等操作，一般从程序直接走的我们可以从代码的角度去实现我们的需求，如果从导入走的话，我们也可以从集成自动化去实现我们的业务场景。

3.9 图片上传组件：

其实对于图片上传组件来说，使用比较多的就是修改它上传类型的属性，我们一般会选择卡片，这个其它的属性，大家也可以去了解学习。

3.10 附件组件：

附件组件的属性也是相对而言没有那么多使用的空间，在我们平常的业务场景中附件组件和图片上传组件使用起来也是相对而言需求较少的，所以这里大致就聊一下他们的样式对应的属性。

3.11 子表单组件：

正常的子表单其实就是这样的，我们一般使用的方式就是将其它组件和它组合在一起使用，子表单这里面的内容还是很多的，所对应的业务场景也是比较复杂而且内容也是较多的。对于属性而言，比如说我们要控制操作列，一些子表单对应的一些功能比如说导入导出等等，这个旁边的属性表都是有的。

1.2 数据管理页面（列表页）

1.创建方法：

• 生成数据管理页面也是比较简单的，选择这个按钮即可生成对应的列表页面。

我们一般会去选择这个隐藏导航中表单页面，因为其实我们对用户提供的就是列表页面即可，表单在的话，用户在查看的时候也不能去新增或者进行什么操作，这样是有问题的。

2.页面功能：

数据管理页面对应其实有很多内容：新增，导入，导出，对于表格的某一些设置以及权限的控制。

这里我想要强调几个知识点：

2.1 显示列的控制：

• 因为对于用户来说，宜搭自动生成的这个列表页面里面有很多字段对于用户而言其实没那么重要的。开发者就可以在显示列中去控制它是否展示出来。下面两种方式都是可以控制对应的显示列是否展示的。

2.2 自定义按钮：

• 对于自定义按钮我们通过配置不同的属性在面对不同的业务场景去实现，这个我会在下一篇文章具体讲解的。

2.3 导入注意事项：

• 进入导入页面我们会发现其实就是这样的一个模板，我们直接去下载导入模板，我一般选择的是按表单展示字段下载。
• 当你下载好，填写好字段的时候一定要注意勾选触发校验规则、业务规则、集成自动化流、消息通知和第三方服务回调。因为如果你没有勾选这个，你会发现你导入的时候你的集成自动化并不会触发的。

2.6 批量修改数据：

• 对于批量修改数据来说，注意的点就是你需要数据要对应上就可以，对应上之后修改你对应的字段值即可。

1.3 报表页面搭建

1.创建方式：

首先对于报表页面来说：创建方式也是简单的跟我们普通表单是一样的。

2.组件：

2.1 专题名称内容：

• 筛选组件：分为下拉筛选和时间筛选

  

  对于这里的下拉筛选来说只要配置好数据集，查询的字段，显示字段，默认值等等即可

  

  对于时间筛选来说还需要注意点是如果要做区间的话就去样式里面进行设置即可

  

2.2 报表主体内容：

报表主体内容来说使用最多的几个组件是图表，指标卡，表格

• 图表：

  

  至于关于图表的一些业务场景，我们在下一篇文章去具体描述。

• 指标卡：其实指标卡也是我们常见的使用组件

• 表格：表格其实就不用多说了它肯定是联动上面的筛选框，所以我们这里选择的数据集肯定要跟上面的筛选框一致的，要不然筛选框就没有意义了。

1.4 自定义页面搭建（使用情况较少）

对于自定义页面来说，我目前开发过来使用的情况较少，它在使用层面来说比报表页面更加灵活，组件层面可以搭配实现一些更加优化的界面。但是具体的我使用起来是比较少的，这里我就不过多阐述了，如果需要详细的内容，请去官网上面学习。

2 集成自动化

集成自动化也是我们使用起来核心模块，因为关于样式以及组件的初始化等等我们在上面就已经介绍了。

那么关于数据的联动层面我们就要使用这个集成自动化了，通过集成自动化我们可以实现一系列的业务场景，比如说老师上完课新增课时之后要将课时统计课时页面。

集成自动化就可以非常方便的设置了，而不用繁琐的去写代码。我们只需要先选择表单的事件触发，接着

添加对应的数据节点比如说这里我肯定就是去获取我们统计页面的某一个老师对应的数据，所以我们只需要添加获取单条数据节点即可。

集成自动化可以实现多种的逻辑需求，其实这里就类似于一个流程图，你可以配置满足你业务场景的流程图，可以实现不同表之间的逻辑关联等等操作，还包括发送卡片的操作，发送卡片即会在钉钉里面推送给你设置好的角色或成员或你表单设置好的字段。

具体有哪些的需求以及对应不同的集成自动化的配置，我会在下一篇文章详细说明。

3 应用的数据联调

3.1 应用内部的数据联调

动态维护列表在组件中展示

比如说现我已经在下面这个列表页维护好我的评价项目

但是我需要将我的评价项目放到评价之中去，因为评价项目只是作为其中的一个字段去供用户选择。

配置好即可展示出我们列表页维护好的数据，这样也就实现了我们上面的需求，当然这里我只是举了一个例子，对于这种动态维护列表在组件中展示需求有很多内容，这是一种最方便的方式。这里我之前也说过，推荐的方式是使用下拉单选组件，因为你如果使用单选组件可能会存在问题。关于调用代码的业务场景我会在下一篇文章具体描述，绝对是保姆级教程。

3.2 不同应用间的数据联调

不同应用应用之间的数据联调的话，我们使用最多的方式还是通过代码，因为有些业务场景我们需要从一个应用拉取对应的数据到另外一个应用中某一个页面之中去。

还包括应用和钉钉的数据联调以及应用和后端的数据联调具体的内容我会放到下一篇文章。下一篇文章我会把我遇到的需求以及开发以来遇到的问题都会详细的描述。

总结，这一篇文章主要介绍了宜搭的使用内容包括组件的介绍，组件数据联动以及逻辑层面的集成自动化的内容，最后阐述了一些数据的联调，具体的业务场景和需求我会放到下一篇文章中去阐述。