web后台
商城有一部分管理动作在网页侧做。这个菜单项不是客户端里的一个窗口,而是一个跳转入口:点一下,客户端取好免登录票据、拼出后台地址,再调本机浏览器最大化打开,落到网页后台时已经是登录状态,不用再输一次账号密码。
功能路径:系统菜单 → O2O业务 → 微信商城 → web后台
一、功能概述
1. 解决什么问题
- 少一次登录:客户端已经登录过账套,跳网页后台时把身份票据带过去,不用在浏览器里再登一遍;
- 少一次找地址:后台地址由实施统一配置,操作员不需要记网址,也不会因为手输地址进错环境;
- 浏览器就地打开:用本机已装的浏览器打开,页面最大化,不嵌在客户端里。
2. 它不是一个客户端窗口
点这个菜单不会在 ERP 里出现新窗体,客户端只做「取票据 → 拼地址 → 调浏览器」三件事。打开之后的页面、菜单与操作都在网页侧,客户端不再参与。
二、点击后发生什么
1. 浏览器选择顺序
| 顺序 | 浏览器 | 说明 |
|---|---|---|
| 1 | Chrome | 先按常见安装路径找,找不到再查系统注册的应用路径 |
| 2 | Edge | Chrome 不存在时按同样方式找 Edge |
| 3 | 系统默认浏览器 | 两者都没找到时,交给系统按默认浏览器打开 |
三种方式都以最大化方式打开页面。
2. 免登录票据
客户端在打开前依次取三样东西:ERP 服务端的接口票据、网页服务端的接口票据、当前客户标识。三样都取到后拼在后台地址后面一起带过去,网页侧据此识别身份。票据由客户端实时获取,不需要操作员填写,也不要手工复制转发给他人。
三、业务操作步骤
步骤 1:点菜单
系统菜单 → O2O业务 → 微信商城 → web后台。客户端开始取票据,这一步没有进度窗口,正常时几乎立刻弹出浏览器。
步骤 2:在浏览器里继续操作
浏览器最大化打开后台页面,身份已带入,直接按网页侧的菜单继续做商城管理。网页端 O2O 各页面的说明见 O2O业务总览。
步骤 3:弹提示时按原文排查
取票据或取地址失败时,客户端弹出提示并不再打开浏览器。提示原文与对应处理见第七节。
四、地址与票据的来源
后台地址
地址模板按两级取,取到即用:
| 优先级 | 来源 | 说明 |
|---|---|---|
| 1 | 客户端本机 INI 配置 [Srv] 节的 WebBackgroundUrlTpl | 本机配了就用本机的,便于实施期临时指向测试环境 |
| 2 | 服务端选项 WebBackground 下的 UrlTpl | 本机没配时向服务端取,全账套统一 |
两处都取不到时弹「获取web后台url模板失败」。地址由实施人员配置,操作员不需要也不应该自行改动。
票据
三类凭据都由客户端向对应服务实时申请,任一为空即中止跳转并弹提示。凭据属敏感信息,本文不涉及具体取值。
五、典型使用场景
场景 1:客户端查完单要去网页侧处理
背景:在客户端线上订单里查到一笔需要开团或退款的单,处理动作在网页侧。 操作:点 web后台 跳到网页后台,身份已带入,直接在网页侧处理该单,不用重新登录。
场景 2:实施期指向测试环境
背景:上线前要在测试环境验证网页后台。 操作:由实施人员在本机 INI 的 [Srv] 节配 WebBackgroundUrlTpl 指向测试地址,验证完删掉该项,客户端即回到服务端统一下发的地址。
六、权限控制与前置条件
- 需具备 O2O业务 → 微信商城 下本菜单的权限;
- 客户端已正常登录账套,且能连上 ERP 服务端与网页服务端,否则取不到票据;
- 后台地址已由实施配置(本机 INI 或服务端选项二者之一);
- 本机装有 Chrome、Edge 或已设置系统默认浏览器。
七、常见问题
1. 弹「获取web后台 delphiHttpSrv_token 失败」
- 原因:向 ERP 服务端申请接口票据失败,多为服务连不上或当前登录态失效;
- 处理:确认客户端与服务端连接正常,必要时重新登录客户端后再点。
2. 弹「获取web后台 pythonHttpSrv_token 失败」
- 原因:向网页服务端申请接口票据失败;
- 处理:确认网页侧服务已部署且客户端能访问,再重试;仍失败联系实施人员核对服务地址配置。
3. 弹「获取web后台 pardGuid 失败」
- 原因:取不到当前客户标识,通常是账套配置不完整;
- 处理:确认当前登录的账套已正确配置客户信息,再重试。
4. 弹「获取web后台url模板失败」
- 原因:本机 INI 与服务端选项两处都没有配后台地址模板;
- 处理:由实施人员配置服务端
WebBackground下的UrlTpl,或临时在本机 INI[Srv]节配WebBackgroundUrlTpl。
5. 浏览器打开了但要求登录
- 原因:票据未被网页侧接受,常见于本机 INI 指向的环境与票据所属环境不一致;
- 处理:先核对本机是否配了
WebBackgroundUrlTpl指向别的环境,删掉后重试;仍要求登录则在网页侧正常登录一次。
附:与其他功能的关系
| 环节 | 对应功能 |
|---|---|
| 网页端 O2O 各页面说明 | O2O业务总览 |
| 客户端侧的商城订单查询 | 线上订单 |
| 客户端侧的商城基础设置 | 商城模块管理 |
