一、新版员工资料

1.1 开启新版功能

1、开启新版员工档案

人事基础设置-参数设置，开启新版员工资料：是

此时，纯Cloud项目页面仍可能不是最新版，需要开启另一个参数（混合云项目不要自行开启！！！）：

新版我的资料显示样式：

1.2 模版配置基础篇

1、档案模版3+1

员工档案支持3套查看模板，3种查看情况会自动匹配查看模板展示数据：【查看有管理权限的人员的档案】、【查看没有管理权限的人员的档案】、【查看自己的档案】。

假设现在有平级的两个部门1和2，部门1的部门经理是A，部门内有员工B，部门2有员工C，则：

A具有B的管理权限，则A查看B的资料时，使用的是第一套模板（manager）

B没有A的管理权限，B也没有C的管理权限，则B查看A、C的资料时，使用的是第二套模板（employee）

A、B、C各自查看自己的资料时，使用的是第三套模板（owner）

一个特殊规则→

高管的联系方式（手机号、办公电话、邮箱）会被隐藏，高管之间查看时会显示。

假设现在有公司高管M和N、P，M是N、P的上级，则A查看N的资料时无法查看其联系方式，M查看N、P时则可以看到对方的联系方式，但是N、P查看M或者N、P互相查看时无法查看对方的联系方式。

  • 具有管理权限的含义是具有对应部门的【分管范围】
  • 注意【部门主管】（管理团队）是默认具有对应部门分管范围的
  • 高管是指角色设置中的【高管】

和之前一样，以管理员登录系统，查看“我的资料”，点击左侧子集导航的元数据配置，看到的就是owner场景下的配置

在对象管理器中，搜索Employee，点击查看布局，找到对应的3套模板（manager & employee & owner），可进入模板中配置：

每一套模板可以配置要显示的子集，以及每个子集要显示的字段，前者通过base模板的3个state（场景）拆分模板，后者通过每个子集的3个场景拆分模板。

2、base模板配置：显示哪些子集

上述例子中，A的分管范围为部门1，没有部门2的分管范围，其中部门1下有员工B，部门2下有员工C，

则A查看B、查看C、查看自己时使用的模板分别为3套模板中的一个，控制每个模板中显示哪些子集的模板分别是

Employee.meta.base.manager.json、  Employee.meta.base.employee.json、  Employee.meta.base.owner.json


以管理员登录系统，查看“我的资料”，点击左侧子集导航的元数据配置，看到的就是owner场景下的配置

通过在url中手动传入场景（&state=manager 或 &state=employee 或 &state=owner），可以分别进入到3套模板中配置：


No.名称类型属性说明
1keystring
2modelstring模型
3labelstring名称
4iconstring显示图标
5parent_idstring该子集模型中记录人员id的字段，默认为employee_id。其他模块的模型（如绩效）记录人员id的字段可能不同
6viewstring界面展示，分为single (卡片)和multi (列表)
7hidebool隐藏

可以结合「010213 人员信息集管理」一起使用

3、子集模板配置：子集显示哪些字段

子集模板的拆分方式与base模板类似，3套模板中的每一套的子集都对应自己的场景，同样是manager、employee、owner

管理员查看“我的资料”时，各子集的元数据配置为owner场景，

同样通过在url中手动传入场景（&meta_state=manager 或 &meta_state=employee 或 &meta_state=owner），可以分别进入到3套模板中配置：

1.3 模版配置中级篇

1、左侧人员卡片（head）

配置元数据：Employee.meta.view.head_owner.json，也可在图中2号标注位置打开此元数据配置

标注释义示例
1人员卡片显示扩展部分

1、显示配置

"extend": [
        {
            "key": "show_fields",  //扩展字段key值
            "value": {
                "list": [
                    "department_name", // 在fields中配置出来需要显示的字段1，部门名称
                    "position_name" // 在fields中配置出来需要显示的字段2，岗位名称
                ]
            }
        }]

2、部门名称旁边小问号(问题)的配置

 "fields":[{
            "sequence": 30,
            "label": "部门",
            "field": [
                "department",
                "name"
            ],
            "key": "department_name",// 配置在extand里面
            "options": {
                "tip": "=function(){return SCOPE.view_model.data.position.parent.org_full_name}", // 小问号内展示的内容，
                "color": "gray" // 字体颜色为灰色
            }
        }]
2按钮配置

1、和其他功能无差别的按钮配置方式

 "actions": [{
            "action": "C_ACTION",
            "command": "showHitRate",
            "key": "showHitRate",
            "icon": "icon-hcm-board",
            "label": "人气"
        }]

2、可配置的扩展按钮

command值按钮功能
wxShare
在微信中分享带有部门、照片的人员名片
showRela
被查看人员和登陆者的关系图
showHitRate
查看人员的人气卡片
showNameCard
生成二维码
newArticle
在圈子中发送消息
shareEmp
在圈子中分享卡片
emp_appoint
干部任免审批表
portrayal
人员历程图
func值按钮功能
"=function(){return SCOPE.printPreview（bill_name,dynamic）}"可扩展套打文件
"=function(){return stateFunc(state,params)}"可配置跳转按钮

2、上传图片&照片

标注释义示例
1人员卡片显示上传图片
{
    "fields": [{
"options": {             
           "readOnly": false,// 开启照片上传
           "photo_size": "136,112",//一寸照片尺寸，若长宽均为112即圆形
           "can_preview": true,//是否允许预览
           "can_download": true,//是否允许下载
           "downLoadName": "=function()
           {return   SCOPE.auth.employee.name}",//下载文件的名字
           "save_api": "hcm.model.edit",//照片上传后调用该接口
           "save_params": "=function() 
           {return                  
        {'id_':SCOPE.auth.employee.id,'model':'Employee'}}",
            //照片上传后调用接口存到哪个字段上
           "camera": true,//手机端开启拍照模式
           "capture": "camera",//手机端开启拍照模式
        "upload_label": "=function()                     
           {return '测试上传名称'}"//可修改返回值改变名称
        }
}]
}

3、自定义子集样式（list）

为了保持已上线项目和在建项目的稳定，预制模板未调整为新的结构，依然保持了基本的左右布局，但可以通过元数据配置实现好看的布局。可实现的效果包括如下

1）列表模式

 


配置示例：
"list_config": {
        "view_list": {
            "mobile": ["list"], // 移动端可展示的list模式
            "pc": ["list"]  //pc端可展示的list模式
        },
        "view": {
            "mobile": "list", //移动端默认展示的模式
            "pc": "list"  //pc端默认展示的模式
        },
        "list_meta": {
            "dynamic_template": true,  //打开个性化的配置
            "hide_label": true,  //不显示label
            "content": {
                "top_left_area": [ // 左上可展示的字段
                    {
                        "key": "position_type",
                        "ng-class": "=function(data){let result; if(data.position_type===2){result='obj-blue'}else{result='obj-orange'};return result}", //根据数据的逻辑展示不同的样式，图中“兼职”/“主任职”的不同背景色是通过这个函数设置的
                        "class": "font-10 col-6 center radius-2 margin-2" // 此字段的固定展示样式
                    },
                    {
                        "key": "unit_id"
                    }
                ],
                "middle_left_area": [ // 中左展示的字段
                    {
                        "key": "department_id"
                    },
                    {
                        "key": "position_id"
                    }
                ],
                "top_right_area": [  //右上展示的字段
                    {
                        "key": "begin_date"
                    },
                    {
                        "key": "dev_separator",
                        "class": "space-2"
                    },
                    {
                        "key": "end_date"
                    }
                ]
            },
            "class": { // 总体样式设置
                "top_left_area": "font-16 color-black",
                "middle_left_area": "font-12 color-gray separate",
                "top_right_area": "font-12 color-gray"
            }
        }
    }

详细的可以参考平台的list页面配置的wiki：hc-list列表组件

2）时间线模式

pc 端：

mobile 端

 

配置示例：
"list_config": {
        "view_list": {
            "pc": ["detail"], //pc端可展示的模式
            "mobile": ["detail"]  //mobile端可展示的模式
        },
		"view": {
            "pc": "detail",  //pc端默认展示的模式
            "mobile": "detail"  //mobile端默认展示的模式
        },
        "detail_meta": {
            "class": "time-line", //设置为时间线模式
            "hide": {
                "body_label": true  // 隐藏主体内容的label
            },
            "header": [  // 头部（第一行）展示的内容
                {
                    "key_list": [   // 头部展示的字段列表，取自fields中
                        "begin_date",
                        "end_date"
                    ],
                    "class": "gray font-14",  // 头部展示字段的样式
                    "connector": "-"  // 字段之间的连接线为-
                }
            ],
"body": [  //主体部分展示的内容
{  
           "key": "resume" 
}],           
"tail": [  //主体部分展示的内容
{
                "key_list": [{
                        "key": "company_name"
                    },
                    {
                        "key": "department_name"
                    },
                    {
                        "key": "position_name"
                    }
                ]
            }]         }
    }

3）卡片模式

【1】无图模式

页面配置参考： 
list_config": {
		"view_list": {
            "pc": ["card"],
			"mobile":["card"]
        },
        "view": {
            "mobile": "card",
            "pc": "card"
        },
        "card_meta": {
            "hide_img": true,  //无图片模式
            "content": {
                "top_left_area": [ // 左上显示的内容
                    {
                        "class": "font-10 space-10 col-4 center radius-2 margin-2 obj-blue",
                        "key": "appellation"
                    },
                    {
                        "class": "font-14 space-0 col-6 margin-6",
                        "key": "name"
                    }
                ],
                "middle_left_area": [ 左中显示的内容
                    {
                        "key": "unit_job",
                        "class": "font-12 color-gray separate"
                    }
                ]
            },
            "dynamic_template": true, // 开启个性化list模式
            "hide_label": true,  // 隐藏label
            "class": "shadow-box"  // 卡片外部带阴影
        }
    },
【2】有图模式

页面配置参考： 
"list_config": {
		"view_list": {
            "pc": ["card"]
        },
        "view": {
            "mobile": "card",
            "pc": "card"
        },
        "card_meta": {
            "content": {
                "img": {
                    "key": "photo"
                },
                "top_right_area": [{
                        "class": "font-10 no-padding col-4 center radius-2 margin-2 ",
                        "ng-class": "=function(data){let result; if(data.relation==='2'){result='obj-blue'}else{result='obj-orange'};return result}",
                        "key": "relation"
                    },
                    {
                        "class": "font-14 no-padding col-6 margin-6",
                        "key": "name"
                    }
                ],
                "middle_right_area": [{
                    "class": "left space-3 font-12",
                    "key": "job_title"
                }]
            },
            "dynamic_template": true,
            "hide_label": true,
            "class": "shadow-box"
        }
    }

4、可配置的class总结

颜色class:

class

样式

obj-theme

obj-gray

obj-red

obj-green

obj-orange

obj-blue

high-light

color-blue

color-red

deep-gray

color-gray

gray

color-black

green-tab

orange-tab

red-tab

gary-tab

class

样式

line-through

font-bold

class

-后可填范围

font-
10，12，14，16，18（设置字体大小）
radius-
1～10px （设置圆角大小）
space-
0～30（设置左右宽度大小）

5、个人名片（二维码）

显示效果标号描述

PC:


mobile：







1

企业LOGO

在显示设置中上传的【企业Logo】可在这里显示

2

企业系统名称

在显示设置中上传的【企业系统名称】可在这里显示

3

名片展示内容（上）

在【对象管理器】中搜索Employee，打开【查看布局】，找到【Employee.meta.view.callingCard.json 】模版

在合并元数据中找到extend中key是top_fields的数据，list中的字段就是展示在标号3的位置的数据

如果想要新增字段，需要在fields中添加此字段，然后将字段的key值写到extend top_fields的list中

如果想要删除字段，可使用hide属性，hide属性支持function，可支持不同条件下的隐藏

如果想要改变现实字段的样式，可在对应字段的class中配置字段样式，可支持的样式见「可配置的class总结」

4

名片展示内容（下）

配置方式同【名片展示内容（上）】，在合并元数据中找到extend中key是bottom_fields的数据

5

人员照片

如果想要隐藏照片，在Employee.meta.view.callingCard.json 模版中给photo字段加meta_disabled:true

6

背景图片

在显示设置中上传的【移动端首页v3版背景图】可在这里显示

二、员工档案自助修改

2.1 配置审批流程

新版员工档案自助修改是分子集提交，可以满足不同科室对不同子集管理权限的细分，如家庭信息的审核权限归A科室，职称子集的审核权限归B科室，可扩展性更强。

1、初始化

在「人员信息集管理」中，找到“员工资料（本人查看）”，勾选要开放员工自助修改的子集，点击按钮“开放员工修改走审批”



执行之后，会在我的资料相应子集上自动生成一个“修改信息”的按钮；同时在流程设置中自动生成一个相应子集的审批流程，需要在该流程中自定义流转设置后发布

2、提交修改申请

在相应的子集，点击按钮“修改信息”，在弹出的页面上修改之后提交审批流程

3、流程审批

点击按钮“查看修改对比”，可弹出员工修改前和修改后的信息对比。

目前标准的修改按钮直接生成在我的资料里了，因为是流程表单，也支持单独发布成功能菜单。如：功能入口「联系信息自助修改」




2.2 子集修改直接生效

在相应子集列表点击【元数据配置】，配置“修改信息”按钮

注意：修改按钮强制识别了key不能是“edit”，所以把key改成“edit1”或者其他任何除了“edit”之外的自定义key都可以。新增、删除同理。


基本信息single样式只配置编辑按钮：
    "actions": [{
        "key": "edit1",
        "label": "修改",
        "action": "EDIT",
        "is_important": true
    }]
子集multi样式还需要配置新增和删除按钮：
 "actions": [{
            "key": "new1",
            "label": "新增",
            "action": "NEW",
            "icon": "icon-hcm-add-circle",
            "is_important": true
        },
        {
            "key": "edit1",
            "label": "编辑",
            "default": true,
            "action": "EDIT",
            "left": true,
            "condition": "ITEM"
        },
        {
            "key": "delete1",
            "label": "删除",
            "left": true,
            "action": "DELETE",
            "condition": "ITEM"
        }
    ]

2.3 基本信息修改部分字段直接生效、部分字段需要走审批

如果基本信息一部分走审批，一部分立即生效，说明他们是有不同的业务含义的，比如说籍贯信息修改要走审批，身份证信息修改不走审批。

那么可以发布2个功能入口，一个功能入口比如叫「籍贯信息修改申请」，一个功能入口比如叫「证件信息修改申请」

2.3.1 开启员工修改审批

1、在【人员信息集分配】-[员工资料(本人查看)]场景中，勾选[基本信息]子集，点击【更多操作】-【开放员工修改走审批】。

2、点击确定，会自动生成一条档案修改流程

2.3.2 档案修改流程配置

1、点击【系统设置】-【流程设置】，找到刚刚生成的流程（例如：档案修改-基本信息）

2、点击穿透，进行字段设置，选择【表单高级设置】-【可视化设置】（可批量勾选字段属性）

3、按照项目的要求自定义配置流转（适用范围+节点），并启用。

4、在流程【基本信息】中修改业务名称，便于业务区分。

5、发布流程

2.3.3 发布功能入口

1、自定义应用【籍贯信息修改】，参数中填写籍贯修改流程的业务id（业务id可在流程发布页面查看）

2、应用开通

3、找到功能入口，进行籍贯信息修改并提交流程

4、流程审批，可查看修改对比

5、[查看修改对比]中的字段可配置是否可见，在对象管理器中搜索该流程，点击查看布局，在元数据中对于不想展示的字段配置"meta_disabled":true

2.3.4 立即生效相关配置

1、在[流程设置]中，复制一条流程，作为【证件信息修改流程】：勾选刚刚生成的【籍贯信息修改】，点击【更多操作】-【基本导出】，然后再点击【基本导入】，完成复制。

2、导入的流程更改业务名称为【证件信息修改】，分别进行[字段设置]和[查看修改对比]的字段显示配置。

设置好[无人审批]流转，发布流程。

3、应用开通

【系统设置】-【自定义应用】中，勾选[籍贯信息修改]，选择【更多操作】-【应用复制】

找到[籍贯信息修改]，点击确定

更改应用名称，配置参数（业务id可在流程发布页面查看）

在【应用开通管理】中，找到[证件信息修改]，进行应用开通

4、修改证件信息

找到功能入口【证件信息修改】，维护相关信息后，点击提交

5、无需走审批，立即生效

以上，就可以实现【基本信息】中[籍贯信息]走审批、[证件信息]立即生效啦

（以上方案也适用于 当基本信息的不同的字段走不同的审批流程）

  • 无标签