# 把子列表转换为邮件表格

服务把子列表的行对象转换为带内联样式的 HTML 表格，可在支持 HTML 的审批通知、邮件正文或文档生成步骤中使用。

## 输入和输出

| 配置 ID | 类型 | 用途 |
| --- | --- | --- |
| `subListJson` | 文本 | 子列表行对象的 JSON 数组。服务也可以接收直接传入的数组。 |
| `htmlTable` | 文本输出 | HTML 数据表格。 |

## 配置步骤

1. 在测试应用中导入 YCS。调用节点将完整子列表映射给 `subListJson`。
2. 把 `htmlTable` 映射到支持 HTML 的邮件正文或审批通知。发信前可在测试流程预览结果。
3. 按实际列名检查金额、日期和布尔值。记录很多时，先从上游限定本次通知需要的行。

```json
[
  { "物料编码": "0007", "物料名称": "会议资料", "金额": 1250.5, "已验收": true },
  { "物料编码": "0008", "物料名称": "标签纸", "金额": 80, "已验收": false }
]
```

## 表格规则

表头合并每条记录出现的业务列，按第一次出现的顺序排列。系统字段 `_id` 和 `__ctxidx` 不参与展示。完全空白的业务行会跳过，缺失单元格保持空白。没有有效记录时显示「暂无明细」。

文本编码保留前导零和长编号。数值带千分位，布尔值显示「是」或「否」，ISO 日期时间保留原来的日期部分。列名和单元格文本都会转义，业务文本换行显示为表格内换行。

## 验收范围

文件已通过 YCS 格式验证。本地验证了动态列、中文格式、空数据和 HTML 转义。中国版的实际流程调用及目标邮件客户端渲染仍需在测试应用中核对。