金蝶s-HR Cloud 金蝶s-HRV1.5PTM3配置指南（基础）.doc

金蝶s-HRV1.5PTM3配置指南（基础）金蝶软件（中国）有限公司2015年4月目录前言...........................................................................................................11动态扩展平台（DEP）..................................................................................11.1动态扩展方案......................................................................................................................................11.2实体名获取..........................................................................................................................................21.3新增元数据实体..................................................................................................................................31.4扩展实体..............................................................................................................................................41.5新建业务数据源..................................................................................................................................61.6扩展业务数据源..................................................................................................................................72视图...............................................................................................................92.1创建视图............................................................................................................................................102.2列表字段配置....................................................................................................................................102.3列表数据范围配置............................................................................................................................122.4列表默认排序配置............................................................................................................................132.5表单字段配置....................................................................................................................................142.6多行表表单排序设置........................................................................................................................162.7F7视图配置......................................................................................................................................162.8F7屏蔽创建按钮配置......................................................................................................................182.9搜索视图配置....................................................................................................................................192.10对象类型字段配置下拉选择..........................................................................................................222.11动态列表字段配置..........................................................................................................................242.12动态列表系统方案配置..................................................................................................................263权限配置......................................................................................................274菜单配置......................................................................................................305编码规则......................................................................................................315.1规则定义............................................................................................................................................315.2模板设置............................................................................................................................................326预警配置......................................................................................................336.1预警模板设置....................................................................................................................................336.2消息分类设置....................................................................................................................................386.3预警条目设置....................................................................................................................................407引入引出工具...............................................................................................417.1引入引出模板设置............................................................................................................................427.2引入引出工具....................................................................................................................................458套打工具......................................................................................................468.1套打模板设置....................................................................................................................................468.2套打模板应用....................................................................................................................................479工作流配置..................................................................................................4710附录...........................................................................................................5010.1自定义基础资料（实体）..............................................................................................................5010.2自定义基础资料（视图）..............................................................................................................5210.3自定义基础资料（增加菜单及权限控制）..................................................................................5510.4常见问题..........................................................................................................................................5811支持与帮助.................................................................................................58金蝶s-HR配置指南（基础）前言本文档提供s-HR实施过程中可能涉及的各模块通用的自定义配置，涵盖DEP、视图、菜单、权限、预警、编码规则和工作流配置等。从工具的使用方法和应用范围进行说明。金蝶s-HR配置指南（基础）1动态扩展平台（DEP）动态扩展平台(DEP)是s-HR沿用原EAS的动态扩展平台用以自定义配置元数据的强大的配置工具。原EAS还可以利用此工具进行界面配置及菜单发布，但s-HR有单独的界面配置和菜单配置工具，目前可以使用动态扩展平台来对实体、业务数据数据进行自定义新增和扩展。元数据是一切配置的基础，所有视图、菜单、信息集等都需要引用元数据的实体或业务数据源。元数据包括两部分：系统预置和自定义新增/扩展。系统预置的部分可直接引用，无需通过工具处理，但可以通过动态扩展平台导入以图形化的方式查看其数据结构及字段；扩展的部分则需要通过方案进行配置，启用后方能被引用（引用的方式与预置部分一样），实体是元数据的基础，一般基础资料的列表和表单界面通过对应的实体字段配置即可，通过实体配置的界面只能配置对应实体上的字段，无法关联配置实体所引用的其他实体上的字段。所有表单界面都是关联某一实体进行配置的。业务数据源是以一个实体为基础，关联这个实体上引用的对象类型的字段所对应的实体组合产生的一个查询字段的集合。业务数据源字段仅用于查询和显示，不能用于维护；通常用于列表界面和F7界面字段配置，业务数据源无法用于表单界面的配置。业务数据源还可应用于套打数据源，套打通过数据源来获取对应数据的。1.1动态扩展方案要自定义新增和扩展实体、业务数据源，首先需要创建动态扩展方案，在方案中新增或引入元数据进行自定义扩展。1）创建方案后，会在左侧出现一个以方案别名显示的节点，方案可以随时启用禁用，只有在方案启用的情况下，所作的扩展才能生效并被引用；2）选中方案点击右键还可以建立多级目录，进行分类管理，便于查看和维护。1/64金蝶s-HR配置指南（基础）1.2实体名获取在很多地方，如视图、信息集配置等都需要关联实体名，实体名可通过如下途径获取，选中实体，点击元数据校验。2/64金蝶s-HR配置指南（基础）1.3新增元数据实体通过动态扩展平台高级版，可以新增实体，通常用于自定义基础资料和自定义员工单行/多行页签实体的创建。在左侧方案中选中一个方案，右键【从模板复制】，选择一种模板，选择路径并输入名称和别名，点击确定就可以自动按模板创建一套元数据，包含实体、业务数据源。3/64金蝶s-HR配置指南（基础）1.4扩展实体当系统预置的实体上的字段无法满足客户需求时，可以根据客户需要在对应实体上进行扩展，添加字段，数据来源可以是手工录入（支持字符串、数值、布尔、日期等多种类型）、基础资料类别（关联某个实体对象）、固定下拉列表（引用预置的枚举类型字段，不支持自定义新增枚举类型的基础资料）。支持在任何实体上进行扩展，包括从模板创建的实体，通常从模板创建的员工单行/多行页签时一定要进行扩展的。4/64金蝶s-HR配置指南（基础）有几种方式导入实体1、从业务单元导入选择方案，右键【从业务单元导入】2、选中实体节点，右键【导入实体】5/64金蝶s-HR配置指南（基础）在导入实体时，可以通过实体别名进行搜索，也可以点击F7，直接录入实体名进行导入。1.5新建业务数据源选中业务数据源节点，右键可以新建业务数据源。系统已经预置了常用的业务数据源，通常情况下不需要新建业务数据源，在已有数据源上进行扩展即可。6/64金蝶s-HR配置指南（基础）1.6扩展业务数据源选中业务数据源节点，右键可以导入业务数据源（与实体的导入方式一样，可以通过别名查询，也可以点击F7，输入数据源名称匹配导入），双击打开即可在数据源上进行扩展。1）点击添加实体按钮，添加实体、设置实体对象的关联关系对于员工单行或多行页签的实体，关联通过父对象属性id关联子对象属性如person（父对象是其上级节点实体，子对象是其自身）7/64金蝶s-HR配置指南（基础）对于父对象实体上某个字段关联的对象，通过父对象属性字段名称关联子对象属性id2）切换到字段页签，可以引入实体上的字段，修改字段名称和别名，调整字段顺序8/64金蝶s-HR配置指南（基础）2视图视图可以看做是用于页面解析的一个配置文件，通过关联实体，以xml的形式配置界面字段及其属性，然后以一定的模式解析成页面展现给用户。对于不同类型的视图，解析的方式也不相同。9/64金蝶s-HR配置指南（基础）视图通过uipk唯一识别，uipk不可编辑，其生成规则如下：当URI不为空时，取URI的值当URI为空时，取模型的值+后缀，后缀对不同的视图类型按固定值默认匹配因此，当一个元数据实体需要配置多个同一类型的视图时，需要使用相同的模型，不同的URI来区分。2.1创建视图视图是进行数据查看和维护的入口，有界面才能进行数据录入和展示。一般来说基础资料都需要有对应的列表和表单视图，员工页签需要有对应的表单视图，其他业务数据列表也都必须要有列表和表单视图，部分通用的对象还需要根据业务需要配置一个或多个F7视图。以下配置需要使用administrator或业务管理员账号登录2.2列表字段配置1.打开开发平台->视图10/64金蝶s-HR配置指南（基础）2.选择要进行配置的列表视图进入，如联系方式（视图类型是列表）3.grid里面就是列表展示的列，删除不需要的列将整个一行删除即可；若要新增某个列字段，则复制一行，修改里面的name值为对应的字段名即可，字段名可以通过动态扩展平台从对应的实体上获取。11/64金蝶s-HR配置指南（基础）4.字段属性配置：里面用空格隔开，可以添加如下属性type=’hidden’设置为隐藏，即不显示wideth=’100’设置字段显示宽度label=’**’设置字段显示文字2.3列表数据范围配置列表视图中的标签用于定义列表展现的数据范围，可以通过修改该内容中的过滤器或过滤条件自定义设置数据范围。配置时需要保持格式正确，每一个条件之间用半角逗号隔开，用括号括起来，并且将比较条件、比较符、比较值用引号引起来。12/64金蝶s-HR配置指南（基础）2.4列表默认排序配置列表的或标签中，加上sorterItems="index"，即可对列表按此字段进行排序，若是倒序，在后面加上desc，即sorterItems="index"desc。如：下图中，若列表要按编码排序则修改红色框里的内容为13/64金蝶s-HR配置指南（基础）2.5表单字段配置1.打开开发平台->视图2.1.选择要进行配置的表单视图进入，如联系方式（视图类型是表单）14/64金蝶s-HR配置指南（基础）2.2.group就是多个分组，可以自己添加分组组合字。grid里面就是列表展示的字段，删除不需要的字段将整个一行删除即可；若要新增某个字段，则复制一行，修改里面的name值为对应的字段名即可。2.3.里面用空格隔开，可以添加如下属性readonly=’true’设置为只读15/64金蝶s-HR配置指南（基础）required=’true’设置为必录type=’hidden’设置为隐藏，即不显示label=’**’设置字段显示文字ctrl="textArea"colspan="2"rows="1"设置为大文本，占两列（类似员工信息备注字段）2.6多行表表单排序设置打开多昂表的表单视图，在标签里面加上sorterItems属性参考员工任职情况多行表按生效日期倒序排列2.7F7视图配置不指定调用某个F7视图时，默认与列表视图一致，可以根据需要新增F7视图，并在需要特别处理的地方进行引用，参考职等F7及岗位编辑界面的调用。职等F7：16/64金蝶s-HR配置指南（基础）岗位编辑界面引用：F7视图与列表视图很相似，可以同样配置列表视图上支持的一些属性，如数据范围、默认排序等。17/64金蝶s-HR配置指南（基础）2.8F7屏蔽创建按钮配置F7界面默认有创建按钮如需屏蔽，添加false到最后或标签前。18/64金蝶s-HR配置指南（基础）2.9搜索视图配置1.新建搜索视图如员工信息浏览的搜索视图：19/64金蝶s-HR配置指南（基础）2.列表界面配置搜索视图list界面header中加上uipk的值为对应的搜索视图的uipk值20/64金蝶s-HR配置指南（基础）效果则是在员工信息浏览的快速查询和高级查询中，可以根据配置的字段显示和过滤快速查询：高级查询：21/64金蝶s-HR配置指南（基础）2.10对象类型字段配置下拉选择支持配置基础资料字段的控件类型为下拉选择，建议数据少于15个且相对固定，名称不重复且通过名称可以明确语义的基础资料采取这种形式配置。配置某个实体对象的列表视图F7引用类型为下拉。在main或list标签内增加标签:22/64金蝶s-HR配置指南（基础）对该字段进行维护时，会议下拉的方式展现和选择23/64金蝶s-HR配置指南（基础）2.11动态列表字段配置在动态列表的视图中，可以对动态查询及展示所能引用的字段范围进行控制。选择视图类型为动态列表的视图，进入会有字段配置按钮24/64金蝶s-HR配置指南（基础）进入进行字段配置，从信息集中选择该列表可以进行动态设置的字段设置后，在动态列表进行方案设置时，信息集会根据配置的字段范围进行控制25/64金蝶s-HR配置指南（基础）2.12动态列表系统方案配置在动态列表的视图中，可以创建动态查询系统方案设置查询条件、列表字段、列冻结、排序字段等，与动态查询应用界面的设置内容相同。设置完成作为系统级方案，所有进入该动态列表的用户，都可以使用该方案。26/64金蝶s-HR配置指南（基础）3权限配置s-HR支持自定义WEB权限项，administrator进入系统设置-权限，可以查看所有WEB端的权限项（注意，GUI的权限项不在此配置中，权限的分配还是在GUi中进行处理）。当没有定义对应权限项时，则页面访问和操作不受控制，所有用户都可以访问和操作，只有定义了权限项，才会根据权限类型对不同用户进行相应的权限控制。27/64金蝶s-HR配置指南（基础）权限项由两个部分组成1）基本信息：分配权限时，会按照层次结构展示权限数据，以别名进行显示。基本信息中，定义的原则如下：员工自助相关的功能，与组织关系选择“无”专业用户相关的功能，与组织关系选择“HR组织”28/64金蝶s-HR配置指南（基础）根据功能需要支持的分配和使用方式设置权限类型操作类型根据操作该界面的方式进行设置2）URL信息下方的URL信息就是定义需要访问的页面及访问的方式，可以定义多个URL信息由一个权限项控制多个操作。功能简称用于对url信息做简要说明，并非分配权限时展示的内容。URL定义的规范为“/dynamic.do?method=”操作方法“+#uri=+”uipkURL的定义规则一般情况如下：列表查看：/dynamic.do?method=initalize#uri=+列表视图uipk列表删除：/dynamic.do?method=delete#uri=+列表视图uipk新增：/dynamic.do?method=addNew#uri=+表单视图uipk修改：/dynamic.do?method=edit#uri=+表单视图uipk启用：/dynamic.do?method=enable#uri=+表单视图uipk禁用：/dynamic.do?method=disable#uri=+表单视图uipkuipk和method一般情况下可以通过以下方式快速准确获取：i.打开需要控制进入查看的页面，就可以获取当前页面的uipk，一般要控制进入某个页面，method取initalize；ii.点击功能按钮，在打开的页面url可以获取该操作对应的uipk，且在url的最后会出现对应的操作方法29/64金蝶s-HR配置指南（基础）4菜单配置三级菜单为明细菜单，之前称之为服务，它与视图和权限的关联关系如下图，通过关联对应的权限项控制是否可以访问关联的视图，再通过对视图的配置内容进行解析，展示对应的页面。通过菜单管理下的一级、二级、三级菜单可以自定义配置整个菜单结构，通过顺序号可以调整本级的菜单显示顺序；三级菜单的配置则按照上图的逻辑关联对应的权限和视图，并可以配置其归属的一级或二级菜单。30/64金蝶s-HR配置指南（基础）5编码规则对于系统中的业务对象如基础资料、员工、单据等都可以进行编码规则的设置，通过设定的规则自动生成编码。user进入GUI企业建模-业务规则-编码规则员工编码提供了特殊支持，可以通过设置取某一组织层级（如公司）的组织上的某个属性作为编码的一部分，支持不同公司按不同规则生成编码的业务场景。具体操作请参考文档《按组织生成员工编码规则的配置》5.1规则定义选择需要定义编码规则的对象如员工_个人信息，通过新增的方式创建规则。目前系统内一个对象只能启用一个编码规则，且根据编码规则自动生成的编码不支持修改。31/64金蝶s-HR配置指南（基础）通过设置属性类别设置编码的分段组成，保存后可在编码示例中查看编码生成后的示例。5.2模板设置系统有预置部分编码规则模板，在定义编码规则时可以通过引入模板将模板中的设置引入进来进行配置。32/64金蝶s-HR配置指南（基础）6预警配置预警平台可用于配置对某一时刻满足某些条件的数据自动发送消息给指定人。系统预置了部分预警模板和条目，如生日预警、劳动合同到期预警等。只需启用预警消息订阅，即可按调度周期自动筛选满足条件的数据，发送消息给设定用户。客户可自定义预警模板和预警条目，由统一的预警平台进行调度和发送。操作路径：user或其他由权限的业务用户进入GUI企业建模-预警规则-预警平台。6.1预警模板设置1、预警对象及过滤条件设置通过选择预警对象和过滤条件，可以对数据进行基本的范围控制，过滤条件根据对象列表中选中的对象进行匹配，可选择该对象上的字段进行设置。33/64金蝶s-HR配置指南（基础）2、预警条件设置预警条件通过公式编辑器设置判断逻辑及返回的公式结果，公式结果为true的数据才会被返回；同时可以借助预警变量进行设置，需要时常调整的参与公式判断的属性可做为预警变量进行设置，调整时只需调整变量列表中的值即可，无需重新编辑公式。34/64金蝶s-HR配置指南（基础）在公式变量中，增加输入类型的变量，该变量会自动出现在预警变量列表。35/64金蝶s-HR配置指南（基础）3、预警消息设置36/64金蝶s-HR配置指南（基础）预警消息中各主要字段说明如下：消息表达式：当需要进行单条预警（即一个满足预警条件的数据发送一条消息）时设置，设置消息接收人接收的消息显示内容消息合并规则：当需要将当前满足条件的数据合并成一条消息发送给接收人时设置，可以通过参数@@count@@取出满足条件的数据条数；收到的消息可通过详情进入查看满足条件的数据列表（需要定义列表视图及消息分类——参考消息范磊章节）。37/64金蝶s-HR配置指南（基础）消息合并规则与消息表达式互斥。当设置了消息合并规则时，则会以合并消息的方式发送；当没有设置时，通过消息表达式中的内容进行单条预警。业务类别：业务类别对应WEB上定义的消息分类编码，消息分类可用管理员登陆WEB开发平台-消息分类查看和定义，关联业务类别后，消息才会在对应的分类下显示。6.2消息分类设置消息分类用来对消息进行归类，并将所接收的消息进行分类展现；并可在消息分类中定义用于该类型的合并消息展示的详情列表（PC端和移动端）。操作路径：管理员登陆WEB开发平台-消息分类38/64金蝶s-HR配置指南（基础）消息分类中配置合并消息详情在web和移动端的展现形式PC端："pc":[{"name":"detail","alias":"详情",//合并消息后显示详情连接，文字可修改"page":"com.kingdee.eas.hr.contract.app.ContractForewarnQuery.list",//点击详情打开的页面视图，建议配置单独的视图"pageType":"view",//打开界面操作的方式为查看"param":[{//获取的参数"name":"id",39/64金蝶s-HR配置指南（基础）"value":"${id}"//人员ID},{"name":"billId","value":"${id}"//合同ID},{"name":"status","value":"1"}]}],6.3预警条目设置在预警模板定义完成后，可以对该预警模板新增多个预警条目，在条目中可以重新定义预警变量和消息相关设置如接收人、消息表达式、消息合并规则等。40/64金蝶s-HR配置指南（基础）7引入引出工具引入引出工具提供了对象数据的批量引入引出及设置功能。操作路径：user进入GUI系统平台-业务工具-引入引出管理41/64金蝶s-HR配置指南（基础）7.1引入引出模板设置1、基础资料的引入引出通过维护自定义模板，可以配置包括自定义基础资料在内的引入引出模板。2、基础资料的引入引出第一步：维护自定义模板，选择新增模板第二步：选择引入实体对象、模板路径及模板编码名称等42/64金蝶s-HR配置指南（基础）可以将引入引出功能绑定系统已有的某个权限项，对引入引出进行权限控制；如果需要引出的话，还需要设置引出查询对象，这里选择的是数据源（对象的数据源可以参考本文的第一节DEP相关的描述中了解），s-HR的基础资料元数据并未都配备业务数据源，建议基础资料的导出通过列表的导出功能实现。第三步：选择字段可以选择实体上的任何字段，包括自定义扩展的字段。由于沿用EAS7.5的引入引出工具，这里引入的字段支持多语言版本时，会自动带出三个，简体中文是以“l2“结尾的字段，仅保留该字段即可。其他”l1、l3“可以删除。对于选择的字段，可以设置字段必录属性；当需要支持覆盖导入时，哦进行匹配的关键字段必须设置为必录，且确保该字段数据不重复。43/64金蝶s-HR配置指南（基础）第四步：双击维护模板导入方式44/64金蝶s-HR配置指南（基础）第五步：引出模板7.2引入引出工具模板设置保存后，引入引出工具就可以看到对应的模板，并且可以进行数据引入了。45/64金蝶s-HR配置指南（基础）通过在引入引出模板中导出的模板，填写数据保存文件，在文件路径中选择该文件，选择操作类型和引入方式点击运行即可完成导入。8套打工具套打工具用于配置对应套打数据源及套打模板，在页面上选择配置好的模板按照指定格式进行套打。8.1套打模板设置套打相关的功能完全沿用原EAS7.5的套打功能，具体配置方法可参考EAS对应的说明文档。46/64金蝶s-HR配置指南（基础）8.2套打模板应用套打模板要在s-HRWEB上使用，还需要根据不同情况进行相应的设置。9工作流配置工作流沿用原EAS7.5的工作流配置工具，详细说明可参考工作流工具相关的文档，s-HR进在工作流消息节点增加了消息分类属性，用于对接收到的工作流消息归类展现。1、审批节点分支配置47/64金蝶s-HR配置指南（基础）2、任务节点消息配置3、消息节点配置48/64金蝶s-HR配置指南（基础）4、消息中心的工作流消息通知5、事件订阅流程图中通过设置事件订阅可以设置指定流程事件给设定的参与人发送消息可设置流程管理员、流程发起人、指定职员都可以收到消息消息类型为工作流消息49/64金蝶s-HR配置指南（基础）10附录10.1自定义基础资料（实体）创建实体和视图——成本中心有权限的业务人员user进入GUI1、DEP新建方案，选择该方案，右键点击选择从模板复制50/64金蝶s-HR配置指南（基础）2、路径选择基础资料，模板名称选择基础资料51/64金蝶s-HR配置指南（基础）3、选中实体-成本中心，点击元数据校验，记下实体名称PK值com.kingdee.eas.basedata.app.CBZX10.2自定义基础资料（视图）1、管理员登陆s-HR，点击开发平台-视图进入52/64金蝶s-HR配置指南（基础）2、视图界面点击创建，在模型字段输入步骤1中记录下的PK对应的值，视图类型选中列表。3、在底部的扩展输入框里输入如下内容（参考系统中内置的基础资料格式，如国家）53/64金蝶s-HR配置指南（基础）备注：标签里是配置显示在列表上的字段，在这个例子里是配置了成本中心基础资料的编码。名称和控制单元三个字段，name的值可以从下图所示实体中获取，label是显示在界面上的字段名称。另外还要注意的是list和grid标签里的name是自己命名的，sorterIterms里面配置number是指按编码进行排序，这里可以配置实体里有的任何字段。54/64金蝶s-HR配置指南（基础）扩展练习：在这个基础资料的编辑界面增加一个勾选框HR组织4、新增form即表单视图，参考其他基础资料（如国家）form视图，修改模型和其中的字段即可10.3自定义基础资料（增加菜单及权限控制）1、有权限的业务人员vic登陆s-HR，打开系统设置-员工基础数据（同理，若要放到组织基础数据则打开组织基础数据，其他相同）-2、点击创建，在编辑界面输入对应信息，模型还是步骤1中对应的PK的值55/64金蝶s-HR配置指南（基础）3、增加权限项控制基础资料的权限目前我们是集合在一个权限项中进行分配的，这里可以加入到“员工基础资料-维护”权限项中，也可以单独增加一个权限来进行控制，url就是对应视图的UIPK或URI权限配置说明列表查看：/dynamic.do?method=initalize#uri=+列表视图uipk列表删除：/dynamic.do?method=delete#uri=+列表视图uipk新增：/dynamic.do?method=addNew#uri=+表单视图uipk修改：/dynamic.do?method=edit#uri=+表单视图uipk启用：/dynamic.do?method=enable#uri=+表单视图uipk禁用：/dynamic.do?method=disable#uri=+表单视图uipk4、同步权限数据，分配权限，重启OSF服务（管理员登陆s-HR，开发平台-基础配置-OSF配置，点击重启OSF服务），就可以在s-HR员工基础数据中维护该基础资料了56/64金蝶s-HR配置指南（基础）10.4常见问题1、点击某个菜单或链接提示找不到对应视图检查视图是否定义；视图的uipk拼写是否正确2、打开信息查看页面，字段显示为null；列表数据不显示检查视图中配置的字段是否是对应实体上的字段,名称配置是否正确；DEP方案是否启用57/64金蝶s-HR配置指南（基础）3、其他页面报错等情况检查DEP方案是否启用，启用后重启OSF服务11支持与帮助您可就近联系当地的金蝶营销服务机构以获取服务和技术支持。如您需要查询金蝶营销服务机构联系方式，可登录金蝶网站http://www.kingdee.com详细查询。想了解您购买的金蝶软件是否是正版产品，可登录http://www.kingdee.com/genuine/index.jsp进行校验。58/64