集成配置 ​

网页/工作台集成易点易动 ​

设置步骤 ​

在网页或APP的工作台中增加易点易动应用的入口，步骤如下：

1）根据当前登录的员工信息生成令牌

根据单点登录文档中的JWT算法，将当前登录员工的工号或手机号生成令牌。

这里需要注意设置令牌的过期时间，建议8小时后过期，既保证便利性，又保证安全性

2）将令牌附加到链接地址中作为易点易动应用链接地址

将生成的令牌作为token参数的值，附加到易点易动回调端点，作为易点易动的应用的入口链接。你可以使用platform参数传递标识符，指定易点易动应用跳转到哪个客户端，标识符支持两种类型，包括：

标识符描述
PC_ADMINPC端
MOBILE_ADMIN手机端

生成的入口链接示例：

http
https://oauth.yideamobile.com/sso/****/simple/login?token={令牌}&platform=MOBILE_EMPLOYEE

3）在工作台中添加易点易动应用链接地址

将上面的入口链接地址集成到您系统的工作台中，通过该链接进入易点易动应用。

建议每次进入工作台页面时重新生成入口链接中的令牌，确保其不失效。

示例代码 ​

Java Spring Boot完整示例代码下载

Python Flask完整示例代码下载

运行项目后，进入/idp/workplace页面，该页面列举了PC管理员端、PC员工端、手机管理员端和手机员工端四种链接。

手机APP集成易点易动 ​

将易点易动的移动端（H5)集成到您的的手机APP中，需要做一些与H5交互的改造工作，用于H5页面的扫码和定位功能。

H5与APP的交互约定如下：

  • 扫码功能

JS调用APP扫码功能

json
// Android
window.EmployeClientJS.scanBarcode();

// iOS
window.webkit.messageHandlers.scanBarcode.postMessage(null);

APP扫码完成回调JS

json
window.scanBarcodeResult(code);
  • 定位功能

JS调用APP定位功能

json
// Android
window.EmployeClientJS.getLocation();
            
// iOS
window.webkit.messageHandlers.getLocation.postMessage(null);

APP定位完成回调JS

json
window.getLocationResult(lat, lng);