异步导入数据字典列表（JMS 发布受理）#

验证状态：存在关键缺口，不可作为完整契约发布；适用基线：Web 7fe6dd10、services 89bd222c；核验日期：2026-09-12

用途与 App 场景#

把一批数据字典写入请求发布到 JMS 通道 data dictionary import list（租户随载荷传递）。HTTP 成功只代表发布受理；最终消费方在仓外（见已知缺口），本页按质量标准标注为关键缺口页，不能当作可用的完整导入合同。

Web 使用位置#

协议身份#

前置条件与权限#

需要有效登录态，并满足 administrator 角色或 configuration-data-dictionary:create。 发布前用当前认证租户填充载荷（TenantIdSupplierExecutor），以 tenant-less 上下文发布；资源表写入侧的租户归属由仓外消费方决定，缺证。认证与空间。

输入#

输出、应答或事件#

完成判据#

status=200 && data=true 只表示 JMS 发布调用已提交（事务后发布，TenantlessPublishExecutor）。它不是导入成功：仓内没有该通道的消费者，最终是否落库、逐行结果、失败回传全部缺证。调用方不得把该响应当作导入完成信号。

示例#

以下均为按已核验契约构造的示例，不是真实联调记录；ID、时间与租户为占位值。

请求：

1[
2  {
3    "dataDictionaryTypeCode": "device-vendor",
4    "dataDictionaryCode": "hikvision",
5    "value": "海康威视",
6    "name": "海康威视",
7    "sort": 1
8  }
9]

成功响应：

1{
2  "timestamp": 1789142400000,
3  "status": 200,
4  "error": null,
5  "localizedError": null,
6  "path": null,
7  "extraData": {},
8  "data": true
9}

信封字段证据：gt-common-core/src/main/java/tech/gt/api/ApiResult.java（成功/失败信封）与 es-center-server-main-service/src/main/java/com/es/center/server/config/JsonFormatConfig.java:20-113（时间序列化）。

错误与边界#

认证失败/权限失败：认证与资源权限拒绝的 wire 形态见错误差异页对应锚点。 Bean Validation（@NotBlank/@Size）与参数绑定失败适用请求校验（HTTP 200，body 400/1002-1004）。 @Valid 标注在 List 参数上，框架是否对元素逐项级联校验未由本仓源码或测试证明；空数组也会被发布。 公共 Web helper 默认 15 分钟超时（app/.common/lib/fetch-timeouts.ts:4-76 fetchTimeout/fetchTimeoutResponseJson）。本组写/导入操作没有幂等键，超时后须先读取资源状态再决定是否重试，不能仅凭超时盲重试。

调用关系与资源清理#

HTTP 返回后 Web 直接 toast 成功并 reload 列表；由于消费方缺证，reload 看不到新数据不代表导入被拒绝，看到新数据也不代表全部行已按预期落库。

已知缺口#

关键缺口（本页因此不可作为完整契约发布）：services 全仓没有任何 @JmsListener 消费 data dictionary import list 通道；es-center-server-main-service/src/test/java/com/es/center/server/message/JmsChannelContractTest.java:70-93 把该通道显式列为 EXTERNAL_CONSUMER_BOUNDARY_DESTINATIONS（"仓外消费状态无法由本仓证明；显式冻结边界可保留 wire"）。因此：

• 导入是否最终落库、以什么语义 upsert、逐行校验与失败回传、幂等与重试语义均缺证，责任端为仓外消费方。
• XLSX 行以字符串读取后发送（sort 在 wire 上是字符串数字），服务端反序列化是否接受未经联调证明；App 导入应优先发送数字类型。 未执行真实 HTTP、JMS 或部署环境联调。

验证状态与依据#