11 KiB
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/订单版本关系;多订单标识含义;各表单产品线/项目字段;自动阅读副作用;会话跨重启与过期行为。上述五类样本不能替代完整联调。