文档介绍：协同自定义表单用户指南
2013-4-8
ligqa
创建
引言
本文以自定义请假单为例, 描述协同自定义表单的使用指南。
数据结构定义
开始定义数据结构
通过菜单协同→自定义表单→数据结构定义进入。
主实体即主表,用于保存单据的表头信息。填写编码、标题后点击左侧树的“自定义的组件”,填写的信息会被应用(此操作以下简称“应用”)。此时可以开始定义主实体。
定义主实体
点击右侧表下的可以为当前数据结构增加主实体。修改显示名称后应用,此时页面切换至主实体的基本信息及属性列表,此时可以开始增加需要的主实体字段。
应用后,各属性显示在左树中,此时可以开始编辑各个属性的详细信息,各数据类型说明如下:
简单类型
可以指定当前属性为字符串、布尔型、数值、时间日期
实体类型
如果是选择的实体类型,还需要指定关联到的实体类型,可选的实体除了系统中的实体外,还可以是自定义表单中的自定义实体。本例中职务代理人关联的是用户实体。
属性类型
可以使用基础设置中的各种基础属性。
枚举类型
在页面总最终显示为下拉列表,可以使用系统预置的枚举或者自定义枚举类型。自定义枚举参见定义枚举。
定义子实体
如果请假单还需要列举各种需要注意的工作事项,可以通过定义子实体实现。
添加子实体
选择左树的根节点, 点击右表下的即可为当前数据结构添加子实体。其他操作与主实体相同。一个数据结构中可以存在多个子实体,但只允许有一个主实体。
与主实体关联
子实体需要手动设置与主实体关联,才能在页面上以子表的形式显示出来。在主表中加入一个实体类型字段,数据类型选择为刚刚建立的“工作注意事项”即可。子实体中会自动添加主实体的只读属性。

定义枚举
如果请假单上要加入一个请假类型,标示是事假、病假、婚假等等,需要以枚举形式显示,这时需要自定义枚举。自定义枚举过程与自定义子实体类似,不过之需要填写各个枚举项即可,无须为枚举项指定数据类型,每个枚举项会被程序自动指定整数类型的值。
然后在主实体中加入整数类型的属性“请假类型”,并绑定该自定义枚举即可。
发布数据结构
定义好的数据结构,需要经过发布才能应用在数据库中,才能被自定义表单使用。点击左树下的按钮即可。
关联数据参照定义
当表单中需要使用其他自定义单据类型作为参照时,由于系统中没有预置的此类型的参照,所以需要自定义此参照。
这里假设请假单中加入“关联请假类型”的属性,需要关联到自定义实体“请假类型”。
定义请假类型的自定义实体并为其定义表单及添加数据
为请假单加入关联到自定义请假类型的属性
设计关联数据参照
添加到请假单表单中
在表单中使用该参照选取请假类型
表单页面设计
菜单协同→自定义表单→表单页面设计进入。
选择关联实体
选择主表需要显示的数据
选择子表需要显示的数据
定义默认值
指定参照的编码和名称字段
为职务代理人配置参照, 先选择参照的代码和名称字段。
再指定“职务代理人”的参照信息。
定义多行文本
事由可能需要大段文字描述,可以定义为多行文本。
表单流程定义
与正常的工作流定义类似,不同的是需要在流程设计页面选择流程实体为请假单。
表单数据维护
数据维护
菜单协同→自定义表单→表单数据维护,进入后是各个自定义表单的列表,选择要填写的表单双击,开始新增操作。操作与标准单据类似。点击编辑页面工具栏的可以显示当前单据的数据列表。如果希望直接进入某自定义表单的新增或列表页面,可以将其保存为快捷菜单。
打印
自定义表单支持两种打印方式。其一是使用默认的“自定义表单打印模板”,默认方式仅支持打印表头,以流式方式按表单页面设计顺序打印出所有单据字段, 不允许自定义细节信息,不支持打印子表信息;其二是支持用户自定义打印模板。
当默认模板不足以满足用户的打印需求时,可以考虑使用UBF报表设计器以默认的打印模板为基础创建新的打印模板。默认打印模板在CS文件夹下:
创建自定义打印模板所需的字段信息可以通过Portal中协同自定义表单数据维护页面获取: 在页面URL后附加参数OutputSampleSQL=true, 更新页面后重复打印步骤,示例SQL即可通过错误提示输出。
示例SQL中包含全部当前单据可用于打印模板的字段信息,包含表头的所有字段和第一个选项卡(第一个子表)的全部字段,字段构造规则为:
参照的现实文本为【参照字段_Name】,
枚举的显示文本为【枚举字段_DisplayName】,
子表字段统一以主实体中子实体的关联字段为前缀,本例中为【Gongzuojj_子表字段】
用得到的示例SQL作为打印模板的数据源SQL即可定义新的打印模板。
模板中还可以包含上下文信息、单据审批数据等模板设计器所提供的其