Files

11 KiB
Raw Permalink Blame History

BPM Web 结构与接口线索

历史调研或分阶段记录;当前能力与设计要求见 设计要求。本文件中的订单标识样例已替换为虚构值,旧站点记录不构成兼容要求。

首次采集:2026-10-15(Asia/Shanghai),旧站点:https://bpm.skyworthdigital.com/ 。2026-10-16 已补充新版门户实地观察,后续以新版 https://bpmn.skyworthdigital.com/ 为主;旧域名仍承接已观察的订单详情。

范围:登录后的首页及用户提供的海外运营订单更改评审 V7 页面。仅分析技术结构,不以业务表单内容作为接口文档;未调用审批、已阅、讨论、发送邮件或上传操作。

证据等级

  • 加载记录:内置浏览器 pageAssets 资源清单实际列出了该请求 URL;不代表已经核实 HTTP 方法、状态码、请求体、响应格式或接口权限。
  • 源码线索:当前页面 DOM 中的内联脚本或控件属性引用该入口;不代表当前页面执行过该分支。
  • 当前浏览器工具未提供完整 Network 请求体和响应体,因此不能把以下路径作为已经完成联调的 API。

Web 结构

BPM 首页(ASP.NET / ExtJS)
  ├─ /BPM/MainWindow.js 与 YZSoft/Frame/Classic/Scripts/Frame.js
  ├─ 导航树:MainModuleTree.ashx、BPMModuleTree.ashx
  ├─ 历史任务模块:HistoryTask*Panel.js / HistoryTaskStore.js / HistoryTaskGrid.js
  │    └─ /YZSoft/BPM/StoreDataService/HistoryTask.ashx
  └─ 业务表单:/YZSoft/Forms/XForm/.../*.aspx
       ├─ XFormCore.js / XFormAgent.js / XForm.js
       ├─ XMLService/DataProvider.ashx
       ├─ ProcessStep.ashx
       └─ Attachment/GetAttachment.ashx 与自定义附件处理器

可确认是 ASP.NET Web Forms 风格(.aspx、WebResource.axd、表单 POST),前端为 ExtJS、jQuery、YZSoft XForm。表单内联变量声明 XFormAgentVer = "3.1.0.5";该值不能当作整个 BPM 产品的版本号。页面有 xdatabind 数据绑定属性。站点同时存在 .ashx 处理器及少量 /api/ 路由,不能据此断定所有服务都是 REST API。

入口清单

以下以站点根路径为基准,忽略 _dc、r 等时间戳或随机参数。

路径 已见参数 用途及证据
/BPM/MainModuleTree.ashx _dc 首页导航入口;加载记录
/BPM/BPMModuleTree.ashx node=root 流程模块导航;加载记录
/YZSoft/BPM/StoreDataService/HistoryTask.ashx start、limit、HistoryTaskType=MyRequest、SpecProcessName、byYear=1、Year 历史流程列表;加载记录。待确认订单流程过滤与权限范围
/YZSoft/BPM/XMLService/DataProvider.ashx URL 仅见 _dc 表单数据服务候选;加载记录。真正的操作类型和业务参数可能在请求体,尚未采集
/YZSoft/BPM/ProcessStep.ashx TaskID、r 流程步骤;加载记录
/YZSoft/Attachment/GetAttachment.ashx URL 仅见 _dc 附件相关服务;加载记录。不能仅凭名称断言它直接返回文件二进制
/ASHX/YZAttachmentInfo.ashx fids,逗号分隔 附件信息服务候选;加载记录
/ashx/OrderReview/RevertRecordModifyHandle.ashx TaskID、Field 订单变更记录相关;加载记录。仅观察,未重放,修改性需另核实
/ashx/BPMOwnerPosition.ashx tid 归属/岗位相关服务候选;加载记录
/MyApp/Demo/TaskComment/MyData.ashx TaskId、ParentId、AppName、AppKey、curindex 讨论数据相关;加载记录
/api/PLM/MyTask uid 首页 PLM 任务对接;加载记录,与订单接口不能混同
/sso/KeycloakAuth.ashx action=check SSO 状态检查候选;加载记录。未读取或保存认证内容
/ASHX/MasterData/POExportExcelHandler.ashx Action=HWDetail、TaskID 页面 downMatDetail() 通过 location.href 导航,属于物料 Excel 导出源码线索,不能当作通知书 PDF 接口
http://172.28.17.108/api/sdt-rdm/product/bpmGetOne projNo、r 页面 $.ajax 源码线索。未声明 type/method,按 jQuery 默认语义为 GET;回调引用 re.data,但未实测返回、内网可达性或跨域行为

打印与 PDF

打印控件 #XPrintButton1 的 DOM 属性为:

XFormPrint(this, 'ori=v;zm=60;ml=2;mt=20;mr=2;mb=10;ph=;pf=', true);

这证明页面通过 XForm 打印函数进入打印链路。点击时浏览器工具超时;随后未观察到新标签、JavaScript 对话框或新增资源 URL。因此本次不能确认打印已成功,更不能确认存在服务端 PDF 下载接口。

后续需核实 XFormPrint 实现、是否打开打印预览、是否依赖客户端组件,以及打印样式、页码、签名和分页的输出效果。

后续工具要求

用户明确要求最终工具能直接操作浏览器。设计时应保留浏览器控制能力,包括启动或连接、人工登录后继续、导航、点击、等待及文件下载;接口调用可作为提高效率的手段。端口连接和独立浏览器配置的最终方案尚未确定。

以上为旧入口阶段的后续方向。2026-10-16 起优先核实新版待阅/知会列表的范围、分页与只读接口,再结合既有详情核实 DataProvider、附件和 PDF 链路;不再默认旧 HistoryTask 是正式列表来源。不要重放审批、已阅、讨论、邮件或上传请求。

本记录不包含密码、Cookie、Token 或完整业务表单数据。

本地 PDF 导出实验

2026-10-15:内置浏览器原生打印弹窗未通过现有控制能力完成。为交付样稿,提取已登录页面的静态 DOM、可见控件值、已加载 CSS 与 logo,在禁止网络访问的本地排版进程中生成 PDF,无需人工点保存。移除了脚本、隐藏字段、讨论输入和流程操作控件;未执行提交、审批、邮件或上传操作。

输出:output/pdf/900001_DEMO-PROJECT-001_DEMO-MODEL_DEMO-CHANGE-001.pdf。命名规则为 订单号_项目编号_产品型号_通知书编号.pdf。最终文件为两页 A4、331560 字节;已逐页渲染检查,并核对四个命名标识和正文末端的参考资料标题。

该文件是页面导出样稿,不是已联调的服务器 PDF 下载结果。图片区域、窄控件和分页经过本地处理,尚未验证与 XForm 原生打印一致;不能据此认定 PDF 接口或原生打印自动化已打通。

2026-10-16:新版门户与“知会”样本

用户自行登录新版门户,并要求后续以新版为主。当前已登录入口为 https://bpmn.skyworthdigital.com/#,标题“创维数字流程门户”。本次仅查看列表和必要订单样本,没有复制 Cookie,也没有点击已阅、知会、讨论、审批或发送提醒邮件按钮。

已验证的导航与跨域结构

新版门户 bpmn.skyworthdigital.com
  └─ 流程 → 待阅
       ├─ 普通待阅 (1):一条采购申请
       └─ BPMV4 (6):五条订单 + 一条采购申请
            └─ 订单详情仍在 bpm.skyworthdigital.com
                 /YZSoft/Forms/XForm/.../*.aspx?tid=...&pid=...

列表编号链接为 a.yz-worklist-sn,href="#";实际点击后才能取得详情路由,不能仅收集锚点 href。当次查看后列表计数仍为 6,但不能据此证明打开详情无自动阅读副作用。

表单类型 样本编号 订单号 详情 tid / pid
零售产品部订单评审 V12 DEMO-RETAIL-001 900002 800001 / 700001
备损订单评审 V5 DEMO-SPARE-001 900003 800002 / 700002
宽带事业订单评审 V16 DEMO-BROADBAND-001 900004 800003 / 700003
海外运营订单更改评审 V7 DEMO-CHANGE-001 900001 800004 / 700004
海外运营订单评审 V13 DEMO-ORDER-001 900005 800005 / 700005

以上列表接收日期均为 2026-10-15,状态均显示“知会”。此状态不能直接作为流程全部审批完成的证据。宽带记录摘要还出现 HA900004 及另一个公司/订单信息块,尚未核实关联语义;不能强制一条来源记录对应一个业务订单。

已加载的新门户资源线索

以下来自 pageAssets 清单,已去除查询字符串;仍不代表已核实方法、响应体或用途:

路径 可支持的观察与边界
/bpm/account/info 账号信息候选;没有读取认证值或响应结构
/bpm/worklist/counts、/bpm/worklist、/navigator/bpm/worklist 工作列表及计数相关候选;未确认哪个专门返回 BPMV4 知会、筛选及分页参数
/Yzsc/features/web/override/Yiez/workflow/worklist/Informlist.js 知会列表模块资源线索
/Skyworth/Portal/src/component/Informlist.js 门户知会组件资源线索
/Skyworth/ToDoV2/panel/WorklistV4Panel.js、WorklistV8Panel.js 新旧代际工作列表面板资源线索
/portal/calendar/dates、/portal/calendar 门户日历候选;可见日历包含会议/备忘/用车,不能视为公司工作日历接口
/hubs/system/negotiate、/hubs/notice/negotiate 实时通道协商资源线索;不能据此认定完整事件协议或漏消息恢复能力

本次没有重放这些请求。下一步如实现接口采集,需在合法执行会话内另核实请求/响应和只读性。

字段适配的实际差异

  • 零售:OFR_LSCP_Applicant.OrderNum、.SN,型号 OFR_LSCP_BInfo.ProductModel。
  • 备损:OFR_BS_Applicant.OrderNum、.SN、.ProductLine;项目及型号的等价字段尚未确认。
  • 宽带:OFR_KD_Applicant.OrderNum、.SN、.OrderNum_Original,型号 OFR_KD_BInfo.ProductModel;项目的确切绑定尚未确认。
  • 海外 V7/V13:OFR_WY_Applicant.OrderNum、.SN,项目 OFR_WY_BInfo.ProductNum,完整型号 .ProductModel 与短型号 .ProductModelNEW 均存在,不能混用。

实际编号 LABEL 控件可出现 .value 为空而 .textContent 非空;当前 extension/capture.js 使用 value ?? textContent 会忽略这种回退。还需处理同一绑定出现在多个控件上的情况。建议按表单类型和版本注册适配器,按控件类型读取并校验必填项。本次仅记录兼容问题,未修改代码。

零售样本可见 .xls BOM 对比附件,锚点 href 为 ###。这证明存在附件入口,不证明有直接下载 URL,也不证明附件应随通知发送。

会话设计要求与剩余问题

用户已确认 Web 面向“多人在各自电脑访问同一台服务器”。正式方案应在 Web 中提供服务器专用浏览器的交互登录画面,由人完成 BPM 登录和验证码;会话保存在执行端,并验证新版门户与旧域名详情均可访问。普通跳转到同事本机浏览器无法把登录态自动交给服务器,跨域 iframe 读取 Cookie 也不可作为实现方案。

不提取本次会话;后续使用隔离 profile/认证状态、连接级权限和本地凭据保护。登录失效接入异常待办与续登,续登期间暂停同一连接的自动采集。完整设计见 架构调研第 12 节。

仍需明确:历史/已读来源范围、分页与排序;知会与业务触发条件;来源 ID/流程 ID/订单版本关系;多订单标识含义;各表单产品线/项目字段;自动阅读副作用;会话跨重启与过期行为。上述五类样本不能替代完整联调。