数据表设计与数据源配置指南

林栖云数据流讲解B站详解 https://www.bilibili.com/video/BV1254y1P7uN/

数据表设计与数据源配置

一、在左侧菜单中点击“数据对像设计”进入后端设计下的数据库表对象设计主页，如下图所示：

1.新建表

在数据对象设计主页上图所示中点击“新建”按钮进入创建数据库表界面，如下图所示：

输入依次输入表名、显示名、备注，点确定即可。

表名：就是数据库中表的名称，一般用半角英文字母命名。

显示名：就是在表设计页面中显示的名称，一般用中文来表示。

备注：说明表的内容。（可以简单介绍表中的字段）

表创建好后，在主界面中会显示刚才创建的表，这时只是在平台数据库中保存的相关信息并，未实际在项目的数据库中创建表。

2.设计表结构

表新建好后，在数据对象设计主页中依次点击已经新建的表的图标，然后会显示右侧工具栏， 

点击“设计表”按钮可以设计或修改数据库表的结构，点击后显示如下图所示:

（1）添加数据库表字段

点击如下图所示“添加”按钮，则会增加一行输入行，把设计输入相应字段内容即可。

字段名：就是数据库中表中的字段名称，一般为英文字线、下划线。

显示名称：一般会相应的中文件意思。

类型：字段的数据类型，目前支持String字符串型，Int整型，Double双精度型，其它数据库类型暂不支持。

最大长度：字段占用的最大字符位数，Int一般为11，Double为20，String对应数据库的varchar型，根据实际情况输入，最大长度受数据库的varchar字段的最大长度限制。

是否可NULL：输入数据时，值是否允许为空，当去掉选中时为不允许为NULL，这时可设置默认值。

默认值：当添加数据库表字段时，前端没有带该字段参数，数据库会自动填入输入的该数值。

说明：解释说明文本。

主键：是否设置该字段为主键，主键可选多个字段。

自增长：当字段类型是Int时并设置为主键时，可选择该字段，选中后，添加记录时没有带该字段参数时，数据库会取该字段当前最大值+1设置。

（2）自动生成数据源和接口

在上面添加完字段后，如果需要自动生成数据源的接口，则需要勾选如下图所示复选框：

这样就会自动相应的数据源和接口，对应的接口名称分别是：add_tab_verifi_code.action、delete_tab_verifi_code.action、update_tab_verifi_code.action，就是在表名前面加相应的操作名，后面加.action。

目前只能自动生成插入、修改和删除操作的数据源和接口

3.添加数据源

源据源是业务服务用于处理数据库表的一个“操作”，增、删、改的数据源都是在“增删改操作”里面配置，查询数据源在“数据源设计”中配置。

配置数据源

自定义数据源id与数据名称（如下图）选择数据源查询字段

已选字段再选中查询字段后自动生成

4.增删改操作数据源

在上图数据源的主页中选择需要配置数据源的表，显示右边配置栏的中点击增删改操作一栏中的“配置操作数据源”，显示如下配置页面：

这里只能配置插入、修改、删除表操作的数据源。

1.插入：

输入数据源ID和数据源名称：两个都只能用英文加下划线命名，一般设置成一样的

字段列表区域：是需要修改或插入的字段名称。必须和数据库表设计中的一致

值：用于输入前端传入参数的变量名称，字段数量和顺序需要和上面的列表保持一致

参数：用于配置前端传入参的变量名称和对应的数据类型

2.修改：

输入操作ID和操作名称：两个都只能用英文加下划线命名，一般设置成一样的

字段列表区域：是需要修改或插入的字段名称。必须和数据库表设计中的一致

设备值：以“字段名=#{字段变量名}”成对加入

点击“添加过滤”可以设置操作时的过滤条件，值可以是变量也可以是常量，如下图所示：

在下图配置好扣，就会在上图中的条件栏中增加相应字段的过滤条件。

参数：需要再选择一下设置字段的类型

查看源码：点击“查看源码”按钮，显示如下图所示的XML的配置窗，编写语法格式可以查看具体的说明文档，类似于Mybaits的配置方法。

5.添加数据源

在数据源的主页中选择需要配置数据源的表，显示右边配置栏的中点击数据源设计一栏中的“添加数据源”，显示如下配置页面：

输入操作ID和操作名称：两个都只能用英文加下划线命名，一般设置成一样的。

备注：可以输入数据源的作用描述等。

然后点击主表名称，在右侧会列出该表的所有字段。

查询的字段：在右侧字段选中复选框，选中后会在已选字段中列现，格式为：表名.字段名。

关联的表：增加关联表，用SQL语句就可以。

查询条件：主表字段的查询条件可以在点击字段后的“添加过滤”用选择点击操作，选择好。后会在“已添加过滤条件”栏显示出来，如设置了变量，则在“变量类型设置”栏也会增加相应一行，这里还需要设置变量对应的字段类型和匹配模式。

匹配模式：前缀匹配à变量行最左边的比较，右边模糊；精确匹配à就是变量要和数据库中完全一样才能匹配上；模糊匹配à就是可以左、中、右匹配。

6.配置接口

“数据对像设计” 主页中选择需要配置接口的主表，右边扣操作栏中“前端接口定义”栏中选择“配置接口”按钮用于给前端开接接口，如下图所示：

接口名称：可以输入中文，方便识别

URL：设置接口的URL

服务类型：一般选“服务访问”，当是用户登录接口则需要选择“用户登录”其它都是内置接口类型。

权限控制：无需登录，不登录就可以调用；另一个则相反

操作类型：

目标服务项目ID：根据接口所在服务选择就可，选“其它”时需要用户输入服务的ENTCODE;

目标服务项目类型：除“手动填写”外选择后都是自动填入。这是一个十六进制数

操作ID:当选择操作ID时，需要点击“选择”按钮去选择相应的数据源。

添加参数：就是配置前端需要传入的参数，这里的参数一般是指静态参数，由平台自动带上，另上种是会话参数，会话参数优先级更高。

会话参数：会话参数目前有：EntCode(项目编码)，UserID(用户ID)，UserName(用户名称)，(UserRoles)用户角色，其他，用于其它保存在会话中的参数获取，只需输入参数名称。

接口说明：用于描述接口的功能或使用方法

参数说明：用于说明该接口所有参数，包含上面加的静态参数和前面带的说明参数。

接口的修改和新增操作是一样的。

注意：

     报错500可能配置url重名;

不要重复配置接口;

配置查询接口需要添加数据源;

（1）接口配置的操作类型说明与配置

目标服务项目ID：项目ID为16进制，

选择当前项目服务项目ID就是当前项目的ID即调用的是当前项目的接口，

选择平台项目就是选择林栖云平台（项目ID为8）的项目服务ID，调用的时平台的接口

选择其它就需要根据具体情况来选择其它项目的服务ID

目标服务类型和消息ID: 根据选择的条件（插入，修改，删除，查询）会自动填充目标服务类型和消息ID,每种条件的服务类型和消息都不同，选择手动填写的一般为比较特殊的服务类型和消息ID，例如发送短信，登录等。选择完对应的条件后就需要选择对应的数据源或者表。

“选择”按钮：当选择“查询数据源”和“选择操作ID”时需要点击左下方的“选择”按钮，用来选择使用哪个数据源操作数据库；其它则需要选择操作哪个表。

手动填写：自定编写的服务一般在这里都是需要手动填写服务类型和消息ID

二、枚举定义

在左侧菜单栏中选择“枚举定义”。

添加到枚举定义一般用于当前项目的自定义表单（在下一章）或者是自定义页面组件选择静态枚举数据，

例如:

1.枚举使用在自定义表单：

2.枚举使用在自定义页面：

选择枚举后显示的下拉选择就是在枚举里面添加到项

三、数据字典

在左侧菜单栏中选择“数据字典”。

数据字典：简单来说就是使用当前项目的tab_tree_data表中的数据形成树状结构的数据

tab_tree_data表

最大层级：如果限制了最大层级那么添加到限制的层级后将无法添加子集，如下图设置了4级

groupID：groupID分为四类获取，

1.为从会话中获取，选择了的话那么如果会话中有groupID的话那么就会自动带上。

2.为从本地缓存中获取，格式例如下图如果要取存储在WebSite中的CustomerID作为groupID，那么格式就是WebSite.CustomerID

3从页面缓存取：即从VueX中取，格式和从本地缓存中获取一致。

4变量：即从使用的页面获取，输入要使用的变量名即可。