108 lines
13 KiB
Markdown
108 lines
13 KiB
Markdown
# 业务配置与 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、精确流程/节点和任务身份边界。
|