---
url: https://www.pingjuba.com/docs/data/attendees
title: 参与人员与分组
description: 看谁签到了、导入名单和唯一签到码、按分组管理嘉宾。
section: data
sectionLabel: 人员与数据
sectionOrder: 9
order: 2
updatedAt: 2026-09-16
platforms: [admin, mobile]
adminPath: /ucenter/users/hdUsers
settingKeys: [import_primary, import_name_field, import_name_display, seat_num_enable]
keywords: [参与人员, 名单导入, 唯一签到码, 签到分组, 自定义分组, 黑名单, 导出Excel]
videoStatus: pending
---

## 这个模块是做什么的

人员数据是**嘉宾的主数据**：谁来了、什么时间签到的、叫什么、坐哪里、在哪个组。
名单验证签到的名单也在这里导入。

人员数据分组里有三个**独立页面**（不是同一个页面的页签）：

| 页面 | 后台路径 | 管什么 |
| --- | --- | --- |
| **参与人员** | `/ucenter/users/hdUsers` | 已加入活动的嘉宾名单 |
| **签到分组** | `/ucenter/users/checkinGroup` | 按签到情况自动分好的组 |
| **自定义分组** | `/ucenter/users/customGroup` | 自己建的分组，用于限定抽奖范围等 |

---

## 后台怎么设置

进入 **人员数据**。

### 参与人员

::docs-figure{src="/asset/builtin/docs/data/attendees/01-list.png" caption="参与人员：全部 / 已签到 / 未签到"}
::

- 顶部可按 **全部 / 已签到 / 未签到** 筛选
- 列表列：昵称、签到时间、黑名单、操作；名单验证签到的活动还会多出
  **唯一签到码**、姓名、手机号、座位号等列
- 右上角**导出**成 Excel

**唯一签到码** 很关键：用名单验证签到时，嘉宾必须填对才能签到。
页面上有提醒「检查唯一签到码是否正确，否则用户无法签到」。

导入名单的模板可以**下载导入名单模板.xlsx**，按模板填好后上传。

### 签到分组

按签到顺序自动分组，适合需要分批的环节，各组的成员列表可以展开查看。

::docs-figure{src="/asset/builtin/docs/data/attendees/02-group.png" caption="签到分组：按签到顺序自动分组"}
::

### 自定义分组

自己建组、把嘉宾放进组里。抽奖时可以只用某个组的人员，
例如「只抽 VIP 组」「只抽市场部」。

> 活动没开报名限制时，非管理员看不到「自定义分组」。

---

## 现场怎么用

1. 入口接待处盯 **参与人员 → 未签到**，名单给接待的人去催
2. 需要分批上台，用**签到分组**念组名
3. 分组抽奖前，先确认目标组里的人是对的
4. 活动结束**导出**名单存档

---

## 配置建议

- 用名单验证签到时，**导入后一定要自查唯一签到码列**，别有空格或格式错
- 名单用 Excel 批量导入，别现场一条条手工加
- 建**自定义分组**做定向抽奖，比现场解释「只抽XX部门」清楚
- 需要**黑名单**功能时在这里标记，被标的人无法参与
- 座位号和参与人员结合使用，见[签到设置](/docs/setup/checkin)里的座位号

---

## 注意事项

> 切换**唯一签到码字段**后，必须**重新导入所有用户的唯一签到码**，否则没人能签到。
> **自定义分组**在没开报名限制的活动里，只有管理员能看到。
> 删人或改名单会影响已有数据，**活动进行中尽量不要改名单**。