OpenPortal认证计费系统-用户手册 · 定制功能
适用系统:OpenPortalServer V6 后台 — 定制功能
手册说明:本文所有截图取自系统实际界面并按页面原样展示(未做任何遮挡),实际参数以生产环境为准。
一、模块概述
本模块是按客户需求定制的对接能力,当前包含两项:
| 功能 | 页面地址 | 用途 |
|---|---|---|
| 联通接口设置 | /zsqhdapiunicom/config.action | 配置与联通侧平台对接所需的密钥与提示文案 |
| DrCom 用户导入管理 | /zsqhdapiunicomdrcomread/list.action | 查看每次批量导入的结果与失败原因 |
| DrCom 用户导入 | /zsqhdapiunicomdrcomread/in.action | 用 Excel 批量导入 DrCom 用户 |
定制功能随客户开通,未开通的环境不会在菜单中出现。参数取值请以对接方提供的技术文档为准,不要自行猜测填写。
二、联通接口设置
2.1 页面说明
页面提示「本页面为联通接口设置页面!」,下方为参数表单,底部为「保存」按钮。
2.2 参数说明
| 参数 | 填写说明 |
|---|---|
| 联通密钥 | 由联通侧提供,用于接口调用的身份校验 |
| 绑定接口 | 下拉选择,控制绑定类接口是否启用;默认「关闭」 |
| 绑定密钥 | 绑定接口开启时使用,由联通侧提供 |
| 账户不存在 | 当联通侧返回「账户不存在」时,展示给用户的提示文案 |
| 账户已锁定 | 当联通侧返回「账户已锁定」时,展示给用户的提示文案 |
2.3 操作步骤
- 向联通对接方获取密钥与各项参数。
- 逐项填入对应输入框。
- 需要启用绑定接口时,把「绑定接口」改为开启,并填写「绑定密钥」。
- 点击「保存」。
2.4 注意事项
- 未确认对接完成前,「绑定接口」保持「关闭」,避免影响现有用户的认证。
- 密钥属于敏感信息,对外分享手册前请自行确认;本手册截图按页面原样展示,未做遮挡。
- 「账户不存在」「账户已锁定」是展示给最终用户看的文字,建议使用通俗表述。
- 修改后请用一个真实账号走一次认证,确认提示正常。
三、DrCom 用户导入管理
用于查看历史导入批次的结果,定位导入失败的原因。
3.1 查询条件
| 条件 | 说明 |
|---|---|
| 管理员 | 执行导入的操作员账号 |
| 批次 | 每次导入生成一个批次标识,可凭此筛选某一批 |
| 学籍号 | 按学籍号检索 |
| 证件号 | 按证件号检索 |
| 失败原因 | 仅查看失败记录时使用 |
3.2 列表字段
| 列 | 说明 |
|---|---|
| 编号 | 序号 |
| 批次 | 该条记录所属的导入批次 |
| 学籍号 | 用户学籍号 |
| 证件号 | 用户证件号码 |
| 失败原因 | 成功时为空;失败时显示具体原因 |
| 管理员 | 执行该次导入的操作员 |
| 操作 | 该行的可用操作 |
3.3 操作按钮
| 按钮 | 作用 | 说明 |
|---|---|---|
| DrCom 用户导入 | 跳转到导入页 | 等同于进入「DrCom 用户导入」 |
| 查询 | 按条件检索 | 常用操作 |
| 刷新 | 重新加载列表 | 不改变查询条件 |
| 删除勾选 | 删除勾选的行 | 需先勾选左侧复选框 |
| 删除全部 | 清空当前列表记录 | 不可恢复,执行前确认已备份需要的数据 |
3.4 使用步骤
- 完成一次导入后进入本页,在「批次」中填入刚生成的批次号查询。
- 重点看「失败原因」列,逐条判断是数据问题还是系统问题。
- 修正数据后重新导入。
- 需要清理历史记录时,勾选用不到的记录点「删除勾选」。
3.5 注意事项
- 本页只记录导入结果,删除记录不会影响已经导入成功的用户账号。
- 「删除全部」会清空当前全部导入记录,操作前务必确认。
- 失败原因中若出现账号已存在、格式不符等提示,属数据问题,修正源文件即可。
四、DrCom 用户导入
4.1 操作步骤
- 点击页面中的「模板下载」(或「请点这里」下载地址),取得标准模板。
- 严格按模板表头填写,不要增删列或改动表头文字。
- 点击「选择文件」,选中填好的 Excel。
- 点击「提交」。
- 提交后会自动进入「DrCom 用户导入结果」页面,查看本批次的导入统计与失败明细。
4.2 注意事项
- 文件必须是 Excel 格式,其他格式无法识别。
- 一次导入的数据量较大时,请分批提交,便于定位失败记录。
- 导入前先在「DrCom 用户导入管理」中确认是否已存在相同学籍号,避免重复。
五、常见问题
| 现象 | 原因与处理 |
|---|---|
| 菜单里找不到本模块 | 定制功能未开通,请联系管理员确认授权 |
| 保存联通接口设置后认证异常 | 检查密钥是否与联通侧一致;不确定时先把「绑定接口」改回「关闭」 |
| 用户看到「账户不存在」提示 | 说明联通侧无此账号,按其业务规则补开或更换账号 |
| 用户看到「账户已锁定」提示 | 说明账号在联通侧被锁定,需联通侧解锁 |
| 导入后全部失败 | 模板表头被改动或文件格式不对,重新下载模板填写 |
| 导入结果页查不到刚导入的批次 | 确认「批次」是否填对;或用「管理员 + 时间」大致筛选后翻页查找 |


