创建数据库主子表插件

1. 简介

1.1 插件简介

创建数据库主子表插件，支持根据简道云表单、字段别名，自动创建数据库主子表、字段。若表单中包含多个子表单，则支持同时创建多个字表数据。

1.2 应用场景

该插件常用于主数据/业务数据同步前，先创建或者更新数据库表和字段，以便能接收表单的全部字段数据的场景中。如人员、组织、客户、产品、物料等主数据同步前；合同、订单、费用等业务数据同步前等。

1.3 预期效果

开启创建数据库主子表插件，在「标准订单」表单中设置智能助手定时任务后，在指定时间自动创建或者更新数据库表和字段。效果如下所示：

1.4 使用说明

1）该插件需要具有 API 权限才能使用。

2）创建数据库主子表为付费插件，请联系我们增购。插件购买流程如下所示：

2. 插件安装及配置

2.1 安装插件

1）直接安装

2）插件市场处安装

在简道云「插件市场」处，安装「创建数据库主子表」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

2.2 配置插件

1）安装后，在「插件管理」处，点击插件右侧的「设置」按钮，根据企业数据库信息，将「简道云 API Key」、「数据库类型」、「主机地址」、「端口号」、「数据库账号」、「数据库密码」、「数据库名称」等信息配置进去，配置完成后点击确定。

2）进入「开放平台 >> 密钥管理」处，即可查看并复制对应的简道云 API Key。

2.3 启用插件

在插件管理中，打开「创建数据库主子表」插件右侧开关，启用插件。

3. 表单搭建

3.1 创建表单

以订单业务为例，新建「标准订单」表单，字段设置如下所示：

3.2 设置字段别名

进入「扩展功能 >> 数据推送」中，点击设置字段别名，依次将字段别名设置为数据库对应字段的名称，设置完成后，点击「保存」按钮。设置如下所示：

4. 智能助手配置

该插件支持在 前端事件 和 智能助手 中调用触发，本文以智能助手调用触发为例，进行插件的调用配置。如下所示：

4.1 添加智能助手

设计完表单后，在「扩展功能」处添加「智能助手」，并修改智能助手名称为「创建数据库主子表」。

4.2 设置触发动作

由于需要每日触发智能助手同步数据库数据，故「触发动作」选择「定时重复」，详细配置项如下所示：

4.3 设置执行动作

1）选择「创建数据库主子表」插件，如下图所示：

2）设置「表单」「应用 ID」「表单 ID」「数据库主表名称」，设置完成后点击「完成」，如下图所示：

4.4 效果演示

效果参见本文【1.3 预期效果】。

5. 注意事项

5.1 数据库说明

1）目前仅支持 mysql/sqlserver/postgresql 数据库。如希望增加更多数据库，可通过下方联系方式联系开发者增加。

注：mysql 通常默认的是 3306 端口，sqlserver 默认的是 1433 端口，postgresql 数据库，默认的端口号为 5432。

2）本地部署的数据库如具备允许公网访问的固定 IP，则可使用此插件；暂不支持公网访问的本地数据库。如您的数据库 IP 属于如下所示的局域网 IP 地址，则不支持访问：

5.2 字段增删说明

通过表单字段的字段别名与数据库的字段名称做对比：（仅针对设置了字段别名的字段参与比对）

5.3 IP地址白名单

如果您的数据库允许外放访问但需要 IP 地址加白名单，请设置白名单 IP 为： 47.97.99.12。

6. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：