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