跳到主要内容

基础字段使用教程

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

一、什么是基础字段​

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

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

基础字段支持：

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

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

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

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

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

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

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

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

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

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

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

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

添加基础字段

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

设置基础字段

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

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

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

配置二维码页面样式

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

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

保存模板

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

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

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

你可以这样理解：

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

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

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

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

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

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

基础字段不只支持批量模板，单个二维码也可以使用。如果你还不熟悉单个活码的编辑入口，可以先了解活码编辑器。

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

这样做的好处是：

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

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

单码中使用基础字段

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

六、如何确认设置成功​

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

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

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

七、常见问题​

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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