# E10通过千里聆RPA单点登录EM7客户端配置示例

来源快照：`result_data_new_260518.json`

- 来源 ID：`1175517718538387494`
- 模块：集成中心
- 目录：集成登录 - 配置示例 - 集成登录-千里聆RPA套件
- space ID：`1158011075224911873`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、功能介绍

**10.0.2506.01基线开始支持千里聆RPA套件。**

本文档结合千里聆RPA单点登录插件实现E10系统的单点登录EM7客户端功能。

# 二、功能概述以及使用说明

## 1、千里聆RPA系统操作

千里聆RPA插件配置说明请参考：

[ _https://help.qianliling.com/#/HelpCenter/UsingHelp/DocTree?openKeys=f9e03e25aa13866f0c0c58014c03aad4 &type=pc_](https://help.qianliling.com/#/HelpCenter/UsingHelp/DocTree?openKeys=f9e03e25aa13866f0c0c58014c03aad4&type=pc)

### 1.1、申请千里聆RPA插件授权

需根据E10系统的license授权码信息，申请千里聆RPA插件授权。

先登录E10主团队系统管理员账号在后台管理中心->【基本设置】->【授权信息】->【系统授权信息】处的标识码：

c94a2834d70cc955efe4be7e33e6577259ce4d7d7684f3e758240423988287a1

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601029717483524&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

根据授权标识码，提交千里聆单点登录插件机器人的license文件：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601055449120773&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 1.2、注册单点登录插件机器人

根据1.1中获取的E10系统授权标识码值，点击“添加插件”按钮注册单点登录机器人。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601201449066502&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601218578604058&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 1.3、添加单点登录系统

点击插件机器人配置按钮，根据EM7页面元素配置登录登录步骤：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601244298076160&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击添加系统按钮，开始配置E-Mobile的登录步骤：

**注：以下配置中的EXE名称、所有元素XPath路径仅适用EMobile7客户端，其他客户端请咨询千里聆RPA技术人员协助获取。**

单点登录系统名称：需与安装软件名称一致，此处配置：E-Mobile

系统类型：选择“桌面应用”

桌面软件Exe名称：E-Mobile.exe

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601291672322050&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**登录步骤1：输入账号**

账号输入框元素Xpath：

/PaneControl[@name='E-Mobile']//EditControl[@name='登录名']

输入值：#account#

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601313160159242&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**登录步骤2：输入密码**

密码输入框元素Xpath：

/PaneControl[@name='E-Mobile']//EditControl[@name='登录密码']

输入值：#password#

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601334601441280&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**登录步骤3：输入验证码**

验证码类型需根据实际设置选择。

验证码全图Xpath：

/PaneControl[@name='E-Mobile']/DocumentControl[@name='E-Mobile']/PaneControl/DocumentControl/ImageControl[7]

验证码操作XPath：

/PaneControl[@name='E-Mobile']//EditControl[@name='请输入验证码']

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601356151775234&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**登录步骤4：点击登录按钮**

登录按钮元素Xpath：

/PaneControl[@name='E-Mobile']//ButtonControl[@name='登 录']

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601381765971972&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击确定按钮，提示添加成功，即可在单点登录系统列表获取对应编号值，该编号即为**单点登录系统编号（serial）** 参数值：w72igxcs。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601403262197762&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**注：若需要输入验证码，需先授权验证码平台，输入验证码平台的账号密码，点击保存后生效。**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601433339133956&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 1.4、下载RPA单点登录插件，提供给用户注册并安装

完成上述配置后，点击插件机器人的“下载”按钮，下载RPA插件，下载好后，会得到plugin.zip压缩包。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601454755250183&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

解压缩plugin.zip后进行以下操作即可：

1、

关闭 Chrome 浏览器。

2、

双击运行解压目录中的 single_login_{version}_win.exe。

3、

按安装向导完成安装（如果出现 UAC 提示，选择允许）。

4、

安装完成后，重新打开 Chrome。

根据实际系统自定义路径：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601506475630594&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击开始安装，安装加载中

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235601527903911939&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

显示上述页面表示安装完成，打开Chrome后，按以下两步逐项检查：

1、在 Chrome → 扩展程序（chrome://extensions）中，能看到单点登录扩展插件。

2、打开“任务管理器”→“详细信息”选项卡，能找到进程名：

Q_E-RPA_chrome_driver.exe。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235602369600061443&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235602412571123719&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

满足上述两项即认为安装成功。

**手动安装或更新（当自动安装失败或需更新插件）**

适用于：之前手动移除过插件、自动安装无法复原、或要安装新版插件。 步骤：

1、

双击运行 single_login_{version}_win.exe（此步骤会把config.json放到安装目录，注册相关注册表）。

2、

打开 Chrome，访问：chrome://extensions，开启“开发者模式”。

3、

找到 single_login_{version}_win.exe 的安装目录，找到 loginPlugin.crx。

4、

将 `loginPlugin.crx` 拖拽到 `chrome://extensions` 页面并确认添加。

5、

重启 Chrome 并按“安装验证”步骤检查是否生效。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235602687398699012&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

## 2、E10系统功能入口

配置新建集成登录千里聆RPA，点击页面的新建按钮，选择千里聆RPA套件即可。

【集成登录】-【集成登录设置】-【千里聆RPA】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603013803212806&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

需要集成登录权限：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1175517800196300812&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 3、配置说明

### 3.1、千里聆RPA套件

套件参数从 _1.1、申请千里聆RPA插件授权_ 、 _1.3、添加单点登录系统_ 中获取。

系统识别码(systemCode)：E10系统识别码值

c94a2834d70cc955efe4be7e33e6577259ce4d7d7684f3e758240423988287a1

单点登录系统配置编号(serial)：千里聆单点登录插件中注册的单点登录系统编号值

w72igxcs

点击套件进行新建：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603048384839684&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

详细配置：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603095647084550&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

配置说明：

外网地址：固定为 /sp/intlogin/rparesultpage；

自定义参数：

默认参数account（单点账号）、password（单点密码）

account单点账号为手机号，配置用户参数-手机号；

password单点密码为用户登录密码，配置用户参数-登录密码。

 

### 3.2、共享范围

需要在共享范围内设置，哪些人员能够通过集成登录实现对EM7客户端的单点登录。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603138538037258&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 3.3、维护每个人的手机号

account若设置用户参数-手机号，需要到人力卡片手机字段维护正确的手机号。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603168547864577&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.4、门户集成登录组件

按照实际需要选择是否配置

【后端管理中心】-【门户】-【设计】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603198695317510&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

模块组件中搜索“集成登录”可添加集成登录组件。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603215724191745&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

设置后，有权限人员在门户中可展示集成登录组件，点击应用可直接单点千里聆RPA。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603237133123592&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 3.5、构建应用

按照实际需要选择是否配置。

【后端管理中心】-【应用管理】-【构建应用】

可配置菜单，菜单中集成登录可选择已配置的集成登录。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603258846625797&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

可配置单页面内容， URL地址配置集成登录的单点登录地址。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603275960213508&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

集成登录的单点登录地址可通过集成登录里面【更多】-【单点登录地址】进行复制。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603297370513418&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

最终效果，有权限人员在应用中可点击应用单点登录唤醒千里聆RPA插件，实现单点登录EM7客户端。

## 4、单点登录效果

### 4.1、前提条件

务必确保每个客户端均已安装千里聆插件、EM7客户端工具，且桌面上有EM7客户端图标。

①需确保谷歌浏览器已有单点登录扩展程序，导入方式请参考 _1.4、下载RPA单点登录插件_

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603335958110213&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②桌面有E-Mobile客户端、谷歌浏览器快捷方式

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603400514265100&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603430578208774&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**注：目前千里聆插件针对谷歌浏览器兼容性较好，故建议在谷歌浏览器登录E10系统进行单点登录。**

 

### 4.2、点击门户元素或构建应用菜单，跳转进行单点登录

本文档以点击集成登录元素为例：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603593661964294&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击元素后，会先跳转到下述提示页面，等待插件唤醒EM7客户端：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603628189474818&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

RPA机器人会将E10系统传入的用户信息代填到EM7客户端的账号密码输入框、RPA机器人填写验证码后点击登录按钮，完成登录：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603653736562691&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603679523143683&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

单点登录成功，进入客户端登录后页面，同时关闭提示页面，重新回到门户页面。

单点登录效果：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603705506447367&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

# 三、上下游关联功能点

集成登录-千里聆RPA套件功能介绍说明文档请参考：

[https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1175514677751873561&freepass_doc=1&space_id=1158011075224911873](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1175514677751873561&freepass_doc=1&space_id=1158011075224911873)

# 四、常见问题

## 问题1：集成登录单点登录提示单点登录成功，但是未打开客户端

集成登录单点登录时，跳转到了“单点成功”现象如下：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235603842807398410&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**问题原因** ：RPA单点登录插件未唤醒客户端；

**解决方案** ：请按照下述步骤检查配置：

①前往RPA插件检查EXE文件配置是否正确，配置说明参考1.3、添加单点登录系统；  
②检查是否已导入RPA插件，配置步骤参考1.4、下载RPA单点登录插件，提供给用户注册并安装；

③若以上配置均无问题，请联系**千里聆****RPA****技术人员** 协助排查。
