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>
This commit is contained in:
2026-06-18 13:09:36 +08:00
parent 75885f9d7d
commit 22211b2557
6 changed files with 464 additions and 81 deletions

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;
}
/**