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