ES Documentation
手册
API
手册
API
简体中文

按 ID 查询值集映射详情

验证状态：已源码核验、未联调；适用基线：Web 7fe6dd10、services 89bd222c；核验日期：2026-09-12

用途与 App 场景

按 ID 读取单条值集映射详情。当前 Web 编辑与查看页用其预填表单。

Web 使用位置

页面/功能 角色或空间分支 调用证据
编辑/查看表单预取 后端授权 administrator 或 value-set-map:read；前端入口见调用证据 app/routes/($lng).$spaceId.configuration.value-set-map.edit.$valueSetMapId/route.tsx:65
编辑/查看表单预取（2） 后端授权 administrator 或 value-set-map:read；前端入口见调用证据 app/routes/($lng).$spaceId.configuration.value-set-map.view.$valueSetMapId/route.tsx:35

协议身份

项 值
operationId http-get-main-service-system-api-configuration-value-set-map-getbyid-ff227f03
method + path GET /main-service/system-api/configuration/value-set-map/getById
base URL 当前 Web 使用同源相对 URL；App 的部署 base URL 未由源码固定
headers Accept: application/json;charset=UTF-8；有登录态时 Authorization: Bearer <token>；query 请求不发送 Content-Type
序列化 query 参数由 qs.stringify(..., { arrayFormat: "repeat" }) 编码；单标量无差异

前置条件与权限

需要有效登录态，并满足 administrator 角色或 value-set-map:read。 资源表受 MyBatis 租户拦截器按当前认证租户上下文约束（es-center-server-main-service/src/main/java/com/es/center/server/config/MybatisPlusConfig.java:72-88；configuration 表不在 tenant-id-ignore-tables 白名单），请求中的租户筛选字段不能代替空间切换。认证与空间。

输入

JSON 路径/参数 JSON 类型 位置 必填 可空 默认值 枚举/范围/单位 说明 字段证据
id string query 是 否 无 非空；服务端无长度校验注解 资源主键（valueSetMapId） Controller @NotBlank

输出、应答或事件

JSON 路径 JSON 类型 出现条件 可空 枚举/范围/单位 说明 字段证据
timestamp number JSON 响应 否 epoch 毫秒 响应生成时间 gt-common-core/src/main/java/tech/gt/api/ApiResult.java
status number JSON 响应 否 成功为 200 不能只看 HTTP status gt-common-core/src/main/java/tech/gt/api/ApiResult.java
error/localizedError/path string | null JSON 响应 是 — 成功通常为 null；失败见差异页 gt-common-core/src/main/java/tech/gt/api/ApiResult.java
extraData object 成功 否 — 本操作无专属键，恒为 {} gt-common-core/src/main/java/tech/gt/api/ApiResult.java
data object | null 业务成功 是 — 详情对象；同租户不存在或跨租户读为 null（不报错）；字段见本资源族字段模型 gt-common-configuration-common/src/main/resources/mapper/postgresql/gt-common-configuration/ValueSetMapMapper.xml#119

完成判据

status=200：读取已完成；data=null 表示同租户范围内未命中（不存在或属于其他租户），不是失败。

示例

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

请求：

1{
2  "id": "vsmap-01"
3}

成功响应：

1{
2  "timestamp": 1789142400000,
3  "status": 200,
4  "error": null,
5  "localizedError": null,
6  "path": null,
7  "extraData": {},
8  "data": {
9    "valueSetMapId": "vsmap-01",
10    "valueSetTypeCode": "gender",
11    "key": "male",
12    "value": "1",
13    "sort": 1,
14    "revision": 1,
15    "createdUsername": "administrator",
16    "createdTime": 1789142400,
17    "lastModifiedUsername": "administrator",
18    "lastModifiedTime": 1789142400,
19    "deleteTime": null,
20    "tenantId": "default"
21  }
22}

信封字段证据：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 形态见错误差异页对应锚点。 公共 Web helper 默认 15 分钟超时（app/.common/lib/fetch-timeouts.ts:4-76 fetchTimeout/fetchTimeoutResponseJson）。读取无副作用，可按网络策略重试。

调用关系与资源清理

编辑页提交后跳回列表；查看页只读展示。无长连接资源。

已知缺口

无已知会阻止按当前源码调用的关键契约缺口。 仅完成双仓静态源码核验，未执行真实 HTTP、数据库或权限矩阵联调。

验证状态与依据

结论 状态 仓库/基线 路径、符号及定位 内容指纹（脏文件）
Web 方法、路径、序列化与消费 已源码核验 web 7fe6dd10 app/.client/api/system/configuration/valueSetMapApi.ts:18 configurationvalueSetMapGetByIdApi；app/routes/($lng).$spaceId.configuration.value-set-map.edit.$valueSetMapId/route.tsx:65；app/routes/($lng).$spaceId.configuration.value-set-map.view.$valueSetMapId/route.tsx:35；公共 wrapper：app/.common/lib/fetch-timeouts.ts:4-76 fetchTimeout/fetchTimeoutResponseJson 证据文件与 HEAD 一致
权限、输入、输出和完成语义 已源码核验 services 89bd222c es-center-server-main-service/src/main/java/com/es/center/server/configuration/controller/ValueSetMapController.java:118 getById；gt-common-configuration-common/src/main/resources/mapper/postgresql/gt-common-configuration/ValueSetMapMapper.xml#119 selectOneResponseDTOBy…Id 证据文件与 HEAD 一致
JSON 字段与时间类型 已源码核验 services 89bd222c 本资源族字段模型；ValueSetMapListResponseDTO.java、ValueSetMapGetByIdResponseDTO.java（gt-common-configuration-dto/src/main/java/tech/gt/configuration/dto/） 证据文件与 HEAD 一致
清单归属 已重新比对 inventory .scratch/institutional-app-api-docs/inventory/operations.json SHA-256 b5cce137b4fc602840fdbe74c99d90667b3e581815bddc709e263ffcc64e00f9（工作树仅既有格式化漂移，本票未修改）
真实部署联调 未执行 — 未发送请求、未连接数据库/缓存/JMS —
目录