协同自定义表单用户指南

协同自定义表单用户指南

1引言

本文以自定义请假单为例，描述协同自定义表单的使用指南。

2数据结构定义

2.1开始定义数据结构

通过菜单协同→自定义表单→数据结构定义进入。

主实体即主表，用于保存单据的表头信息。填写编码、标题后点击左侧树的“自定义的组件”，填写的信息会被应用（此操作以下简称“应用”）。此时可以开始定义主实体。

2.2定义主实体

点击右侧表下的可以为当前数据结构增加主实体。修改显示名称后应用，此时页面切换至主实体的基本信息及属性列表，此时可以开始增加需要的主实体字段。

应用后，各属性显示在左树中，此时可以开始编辑各个属性的详细信息，各数据类型说明如下：

a)简单类型

可以指定当前属性为字符串、布尔型、数值、时间日期

b)实体类型

如果是选择的实体类型，还需要指定关联到的实体类型，可选的实体除了系统中的实体外，还可以是自定义表单中的自定义实体。本例中职务代理人关联的是用户实体。

c)属性类型

可以使用基础设置中的各种基础属性。

d)枚举类型

在页面总最终显示为下拉列表，可以使用系统预置的枚举或者自定义枚举类型。自定义枚举参见定义枚举。

2.3定义子实体

如果请假单还需要列举各种需要注意的工作事项，可以通过定义子实体实现。

a)添加子实体

选择左树的根节点，点击右表下的即可为当前数据结构添加子实体。

其他操作与主实体相同。一个数据结构中可以存在多个子实体，但只允许有一个主

实体。

b)与主实体关联

子实体需要手动设置与主实体关联，才能在页面上以子表的形式显示出来。在主表

中加入一个实体类型字段，数据类型选择为刚刚建立的“工作注意事项”即可。子

实体中会自动添加主实体的只读属性。

2.4定义枚举

如果请假单上要加入一个请假类型，标示是事假、病假、婚假等等，需要以枚举形式显示，这时需要自定义枚举。自定义枚举过程与自定义子实体类似，不过之需要填写各个枚举项即可，无须为枚举项指定数据类型，每个枚举项会被程序自动指定整数类型的值。

然后在主实体中加入整数类型的属性“请假类型”，并绑定该自定义枚举即可。

2.5发布数据结构

定义好的数据结构，需要经过发布才能应用在数据库中，才能被自定义表单使用。点击左树下的按钮即可。

3关联数据参照定义

当表单中需要使用其他自定义单据类型作为参照时，由于系统中没有预置的此类型的参照，所以需要自定义此参照。

这里假设请假单中加入“关联请假类型”的属性，需要关联到自定义实体“请假类型”。

a)定义请假类型的自定义实体并为其定义表单及添加数据

b)为请假单加入关联到自定义请假类型的属性

c)设计关联数据参照

d)添加到请假单表单中

e)在表单中使用该参照选取请假类型

4表单页面设计

菜单协同→自定义表单→表单页面设计进入。

a)选择关联实体

b)选择主表需要显示的数据

c)选择子表需要显示的数据

d)定义默认值

e)指定参照的编码和名称字段

为职务代理人配置参照，先选择参照的代码和名称字段。

再指定“职务代理人”的参照信息。

f)定义多行文本

事由可能需要大段文字描述，可以定义为多行文本。

5表单流程定义

与正常的工作流定义类似，不同的是需要在流程设计页面选择流程实体为请假单。

6表单数据维护

6.1数据维护

菜单协同→自定义表单→表单数据维护，进入后是各个自定义表单的列表，选择要填写的表单双击，开始新增操作。操作与标准单据类似。点击编辑页面工具栏的可以显

示当前单据的数据列表。如果希望直接进入某自定义表单的新增或列表页面，可以将其保存为快捷菜单。

6.2打印

自定义表单支持两种打印方式。其一是使用默认的“自定义表单打印模板”，默认方式仅支持打印表头，以流式方式按表单页面设计顺序打印出所有单据字段，不允许自定义细节信息，不支持打印子表信息；其二是支持用户自定义打印模板。

当默认模板不足以满足用户的打印需求时，可以考虑使用UBF报表设计器以默认的打印模板为基础创建新的打印模板。默认打印模板在CS文件夹下：

创建自定义打印模板所需的字段信息可以通过Portal中协同自定义表单数据维护页面获取：在页面URL后附加参数OutputSampleSQL=true，更新页面后重复打印步骤，示例SQL即可通过错误提示输出。

示例SQL中包含全部当前单据可用于打印模板的字段信息，包含表头的所有字段和第一个选项卡（第一个子表）的全部字段，字段构造规则为：

a)参照的现实文本为【参照字段_Name】，

b)枚举的显示文本为【枚举字段_DisplayName】，

c)子表字段统一以主实体中子实体的关联字段为前缀，本例中为【Gongzuojj_子表字

段】

用得到的示例SQL作为打印模板的数据源SQL即可定义新的打印模板。

模板中还可以包含上下文信息、单据审批数据等模板设计器所提供的其他信息，具体请

参考打印模板设计的相关文档。