Files

108 lines
13 KiB
Markdown
Raw Permalink 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.
# 业务配置与 Excel 导入
## 订单中心与邮件批次
符合分类规则的订单进入订单中心后,在邮件批次页自动归入当前窗口的“收集中”批次。同分类、同规则/模板及通知模式聚合,不同分类分开。点击订单中心“查看收集中批次”或批次“查看详情”可打开弹窗;批次内点击订单可查看该订单详情,再返回原批次,不跳转到订单列表。
管理员可在发送截止前编辑本批次标题及纯文本/HTML正文。请保留 `{{订单明细}}` 或 `{{订单列表}}`,普通通知还须保留 `{{存放地址}}`,使后续到达订单自动进入邮件而不覆盖人工说明。账户签名自动追加;保存只影响该批次,规则模板及BPM原文不变。订单还在归档时可提前写文案,归档未完成仍不能发送。
11:00/17:00沿用原计划和业务日历,按最新已保存内容冻结发送;未编辑使用原模板。截止后、已冻结、发送中、已发送或结果不明的批次均不可编辑。来源配置变化后须重新核对保存,不自动丢弃人工内容。错过窗口的普通历史订单不自动补发,结果不明不自动重发。收集显示不代表来源、PDF/归档或发送验收全部通过。
## 邮件模板与账户签名
“邮件模板”可直接新建,或打开现有模板后点击“编辑模板”。可以维护标题、正文、适用产品线,正文可选择纯文本或HTML源码;“预览正文”不会发信。保存后的内容存入加密数据库,刷新、重启后保留。待确认模板须确认生效后才可被规则使用;编辑已生效模板保留原分类关联并更新版本,只影响后续新冻结批次。历史版本保持只读,可复制编辑。
邮件尾部在“邮箱管理→管理邮箱→邮件尾部签名”设置,可选择纯文本或HTML并预览。签名为固定内容,不使用订单变量;启用后按实际发信账户追加到新批次。正文中原来已经写死的签名不会自动删除,请在模板编辑时手动调整。签名修改不会清除SMTP/IMAP密码或重置连接状态。规则试运行正文也会显示账户签名,已冻结批次保留当时正文和签名版本。
## 字段映射与规则导入(2026-10-23更新)
“字段映射”页面现在只展示BPM实际采集到的流程、对应节点,以及自动采集开关。名称和配对保存在数据库;开启后监听完整待办列表或手动“从 BPM 更新”会新增去重项,关闭后保留目录和既有业务规则。初始化仅读取已保存的服务端真实采集证据,不使用分类种子、Excel或历史查看占位节点生成选项。采集不创建业务订单、不发信、不办理BPM。
规则编辑新增行的流程选项只来自此目录,选中流程后只显示对应节点。流程和节点选择框可以直接输入关键词实时筛选,支持方向键和回车;不能创建目录以外的名称。分类编号只在内部及Excel模板保留,页面不再展示。已有规则中的未知项仍显示原值并标记“未在BPM采集”,不会被自动删除或改写;这些值不会成为其他行的候选项。内部订单详情读取和PDF执行所需的已核验适配器仍保留,页面不再要求逐项配置客户、型号、数量。
在“分类规则 → 导入 Excel”下载“规则导入模板”。模板包含分类规则、填写说明、BPM可选项三个工作表;每行一个流程/节点,同分类可填多行,其余业务配置必须一致。模板以现有分类编号和当前配置作为起点,支持填写邮件模板ID和产品线;原始xls及“下载当前规则 Excel”仍兼容。导入仅维护已有分类的匹配与分发草稿,不新增字段映射项,也不自动启用规则。
预览会按Excel行提示未知流程、未知节点、无效邮件模板或同分类配置冲突。未知范围可以保存草稿,但不允许直接应用到测试、首次建立测试、恢复测试或正式发布;应检查Excel或补充BPM采集。未观测到不等于流程一定不存在。保存草稿、应用到测试和正式发布仍是独立操作;已有活动快照与冻结批次不因本次界面调整被修改。
模板 `{{日期}}` 使用订单原始 `event.receivedAt` 的北京时间日期;跨日按订单出现顺序去重,不能改用批次截止、纳入或创建日期。只有引用该变量的模板要求该时间完整;缺失阻断新冻结,不重写旧批次。
2026-10-23 当前业务权威:唯一来源文件是 `source/订单通知书邮件发送信息.xls`。系统只采用该文件原始 15 类的精确流程和精确节点;不使用“生效”别名,BOM 节点排除,海外 4 个流程只允许 `订单专员(订单通知书)`。产品线和模板 ID 由类别配置显式指定,Excel 不提供这些字段;测试产品线暂用 rule.name,并明确标为测试标签。固定 QQ、空 Cc、Desktop 目录是受控测试覆盖值,不是原 Excel 的正式目的地;正式原始目的地不提交 Git。
处理单位身份为 `source + portalSource + taskId`。`revision` 缺失就缺失,不补 0;旧 ID、冻结回执、已知 `sent`/`unknown` 结果保留且不自动重放。列表 `listVersion` 与表单 `formVersion` 分开保存;完整表单路径只是适配器证据,不能证明历史通知节点到达。原始 `brief` 原样保存,展示层按订单号一单一行并保留模板问候、说明、签名。
BPM 只读,不已阅、不审批、不保存;本轮受控测试仅归档到本机 Desktop 测试目录。发送固定为北京时间 11:00、17:00:To `2639266652@qq.com`,Cc 为空,附件为空;PDF 必须先归档但不附在邮件中。按类别、绑定模板和发送窗口分别成批;无新增不发空邮件,错过窗口不即时追赶或回填。当前服务端待办只有在新鲜提供器扫描后才能纳入带 `admittedAt` 的不可变清单,原始 `receivedAt` 不修改,冻结和发送前都要复核任务仍存在且内容新鲜。
当前本机已更新为Excel规则执行桥版本,原数据与输出路径保留,正式服务机未更新。本轮核心回归29项全部通过,约74秒;此前基础整合全量990项为历史验收记录,并非本轮全量结果。13:03/13:09的17条待办快照均未匹配,不代表当天没有应通知任务。当天邮件反查已确认两笔试产类订单在11:24/11:25办理Excel确切通知节点,另有一笔海外返工节点名称与Excel不同,用户已选择继续按Excel保持阻断。当前只扫描待办,尚无已办通知任务补偿读取;历史步骤只提供完成时间而缺少通知任务ID/到达时间,不能伪造执行事件或自动补发。仍按Excel分类分批,不照抄人工邮件的跨类合并。PDF及归档运行能力待首笔合格任务实检,计划意图已启用,页面仍显示受阻。15类真实闭环未验收,零售国内返工订单更改评审仍缺适配器。详细证据和待确认项以[本轮整合验证](bpm-native-integration-verification-2026-10-23.md)为准。
不自动回填历史窗口:仅有提供器证明且已纳入不可变清单的待办,可保留到下一合法 11:00/17:00 窗口;非纳入历史任务保持 missedWindow 人工核验。已冻结 prepared 批次只有 30 分钟发送宽限,超时不得自动发送。
## Excel 导入与规则编辑
在“业务设置 → 分类通知规则 → 导入 Excel”选择原始 `.xls`,或选择“下载当前规则 Excel”得到的 `.xlsx`。上传限制为2 MiB,分类表最多200行、20列;表内公式须先转成值。读取只继承明确的纵向合并单元格,不把原表下方的说明或图片当成分类行。
预览必须先核对每行的流程与节点配对、邮件主题、归档位置、主送/抄送和变更项,再确认导入。流程与节点按原始源表读取器相同的NFKC规则规范化全角/半角字符;不把“生效”“订单通知书”等不同名称解释成别名。原始表中多个流程、多个节点按明确列出的组合导入;如只适用部分组合,应使用导出表的“流程节点配对”逐行维护。
原表的“附件:PDF”文字和旧模板“附带PDF=是”不启用邮件附件,预览给出提示;当前业务始终PDF仅归档、邮件无附件。只写目录名称的行保留为待完善草稿,在规则编辑第03步选择实际存储位置。邮箱或规则内容不合格时,整次导入不可提交;分类不明确或重复必须在表内修正。导入只更新已存在的类别,优先按“类别编号”定位,原表按现有分类名称/主题定位,不猜测新增类别。
可仅保存草稿,也可在受限测试启用时选择“确认导入并应用到测试”,原子地保存并更新执行规则。管理员逐类编辑后,先保存,再点击“应用到测试”;新任务由现有协调器自动采集、归档及进入分类批次。刷新保留已保存值。下载当前规则保留稳定类别编号和明确流程节点配对,修改分类名称后仍可回导。另一个管理员在预览后修改规则时,提交返回版本冲突,不能部分覆盖;同一预览重复确认只提交一次。仅保存草稿不改变执行。显式应用只改变新任务使用的规则,不直接归档、创建订单批次或发送邮件,也不恢复已暂停的发送计划。
草稿、正式发布版本与当前测试执行版本分别保存,测试规则由同一份导入/编辑草稿生成,不另建处理器。应用时固定覆盖为既有测试邮箱、空Cc、无附件及每类桌面目录,测试基线和发送计划不变。若本类别尚有未冻结的旧版本订单或未完成任务,应用会拒绝,须先完成或人工处理,避免版本混发;已冻结的原批次保留原快照,仍可按原规则完成。缺字段适配的流程明确阻断,不用其他流程字段凑数。暂停测试后恢复普通验证/发布控件,发布仍须真实样本检查,且不会自行恢复测试发送。当前用户选择继续严格按Excel,不为海外返工流程增加节点等价映射。
以下“业务通知来源”字段表属于既有通用来源接口的历史资料模板,不用于上述 BPM Excel 订单工作流;通用接口的版本回退语义不用于 BPM 任务身份。
## 存储服务器
| 项目 | 需要整理的内容 |
|---|---|
| 名称 | 便于同事识别的服务器名称 |
| 共享路径 | 可只填写服务器 IP / 主机名,再点击“浏览”选择共享和子目录;也可复制完整路径,如 `\\服务器\共享\归档`,名称可自动生成 |
| 访问方式 | 默认免填账号密码,复用部署机现有 Windows SMB 会话/权限;或指定账号 |
| 登录账号 | 指定账号时填写,域账号可使用 `域\账号` |
| 密码 | 指定账号时由管理员在工作台录入;无密码账号明确勾选“此账号无密码”,不放资料表中 |
| 自动归档 | 是否作为新导出 PDF 的自动归档目标 |
填写服务器入口后点击“浏览”,进入共享并选择目录;也可对完整路径点击“检查连接”,确认目录可读取再保存。检查或浏览期间可取消,网络等待有 15 秒上限。检查失败不新增服务器;更改路径、访问方式或账号密码需要重查。浏览和预览只需读取权限,归档及自动归档需要另行通过“检查读写”。
## 业务通知来源
请提供一份脱敏来源对象样本,并标明以下字段的真实路径。支持中文、英文及嵌套对象点路径;不执行表达式。
| 字段 | 用途 | 必填 |
|---|---|---|
| 通知 ID | 标识同一条来源记录 | 是 |
| 版本 | 既有通用接口区分更改版本;留空时使用简要说明摘要,不能用于 BPM 任务身份 | 否 |
| 产业 | 对应工作台收件组的产业 / 产品线名称 | 是 |
| 简要说明 | 作为邮件正文的原文,保留换行 | 是 |
| 标题 | 邮件标题;留空时使用产业业务通知标题 | 否 |
| 业务时间 | 标准日期时间,建议带 `+08:00` 时区 | 否 |
仅用于解释格式的虚构样本:
```json
{
"来源": {
"编号": "DEMO-001",
"版本": "1",
"产业": "示例产业",
"简要说明": "第一行原文\n第二行原文",
"标题": "示例业务通知",
"时间": "2026-10-17T09:00:00+08:00"
}
}
```
对应路径分别为 `来源.编号`、`来源.版本`、`来源.产业`、`来源.简要说明`、`来源.标题`、`来源.时间`。先使用“来源样本预览”核对原文与收件人;预览不入队、不发信。
## 产业接口人与发送安排
| 项目 | 需要整理的内容 |
|---|---|
| 产业 / 产品线 | 与来源产业字段一致的名称 |
| 收件人 To | 该产业接口人的邮箱,可多个 |
| 抄送 Cc | 可选,可多个 |
| 发件邮箱 | 管理员托管的 SMTP 邮箱及参数 |
| 两个时段 | 每日两个北京时间;每单或按产业汇总 |
| 日历 | 周末是否发送、公司调休和停发日期 |
PDF 仅归档至 SMB,不作为业务通知附件。通知内容只取来源简要说明。实际 BPM 订单工作流不走此通用字段表;仍须遵守顶部 Excel、精确流程/节点和任务身份边界。