协同自定义表单用户指南.docx

1、协同自定义表单用户指南协同自定义表单用户指南2013-4-8ligqa创建1 引言本文以自定义请假单为例，描述协同自定义表单的使用指南。2 数据结构定义2.1 开始定义数据结构通过菜单协同自定义表单数据结构定义进入。主实体即主表，用于保存单据的表头信息。填写编码、标题后点击左侧树的“自定义的组件”，填写的信息会被应用（此操作以下简称“应用”）。此时可以开始定义主实体。2.2 定义主实体点击右侧表下的可以为当前数据结构增加主实体。修改显示名称后应用，此时页面切换至主实体的基本信息及属性列表，此时可以开始增加需要的主实体字段。应用后，各属性显示在左树中，此时可以开始编辑各个属性的详细信息，各数据类

2、型说明如下：a) 简单类型可以指定当前属性为字符串、布尔型、数值、时间日期b) 实体类型如果是选择的实体类型，还需要指定关联到的实体类型，可选的实体除了系统中的实体外，还可以是自定义表单中的自定义实体。本例中职务代理人关联的是用户实体。c) 属性类型可以使用基础设置中的各种基础属性。d) 枚举类型在页面总最终显示为下拉列表，可以使用系统预置的枚举或者自定义枚举类型。自定义枚举参见定义枚举。2.3 定义子实体如果请假单还需要列举各种需要注意的工作事项，可以通过定义子实体实现。a) 添加子实体选择左树的根节点，点击右表下的即可为当前数据结构添加子实体。其他操作与主实体相同。一个数据结构中可以存在多

3、个子实体，但只允许有一个主实体。b) 与主实体关联子实体需要手动设置与主实体关联，才能在页面上以子表的形式显示出来。在主表中加入一个实体类型字段，数据类型选择为刚刚建立的“工作注意事项”即可。子实体中会自动添加主实体的只读属性。2.4 定义枚举如果请假单上要加入一个请假类型，标示是事假、病假、婚假等等，需要以枚举形式显示，这时需要自定义枚举。自定义枚举过程与自定义子实体类似，不过之需要填写各个枚举项即可，无须为枚举项指定数据类型，每个枚举项会被程序自动指定整数类型的值。 然后在主实体中加入整数类型的属性“请假类型”，并绑定该自定义枚举即可。2.5 发布数据结构定义好的数据结构，需要经过发布才能

4、应用在数据库中，才能被自定义表单使用。点击左树下的按钮即可。3 关联数据参照定义当表单中需要使用其他自定义单据类型作为参照时，由于系统中没有预置的此类型的参照，所以需要自定义此参照。这里假设请假单中加入“关联请假类型”的属性，需要关联到自定义实体“请假类型”。a) 定义请假类型的自定义实体并为其定义表单及添加数据b) 为请假单加入关联到自定义请假类型的属性c) 设计关联数据参照d) 添加到请假单表单中e) 在表单中使用该参照选取请假类型4 表单页面设计菜单协同自定义表单表单页面设计进入。a) 选择关联实体b) 选择主表需要显示的数据c) 选择子表需要显示的数据d) 定义默认值e) 指定参照的编

5、码和名称字段为职务代理人配置参照，先选择参照的代码和名称字段。再指定“职务代理人”的参照信息。f) 定义多行文本事由可能需要大段文字描述，可以定义为多行文本。5 表单流程定义与正常的工作流定义类似，不同的是需要在流程设计页面选择流程实体为请假单。6 表单数据维护6.1 数据维护菜单协同自定义表单表单数据维护，进入后是各个自定义表单的列表，选择要填写的表单双击，开始新增操作。操作与标准单据类似。点击编辑页面工具栏的可以显示当前单据的数据列表。如果希望直接进入某自定义表单的新增或列表页面，可以将其保存为快捷菜单。6.2 打印自定义表单支持两种打印方式。其一是使用默认的“自定义表单打印模板”，默认方

6、式仅支持打印表头，以流式方式按表单页面设计顺序打印出所有单据字段，不允许自定义细节信息，不支持打印子表信息；其二是支持用户自定义打印模板。当默认模板不足以满足用户的打印需求时，可以考虑使用UBF报表设计器以默认的打印模板为基础创建新的打印模板。默认打印模板在CS文件夹下：创建自定义打印模板所需的字段信息可以通过Portal中协同自定义表单数据维护页面获取：在页面URL后附加参数OutputSampleSQL=true，更新页面后重复打印步骤，示例SQL即可通过错误提示输出。示例SQL中包含全部当前单据可用于打印模板的字段信息，包含表头的所有字段和第一个选项卡（第一个子表）的全部字段，字段构造规则为：a) 参照的现实文本为【参照字段_Name】，b) 枚举的显示文本为【枚举字段_DisplayName】，c) 子表字段统一以主实体中子实体的关联字段为前缀，本例中为【Gongzuojj_子表字段】用得到的示例SQL作为打印模板的数据源SQL即可定义新的打印模板。模板中还可以包含上下文信息、单据审批数据等模板设计器所提供的其他信息，具体请参考打印模板设计的相关文档。