Files
order-notification-automation/docs/web-structure-discovery.md
T

142 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# BPM Web 结构与接口线索
> 历史调研或分阶段记录;当前能力与设计要求见 [设计要求](design-requirements.md)。本文件中的订单标识样例已替换为虚构值,旧站点记录不构成兼容要求。
首次采集:2026-10-15(Asia/Shanghai),旧站点:https://bpm.skyworthdigital.com/ 。2026-10-16 已补充新版门户实地观察,后续以新版 `https://bpmn.skyworthdigital.com/` 为主;旧域名仍承接已观察的订单详情。
范围:登录后的首页及用户提供的海外运营订单更改评审 V7 页面。仅分析技术结构,不以业务表单内容作为接口文档;未调用审批、已阅、讨论、发送邮件或上传操作。
## 证据等级
- **加载记录**:内置浏览器 pageAssets 资源清单实际列出了该请求 URL;不代表已经核实 HTTP 方法、状态码、请求体、响应格式或接口权限。
- **源码线索**:当前页面 DOM 中的内联脚本或控件属性引用该入口;不代表当前页面执行过该分支。
- 当前浏览器工具未提供完整 Network 请求体和响应体,因此不能把以下路径作为已经完成联调的 API。
## Web 结构
```text
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 属性为:
```javascript
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,也没有点击已阅、知会、讨论、审批或发送提醒邮件按钮。
### 已验证的导航与跨域结构
```text
新版门户 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 节](project-architecture-research-2026-10-16.md#12-新增要求web-人工登录与持久-bpm-会话)。
仍需明确:历史/已读来源范围、分页与排序;知会与业务触发条件;来源 ID/流程 ID/订单版本关系;多订单标识含义;各表单产品线/项目字段;自动阅读副作用;会话跨重启与过期行为。上述五类样本不能替代完整联调。