Skip to content

web后台 ​

商城有一部分管理动作在网页侧做。这个菜单项不是客户端里的一个窗口,而是一个跳转入口:点一下,客户端取好免登录票据、拼出后台地址,再调本机浏览器最大化打开,落到网页后台时已经是登录状态,不用再输一次账号密码。

功能路径:系统菜单 → O2O业务 → 微信商城 → web后台

一、功能概述 ​

1. 解决什么问题 ​

  1. 少一次登录:客户端已经登录过账套,跳网页后台时把身份票据带过去,不用在浏览器里再登一遍;
  2. 少一次找地址:后台地址由实施统一配置,操作员不需要记网址,也不会因为手输地址进错环境;
  3. 浏览器就地打开:用本机已装的浏览器打开,页面最大化,不嵌在客户端里。

2. 它不是一个客户端窗口 ​

点这个菜单不会在 ERP 里出现新窗体,客户端只做「取票据 → 拼地址 → 调浏览器」三件事。打开之后的页面、菜单与操作都在网页侧,客户端不再参与。

二、点击后发生什么 ​

1. 浏览器选择顺序 ​

顺序浏览器说明
1Chrome先按常见安装路径找,找不到再查系统注册的应用路径
2EdgeChrome 不存在时按同样方式找 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 指向测试地址,验证完删掉该项,客户端即回到服务端统一下发的地址。

六、权限控制与前置条件 ​

  1. 需具备 O2O业务 → 微信商城 下本菜单的权限;
  2. 客户端已正常登录账套,且能连上 ERP 服务端与网页服务端,否则取不到票据;
  3. 后台地址已由实施配置(本机 INI 或服务端选项二者之一);
  4. 本机装有 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业务总览
客户端侧的商城订单查询线上订单
客户端侧的商城基础设置商城模块管理