EKP表单自定义宝典

蓝凌EKP-J 表单自定义宝典文档控制/Document Control 修改记录审阅人分发目录第一章导读 (4)1.1从什么地方开始 (4)1.2相关资料 (4)第二章快速入门 (4)2.1第一次使用表单自定义 (4)2.2表单自定义可以做什么 (5)2.3表单自定义可以用在什么地方 (6)2.4表单自定义不能做什么 (6)第三章使用表单自定义 (6)3.1使用表单自定义工具 (6)3.2表单自定义的版本功能 (14)3.3理解表单自定义的数据存储 (15)3.4使用表单自定义的高级控件 (17)第四章扩展表单自定义 (26)4.1扩展表单自定义中的存储事件 (26)4.2扩展表单自定义工具中的控件（未展开说明） (32)第五章在应用中部署表单自定义 (32)5.1部署说明 (32)5.2部署表单模板 (33)5.3部署表单主文档 (35)5.4部署表单存储映射 (41)第一章导读1.1 从什么地方开始✓若您对表单自定义完全不了解，建议您先查阅“快速入门”章节。

✓若您了解表单自定义的基本概念，想使用表单自定义来完成您的业务需求，那建议您查阅“使用表单自定义”的章节。

温馨提醒：“使用表单自定义”的章节将由浅入深，告诉您如何使用表单自定义，当然，深一点的内容需要有一定的编程基础。

✓当您发现现有的表单自定义满足不了您的业务需求的时候，您期望做一些扩展，那您可以查阅“扩展表单自定义”章节。

温馨提醒：该章节需要有一定的EKP-J编程基础。

✓若您期望在一个新的模块能使用表单自定义的功能，那请查阅“在应用中部署表单自定义”章节。

温馨提醒：该章节需要有一定的EKP-J编程基础。

✓若您是一个表单自定义的使用者，一个非开发人员，建议您查阅本文的所有案例，了解通过表单自定义可以做到什么程度，若您是一个开发人员，建议您通读全文。

1.2 相关资料本文涉及到公式定义器的相关知识，请参阅详见《公式定义器宝典》涉及到流程部分的知识，请参阅详见《流程宝典》第二章快速入门2.1 第一次使用表单自定义我们在费用报销的时候经常会碰到一个这样的需求，当报销金额大于10000元的时候，需要高一层的领导进行审批，然后再交给财务审批。

在不开发新模块的情况下，我们一般会用审批流程来完成这个需求。

然而，由于我们需要在流程里面获取到报销金额的字段，所以我们不能采用RTF作为审批的内容，而借助表单自定义的功能，可以很好地解决该问题。

自定义表单定义：打开审批流程模块模板定义的界面，切换到审批内容标签，我们可以看到表单自定义工具：操作按钮区内容编辑区我们很快就可以定义出这样的界面：由于报销金额是数字类型，所以我们在字段的属性中，设置“数据类型”为“数字”。

流程定义：在流程定义里面，我们增加了一个条件分支的节点，通过定义公式：“$报销金额$>10000”作为条件分支的条件公式，实现当报销金额大于10000元的时候，需要高一层的领导进行审批，然后再交给财务审批的需求。

2.2 表单自定义可以做什么在普通的应用中，每种类型的文档（或记录）都会有自己固有的属性（如标题、创建时间等），若期望添加而外的属性，就必须通过修改代码的方式实现，而EKP-J的表单自定义的功能就是为了打破该限制而产生的。

通过表单自定义，我们可以不通过修改代码，灵活得添加额外的属性，并对界面进行排版。

而这些额外添加的属性，可能会被使用到其它的地方，如流程的判定、统计查询等，因此这些数据的存储必须是结构化的（而不是像RTF一样全部保存）。

此外，客户可能已经知道针对不久的将来，当公司制度发生改革的时候，某些特定表单的内容也会随之改变，客户期望这些表单是“活”的，是可以自己配置的。

而这个时候，表单自定义将是客户需求的最好解决方案。

2.3 表单自定义可以用在什么地方目前在我们的系统中最常使用表单自定义的是审批流程模块，在该模块中，用户根据不同的业务场景，定义不同的表单，满足各种业务需求。

另外，比如公文模块，大部分客户对公文模块的需求基本上都一致，许多基础的字段基本上都一致，后台的业务逻辑也大同小异，最不一样的地方可能就是公文的展现方式，每个企业可能会有自己的公文表单展现习惯，或者有几个定制化的字段。

若我们可以在公文模块中启用表单自定义的功能，就可以屏蔽掉企业间的差异，用一个标准的公文模块通杀所有企业的公文需求。

还有HR的员工信息等，各个企业都会有一些差异化的字段，这也是一个表单自定义很好的实战场景。

当然，您可以根据您的实际业务需求，把表单自定义“发扬光大”。

2.4 表单自定义不能做什么从前面的用途我们基本上发现，目前我们的表单自定义都是依附于某个模块实体的（比如审批流程、公文等），通过表单自定义的功能，我们可以在上面灵活地进行属性的扩充，但它并不包含增删查改的功能，也不包含视图展现等，更没有在上面直接部署机制。

所以我们无法通过自定义表单直接“开发”出一个全新的模块。

该限制可能在将来的版本中会有所改动，但至少现在的版本是无法这样做的。

第三章使用表单自定义3.1 使用表单自定义工具我们在审批流程的模块–模板设置–审批内容标签中，可以找到表单自定义的工具界面，如下图：3.1.1表单自定义使用的小窍门1、使用百分比定义控件宽度。

操作按钮区内容编辑区当我们定义一个控件的宽度的时候，通过拖拉的方式定义，单位往往是像素，但这样定义往往适应不了终端用户的屏幕分辨率，就会导致宽屏终端显示内容太少，或者窄屏用户出现横向滚动条等现象，为了解决该问题，您可以在属性框中按百分比定义宽度（如：“90%”），这样就可以适应各种终端显示器了。

2、选择界面控件。

通过Ctrl+左键，可以选择多个控件。

当是界面的控件很多，难以点选的时候，还可以点击展现控件树，在控件树中快速定位到相应的控件。

3、快速创建多个同类型的控件。

若需要创建一个单行文本输入框，我们需要在操作按钮区中选择了单行文本输入框，然后点击内容编辑区。

当我们期望创建多个输入框的时候，我们可以在操作按钮区中选择单行文本输入框，然后按住shift键不放，在内容编辑区的不同地方点击，这样就可以连续创建多个编辑框了，若期望取消，按下Esc就可以了。

4、拷贝整个表单。

若我们前面做好了一个表单，我们可能期望在一个新的表单中使用原来的表单，然后在新表单里面稍微修改一下，做为新的表单使用。

显然，界面里面一个个控件的拷贝太繁琐，我们可以这样操作。

点击显示高级控件：，旁边会显示“编辑表单HTML代码”的按钮，点击该按钮，在编辑区域里面就会显示整个表单的HTML代码，这时候，我们可以将所有代码拷贝到另外一个表单中使用，拷贝完毕后，记得点击“设置HTML”按钮，使您拷贝的HTML代码生效。

注意：除非您对表单的HTML代码非常熟悉，否则不建议您直接通过修改HTML代码的方式修改表单。

3.1.2控件的属性在我们双击控件的时候，会弹出控件的属性窗口，下面是一个单行文本输入框的属性：在属性界面中，需要注意的有几个地方：1、数据类型表单中每个被存储的数据项都是有数据类型的，数据类型对于后面的公式计算等方面起看完了这张表以后，您可能会对日期时间型（Date）、组织架构对象类型（SysOrgElement）的概念还比较模糊，没关系，在您往后的使用中，我们会详细地介绍它：若您需要在公式定义器中使用，那《公式定义器宝典》会有详细描述；若您在扩展表单自定义的章节中使用它，那该章节也会为您进行描述。

2、初始值您可以在初始值输入框中，输入该字段的初始值。

直接手工输入的内容不进行公式计算，若期望初始值通过公式来进行计算，请点击“公式定义”的按钮，在弹出框中输入公式，公式输入完毕后，属性框中的初始值被锁定，不能直接输入，同时下面出现“更新时重新计算”的选项。

若您期望修改为非公式计算的模式，那请再次点击“公式定义”按钮，将公式清空后即可。

公式定义器的使用，详见《公式定义器宝典》。

初始值的计算是有顺序的，顺序是按照界面从上到下，从左到右的顺序执行。

案例1：初始值计算顺序我们在表单自定义中定义了以下几个字段：在实际运行中，总额1的初始值计算结果为0（原因是由于在计算总额1的时候，单价和数量的初始值并未初始化），总额2的计算结果为200。

案例2：更新时重新计算在案例1中，我们可能期望总额是不能让用户自己输入的，而且当单价和数量发生改变的时候，需要重新计算总额这个字段，那我们就可以在总额字段的属性框中将该字段设定为“只读”，而且是“更新时重新计算”3、IDID是该控件的唯一标识，修改时请谨慎，否则可能导致引用地方的错误。

案例1：字段改名对公式的影响问：我在流程中使用了公式：“$金额$>1000”，后来我把“金额”这个字段名称修改为了“报销金额”，可是我忘记修改了流程中的公式，这时公式的计算是否还能正常运行？答：公式计算时候引用的是字段的ID，只要ID没有发生改变，公式是能够正常运行的。

但在流程定义的界面中，公式显示的地方可能还是出现“$金额$”这个变量，这只是显示没有更新而已，重新打开公式定义器的页面就会自动更新名称。

但是若您把金额这个字段删除了，那公式运行时就会报错。

案例2：更换控件的展现形式问：我开始用单行文本输入框定义了一个报销内容的字段，可用了一段时间后，发现单行文本输入框太小了，我想把它换成多行文本输入框，我该如何操作才能兼容以前的数据显示？答：若您直接删除了单行文本输入框，然后再添加一个单行文本输入框，这个时候系统会认为这两个是不同的字段，所以旧数据是无法显示在新的多行文本输入框中。

要解决该问题，您可以先将单行文本输入框的ID记录下来，再删除单行文本输入框，创建多行文本输入框后，将原来的ID写入到多行文本输入框中，这样系统就会认为这两个字段是同一个。

3.1.3控制表单字段级权限在一个标准的EKP产品模块中，主文档的数据基本上都是由起草人进行所有字段的信息输入，审批人若有“编辑主文档”的权限，那他就可以进入编辑页面，对文档字段进行修改，但往往在审批过程中，需要控制到字段级的权限。

下面举个员工转正申请的例子说明表单的权限。

3.1.3.1 案例需求表单内容大概定义如下：我们需要实现申请人能填写“申请人填写”部分内容，流程中的“部门经理审批”节点处理人可以填写“部门经理填写”部分内容，流程中的“HR经理审批”节点处理人可填写“HR 经理填写”部分内容。

另外，我们还期望HR经理填写的意见，人力资源部和总裁办的所有人可以查阅，其它人不可查阅。

3.1.3.2 案例实现第一步：插入权限区段为了实现这个需求，我们需要插入权限区段，将特殊权限的区域放入权限区段中。

插入后的表单的样子如下：注意上图的红色小方块就是权限区段的作用范围。

其中，申请人填写部分，由于跟标准的权限一致，所以可以不设置权限区段。