运动员管理
与一些成绩统计软件不同，InstaPunch区别对待运动员个体及其所参加的赛事。因此运动员管理实际上可以分为：
- 基本信息：运动员基本信息包括姓名、性别、单位、组别、邮箱等与参赛者个体相关的信息，这些信息对于不同竞赛日的同一个运动员应该是相同的。
- 参赛信息：每个运动员针对每场竞赛日都有一个参赛信息，包括该运动员在该场比赛时使用的指卡号、号码簿、通道、出发时间等。
下图便是软件中的运动员管理页面。界面的右侧是运动员表格，右侧的参赛信息列数与建立的竞赛日有关，
竞赛日每个单元格会使用不同的颜色标明各个运动员在对应竞赛日的情况。其中，白色代表不参加该竞赛日(下图D1)，如果参加则有三种颜色状态：红色代表没有分配通道(下图D4)，黄色代表分配了通道但是对应没有路线(下图D3)，绿色表示通道和路线都已配置(下图D2)。通道是运动员每场赛事成绩统计的关键部分，你可以在后面的章节详细了解通道和路线的概念。
界面左侧则是树状筛选区，默认按照俱乐部->组别的模式进行分组展示，也可以通过分组单选框反转层次。每一层次的括号内表示该层次运动员的数量.如下图所示，没有选中时将显示所有运动员，选中时将进行筛选，支持跨层次多选。右键筛选区可以展开/收起全部，以及清除当前选择的分组:
分组旁的小搜索框可以对分组层次进行搜索：
左上方的所有竞赛日下拉框可以按照运动员是否报名对应竞赛日进行直接筛选：
总之，左侧面板的全部功能都是为筛选出运动员而服务的，运动员列表的显示结果将先按照左侧分组进行筛选，再根据搜索框内容进行搜索（如有）。右侧大搜索框旁边的总计为当前筛选+搜索结果的计数。
新增
如果期望手动新增运动员，可以在左侧筛选区的第二层点击右键新建运动员，其编号会自动取当前最大的运动员编号加一。
修改运动员基础信息
双击修改
通过双击白色单元格可以直接修改单个运动员的基础信息，单位和组别需要在弹出的选择器中进行双击选择。
多选右键修改批量修改
多选行后在某一列右键可以对所选运动员的这一属性进行批量操作。如下图所示，目前支持的批量操作包括：
- 修改单位、组别、性别
- 修改是否参加某场赛事
- 修改某场赛事使用的通道
- 在运动员指卡号右键，可以使用该号码覆盖所有竞赛日的指卡号；在竞赛日的指卡号右键，可以将当前指卡号改为运动员的指卡号。
修改运动员参赛信息
参赛信息修改与前面类似，具备单个双击和多选右键两种模式，但双击提供的是详细编辑功能，而右键只提供一些快捷基础功能。
双击修改参赛信息
双击参赛信息会弹出编辑对话框，在这里你可以修改对应的指卡号、号码布、通道、出发时间、是否参加等。通道默认开启同组筛选，你可以去掉后选择其他组别的通道（并不推荐），修改完成后点击SAVE保存修改
右键的快捷功能
选择后右键弹出菜单，包含快速禁用/启用、重设为运动员指卡号、分配对应组别默认通道、手动设置通道、清除设置的通道等功能，一般的活动使用右键菜单提供的功能基本能满足需求。
基于CSV格式的导入/导出模板
InstaPunch使用CSV作为导入、导出运动员名单的数据格式。每行表示一位运动员，每列表示该运动员的某个信息。首先是必须包含的六个运动员基本信息字段：
| 字段名 | 含义 | 必须 |
|---|---|---|
| COMPETITOR_NUMBER | 运动员编号 | ✔ |
| COMPETITOR_NAME | 运动员姓名 | ✔ |
| CLUB | 俱乐部名称 | ✔ |
| CATEGORY | 组别名称 | ✔ |
| GENDER | 性别 | ❌ |
| CHIP_NUMBER | 运动员指卡号 | ✔ |
- 运动员编号
用以识别一个运动员，从1开始递增。多日赛成绩计算以运动员编号为基础，务必保证唯一。最简单的生成方法是使用Excel等表格软件拖动生成。
- 俱乐部
俱乐部（单位）的名称，导入时会抽取该字段自动建立俱乐部条目，请务必检查同单位运动员该字段是否一致，否则会重复创建俱乐部。
- 性别
性别（GENDER）列不是必须的，如果未提供性别列且组别（CATEGORY）一栏使用了M**/W**/**男子组/**女子组等包含提示性别的字眼，会自动判断运动员性别。
- 运动员指卡号
运动员指卡号只是一个存储字段，这与参赛信息中的参赛指卡号并不一致。如填写任意非0数字将解析为指卡号，否则认为是没有指卡，在软件中显示为Not Set。
- 运动员参赛信息的两个字段
| 字段名 | 含义 | 必须 |
|---|---|---|
| {竞赛日名称} | 用“Y”/“是”表达是否参加，或者是该场使用的指卡号 | ✔ |
| {竞赛日名称} BIB | 运动员该场号码布 | ✔ |
- {竞赛日名称}
如下图红框所示，各竞赛日内容的首列以该竞赛日命名，不包含任何后缀
这一列将同时决定该运动员是否参加本场比赛以及本场比赛使用的指卡号，具体而言按照如下规则处理
以上量个字段为一组，每个竞赛日一组，也就是每一行的数据为
基本信息(6列) + 竞赛日1的参赛信息(1到2列) + 竞赛日2的参赛信息(1到2列) +...+ 竞赛日n的参赛信息(1到2列)
获取模板
只需要点击运动员页面右下角的导出CSV即可获得所需的导入模板。模板的内容取决于竞赛日的配置。如果没有建立竞赛日，导出的CSV模板将只包含运动员基本信息的六个字段
如果按照 竞赛日配置 的指示预先建立了竞赛日，则导出的CSV模板将额外包含竞赛日的表头，其中以BIB结尾的表示对应竞赛日的号码布。
整合外部数据
获取模板后（当然也可以手动建立这样的CSV，需要确保字段名大小写一致）可以用Excel等文档软件打开，将收集表的模板内容复制到csv中。完成后应如下图所示
关于运动员编号
请确保运动员编号是唯一的，如不确定最好重新拖动生成一次
关于文件编码
请务必使用UTF8编码的逗号分隔符文件进行导入导出，否则会出现导入失败的问题
导入运动员
InstaPunch支持两种导入模式。分别是所有竞赛日整体导入和各竞赛日独立导入。这一设计是为了尽可能在易于理解的情况下适配更多样的数据来源。
整体导入
整体导入就是一次导入所有竞赛日的信息，如果你的报名表是按照多个竞赛日一同收集的，那么整体导入更加适合。
为保障兼容性，上述CSV字段必须用字段名，不能使用中文。
独立导入
如果你的多日赛是每一个竞赛日单独收集，下图就是一个例子，有的运动员两场都会参加，有的则只会报名其中某一场，这导致两个竞赛日的收集表并不完全相交：
通常来说这需要负责报名的工作人员利用Excel的VLookUp之类的公式将两个收集表的结果合并到一张大表，但VLookUp的语法比较复杂且用法繁琐，并不是人人都能轻松掌握。
更简单的办法是使用InstaPunch提供的独立导入模式：
注意
独立导入模式不会进行运动员删除标记，但如果不同竞赛日的同一个运动员填写的运动员基础信息有差异，将会以最后一次导入为准。
恭喜！🎉 至此，你成功使用InstaPunch导入、管理运动员名单，接下来的内容将是队伍管理。