---
uuid: "321fadcb-354a-466d-94f2-2b993f329a6f"
type: "tutorial"
title: "基础信息组件使用教程"
sidebar_position: 2
description: "本文介绍如何使用基础信息组件管理每个二维码不同的内容，适用于设备档案、资产台账、人员信息、证卡信息等需要批量维护字段的场景。"
---

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

## 一、什么是基础信息组件

基础信息组件用于展示“每个二维码不同的信息”。它会把字段统一放在一个表格中管理，配置更清晰，维护更方便。既支持批量模板生码，也支持单码使用。

先在二维码模板中配置好基础信息组件，后续批量生码时导入不同数据，每个二维码就会自动显示对应内容。例如人员场景中，可以添加姓名、电话、部门、岗位等基础字段。

![基础信息组件示例](https://blogcdnimg.clewm.net/2026/04/image-1776135636915_17761356373769.png)

基础信息组件支持：

- 拖动排序：调整字段的展示顺序；
- 字段分组：将相关字段归为一类，结构更清晰；
- 统一管理：增删字段、改名都在一处完成；
- 设置重点展示字段：突出显示最重要的信息，此能力后续开放；
- 对接 API 生码：通过接口批量写入数据，自动化生码。

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

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

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

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

## 三、如何在批量模板中使用基础信息组件

你可以把批量模板理解为二维码的“模具”。在模板中添加基础信息组件后，后续只需填写或导入不同数据，就能快速生成一批内容不同的二维码。

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

进入批量生码页面，创建一个新的批量模板，或打开已有批量模板进行编辑。

![进入批量模板编辑页](https://blogcdnimg.clewm.net/2026/04/image-1776134677624_17761346781093.png)

### 2. 在模板中添加基础信息组件

在模板编辑页面，添加“基础信息组件”。将每个二维码中需要变化的内容，例如“姓名”“电话”“部门编号”等，添加到基础信息组件中。

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

![添加基础信息组件](https://blogcdnimg.clewm.net/2026/04/image-1776134834859_17761348352632.png)

基础信息组件支持多种字段类型，包括文本、数字、日期、地址、链接、图片、文件等。部分文本、数字字段，还可以设置默认值。

![设置基础信息字段](https://blogcdnimg.clewm.net/2026/04/image-1776134989863_17761349901992.png)

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

基础信息组件添加完成后，可以继续按需配置二维码页面样式，例如添加背景效果、表单、状态等。

![配置二维码页面样式](https://blogcdnimg.clewm.net/2026/04/image-1776135188968_17761351894256.png)

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

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

![保存模板](https://blogcdnimg.clewm.net/2026/04/image-1776135236477_17761352368956.png)

系统提供在线表格填写、导入 Excel、单个填表新建 3 种生码方式，你可以按需选择。

![选择生码方式](https://blogcdnimg.clewm.net/2026/04/image-1776135319773_17761353202063.png)

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

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

你可以这样理解：

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

![可变内容字段示例](https://blogcdnimg.clewm.net/2026/04/image-1776401134480_17764011347194.png)

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

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

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

![切换为基础信息组件模式](https://blogcdnimg.clewm.net/2026/04/Group-2018776234_17773374349847.png)

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

## 五、如何在单码中使用基础信息组件

基础信息组件不只支持批量模板，单个二维码也可以使用。

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

这样做的好处是：

- 可以先快速验证内容展示方式；
- 后续如果要扩展成多个码，可以转为批量管理；
- 也支持后续通过 API 生码。

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

![单码中使用基础信息组件](https://blogcdnimg.clewm.net/2026/04/image-1776328817597_17763288179580.png)

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

完成设置后，可以从以下几个方面确认基础信息组件已经生效：

- 在二维码预览区，能看到基础信息按字段展示；
- 字段顺序、分组和名称与刚才保存的配置一致；
- 使用模板生码后，不同子码能显示各自对应的数据；
- 扫码查看时，姓名、编号、部门、位置等重点信息能快速被识别。

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

## 七、常见问题

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

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

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

### 2. 基础信息组件只能用于批量生码吗？

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

### 3. 基础信息组件和 Excel 导入是什么关系？

基础信息组件负责定义“要展示哪些字段”，Excel 导入负责提供“每个二维码的具体数据”。

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

### 4. 如果以后要接 API 生码，现在要不要先用基础信息组件？

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

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

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

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