# 基础字段使用教程

本文介绍如何使用基础信息组件管理“每个二维码不同的内容”，适用于设备档案、资产台账、人员信息、证卡信息等场景。

## 一、什么是基础字段

基础字段用于展示「每个二维码不同的信息」。它会把字段统一放在一个表格中管理，配置更清晰，维护更方便。既支持批量模板生码(/help/bulk-qr-code/bulk-generation-and-management)，也支持单码使用。

先在二维码模板中配置好基础字段，后续批量生码时导入不同数据，每个二维码就会自动显示对应内容。例如人员场景中，可以添加姓名、电话、部门、岗位等字段；设备场景中，可以添加编号、位置、生产日期、报废日期、负责人等字段。

基础字段支持：

- 多种字段类型：文本、数字、日期、图片、文件、定位、链接、单选、多选等，按信息的性质选择对应类型；
- 拖动排序：调整字段的展示顺序；
- 字段分组：将相关字段归为一类，结构更清晰；
- 统一管理：增删字段、改名都在一处完成；
- 重点字段：后续将支持把某个字段设为重点，突出展示并在临近到期时提醒，例如灭火器报废日期；
- 对接 API 生码：通过接口批量写入数据，自动化生码。

## 二、什么时候适合使用基础信息组件

当你希望二维码中展示的信息具有以下特点时，建议使用基础信息组件：

- 每个二维码展示的内容不同；
- 字段较多，需要统一管理；
- 后续会批量导入 Excel 或表格数据；
- 需要长期维护字段结构；
- 后续可能通过 API 批量生码；
- 当前先做单码，后续可能扩展成批量生码。

如果你对自由排版要求更高，也可以继续根据实际场景选择其他内容展示方式。

## 三、如何在批量模板中使用基础字段

你可以按 4 步在批量模板中完成基础字段配置：进入模板编辑页、添加字段、调整页面样式、保存模板并生码。批量模板就像二维码的「模具」，添加基础字段后，后续只需填写或导入不同数据，就能快速生成一批内容不同的二维码。

### 1. 进入批量模板编辑页

进入管理后台，找到需要编辑的活码批量模板。你可以选择创建一个新的批量模板，也可以打开已有模板，进入模板详情页后点击「修改批量模板」，进入批量模板编辑页。

### 2. 在模板中添加基础字段

在模板编辑页面，添加「基础字段」。将每个二维码中需要变化的内容，例如「姓名」「电话」「部门编号」「报废日期」等，添加到基础字段中，并为每个字段选择合适的类型。

后续生码时，只需要填写或导入不同的数据，系统就会自动将数据填入对应字段。

![添加基础字段](https://gstatic.clewm.net/cl-cms/260728/1af9dc_yjqwj01c.png)
>图片说明：展示后台模板编辑界面中“基础字段”组件的添加与配置流程，含组件位置、操作指引及预览效果。

基础字段支持文本、数字、日期、图片、文件、定位、链接、单选、多选等多种字段类型，按信息的性质选择对应类型即可。部分文本、数字字段还可以设置默认值。

![设置基础字段](https://gstatic.clewm.net/cl-cms/260728/1af9dc_zyrevl73.png)
>图片说明：后台编辑基础字段的配置界面，支持添加资产名称、编号等字段并设置数据类型与批量填写功能。

并不是所有字段都要「每个码不同」。像「品牌」「厂区」这类全批一致的信息，可以直接在模板里固定填写；只把真正会变化的信息留给生码时填写。

### 3. 按需配置二维码页面样式

基础字段添加完成后，可以继续按需配置二维码页面样式，例如添加背景效果、表单(/help/forms/form-feature)、状态(/help/status/status-feature)等。字段较多时，建议用字段分组把相关字段收拢成几块，扫码人更容易找到需要的信息。

![配置二维码页面样式](https://gstatic.clewm.net/cl-cms/260728/1af9dc_o3vz178f.png)
>图片说明：该图展示的是后台模板编辑界面，左侧为组件库，中间为编辑区域，右侧为标签样式设置与保存功能，用于配置批量生码模板的视觉结构。

### 4. 保存模板并批量生码

模板配置完成后，点击保存模板。然后选择一种生码方式，填写对应字段的数据，就可以批量生成一批内容不同的二维码。

![保存模板](https://gstatic.clewm.net/cl-cms/260728/1af9dc_3ad2akwt.png)
>图片说明：展示批量模板编辑界面，右侧为标签样式预览与“保存模板”操作区域，用于配置资产信息的批量导入字段及样式。

系统提供在线表格填写(/help/bulk-qr-code/bulk-dynamic-qr-code/generate-with-template/online-spreadsheet-bulk-generation)、导入 Excel(/help/bulk-qr-code/bulk-dynamic-qr-code/generate-with-template/excel-bulk-qr-code-generation)、单个填表新建 3 种生码方式，你可以按需选择。

## 四、如果你之前已经使用过可变内容字段

如果你之前已经用「可变内容」做过批量模板，不用担心，核心使用场景并没有变，还是为了实现「每个二维码展示不同内容」。

你可以这样理解：

- 以前：在模板里逐个添加可变内容，占位比较分散；
- 现在：通过基础字段集中管理字段，结构更清晰，字段有类型，后续维护更方便。

对于老用户，重点关注这几点：

- 使用目的变了吗？没变，仍然是实现「每码不同内容」。
- 主要变化是什么？字段从分散占位，变为集中管理，且支持多种字段类型。
- 有什么好处？结构更清晰，维护更方便，也更适合后续扩展、API 生码。
- 新模板怎么做？按需选择即可；如果字段多、后续要长期维护，建议优先使用基础字段。
- 老模板怎么办？可继续使用；如需提升维护效率，可逐步迁移。

如果你之前已经添加过可变内容，后面想切换为基础字段模式，也可以直接在批量模板编辑器左上角的可变内容列表中，切换为「基础字段模式」。

注意：基础字段支持添加图片和文件，但目前会统一显示在基础信息表格中。暂不支持将图片、文件自由插入到页面任意位置。

## 五、如何在单码中使用基础字段

基础字段不只支持批量模板，单个二维码也可以使用。如果你还不熟悉单个活码的编辑入口，可以先了解活码编辑器(/help/content-display/dynamic-qr-code-editor)。

如果你当前只是先做一个码，但后续可能会扩展成多个码，也可以先在单码中使用基础字段录入内容。

这样做的好处是：

- 可以先快速验证内容展示方式；
- 后续如果要扩展成多个码，可以直接转为批量管理，已录入的字段和内容会一并带过去；
- 也支持后续通过 API 生码。

如果你还不确定最终要做几个码，先用单码搭建会更灵活。

![单码中使用基础字段](https://gstatic.clewm.net/cl-cms/260728/1af9dc_41ey56bs.png)
>图片说明：展示“基础字段”组件的编辑界面，用于在模板中添加资产名称、编号等核心字段，并预览其极简双列显示效果。

提示：做单码时，就把「以后每个码会不一样」的信息，如编号、位置、报废日期等，放进基础字段，而不是写死在正文里。这样后续扩展成批量时，这些字段能直接复用。

## 六、如何确认设置成功

完成设置后，可以从以下几个方面确认基础字段已经生效：

- 在二维码预览区，能看到基础信息按字段展示；
- 字段顺序、分组和名称与刚才保存的配置一致；
- 使用模板生码后，不同子码能显示各自对应的数据；
- 扫码查看时，姓名、编号、部门、位置等重点信息能快速被识别；
- 若使用了重点字段相关能力，以产品内实际展示的高亮、剩余时间或提醒效果为准。

如果修改字段后页面没有变化，先确认是否已经保存模板。批量模板保存后，新生成的子码会使用最新模板；如果修改的是标签样式，同一模板下所有子码的标签也会同步更新。

## 七、常见问题

### 1. 模板保存后，还能继续修改吗？

可以。保存后的模板仍然可以继续修改。

修改模板后，同一模板下的新子码会自动使用最新模板。如果修改的是标签样式，模板下所有子码的标签也会同步更新。

### 2. 基础字段只能用于批量生码吗？

不是。单个二维码也可以使用基础字段，后续还可以转为批量管理。

### 3. 基础字段和 Excel 导入是什么关系？

基础字段负责定义「要展示哪些字段」，Excel 导入负责提供「每个二维码的具体数据」。

例如，基础字段中有「姓名」「部门」「电话」3 个字段，导入 Excel 时就可以为每个二维码填写不同的姓名、部门和电话。

### 4. 什么是重点字段？现在能用吗？

重点字段是指被标记为「需要重点关注」的字段，例如灭火器报废日期。相关能力陆续开放，开放后可用于突出展示，并在临近到期时高亮、显示剩余时间或推送提醒。具体以产品内实际显示为准。

### 5. 报废日期这类字段，用文本可以吗？

不建议。用文本填写，日期格式容易不统一，如「25 年 3 月」「2025.3」，系统无法识别，也就无法做临期高亮和到期提醒。请使用日期类型。

### 6. 如果以后要接 API 生码，现在要不要先用基础字段？

建议直接使用。这样后续从手工导入切换到 API 生码会更顺畅。

### 7. 老模板里的可变内容还能不能继续用？

可以继续用。如果原模板已经在正常使用，不需要立即迁移。

新建模板时，如果你更看重字段统一管理、字段类型、后续维护和 API 生码，建议直接使用基础字段。