跳到主要内容

基础信息组件使用教程

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

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

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

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

基础信息组件示例

基础信息组件支持：

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

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

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

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

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

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

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

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

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

进入批量模板编辑页

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

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

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

添加基础信息组件

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

设置基础信息字段

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

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

配置二维码页面样式

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

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

保存模板

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

选择生码方式

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

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

你可以这样理解：

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

可变内容字段示例

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

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

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

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

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

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

这样做的好处是：

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

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

单码中使用基础信息组件

六、如何确认设置成功​

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

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

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

七、常见问题​

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

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

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

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

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

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

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

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

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

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

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

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

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