Compare commits

..

3 Commits

Author SHA1 Message Date
55b9c201d6 docs: mark framework P2 gate complete
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-18 13:25:30 +08:00
ffd8c31e7e fix: gate function template downloads 2026-06-18 13:24:43 +08:00
22211b2557 feat(附件): 双态组件 + 新建/编辑保存落库打通
- 转换器 buildAttachmentField: 附件字段收敛为单个 input-file 双态组件
  (staticOn ${__readonly} 查看只读可下载/编辑可增删; joinValues:false,extractValue:false
  提交附件对象数组), 删除 each+service 容器, 查看/编辑同位置同布局
- FlowController 读路径 resolveAttachmentFields: 把保真层大写 DOCUMENT
  ({SYS_DOC_ID,FILENAME,FILESIZE}) 归一为 amis 小写契约 {id,name,value,url,sizeKb},
  修掉"查看附件空白图标"
- FlowController 写路径 normalizeAttachmentFieldsForWrite(按 url=/api/file/ 签名识别):
  修改流 → [{SYS_DOC_ID}] 交保真层 updateAttachments 对账(留/软删/不重复插);
  新建流 → 捕获 docId+剥离 DOCUMENT, 保存后用返回主键 relinkInsertedAttachments
  UPDATE sys_doc.businesskey 改挂(直接改挂、非复制 → 无 UNKNOWN 孤儿)
- FileController.upload: businesskey 右补白 36 位对齐保真层 getDoc(CHAR(36) 主键),
  否则 loadDoc 读不到新附件; 响应补 value
- 测试: converter 154 + metadata 368 全绿
  (新增 4c 读契约归一 / 4d 修改归一 / 4e 新建改挂 / FileController 补白)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 13:09:36 +08:00
9 changed files with 557 additions and 91 deletions

View File

@@ -26,7 +26,7 @@
| RBAC/组织 | 用户组/角色/菜单维护/部门/数据权限授权 | 🟡 | 2026-06-14 搭了 CRUD 端点 + amis 后台页,但 demo 级、未对照旧版逐功能验收 |
| RBAC/组织 | 岗位管理/分公司岗位管理 | 🟠 | 通用页在;engineclass「设置(岗位↔用户 picker)」未移植 |
| 元数据/平台工具 | 实体/服务流/视图管理/功能管理/自动编号/定时任务/数据导入配置 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器等重度 delta 未移植 |
| 元数据/平台工具 | 功能模板下载(设置 13accf09/管理 0246d4bd) | ✅ | `b5fe995` 机制①整页改写器:去右表单「添加」按钮 + 标题「编辑模板附件」+ `3276774` 布局保真。门控③(VIEW_TEMPLATEID 非空才显)暂延后 |
| 元数据/平台工具 | 功能模板下载(设置 13accf09/管理 0246d4bd) | ✅ | `b5fe995`/`3276774`:去右表单「添加」按钮 + 标题「编辑模板附件」+ 布局保真;`ffd8c31`:补 `VIEW_TEMPLATEID` 门控,未关联模板节点不显示附件编辑/保存 |
| 元数据/平台工具 | 实体分类-枚举组 b114351f | ✅ | 已核对:EIP4 树端点 PK 唯一+去重+全量建树,天然规避老 UUID 防重逻辑,无需移植 |
| 流程/审批 | 待办/已办/我的发起任务 | 🟡 | 已办 `FinishTaskComponentNew` 两个模板已浏览器验收只读详情;待办 `TaskComponentNew` 两个模板已验列表/查看详细/处理抽屉/遮罩层级,未点最终同意/拒绝,处理后刷新仍待专门测试数据或用户确认。我的发起任务的查看/撤回未接。 |
| 流程/审批 | 查看审批/流程监控/流程定义/审批表单删除 | ❌🟠 | 查看审批=bespoke 未起步;流程定义=Flowable Modeler 另案 |

View File

@@ -25,7 +25,7 @@
| 2026-06-17 | 待办/已办时间范围查询:兼容 AMIS datetime-range 秒/毫秒时间戳 | Done | `eip4-platform 57c3412` | live: `2026-06-15 20:37 - 2026-06-17 20:37` 返回 `total=0` |
| 2026-06-17 | `/api/flow` 老脚本临时绑定 `UserSession`,避免无 JWT 上下文直接崩 | Done | `eip4-platform 57c3412` | `FlowControllerTest` |
| 2026-06-17 | 已办任务 `FinishTaskComponentNew`:两个模板只读「查看详细」 | Done | `eip4-platform 57c3412`, `eip4-web f7ac4cd` | 浏览器验收:`efa62458`、`c6eb659c` 均有数据、无「处理」、只读详情抽屉含业务单据和轨迹 |
| 2026-06-17 | 功能模板下载模板管理/设置:去右表单添加按钮、标题改「编辑模板附件」 | Done | `b5fe995`, `3276774` | 转换器测试;重转重导后生效 |
| 2026-06-17/18 | 功能模板下载模板管理/设置:去右表单添加按钮、标题改「编辑模板附件」;补 `VIEW_TEMPLATEID` 门控,未关联模板节点不显示附件编辑和保存 | Done | `b5fe995`, `3276774`, `ffd8c31` | `mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest test`;临时目录全量重转 2757 项,`SchemaImportCli` 扫描 2685 项/更新 789 项;HTTP schema 确认两页含 `funcDownloadNoTemplateTip` 与 `${VIEW_TEMPLATEID}`;内置浏览器 smoke:`待我承办` 有模板时显示附件/保存,`新闻管理` 无模板父节点隐藏附件/保存并显示提示 |
| 2026-06-17 | 实体分类-枚举组:确认 EIP4 树端点 PK 唯一 + 去重,全量建树覆盖老 UUID 防重逻辑 | Done | 文档/核验项 | 无需移植 |
| 2026-06-17 | 用户管理 Delta 端到端案例 | Done | 见 `用户管理-Delta移植-实现过程与踩坑-2026-06-17.md` | 已逐字段 dogfood |
| 2026-06-18 | 消息查看/已读:收到的消息查看弹窗、打开即已读、已发送消息只读详情 | Done | `eip4-platform f690f30` | `NoticeControllerTest`; 浏览器验收 `83971d1a`:本地记录 `94d3645c-2487-47f6-bbf5-ebdff3434f6e` 置未读后列表显示“否”,打开详情后 DB 与列表均回“是”;浏览器验收 `b7635622`:已发送消息只读详情正常,无“消息详情加载失败” |
@@ -50,8 +50,6 @@
| 报表 `e81454af-0e0e-4c0d-add8-db434f198936` | Implemented / Browser smoke verified | `eip4-platform 5636b37` 新增 `ReportMenuController` `/api/report/menu-tree`,按旧 `ReportComponent` 的 DOCUMENT 菜单树口径从 `VIEW_SYS_MENU` 构建父菜单/类型/报表三级树,并只返回 `sys_page_schema` 已有的可路由叶子;`PageSchemaController` 对报表 templateId 提供内置宿主 schema,左侧树选择叶子后右侧用 `/api/page/schema/${reportTemplateId}?format=amis` 复用已转换页。自动化:`ReportMenuControllerTest`、`PageSchemaControllerTest#reportHostBuiltinSchemaFallback`;HTTP smoke:`/api/report/menu-tree` 返回 110 个叶子,宿主 schema 200 且含 `/api/report/menu-tree`、`report-schema-host`;内置浏览器 smoke:报表页显示 DOCUMENT 菜单树和「请选择左侧报表」。 | 页面副作用验收:逐类选择 3-5 个真实报表叶子,确认右侧报表页 schema 加载、查询条件、分页和导出/打印等报表专属动作是否需要继续迁移 |
| 工作日历 `a13fa07f` | Implemented / Browser smoke verified | `eip4-platform eafd872` 新增 `workCalendarService`(bean 名与旧脚本函数一致),复用旧表 `SYS_CALENDAREXCEPTDAY`,实现周末默认休息、例外日双语义(周末调班/工作日放假)、`getNextWorkDay/isWorkDay`;新增 `/api/work-calendar/year` 和 `/api/work-calendar/toggle`;`PageSchemaController` 对 XML 为空的工作日历 templateId 提供内置标准 amis schema,避免菜单 404。自动化已过:`WorkCalendarServiceImplTest`、`WorkCalendarControllerTest`、`PageSchemaControllerTest`;打包:`mvn -q -pl platform-app -am package -DskipTests`;8093 已重启。HTTP smoke:schema 200/X-Schema-Layer=standard,年度 2026 返回 365 行,`2099-01-03` 周末例外日 toggle 写入后回滚;内置浏览器验证 `a13fa07f` 页面显示工作日历、年度查询、日期列表、周休日和切换例外日。 | 用户验收:确认当前 amis 列表式年历是否接受;如必须完全复刻旧 3x4 月历网格,再补视觉布局层;再抽一个真实年份例外日做页面按钮 toggle 后 DB/回显闭环 |
| 菜单真入口 | Needs verification | 前端已去硬编码假入口;需确认所有需要的真菜单在 `sys_menu` 中可达 | 用 `/api/menu` 和页面侧栏核对 |
| 功能模板下载门控 | Pending | backlog 写了 `VIEW_TEMPLATEID` 非空才显示附件编辑;当前只做了去按钮/改标题 | 决定是否补门控,若补则在 `EngineclassDelta` mutator 中按行/上下文控制 |
## P0 / P1(下一批建议先做)
| 优先级 | 范围 | 视图 / engineclass | 要补什么 | 复用机制 |

View File

@@ -246,7 +246,7 @@ public final class EngineclassDelta {
}
}
// ── 功能模板下载模板管理/设置 · 去增删按钮 + 改标题 ─────────────────────────
// ── 功能模板下载模板管理/设置 · 去增删按钮 + 改标题 + 附件门控 ─────────────────
/**
* FuncDownloadComponent.refreshRightLayout 的 EIP4 等价改写。转换后 type=3 树页结构=
* {@code grid → 列[左 input-tree][右 button-toolbar[添加] + form]}。改写:
@@ -254,10 +254,11 @@ public final class EngineclassDelta {
* <li>① 移除右侧 button-toolbar 内「添加/删除」按钮(老 cl.removeComponent(insert)/(del)——附件记录随
* 菜单/实体生成不应手工增删);toolbar 因此变空则整条移除。</li>
* <li>② 右表单标题改「编辑模板附件」(老 panel.setCaption("编辑模板附件"))。</li>
* <li>③ 表单 initApi 取回 {@code VIEW_TEMPLATEID} 后,未关联功能模板的菜单不显示附件编辑项和保存按钮
* (老 pojo.VIEW_TEMPLATEID 非空才 add 右表单)。</li>
* </ul>
* <b>未做</b>:老「仅 pojo.VIEW_TEMPLATEID 非空才显示右表单」的门控——amis 表单 {@code visibleOn} 依赖
* 自身 initApi 数据成循环(隐藏则不 fetch),正解需树节点携带 VIEW_TEMPLATEID(改 TemplateTreeController),
* 价值低,暂延后。
* 注:不能直接给 form 加 {@code visibleOn=${VIEW_TEMPLATEID}},否则 form 隐藏时不会发 initApi。这里保留
* form 壳子加载当前树节点,再把 body/action 按返回数据门控。
*/
@SuppressWarnings("unchecked")
private static void funcDownloadDelta(Map<String, Object> schema, ConversionResult result) {
@@ -291,6 +292,7 @@ public final class EngineclassDelta {
} else if ("form".equals(m.get("type"))) {
// ② 右表单标题改「编辑模板附件」
Object old = m.put("title", "编辑模板附件");
applyFuncDownloadTemplateGate(m, result);
if (result != null) {
result.note("engineclass[FuncDownloadComponent] 右表单标题改写: "
+ old + " → 编辑模板附件");
@@ -303,6 +305,69 @@ public final class EngineclassDelta {
}
}
/** 按表单 initApi 返回的 VIEW_TEMPLATEID 门控附件编辑项;不隐藏 form 本身,避免阻断 initApi。 */
@SuppressWarnings("unchecked")
private static void applyFuncDownloadTemplateGate(Map<String, Object> form, ConversionResult result) {
Object bodyObj = form.get("body");
if (bodyObj instanceof List<?> body) {
List<Object> gated = new ArrayList<>();
gated.add(mapOf(
"type", "tpl",
"id", "funcDownloadNoTemplateTip",
"tpl", "<span class=\"text-muted\">该菜单未关联功能模板,暂无附件可编辑</span>",
"visibleOn", "${selId && !VIEW_TEMPLATEID}"));
for (Object item : body) {
if (item instanceof Map<?, ?> itemMap && shouldGateFuncDownloadItem((Map<String, Object>) itemMap)) {
addVisibleOn((Map<String, Object>) itemMap, "VIEW_TEMPLATEID");
}
gated.add(item);
}
form.put("body", gated);
} else if (bodyObj instanceof Map<?, ?> bodyMap) {
Map<String, Object> item = (Map<String, Object>) bodyMap;
if (shouldGateFuncDownloadItem(item)) {
addVisibleOn(item, "VIEW_TEMPLATEID");
}
}
Object actionsObj = form.get("actions");
if (actionsObj instanceof List<?> actions) {
for (Object action : actions) {
if (action instanceof Map<?, ?> actionMap) {
addVisibleOn((Map<String, Object>) actionMap, "VIEW_TEMPLATEID");
}
}
}
if (result != null) {
result.note("engineclass[FuncDownloadComponent] 右表单按 VIEW_TEMPLATEID 门控附件编辑");
}
}
private static boolean shouldGateFuncDownloadItem(Map<String, Object> item) {
if (Boolean.TRUE.equals(item.get("hidden"))) {
return false;
}
return !"hidden".equals(item.get("type"));
}
private static void addVisibleOn(Map<String, Object> item, String conditionExpr) {
String old = item.get("visibleOn") == null ? "" : String.valueOf(item.get("visibleOn")).trim();
if (old.isBlank()) {
item.put("visibleOn", "${" + conditionExpr + "}");
return;
}
item.put("visibleOn", "${(" + unwrapAmisExpr(old) + ") && (" + conditionExpr + ")}");
}
private static String unwrapAmisExpr(String expr) {
String trimmed = expr == null ? "" : expr.trim();
if (trimmed.startsWith("${") && trimmed.endsWith("}") && trimmed.length() >= 3) {
return trimmed.substring(2, trimmed.length() - 1);
}
return trimmed;
}
/**
* 剥除 button-toolbar 内「添加/删除」按钮(重建 buttons 列表回填,兼容不可变源);剥后为空返回 true(供丢弃整条)。
*/

View File

@@ -2063,39 +2063,34 @@ public class TemplateToAmisConverter {
continue;
}
formItems.set(i, buildAttachmentField(item, upper, pkCol));
result.note("WS-D 附件字段 " + item.get("name") + " → service 容器(已有附件只读下载列表 "
+ "/api/file/list?tableName=" + upper + "&businessKey=${" + pkCol + "} + 保留上传控件)");
result.note("WS-D 附件字段 " + item.get("name") + " → input-file 双态(staticOn ${__readonly}: "
+ "查看只读显名可下载/编辑可增删; 上传 receiver 带 tableName=" + upper
+ "&businessKey=${" + pkCol + "} 关联本记录)");
}
}
/** 构造附件 service 容器:已有附件下载列表(each) + 原上传控件(input-file)。 */
/**
* 附件字段(input-file)配置为查看/编辑双态单组件:
* <ul>
* <li>{@code staticOn:${__readonly}}:查看(只读)态静态化 → 只读文件名列表可点下载、不渲删除/上传按钮;
* 编辑态正常增删。同位置同组件,查看/编辑布局一致。</li>
* <li>{@code receiver} 带业务键:编辑态上传的新附件按 {@code sys_doc.tablename+businesskey} 关联本记录。</li>
* </ul>
* 已有附件由后端按 amis 契约 {@code [{id,name,value,url}]} 返回(FlowController 响应边界
* {@code resolveAttachmentFields} 把保真层大写 {@code SYS_DOC_ID/FILENAME} 归一为小写),
* input-file 默认字段({@code name/value/url})即可显名+下载,无需额外 service/each 容器。
*/
private static Map<String, Object> buildAttachmentField(Map<String, Object> uploadItem,
String upperTable, String pkCol) {
// 已有附件下载链接(文件名(大小KB)),下载走 FileController.download(Content-Disposition: attachment)
Map<String, Object> link = new LinkedHashMap<>();
link.put("type", "tpl");
link.put("tpl", "<a href=\"/api/file/${id}\" target=\"_blank\" download>${name}(${sizeKb}KB)</a>");
Map<String, Object> each = new LinkedHashMap<>();
each.put("type", "each");
each.put("name", "items"); // service api data.items
each.put("placeholder", "无附件");
each.put("items", link);
Map<String, Object> service = new LinkedHashMap<>();
service.put("type", "service");
// 业务键绑表单主键;空主键(新增态)时 list 端点返空,不误列
service.put("api", "get:/api/file/list?tableName=" + upperTable + "&businessKey=${" + pkCol + "}");
// M4:service.name 与内层 input-file 同名(皆 DOCUMENT)。service.name 仅作布局归位 key
// (供 <div location="DOCUMENT"> 把本容器排到正确位置),表单实际取值由内层 input-file 绑定;
// amis 容忍二者同名(外层 service 不抢绑该字段值)——已浏览器实证(查看页附件下载列表+上传控件正常)。
service.put("name", uploadItem.get("name")); // 保 <div location="DOCUMENT"> 归位
service.put("label", uploadItem.get("label"));
List<Map<String, Object>> body = new ArrayList<>();
body.add(each);
body.add(uploadItem); // 保留上传控件(编辑态加附件;static 态自禁用)
service.put("body", body);
return service; // type=service → isWideField 判宽控件独占整行
uploadItem.put("receiver",
"/api/file/upload?tableName=" + upperTable + "&businessKey=${" + pkCol + "}");
uploadItem.put("staticOn", "${__readonly}");
// 提交时保留附件对象数组(而非默认 joinValues 拼成的逗号串):保真层
// POJOServiceImpl.updateAttachments 要求 DOCUMENT 是 List<Map>,String 会 ClassCastException。
// 由 FlowController 写路径把对象数组归一为 [{SYS_DOC_ID:id}] 供保真层按 id 对账(增/留/删)。
uploadItem.put("joinValues", false);
uploadItem.put("extractValue", false);
return uploadItem;
}
/**

View File

@@ -1451,11 +1451,12 @@ class TemplateToAmisConverterTest {
/**
* engineclass=FuncDownloadComponent(功能模板下载模板管理/设置,type=3 树页)→ 整页改写器(机制① MUTATORS):
* 移除右表单「添加」按钮(空 toolbar 整条移除)+ 右表单标题改「编辑模板附件」。复刻 refreshRightLayout。
* 移除右表单「添加」按钮(空 toolbar 整条移除)+ 右表单标题改「编辑模板附件」
* + 按 VIEW_TEMPLATEID 门控附件编辑。复刻 refreshRightLayout。
*/
@Test
@SuppressWarnings("unchecked")
void engineclass_FuncDownload_去添加按钮并改标题() {
void engineclass_FuncDownload_去添加按钮改标题并按模板门控() {
// 模拟转换后 type=3 树页:grid → 列[左 input-tree][右 button-toolbar[添加] + form]
Map<String, Object> addBtn = new LinkedHashMap<>();
addBtn.put("type", "button");
@@ -1466,6 +1467,18 @@ class TemplateToAmisConverterTest {
Map<String, Object> form = new LinkedHashMap<>();
form.put("type", "form");
form.put("title", "功能模板下载模板设置");
Map<String, Object> document = new LinkedHashMap<>();
document.put("type", "input-file");
document.put("name", "DOCUMENT");
Map<String, Object> hiddenTemplate = new LinkedHashMap<>();
hiddenTemplate.put("type", "input-text");
hiddenTemplate.put("name", "VIEW_TEMPLATEID");
hiddenTemplate.put("hidden", true);
Map<String, Object> submit = new LinkedHashMap<>();
submit.put("type", "submit");
submit.put("label", "保存");
form.put("body", new ArrayList<>(List.of(document, hiddenTemplate)));
form.put("actions", new ArrayList<>(List.of(submit)));
Map<String, Object> rightCol = new LinkedHashMap<>();
rightCol.put("body", new ArrayList<>(List.of(toolbar, form)));
Map<String, Object> tree = new LinkedHashMap<>();
@@ -1487,6 +1500,13 @@ class TemplateToAmisConverterTest {
.anyMatch(o -> o instanceof Map && "button-toolbar".equals(((Map<String, Object>) o).get("type")));
assertFalse(hasToolbar, "添加按钮已删 → 空 button-toolbar 应整条移除");
assertEquals("编辑模板附件", form.get("title"), "右表单标题应改为「编辑模板附件」");
List<Object> formBody = (List<Object>) form.get("body");
Map<String, Object> tip = (Map<String, Object>) formBody.get(0);
assertEquals("tpl", tip.get("type"));
assertEquals("${selId && !VIEW_TEMPLATEID}", tip.get("visibleOn"));
assertEquals("${VIEW_TEMPLATEID}", document.get("visibleOn"), "附件编辑项应仅在 VIEW_TEMPLATEID 非空时显示");
assertFalse(hiddenTemplate.containsKey("visibleOn"), "隐藏字段不参与视觉门控,避免影响提交上下文");
assertEquals("${VIEW_TEMPLATEID}", submit.get("visibleOn"), "保存按钮应仅在 VIEW_TEMPLATEID 非空时显示");
// 左树不受影响、表单仍在
assertEquals("input-tree", tree.get("type"));
boolean hasForm = rb.stream()
@@ -1813,8 +1833,8 @@ class TemplateToAmisConverterTest {
@SuppressWarnings("unchecked")
void form_附件字段MultiFileUploadField转inputFile() {
// F2-8 实证:MultiFileUploadField / FileUploadField → input-file(receiver + downloadUrl)
// WS-D D.2:附件字段进而被包进 service 容器(已有附件下载列表 + 上传控件),
// 内层 input-file 契约不变(receiver/downloadUrl/multiple)。
// Tier1:附件字段就是单个 input-file 双态组件(staticOn ${__readonly}: 查看只读可下载/编辑可增删),
// receiver 带 tableName+businessKey 使编辑态上传关联本记录。
String pageXml = "<page entityid='e9'><fields>"
+ "<field name='TITLE' label='主题' uitype='TextField' required='true'/>"
+ "<field name='DOCUMENT' label='附件' uitype='MultiFileUploadField'/>"
@@ -1829,20 +1849,20 @@ class TemplateToAmisConverterTest {
List<Map<String, Object>> items = flattenFormBody(form);
assertEquals(3, items.size());
// MultiFileUploadField → service 容器;内层 input-file multiple=true
// MultiFileUploadField → 单个 input-file(双态),multiple=true,receiver 带业务键,staticOn 只读
Map<String, Object> docField = items.get(1);
Map<String, Object> docUpload = attachmentUploadOf(docField);
assertEquals("input-file", docUpload.get("type"));
assertEquals("/api/file/upload", docUpload.get("receiver"));
assertEquals("/api/file/${id}", docUpload.get("downloadUrl"));
assertEquals(true, docUpload.get("multiple"));
assertEquals("input-file", docField.get("type"));
assertEquals("/api/file/upload?tableName=PM_DEMO&businessKey=${PM_DEMO_ID}", docField.get("receiver"));
assertEquals("/api/file/${id}", docField.get("downloadUrl"));
assertEquals(true, docField.get("multiple"));
assertEquals("${__readonly}", docField.get("staticOn"));
// FileUploadField → service 容器;内层 input-file 无 multiple
// FileUploadField → 单个 input-file,无 multiple
Map<String, Object> singleField = items.get(2);
Map<String, Object> singleUpload = attachmentUploadOf(singleField);
assertEquals("input-file", singleUpload.get("type"));
assertEquals("/api/file/upload", singleUpload.get("receiver"));
assertNull(singleUpload.get("multiple"));
assertEquals("input-file", singleField.get("type"));
assertEquals("/api/file/upload?tableName=PM_DEMO&businessKey=${PM_DEMO_ID}", singleField.get("receiver"));
assertNull(singleField.get("multiple"));
assertEquals("${__readonly}", singleField.get("staticOn"));
// 映射台账中有 input-file 记录
assertTrue(notes.stream().anyMatch(n -> n.contains("input-file")));
@@ -1850,9 +1870,10 @@ class TemplateToAmisConverterTest {
@Test
@SuppressWarnings("unchecked")
void form_附件字段_查看态只读下载列表() {
// WS-D D.2:附件字段(input-file) → service 容器(api 按业务 id 拉 /api/file/list,
// each 渲染已有附件下载链接 + 保留上传控件),对齐老系统查看页附件可下载列表。
void form_附件字段_查看编辑双态单组件() {
// Tier1:附件字段 = 单个 input-file 双态组件。查看(${__readonly}=真)静态只读显名可下载、
// 编辑可增删;已有附件由后端按 amis 契约 [{id,name,value,url}] 返回
// (FlowController.resolveAttachmentFields 把保真层大写 SYS_DOC_ID/FILENAME 归一),无需 service/each。
String pageXml = "<page entityid='e9'><fields>"
+ "<field name='DOCUMENT' label='附件' uitype='MultiFileUploadField'/>"
+ "</fields></page>";
@@ -1865,25 +1886,16 @@ class TemplateToAmisConverterTest {
List<Map<String, Object>> items = flattenFormBody(form);
Map<String, Object> doc = items.get(0);
// 附件容器:service,按业务 id 拉已有附件,name=DOCUMENT(保布局归位),label=附件
assertEquals("service", doc.get("type"));
assertEquals("input-file", doc.get("type"));
assertEquals("DOCUMENT", doc.get("name"));
assertEquals("附件", doc.get("label"));
assertEquals("get:/api/file/list?tableName=PM_DEMO&businessKey=${PM_DEMO_ID}", doc.get("api"));
List<Map<String, Object>> svcBody = (List<Map<String, Object>>) doc.get("body");
assertEquals(2, svcBody.size());
// (1) each 渲染已有附件下载列表
Map<String, Object> each = svcBody.get(0);
assertEquals("each", each.get("type"));
assertEquals("items", each.get("name"));
Map<String, Object> link = (Map<String, Object>) each.get("items");
assertEquals("tpl", link.get("type"));
assertTrue(String.valueOf(link.get("tpl")).contains("/api/file/${id}"), "下载链接指向 FileController.download");
assertTrue(String.valueOf(link.get("tpl")).contains("${name}"), "显示文件名");
assertTrue(String.valueOf(link.get("tpl")).contains("${sizeKb}"), "显示大小KB");
// (2) 保留上传控件
assertEquals("input-file", svcBody.get(1).get("type"));
assertEquals("${__readonly}", doc.get("staticOn"), "查看态静态只读、编辑态可增删");
assertEquals("/api/file/upload?tableName=PM_DEMO&businessKey=${PM_DEMO_ID}", doc.get("receiver"));
assertEquals("/api/file/${id}", doc.get("downloadUrl"));
assertNull(doc.get("api"), "不再用 service/each 容器");
// 提交为对象数组(非 joinValues 逗号串),供保真层 updateAttachments 按 SYS_DOC_ID 对账
assertEquals(false, doc.get("joinValues"), "提交附件对象数组而非逗号串");
assertEquals(false, doc.get("extractValue"), "保留对象(含 url 签名)供写路径归一");
}
@Test
@@ -1916,18 +1928,6 @@ class TemplateToAmisConverterTest {
assertNull(doc.get("api"), "降级时不应配 /api/file/list(表名不可靠)");
}
/** 从 WS-D 附件 service 容器里取内层上传控件(input-file)。 */
@SuppressWarnings("unchecked")
private static Map<String, Object> attachmentUploadOf(Map<String, Object> attachmentField) {
assertEquals("service", attachmentField.get("type"), "附件字段应被包进 service 容器");
List<Map<String, Object>> svcBody = (List<Map<String, Object>>) attachmentField.get("body");
for (Map<String, Object> b : svcBody) {
if ("input-file".equals(b.get("type"))) {
return b;
}
}
throw new AssertionError("附件 service 容器内未找到 input-file 上传控件");
}
@Test
@SuppressWarnings("unchecked")
@@ -1951,12 +1951,13 @@ class TemplateToAmisConverterTest {
// PasswordField → input-password(不再明文 input-text)
assertEquals("input-password", items.get(1).get("type"));
// SingleFileUploadField → input-file 单文件(无 multiple);WS-D 包进 service 容器,内层 input-file
Map<String, Object> certUpload = attachmentUploadOf(items.get(2));
// SingleFileUploadField → 单个 input-file 单文件(无 multiple),双态 staticOn ${__readonly}
Map<String, Object> certUpload = items.get(2);
assertEquals("input-file", certUpload.get("type"));
assertEquals("/api/file/upload", certUpload.get("receiver"));
assertEquals("/api/file/upload?tableName=PM_DEMO&businessKey=${PM_DEMO_ID}", certUpload.get("receiver"));
assertEquals("/api/file/${id}", certUpload.get("downloadUrl"));
assertNull(certUpload.get("multiple"));
assertEquals("${__readonly}", certUpload.get("staticOn"));
// DateField → input-date(复用 PopupDateField 无时分支)
assertEquals("input-date", items.get(3).get("type"));
@@ -4134,10 +4135,10 @@ class TemplateToAmisConverterTest {
assertEquals("group", row2.get("type"), "落单窄字段也包 group(保持行结构一致)");
assertEquals(1, ((List<?>) row2.get("body")).size());
// 附件字段(WS-D)包进 service 容器,仍作宽控件独占整行;内层含 input-file 上传控件
assertEquals("service", rows.get(3).get("type"), "附件 service 容器独占整行(宽控件)");
assertEquals("DOC", rows.get(3).get("name"), "附件容器保留字段 name 以归位布局");
assertTrue(rows.get(3).toString().contains("input-file"), "附件容器内保留上传控件");
// 附件字段(Tier1)= 单个 input-file 双态组件,input-file 本即宽控件独占整行
assertEquals("input-file", rows.get(3).get("type"), "附件 input-file 独占整行(宽控件)");
assertEquals("DOC", rows.get(3).get("name"), "附件字段保留 name 以归位布局");
assertEquals("${__readonly}", rows.get(3).get("staticOn"), "查看只读/编辑可增删");
assertEquals("textarea", rows.get(4).get("type"));
// actions 仍为空(单按钮契约不变)

View File

@@ -132,7 +132,7 @@ public class FileController {
"INSERT INTO sys_doc(sys_doc_id,tablename,businesskey,filename,fileext,"
+ "filesize,filepath,md5hash,createby,createtime,updateby,updatetime,isactive,version)"
+ " VALUES (?,?,?,?,?,?,?,?,?,?,?,?,1,0)",
docId, tableName.toUpperCase(), businessKey,
docId, tableName.toUpperCase(), padBusinessKey(businessKey),
originalName, ext, (int) Math.min(fileSize, Integer.MAX_VALUE),
relativePath, md5, "system", now, "system", now);
} catch (Exception e) {
@@ -143,6 +143,7 @@ public class FileController {
Map<String, Object> data = new LinkedHashMap<>();
data.put("id", docId);
data.put("value", docId); // amis input-file valueField=value:上传后对象即带提交值(写路径按 id 归一)
data.put("name", originalName);
data.put("url", "/api/file/" + docId);
data.put("size", fileSize);
@@ -292,6 +293,23 @@ public class FileController {
}
}
/**
* 业务主键右补白到 36 位,对齐保真层引擎的 CHAR(36) 主键语义。
*
* <p>保真层 {@code FileServiceImpl.getDoc} 用 {@code businesskey = po.get_ID()} 精确匹配查附件,
* 而引擎把记录主键按 {@code CHAR(36)} 处理({@code get_ID()} 返回右补空格到 36 位)。新上传若按
* 去白 32 位 hex 存 {@code businesskey},则 {@code loadDoc}(查看/编辑 {@code _LOAD} 走它)永远读不到
* → 附件“存不上”。故入库前归一为 {@code rtrim 后右补到 36 位};已是 36 位 dashed-UUID 主键不变;
* 超 36 位(理论不会)原样保留。{@code /api/file/list} 用 {@code rtrim(businesskey)} 比对,padding 无影响。
*/
private static String padBusinessKey(String key) {
if (key == null) {
return null;
}
String trimmed = key.trim();
return trimmed.length() <= 36 ? String.format("%-36s", trimmed) : trimmed;
}
private static String extractExt(String filename) {
if (filename == null || !filename.contains(".")) {
return "";

View File

@@ -302,6 +302,10 @@ public class FlowController {
*/
private ResponseEntity<Map<String, Object>> run(String id, Map<String, Object> map, boolean isPost, String egTpl) {
ResolvedFlow resolved = flowNameResolver.resolve(id);
// 写路径附件归一:修改流 → [{SYS_DOC_ID}](保真层对账);新建流 → 捕获 docId 并从 map 剥离,
// 待保存后用返回主键改挂(见 relinkInsertedAttachments)。
List<String> insertAttachmentIds = isPost
? normalizeAttachmentFieldsForWrite(map, id) : List.of();
return switch (resolved.type()) {
case UUID_PASSTHROUGH -> {
@@ -370,6 +374,8 @@ public class FlowController {
}
Properties ctx = currentCtx();
Object output = withEngineContext(ctx, () -> flowExcuteService.excute(map, ctx, id));
// 新建流:把上传时 businesskey=UNKNOWN 的附件改挂到本次新建记录的主键(无孤儿、无复制)。
relinkInsertedAttachments(id, output, insertAttachmentIds);
yield ok(output, null, egTpl);
}
case SYNTHESIZED -> {
@@ -440,6 +446,7 @@ public class FlowController {
// read-path issue D1=603:把元数据标记为用户引用的列 id/工号 → 姓名(仅在已知数据源实体的合成搜索流上)
resolveUserColumns(data, table);
resolveReferenceFields(data, egTpl);
resolveAttachmentFields(data);
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("status", 0);
resp.put("msg", "");
@@ -520,6 +527,226 @@ public class FlowController {
}
}
/**
* 附件字段(DOCUMENT/Binary)契约归一:保真层 {@code loadDoc} 把附件列加载为大写键
* ({@code SYS_DOC_ID/FILENAME/FILESIZE})的 Map 列表,amis input-file 默认认小写
* {@code name/value/url} → 渲成无名空白项、点不开。此处在响应边界统一成 amis 契约
* {@code [{id,value,name,url,sizeKb}]}(零改 {@code com.dsasp}),使附件 input-file 双态可用:
* 查看(只读)态显名可下载、编辑态可增删。覆盖主记录 + 一层子表行的附件列。
*/
@SuppressWarnings("unchecked")
private static void resolveAttachmentFields(Object data) {
if (!(data instanceof Map<?, ?> m0)) {
return;
}
Map<String, Object> map = (Map<String, Object>) m0;
if (map.get("items") instanceof List<?>) {
return; // 列表/crud 形态不加载附件
}
Object resultObj = map.get("result");
Map<String, Object> record = resultObj instanceof Map<?, ?> r ? (Map<String, Object>) r : map;
normalizeAttachmentsInRow(record);
for (Object v : record.values()) {
if (v instanceof List<?> sub) {
for (Object o : sub) {
if (o instanceof Map<?, ?> row) {
normalizeAttachmentsInRow((Map<String, Object>) row);
}
}
}
}
}
/** 就地把行内「附件列」(值为含 {@code SYS_DOC_ID} 的 Map 列表)转为 amis input-file 契约。 */
@SuppressWarnings("unchecked")
private static void normalizeAttachmentsInRow(Map<String, Object> row) {
for (Map.Entry<String, Object> e : row.entrySet()) {
if (!(e.getValue() instanceof List<?> list) || !isAttachmentList(list)) {
continue;
}
List<Map<String, Object>> out = new ArrayList<>();
for (Object o : list) {
if (!(o instanceof Map<?, ?> a0)) {
continue;
}
Map<String, Object> a = (Map<String, Object>) a0;
Object idRaw = a.get("SYS_DOC_ID");
if (idRaw == null) {
continue;
}
String id = String.valueOf(idRaw).trim();
long size = toLong(a.get("FILESIZE"));
Map<String, Object> file = new LinkedHashMap<>();
file.put("id", id);
file.put("value", id); // input-file 提交值 = sys_doc id
file.put("name", a.get("FILENAME"));
file.put("url", "/api/file/" + id);
file.put("sizeKb", size > 0 ? Math.max(1, (size + 1023) / 1024) : 0);
out.add(file);
}
e.setValue(out);
}
}
/** 附件列签名:非空且首元素是含 {@code SYS_DOC_ID} 的 Map({@code loadDoc} 产物,附件专属)。 */
private static boolean isAttachmentList(List<?> list) {
return !list.isEmpty()
&& list.get(0) instanceof Map<?, ?> m
&& m.containsKey("SYS_DOC_ID");
}
/**
* 写路径附件字段归一({@link #resolveAttachmentFields} 的逆向):amis input-file
* ({@code joinValues:false, extractValue:false})提交的是附件对象数组 {@code [{id,value,name,url,...}]},
* 而保真层 {@code POJOServiceImpl.updateAttachments} 期望 {@code List<Map>} 且按 {@code SYS_DOC_ID} 键对账
* (提交 String 逗号串 → {@code ClassCastException};缺 {@code SYS_DOC_ID} → 误当新附件重复插入)。
* 此处把带 amis 附件签名({@code url} 形如 {@code /api/file/{id}})的整列就地转为 {@code [{SYS_DOC_ID:id}]},
* 使保真层正确「保留已存 / 软删移除 / 不重复插入已上传」。零改 {@code com.dsasp}。
*
* <p>空数组保留为空 {@code List}({@code updateAttachments} 据此软删全部已存附件 = 用户清空附件);
* 子表行(大写业务列、无 {@code /api/file/} url)整列不匹配签名 → 不动。
*/
@SuppressWarnings("unchecked")
private static List<String> normalizeAttachmentFieldsForWrite(Map<String, Object> map, String flowId) {
if (map == null) {
return List.of();
}
boolean insert = isInsertFlow(flowId);
List<String> capturedIds = new ArrayList<>();
List<String> keysToRemove = new ArrayList<>();
for (Map.Entry<String, Object> e : map.entrySet()) {
if (!(e.getValue() instanceof List<?> list) || list.isEmpty()) {
continue;
}
if (!list.stream().allMatch(FlowController::isAmisAttachmentItem)) {
continue;
}
if (insert) {
// 新建:文件上传时 sys_doc 已落库(businesskey=UNKNOWN,因新建态尚无主键)。记下 docId
// 待保存后用引擎返回的新主键 UPDATE 改挂(见 relinkInsertedAttachments),并从写入 map
// 移除该字段——不走保真层插入路径(saveAttachments 会复制一条、留下 UNKNOWN 孤儿)。
for (Object o : list) {
String docId = attachmentDocId((Map<String, Object>) o);
if (docId != null && !docId.isBlank()) {
capturedIds.add(docId);
}
}
keysToRemove.add(e.getKey());
} else {
// 修改:→ [{SYS_DOC_ID}] 交保真层 updateAttachments 对账(保留已存/软删移除/已上传不重复插)。
List<Map<String, Object>> legacy = new ArrayList<>();
for (Object o : list) {
String docId = attachmentDocId((Map<String, Object>) o);
if (docId != null && !docId.isBlank()) {
Map<String, Object> m = new LinkedHashMap<>();
m.put("SYS_DOC_ID", docId);
legacy.add(m);
}
}
e.setValue(legacy);
}
}
for (String k : keysToRemove) {
map.remove(k);
}
return capturedIds;
}
/**
* 新建保存后把上传的附件改挂到新记录主键:{@code UPDATE sys_doc SET businesskey=新主键}
* (直接改挂、非复制 → 无 UNKNOWN 孤儿)。新主键取引擎返回 {@code result.<TABLE>_ID};
* 仅改 {@code businesskey} 仍为 {@code UNKNOWN/空} 的未挂行(防误挂他人已挂附件)。businesskey 右补白
* 到 36 位对齐保真层 {@code getDoc}(CHAR(36) 主键)。
*/
@SuppressWarnings("unchecked")
private void relinkInsertedAttachments(String flowId, Object output, List<String> docIds) {
if (docIds == null || docIds.isEmpty() || jdbcTemplate == null) {
return;
}
String table = insertFlowTable(flowId);
if (table == null) {
return;
}
// 原始 output 的 result 多为 GeneralPOJO(非 Map),先归一展平再取主键列。
Object normalized = normalize(output);
Object res = (normalized instanceof Map<?, ?> m && m.get("result") instanceof Map<?, ?> r) ? r : normalized;
if (!(res instanceof Map<?, ?> rm)) {
return;
}
Object pk = ((Map<String, Object>) rm).get(table + "_ID");
if (pk == null || String.valueOf(pk).isBlank()) {
return;
}
String businessKey = String.format("%-36s", String.valueOf(pk).trim());
for (String docId : docIds) {
try {
jdbcTemplate.update(
"UPDATE sys_doc SET businesskey = ?, tablename = ? WHERE sys_doc_id = ? "
+ "AND rtrim(businesskey) IN ('UNKNOWN', '') AND isactive = 1",
businessKey, table, docId.trim());
} catch (Exception ex) {
log.warn("[FLOW] 附件改挂失败 docId={} → {}: {}", docId, table, ex.toString());
}
}
}
/** 插入流名 {@code <TABLE>_ADD/_INSERT/_NEW} → 业务表名 {@code <TABLE>};非插入流返回 null。 */
private static String insertFlowTable(String flowId) {
if (flowId == null) {
return null;
}
String u = flowId.toUpperCase();
for (String suf : new String[] {"_ADD", "_INSERT", "_NEW"}) {
if (u.endsWith(suf)) {
return u.substring(0, u.length() - suf.length());
}
}
return null;
}
/** 插入流判定:服务流名以 {@code _ADD/_INSERT/_NEW} 结尾。 */
private static boolean isInsertFlow(String flowId) {
return insertFlowTable(flowId) != null;
}
/** amis 附件对象签名:Map 且 {@code url} 形如 {@code /api/file/...}(附件专属,子表行不会命中)。 */
private static boolean isAmisAttachmentItem(Object o) {
return o instanceof Map<?, ?> m
&& m.get("url") instanceof String s
&& s.contains("/api/file/");
}
/** 从 amis 附件对象提取 sys_doc id:优先 {@code value},回退 {@code url} 末段,再回退 {@code id}
* (新上传对象 id 被 amis 改写为本地 guid,故 id 优先级最低)。 */
private static String attachmentDocId(Map<String, Object> item) {
Object v = item.get("value");
if (v != null && !String.valueOf(v).isBlank()) {
return String.valueOf(v).trim();
}
if (item.get("url") instanceof String s) {
int i = s.lastIndexOf('/');
if (i >= 0 && i < s.length() - 1) {
return s.substring(i + 1).trim();
}
}
Object id = item.get("id");
return id == null ? null : String.valueOf(id).trim();
}
private static long toLong(Object v) {
if (v instanceof Number n) {
return n.longValue();
}
if (v == null) {
return 0;
}
try {
return Long.parseLong(String.valueOf(v).trim());
} catch (NumberFormatException ex) {
return 0;
}
}
/** view_page 里的可编辑引用字段:列名(大写) + dialogid(picker 数据源) + 是否多选。 */
private record RefField(String name, String dialogid, boolean multi) {}

View File

@@ -4,12 +4,16 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.anyString;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
@@ -20,6 +24,7 @@ import org.junit.jupiter.api.Test;
import org.mockito.ArgumentCaptor;
import org.springframework.http.ResponseEntity;
import org.springframework.jdbc.core.JdbcOperations;
import org.springframework.mock.web.MockMultipartFile;
/**
* WS-D D.2 FileController.list(按业务 id 列已有附件)单测(mock JdbcTemplate,不连库)。
@@ -142,4 +147,39 @@ class FileControllerTest {
assertEquals(evilTable.trim().toUpperCase(), boundArgs.get(0));
assertEquals(evilKey.trim(), boundArgs.get(1));
}
@Test
@DisplayName("6. upload businesskey 右补白到 36 位(对齐保真层 CHAR(36) 主键;否则 loadDoc 查不到新附件)")
void uploadPadsBusinessKeyTo36() throws Exception {
Path tmpRoot = Files.createTempDirectory("eip4-file-test");
FileController c = new FileController(jdbc, tmpRoot.toString());
MockMultipartFile file = new MockMultipartFile("file", "新附件.txt", "text/plain",
"hello".getBytes(StandardCharsets.UTF_8));
// 先挂 thenAnswer 捕获 INSERT 变长绑定参数(docId, tableName, businesskey, ...);
// 变长参兼容「展开」与「Object[] 数组」两种形态。
List<Object> bound = new java.util.ArrayList<>();
when(jdbc.update(anyString(), any(Object[].class))).thenAnswer(inv -> {
Object[] all = inv.getArguments();
for (int i = 1; i < all.length; i++) {
if (all[i] instanceof Object[] arr) {
for (Object x : arr) {
bound.add(x);
}
} else {
bound.add(all[i]);
}
}
return 1;
});
ResponseEntity<Map<String, Object>> resp =
c.upload(file, "oa_newsmanage", "4028803441ba7914014249d52dfa39bb");
assertEquals(0, resp.getBody().get("status"));
assertEquals("OA_NEWSMANAGE", bound.get(1), "tableName 入库前大写");
String businesskey = (String) bound.get(2);
assertEquals(36, businesskey.length(), "businesskey 右补白到 36 位(保真层 CHAR(36) 主键语义)");
assertEquals("4028803441ba7914014249d52dfa39bb", businesskey.trim(), "去白后等于原业务键");
}
}

View File

@@ -4,6 +4,7 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertInstanceOf;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import static org.junit.jupiter.api.Assertions.assertNull;
import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.mock;
@@ -203,6 +204,127 @@ class FlowControllerTest {
assertEquals("姓名u3", owner.get("_label"));
}
@Test
@DisplayName("4c. load 响应附件列(大写 SYS_DOC_ID/FILENAME) → 归一为 amis input-file 契约 {id,value,name,url,sizeKb}")
@SuppressWarnings("unchecked")
void postLoadNormalizesAttachmentContract() {
String flowId = "OA_NEWSMANAGE_LOAD";
Map<String, Object> doc1 = new LinkedHashMap<>();
doc1.put("SYS_DOC_ID", "doc-1 "); // 末尾 CHAR 补白,归一时应 trim
doc1.put("FILENAME", "图片1.jpg");
doc1.put("FILESIZE", 43000);
Map<String, Object> record = new LinkedHashMap<>();
record.put("TITLE", "测试");
record.put("DOCUMENT", new ArrayList<>(List.of(doc1)));
Map<String, Object> output = new LinkedHashMap<>();
output.put("result", record);
FlowExcuteService engine = mock(FlowExcuteService.class);
when(engine.excute(any(), any(), eq(flowId))).thenReturn(output);
FlowController controller = new FlowController(engine, resolverReturning(flowId, namedHit()));
ResponseEntity<Map<String, Object>> resp = controller.executePost(flowId, null, new HashMap<>());
Map<String, Object> data = (Map<String, Object>) resp.getBody().get("data");
Map<String, Object> loaded = (Map<String, Object>) data.get("result");
List<Map<String, Object>> docs = (List<Map<String, Object>>) loaded.get("DOCUMENT");
assertEquals(1, docs.size());
Map<String, Object> f = docs.get(0);
assertEquals("doc-1", f.get("id"), "trim CHAR 补白");
assertEquals("doc-1", f.get("value"), "提交值=sys_doc id");
assertEquals("图片1.jpg", f.get("name"));
assertEquals("/api/file/doc-1", f.get("url"));
assertEquals(42L, f.get("sizeKb"), "ceil(43000/1024)=42");
}
@Test
@DisplayName("4d. 写流附件字段归一:amis 对象数组 → [{SYS_DOC_ID}](保真层 updateAttachments 契约,防 ClassCast/重复插入)")
@SuppressWarnings("unchecked")
void postWriteNormalizesAttachmentToLegacyList() {
String flowId = "OA_NEWSMANAGE_UPDATE";
FlowExcuteService engine = mock(FlowExcuteService.class);
ArgumentCaptor<Map<String, Object>> mapCap = ArgumentCaptor.forClass(Map.class);
when(engine.excute(mapCap.capture(), any(), eq(flowId))).thenReturn(new LinkedHashMap<>());
FlowController controller = new FlowController(engine, resolverReturning(flowId, namedHit()));
Map<String, Object> doc1 = new LinkedHashMap<>();
doc1.put("id", "d1");
doc1.put("value", "d1");
doc1.put("name", "a.jpg");
doc1.put("url", "/api/file/d1");
Map<String, Object> doc2 = new LinkedHashMap<>(); // 无 id/value → 回退 url 末段解析
doc2.put("name", "b.jpg");
doc2.put("url", "/api/file/d2");
Map<String, Object> body = new LinkedHashMap<>();
body.put("TITLE", "t");
body.put("DOCUMENT", new ArrayList<>(List.of(doc1, doc2)));
controller.executePost(flowId, null, body);
Map<String, Object> sentToEngine = mapCap.getValue();
List<Map<String, Object>> docs = (List<Map<String, Object>>) sentToEngine.get("DOCUMENT");
assertEquals(2, docs.size());
assertEquals("d1", docs.get(0).get("SYS_DOC_ID"));
assertEquals("d2", docs.get(1).get("SYS_DOC_ID"), "无 id 时从 url 末段解析");
assertEquals(java.util.Set.of("SYS_DOC_ID"), docs.get(0).keySet(), "归一后仅保留 SYS_DOC_ID");
assertEquals("t", sentToEngine.get("TITLE"), "非附件字段不动");
}
@Test
@DisplayName("4e. 新建流附件:从写入 map 剥离 DOCUMENT;保存后用返回新主键 UPDATE sys_doc 改挂(无孤儿、无复制)")
@SuppressWarnings("unchecked")
void postInsertRelinksAttachmentToNewPk() {
String flowId = "OA_NEWSMANAGE_ADD";
Map<String, Object> result = new LinkedHashMap<>();
result.put("OA_NEWSMANAGE_ID", "newpk-123");
Map<String, Object> output = new LinkedHashMap<>();
output.put("result", result);
FlowExcuteService engine = mock(FlowExcuteService.class);
ArgumentCaptor<Map<String, Object>> mapCap = ArgumentCaptor.forClass(Map.class);
when(engine.excute(mapCap.capture(), any(), eq(flowId))).thenReturn(output);
JdbcTemplate jdbc = mock(JdbcTemplate.class);
List<Object> upd = new ArrayList<>();
String[] sql = new String[1];
when(jdbc.update(any(String.class), any(Object[].class))).thenAnswer(inv -> {
sql[0] = inv.getArgument(0);
Object[] a = inv.getArguments();
for (int i = 1; i < a.length; i++) {
if (a[i] instanceof Object[] arr) {
for (Object x : arr) {
upd.add(x);
}
} else {
upd.add(a[i]);
}
}
return 1;
});
FlowController controller = new FlowController(engine, resolverReturning(flowId, namedWrite()),
null, null, null, null, jdbc, null);
Map<String, Object> up = new LinkedHashMap<>();
up.put("id", "local-guid"); // amis 上传后把 id 改写为本地 guid(不可用)
up.put("value", "doc-new"); // 提交值 = sys_doc id
up.put("name", "a.jpg");
up.put("url", "/api/file/doc-new");
Map<String, Object> body = new LinkedHashMap<>();
body.put("TITLE", "t");
body.put("DOCUMENT", new ArrayList<>(List.of(up)));
controller.executePost(flowId, null, body);
// 1) 发给引擎的 map 已剥掉 DOCUMENT(保真层插入路径不碰附件 → 无复制/孤儿)
assertNull(mapCap.getValue().get("DOCUMENT"), "新建时 DOCUMENT 从写入 map 剥离");
assertEquals("t", mapCap.getValue().get("TITLE"));
// 2) 保存后改挂:UPDATE sys_doc.businesskey = 新主键(36 位补白)
assertNotNull(sql[0]);
assertTrue(sql[0].contains("UPDATE sys_doc SET businesskey"), "应改挂 sys_doc: " + sql[0]);
assertEquals(36, ((String) upd.get(0)).length(), "businesskey 右补白到 36");
assertEquals("newpk-123", ((String) upd.get(0)).trim());
assertEquals("OA_NEWSMANAGE", upd.get(1));
assertEquals("doc-new", upd.get(2));
}
@Test
@DisplayName("4b. 无 JWT 上下文时,读流执行期间临时绑定 ADMIN UserSession,执行后清理")
void readFlowBindsAdminUserSessionWhenMissing() {