通用
升级内容 1:【短信签名】-增加报备必填字段
业务场景&问题:
【签名报备接口-升级通知】
1、签名报备接口“添加报备签名”和“修改报备签名”方法新增了经办人手机号、法人手机号、文件类型3个字段;经办人手机号和法人手机号随身份证号码一起填写,必填(不填写无法通过审核)
2、签名报备接口“查询报备签名”方法返回参数新增了经办人手机号、法人手机号2个字段;
3、具体详见接口文档: https://help.dahantc.com/docs/oss/oss-1g79imj5s7slp
请及时参照最新的接口文档更新接口调用方法,以免影响使用。老版本兼容时间截止下周五(6.20)前,6月23日起未提交手机号码和未按要求分类上传文件的请求将被拦截或驳回
解决方案:
【设置-公共设置-通知模板-短信签名管理】
字段变更:
字段名称 | 字段类型 | 是否必填 | 提示文案 | 校验规则 |
法人姓名 (新增) | 文本,最长50个字符 | 否 | 请输入 | |
法人证件号码 (新增) | 文本 | 否 | 请输入法人身份证号码 | |
法人电话 (新增) | 文本 | 是 | 请输入法人电话号码 | |
经办人姓名 | 文本,最长50个字符 | 是 | 请输入 | |
经办人证件号码 | 文本 | 是 | 请输入经办人身份证号码 | 不能与法人证件号码一致 |
经办人号码 (新增) | 文本 | 是 | 请输入经办人电话号码 | 不能与法人电话号码一致 |
签名报备状态为【审核通过、已在其他渠道报备】时,及时在用也支持编辑,可以调用修改进行报备
PS:由于电信运营商的合规要求升高,虽然当前已报备的无需补充资料,未来不好说,这次一并放开
权限
升级内容 1:法人公司支持按权限获取--一期
业务场景&问题:
客户有300家法人公司,不同区域的HR负责的法人公司不一致,希望在签署合同时,可以按权限选择法人公司
解决方案:
【设置-账号权限-账号管理】
新增【组织字段可选范围】
本期仅增加法人公司
【可选择全部法人公司】默认选项
【仅可以选择权限范围内法人公司】,可选选项
提示:【可选择员工所有角色下法人公司的并集】
影响范围:仅罗列一期的影响范围
法人公司权限
读取登录账号下所有角色下法人公司的数据并集,若无则返回空
【影响范围】
人事列表、合同页面/导入、入职列表、入职表单、审批表单、BI报表
https://wiki.mokahr.com/pages/viewpage.action?pageId=201950593
BI 报表
升级内容 1:自定义实体支持设置管理员
业务场景&问题:
自定义实体的信息需要多人一起维护
自定义实体的创建人离职后无人能继续管理相关数据,只能新建实体
解决方案:
自定义实体添加和编辑时,支持设置协作人(协作人会根据数据源管理功能权限过滤)
协作人在协作给我的列表中可以选择对应实体进行数据的替换和追加
升级内容 2:PP预置数据源和报表
业务场景&问题:
部分实体的字段缺失或者逻辑不合理导致一些报表难以配置,例如:缺失异动字段变更记录,想要统计员工职级停用时长,目前无法实现
实体过于原子化,导致报表配置成本较高,上手难度高,例如:异动明细表,需要创建数据源关联两次异动记录,再展示异动前信息和异动后信息
预置报表不足,且没有使用手册,无法参考,导致报表配置的效率较低,例如:平均在职人数、离职率等常用指标的统计
解决方案:
【数据源】
数据源 | 数据源说明 |
时点花名册 | |
出勤月统计数据源 | |
时点薪资档案数据源 | |
发薪成本分摊数据源 | |
审批数据源 |
【内置报表】
最终预置报表清单:People内置报表和看板.able
模块 | 数据源说明 |
人事 | |
假勤 | |
薪酬 | |
审批数据源 |
升级内容 3:自定义实体支持外部接口回写
业务场景&问题:
自定义实体仅支持上传不支持通过接口回写
解决方案:
新增实体ID,实体编辑查看时,显示实体ID,只读不允许编辑
【入参】
请求参数(以下内容是接口规范主要应用于鉴权,无需业务开发):
字段 | 字段类型 | 是否必填 | 请求方式 | 说明 |
entCode | string | 是 | url中拼接param | 租户编码 |
apiCode | string | 是 | url中拼接param | 接口编码 |
sign | string | 是 | url中拼接param | 电子签名 |
timestamp | long | 是 | url中拼接param | 时间戳,单位:毫秒 |
nonce | string | 是 | url中拼接param | 随机数 |
请求body(业务接口查询参数,需要开发)
字段 | 字段类型 | 是否必填 | 说明 |
└recordId | string | 是 | 实体ID |
└insertType | string | 是 | 数据写入类型 1:追加数据 2:替换数据 |
└data | Json | 是 | 数据明细 |
└└fields | Json | 是 | 字段明细 |
└└└fieldName | string | 是 | 字段名称 |
└└└fieldValue | string | 是 | 字段的值 |
【查写入逻辑】
追加数据,在现有实体中增加相关数据
替换数据,删除现有实体中的数据,然后增加接口数据
【参与校验】
错误校验逻辑 | 错误编码 | 错误提示 |
recordId是否填写 | 400 | recordId 实体Id未填写 |
recordId是否存在 | 400 | recordId 实体Id不存在 |
insertType是否填写 | 400 | insertType 数据写入类型未填写 |
insertType是否存在 | 400 | insertType 数据写入类型不存在 |
fieldName是否存在 | 400 | fieldName 第X行,字段名称不存在 |
fieldValues是否有值 | 400 | fieldValues 第X行,XXX(字段名称)的值为空 |
【出参】
字段名称 | 字段类型 | 描述 | 备注 |
data | object | ||
└code | String | 返回结果的状态码 | |
└msg | String | 返回结果的状态信息 |
IM 对接
升级内容 1:创建钉钉企业账号时支持指定 UserID
业务场景&问题:
员工确认入职创建企业账号后,userid是随机的,导致下游生产系统根据userid匹配数据匹配失败。客户期望入职以工号作为企业账号userid进行创建。
解决方案:
如下图,在对接钉钉时,如需对接钉钉的企业账号,新增「钉钉账号 UserID」规则,可配置通过 People 系统自动创建的钉钉企业账号,是否要指定钉钉的 UserID。如需指定,可选以下唯一标识之一作为 UserID:
工号
手机号
个人邮箱
考虑到 UserID 在创建账号后不可修改,建议使用「工号」,其不会轻易变化使用更稳定
需要注意:
该配置仅影响通过 People 系统自动创建的企业账号(即完成对接后新入职的员工),已有账号不受影响
配置后,也可以再度修改该配置,修改后仅影响修改之后创建的新账号,已有账号不受影响
钉钉自建企业账号或者 SSO 账号均支持该能力
文件模板
升级内容 1:修改文件模板后需重新设置电子签优化
业务场景&问题:
当前如果修改了模板内容,需要重新设置电子签,有时候客户只是简单改了下,但也需要重复操作,导致效率低下
核心问题:当前文件模板中,「XX签署区」类变量,是一个纯文本串 {XX签署区} 插入至 Word,系统并不知道哪个签章对应哪个设置(如下图 2),导致修改了模板后,只能重新电子签以避免错误
解决方案:
对于签署区类变量,插入的变量后新增 ID,如下图中 # 后即为该签章的 ID,ID 在该文件内唯一
当修改模板内容时,若本次修改未增加新的「企业签署区」或未授权的「XX签署区」变量,则修改后无需重新设置电子签:
除签署区类变量外,若本次也未增加任何其他字段,则可以直接成功保存模板,并无需重新设置电子签
若本次新增了其他字段,则保存文件模板时,会弹窗让用户选择新字段是否必填,如下图,确定后同样可以成功保存模板,无需重新设置电子签
当修改模板内容时,若本次修改增加了新的「企业签署区」或未授权的「XX签署区」变量,则需要重新设置电子签,因为需设置新的「企业签署区」或未授权的「XX签署区」变量的属性,如下图,但原有其他签署区的设置会得以保留:
需要注意:由于历史模板插入的签署区变量没有 ID,导致无法使用上面的新能力,系统开放一键升级的能力,可以一键对旧变量插入 ID,建议升级:
升级后需要重新设置一遍电子签(这样才能保存对应 ID 的签署区属性),这个是一次性的
升级后签署区字符变长,可能导致排版变化,请检查所有签署区附近的格式是否符合预期
若不完成升级,由于系统无法区分哪个签署区是哪个,导致任意修改模板后,依旧需要重新设置电子签