【开放平台】如何进行数据自动对接？ – 掌知识

1、什么是数据自动对接？

为提高企业的工作效率，掌知识提供了数据自动对接的开放平台，即将企业内部管理系统中的相应数据自动对接到掌知识平台中。

例如：今天工厂有30个员工入职，5个员工离职，如果进行数据自动对接后，这些信息只需在企业内部的管理系统中进行录入与删除操作，这些操作便会自动同步更新到掌知识平台中，无需重复导入与删除。

再比如：员工的考勤，人事部门每天都需将员工的考勤数据录入企业内部系统，如果与掌知识进行数据自动对接后，这些数据也会自动同步更新到掌知识中，员工便可非常方便地登录手机掌知识查询自己的考勤。

Tips：哪些模块需要进行数据对接？

一般建议：

2、数据自动对接有什么好处？

进行数据自动对接的两大好处：

人事部门每天都有很多重要的事情需要处理，进行数据自动对接后，就无进行需重复的上传、删除等操作，也不会因为忙碌而忘记上传，将自己解放出来，将精力集中在更重要的事情上。

如果选择手动上传，不仅自己每天工作量增多，而且经常会因为忙而上传不及时，这时就会有员工来咨询。选择数据自动对接后，完全不用担心这个问题，可以说一劳永逸。

3、进行数据自动对接安全吗？

数据自动对接相较于手动对接来说更安全、更准确，因为整个过程减少了人为的干预，都是系统自动处理的，所以不用担心数据外泄等安全问题。
此外，微邦已于2018年10月份取得了信息安全管理体系认证证书（见文末附录），在此前及以后，微邦都一直谨遵与客户之间的保密协议，确保客户在掌知识上的所有数据处于安全状态，而且至此，也从未发生过数据安全事件。
如果还不放心，人事部门可以在信息查询的模块设置双重密码，只有相关负责人自己可以看到，其余人都看不到。

4、如何进行数据自动对接

进行数据自动对接主要是IT工作人员的工作，人事部门只需要做两件事情：

第一步：在掌知识后台的系统管理中点击开放平台，进入后确保数据对接的按钮是开启的状态，然后添加密钥，密钥是对接时需要用到的参数，人事需自己设置好，然后告知IT人员。

第二步：和IT部门进行沟通。

为了方便您与IT部门进行沟通，我们专门准备了一份技术文档，您只需将这份文档发给IT相关负责人即可。该文档包含：数据自动对接的方法、对接过程常见的问题等等（点击下方链接查看文档）。

关于掌知识自动化数据对接，我们提供了三种方法，人事可与IT进行沟通，然后根据企业自身具体情况进行选择。

方法一：Open API

企业IT工程师使用基于HTTPS协议的API实现数据对接的自动化。该方法具备较高的通用性、灵活性；不受系统类型、开发语言等客观条件的限制。

方法二：SDK

针对有常规开发能力的企业，使用掌知识官方提供的.NET版或Java版SDK，简化了调用API的开发过程，可快速开发自动化数据对接。

方法三：Tool

基于Windows系统的数据对接小工具，直连HR数据库，配置简单的SQL脚本即可完成员工数据的自动对接。（支持：SQLServer/MySQL/ Oracle）

其中方法一和方法二适用于有一定开发能力的企业，而方法三是利用工具，相对来说比较简单，但目前只支持对接用户数据（即创建员工账号），不支持对接查询数据（即薪资、考勤等模块）。

注意事项（人事与IT均须阅读）：

请IT相关人员务必仔细阅读上面的技术文档，里面涵盖了目前所遇到的所有问题的解决办法。
薪资、考勤这些个人信息数据在自动对接前，人事部门需先在掌知识后台创建相应模块。创建时可根据自己的实际情况选择相应的模板（每个模板都有示例和解释）。
对接时需要用到的参数： 账号（corpId）和密钥（secret），人事可以在后台直接获取然后告知IT。具体方法：在掌知识后台>系统管理>开放平台 中查看（如下图），关于密钥，需人事自己添加。

在对接用户数据（即创建员工账号）时，员工号、密码、在职状态、入职日期、姓名为必填字段，不可为空，即自动对接时必须抓取这些信息。
用户信息，在未激活前（即员工登录掌知识前）可在后台手动删除，激活后暂不支持删除用户信息。
已离职员工数据，除在职状态和离职日期列，其余数据不可变更。
更新用户数据时，系统只会更新以下几个字段：状态、厂别、部门、入职日期、离职日期、职位、劳动类型。其余字段如姓名、工号、性别等无法更新。如需更新，需在后台手动更新。
密码仅限于创建用户（更新用户时，并不能修改用户密码）。
对接查询数据（即薪资、考勤等）时，上传的文件有格式和大小限制，如下：文件大小上限: 20MB，仅支持csv或者zip格式，英文逗号(,)分隔符。对于网速较慢或者数据量较大的文件，建议使用zip压缩后再上传，以免出现网络超时。
如果在对接过程出现文档中没有包含的问题，可直接联系微邦IT负责人。请记得在调用我们接口时记录相应log，以便快速排查问题。

附录~