通用

升级内容 1：【短信签名】-增加报备必填字段

业务场景&问题：

【签名报备接口-升级通知】

• 1、签名报备接口“添加报备签名”和“修改报备签名”方法新增了经办人手机号、法人手机号、文件类型3个字段；经办人手机号和法人手机号随身份证号码一起填写，必填（不填写无法通过审核）

• 2、签名报备接口“查询报备签名”方法返回参数新增了经办人手机号、法人手机号2个字段；

• 3、具体详见接口文档: https://help.dahantc.com/docs/oss/oss-1g79imj5s7slp

• 请及时参照最新的接口文档更新接口调用方法，以免影响使用。老版本兼容时间截止下周五（6.20）前，6月23日起未提交手机号码和未按要求分类上传文件的请求将被拦截或驳回

解决方案：

【设置-公共设置-通知模板-短信签名管理】

字段变更：

签名报备状态为【审核通过、已在其他渠道报备】时，及时在用也支持编辑，可以调用修改进行报备

PS：由于电信运营商的合规要求升高，虽然当前已报备的无需补充资料，未来不好说，这次一并放开

权限

升级内容 1：法人公司支持按权限获取--一期

业务场景&问题：

客户有300家法人公司，不同区域的HR负责的法人公司不一致，希望在签署合同时，可以按权限选择法人公司

解决方案：

【设置-账号权限-账号管理】

• 新增【组织字段可选范围】

• 本期仅增加法人公司

  • 【可选择全部法人公司】默认选项

  • 【仅可以选择权限范围内法人公司】，可选选项

提示：【可选择员工所有角色下法人公司的并集】

影响范围：仅罗列一期的影响范围

• 法人公司权限

  • 读取登录账号下所有角色下法人公司的数据并集，若无则返回空

【影响范围】

人事列表、合同页面/导入、入职列表、入职表单、审批表单、BI报表

https://wiki.mokahr.com/pages/viewpage.action?pageId=201950593

BI 报表

升级内容 1：自定义实体支持设置管理员

业务场景&问题：

• 自定义实体的信息需要多人一起维护

• 自定义实体的创建人离职后无人能继续管理相关数据，只能新建实体

解决方案：

1. 自定义实体添加和编辑时，支持设置协作人（协作人会根据数据源管理功能权限过滤）

2. 协作人在协作给我的列表中可以选择对应实体进行数据的替换和追加

升级内容 2：自定义实体支持外部接口回写

业务场景&问题：

• 自定义实体仅支持上传不支持通过接口回写

解决方案：

• 新增实体ID，实体编辑查看时，显示实体ID，只读不允许编辑

【入参】

请求参数（以下内容是接口规范主要应用于鉴权，无需业务开发）：

请求body（业务接口查询参数，需要开发）

【查写入逻辑】

追加数据，在现有实体中增加相关数据

替换数据，删除现有实体中的数据，然后增加接口数据

【参与校验】

【出参】

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 的签署区属性），这个是一次性的

  • 升级后签署区字符变长，可能导致排版变化，请检查所有签署区附近的格式是否符合预期

• 若不完成升级，由于系统无法区分哪个签署区是哪个，导致任意修改模板后，依旧需要重新设置电子签

升级内容 2：编辑文件模板时支持选择签署人预览

业务场景&问题：

• 由于电子签对文件的格式比较敏感，客户在配置完文件模板后，会去前台实际发起一个电子签，通过预览看格式是否符合要求，若有问题再返回修改文件模板，这样操作链路导致配置文件模板效率低下

解决方案：

• 支持在配置文件模板时，选择签署人进行预览，预览时与实际发起签署的效果类似：

  • 会填充被选的签署人的信息：

    • 填充信息时，会做「字段权限」过滤，若当前操作人没有对应的字段权限，将不会填充对应字段的值，可以手动输入

  • 完成字段填写后，可以预览签署文件

• 需要注意：若编辑文件时增加了新的「企业签署区」或未授权的「XX签署区」变量，则需要先完成电子签设置后才可以预览