研发迁移数据盘点清单用于在迁移前把“要搬什么、在哪里、有多少、谁负责、多敏感、先搬哪批、依赖谁”记录成可交接的表格。它以一行一个待迁移对象集合为基本粒度,至少覆盖对象类型、来源位置、数据量、负责人、敏感级别、迁移优先级、依赖关系七类字段。源系统对象类型多、项目并行、存在多套用户目录时,先按对象类型和项目分批登记,再用敏感级别与依赖关系校正优先级,最后形成盘点总表与分批迁移清单。
要点总览(TL;DR)
- 清单以“一行一个待迁移对象集合”为粒度,主表覆盖对象编号、对象类型、来源系统与位置、数据量、负责人、敏感级别、迁移优先级、依赖关系八列,另配分批迁移子表和账号映射附表。
- 对象类型按源系统实际导出结构取值,常见有需求、任务、缺陷、文档与页面、附件、账号与权限、系统配置;数据量同时记录条数、附件容量、版本数并注明统计时间点。
- 对象编号、对象类型、来源位置、数据量、负责人、敏感级别、迁移优先级、依赖关系为必填,依赖关系无前置时填“无”;备注与批次状态为选填。
- 多项目并行、多套用户目录时,先按对象类型和项目拆行登记,再用依赖关系校正优先级,账号映射附表以“所属用户目录+源账号”识别重名账号。
- 清单按初盘、复核、交接三阶段推进,每次复核保存版本,对象编号不复用,分批结果与对象编号清单分别交接给迁移计划和验证环节。
可复制空白盘点清单模板
下面三张表可以直接复制到表格工具中填写。主表负责登记全部待迁移对象集合,分批子表负责把主表行组织成可执行的迁移批次,账号映射附表单独处理多套用户目录的账号对应关系。三张表通过“对象编号”关联:主表每行分配一个唯一编号,分批子表引用编号圈定批次范围,账号映射附表回填主表的依赖关系。
盘点主表
| 对象编号 | 对象类型 | 来源系统与位置 | 数据量 | 负责人 | 敏感级别 | 迁移优先级 | 依赖关系 | 备注 |
|---|---|---|---|---|---|---|---|---|
分批迁移子表
| 批次 | 对象范围(对象编号) | 前置依赖 | 计划窗口 | 交接人 | 批次状态 |
|---|---|---|---|---|---|
账号映射附表(多套用户目录场景)
| 源账号 | 所属用户目录 | 目标账号 | 映射状态 | 关联对象编号 | 备注 |
|---|---|---|---|---|---|
主表按“对象类型+项目或来源空间”拆行。同一项目下的需求、任务、缺陷可以各占一行,同一类对象跨多个项目时按项目再拆,避免一行混装多种对象导致数据量和负责人无法对应。分批子表不重复登记对象细节,只引用对象编号;账号映射附表在源账号数量较多时逐条登记,数量少时可按目录汇总后回填主表。
字段说明:每个字段填什么、怎么判断
字段口径不一致是盘点返工的主要原因。同一份清单由多个项目负责人填写时,需要先约定每个字段的取值和判断方法,再开始登记。下表给出字段字典,模板、示例和后续维护都以此为准。
| 字段名 | 含义 | 取值示例 | 判断口径 |
|---|---|---|---|
| 对象编号 | 主表行的唯一标识 | REQ-01、DOC-03 | 按“对象类型缩写-序号”编制,全表不重复 |
| 对象类型 | 待迁移对象的分类 | 需求、任务、缺陷、文档、附件、账号与权限、配置 | 以源系统导出结构中的对象分类为准,一类对象一行 |
| 来源系统与位置 | 对象所在的系统、项目或空间 | 源系统A/项目X/需求池 | 写到可定位的层级,至少包含系统和项目或空间两级 |
| 数据量 | 该行对象的规模 | 1,200条;附件8.6GB;版本320个 | 同时记录条数、附件容量、版本数三类口径,并注明统计时间点 |
| 负责人 | 对该行盘点结果负责的人 | 项目X的产品负责人 | 填具体角色或人员,能回答该行数据的来源与口径问题 |
| 敏感级别 | 数据泄露或误用的影响程度 | 高、中、低 | 按字段字典中的档位定义判断,涉及个人信息、权限配置、合同类附件通常为高 |
| 迁移优先级 | 进入迁移批次的先后 | P1、P2、P3 | 先按业务重要性初定,再用依赖关系校正 |
| 依赖关系 | 该行对象迁移前需要就绪的前置条件 | 前置对象REQ-01;外部系统B;用户目录LDAP-1 | 记录前置对象编号、外部系统名称、账号目录名称三类 |
对象类型的取值需要覆盖源系统的实际导出结构。研发场景常见的有需求、任务、缺陷、文档与页面、附件、账号与权限、系统配置,其中系统配置包括问题类型、工作流、字段配置、权限配置等。以ONES的迁移范围为例,项目、工作项、状态、字段、流程、附件和历史记录都在可迁移对象之列,Confluence向ONES Wiki迁移时还涉及空间、页面、附件和权限结构,盘点时可以把这些作为对象类型取值的参考,具体范围以迁移前确认为准。
数据量字段建议固定统计时间点,例如“截至某月某日导出”。条数、附件容量、版本数三类口径分别记录,原因是附件容量影响传输窗口安排,版本数影响文档类对象的处理工作量,只记条数会低估后两类对象的规模。敏感级别和迁移优先级都采用有限档位,档位定义写在字段字典里,避免不同项目各自解释“高”和“紧急”。依赖关系字段只记录会阻断迁移的前置条件,前置对象未就绪时,依赖它的对象不排入同一批次。
必填与选填:哪些字段不能空
必填字段的空缺会直接阻断分批和交接,选填字段用于补充判断信息。初盘阶段允许部分字段待补,复核阶段必须补齐必填项,交接阶段要求主表、分批子表和账号映射附表三表一致。
| 字段 | 必填/选填 | 空缺后果或适用场景 |
|---|---|---|
| 对象编号 | 必填 | 无法与分批子表、账号映射附表关联 |
| 对象类型 | 必填 | 无法按类型组织批次和估算工作量 |
| 来源系统与位置 | 必填 | 执行人无法定位数据,盘点结果不可执行 |
| 数据量 | 必填 | 无法安排迁移窗口和评估容量 |
| 负责人 | 必填 | 口径问题无人确认,复核无法闭环 |
| 敏感级别 | 必填 | 无法确定访问控制和迁移顺序中的安全要求 |
| 迁移优先级 | 必填 | 分批子表无法排序 |
| 依赖关系 | 必填(无依赖填“无”) | 批次顺序可能倒置,导致返工 |
| 备注 | 选填 | 用于记录口径差异、待确认事项、特殊处理要求 |
| 批次状态 | 选填(分批后填写) | 用于跟踪批次进展,初盘阶段留空 |
按阶段划分填写要求:初盘阶段必填对象类型、来源位置、负责人三项,数据量可以填估算值并标注“估”;复核阶段补齐数据量、敏感级别、迁移优先级和依赖关系,估算值替换为统计值;交接阶段检查三张表的对象编号是否一一对应,账号映射附表中未完成映射的账号需要在主表依赖关系中标注,交接人签字确认。每个阶段指定一名确认人,变更在备注中留痕。
填写示例:一个多项目并行场景的完整盘点行
以下示例为演示情景,用于说明字段如何配合使用。场景设定为两个项目并行迁移,源系统存在两套用户目录,对象类型覆盖工作项、文档、附件和账号权限。
| 对象编号 | 对象类型 | 来源系统与位置 | 数据量 | 负责人 | 敏感级别 | 迁移优先级 | 依赖关系 | 备注 |
|---|---|---|---|---|---|---|---|---|
| ACC-01 | 账号与权限 | 源系统A/用户目录LDAP-1 | 86个账号 | IT管理员 | 高 | P1 | 无 | 映射见附表 |
| CFG-01 | 配置 | 源系统A/项目X/字段与工作流配置 | 12类问题类型、3条工作流 | 项目X管理员 | 中 | P1 | ACC-01 | 逐项核对后迁移 |
| REQ-01 | 需求 | 源系统A/项目X/需求池 | 1,200条,截至6月30日 | 项目X产品负责人 | 中 | P2 | CFG-01 | 含历史状态 |
| DOC-01 | 文档 | 源系统A/项目X/知识空间 | 340页,附件8.6GB,版本320个 | 项目X文档负责人 | 高 | P2 | ACC-01、CFG-01 | 权限结构随页面迁移 |
| ACC-02 | 账号与权限 | 源系统A/用户目录HR-2 | 54个账号 | IT管理员 | 高 | P1 | 无 | 与LDAP-1存在重名账号 |
| BUG-01 | 缺陷 | 源系统A/项目Y/缺陷库 | 2,800条,截至6月30日 | 项目Y测试负责人 | 低 | P3 | CFG-02、ACC-02 | 项目Y配置单独登记 |
示例中优先级经过依赖关系校正。REQ-01初定P1,因其依赖CFG-01的字段与工作流配置,而CFG-01又依赖ACC-01的账号就绪,实际排入P2批次;DOC-01同时依赖账号和配置,与REQ-01同批;BUG-01依赖项目Y自己的配置和HR-2目录账号,排在P3。敏感级别为高的账号与权限、文档类对象,在批次内优先安排访问控制核对,这一处理写入备注供执行人参考。
账号映射附表对应ACC-01和ACC-02两行,逐条登记源账号、所属目录、目标账号和映射状态。两套目录存在重名账号时,以“所属用户目录+源账号”作为唯一识别,避免映射到错误人员。映射状态未完成的账号,在主表依赖关系中标注,相关对象不进入该批次。
调整与维护方法:清单如何随盘点推进更新
清单在迁移全程持续使用,需要按项目规模和对象类型裁剪列,按版本记录变更,并在盘点结果向迁移计划和验证环节交接时更新状态。以下规则可按团队实际情况取舍。
- 裁剪列:对象类型单一、单项目迁移时,可以合并“来源系统与位置”为“来源位置”,保留对象编号、对象类型、数据量、负责人、敏感级别、迁移优先级、依赖关系七列;多项目并行时保留项目列或把项目写入来源位置,不建议删除依赖关系列。
- 裁剪行:账号数量少时,账号映射附表可按目录汇总为一行,在备注中写明账号数和重名情况;账号跨多套目录且存在重名时,逐条登记。
- 版本记录:每次复核后保存一个版本,版本号、修改日期、修改人、修改内容记在清单首页或独立变更记录表中;对象编号一经分配不再复用,删除的行标记“作废”而非直接删除。
- 向迁移计划交接:分批子表的批次、对象范围、前置依赖、计划窗口、交接人确认后,作为迁移计划的输入;批次调整时同步更新主表的迁移优先级和依赖关系,保持两表一致。
- 向验证环节交接:每批迁移完成后,在分批子表更新批次状态,并把该批对象编号清单交给验证环节,用于核对条数、附件容量和权限结构是否与盘点记录一致。
盘点结果需要在团队内分配负责人、跟踪复核状态并保留变更记录时,可以把主表作为文档登记,把每个待迁移对象集合登记为工作项,由负责人更新复核状态,分批子表与账号映射附表作为关联文档维护。ONES的项目与Wiki可以承载这类登记和文档协作,迁移范围本身覆盖项目、工作项、文档、附件、账号与权限、配置等对象,盘点清单的字段设计与这一范围可以对应起来。多套用户目录的映射规则和迁移容量上限,建议在盘点前向迁移实施方确认后再设定阈值。
常见问题
盘点时数据量只统计条数可以吗?
只统计条数会低估文档和附件类对象的规模。建议同时记录条数、附件容量和版本数三类口径,并注明统计时间点,例如“截至6月30日导出”。附件容量影响传输窗口安排,版本数影响文档类对象的处理工作量,这两类信息在分批时都会用到。
同一项目下需求、任务、缺陷要不要合并成一行?
建议按对象类型拆行。同一项目下的需求、任务、缺陷各占一行,同一类对象跨多个项目时再按项目拆。一行混装多种对象时,数据量无法对应到具体类型,负责人也难以界定,复核阶段容易返工。
两套用户目录存在重名账号,映射时怎么区分?
以“所属用户目录+源账号”作为唯一识别,在账号映射附表中逐条登记源账号、所属目录、目标账号和映射状态。映射未完成的账号,在主表依赖关系中标注,相关对象不排入该批次,等映射确认后再调整批次。
初盘阶段数据量填不准,可以先空着吗?
初盘阶段允许填估算值并标注“估”,复核阶段再替换为统计值。对象类型、来源位置、负责人三项在初盘阶段就应填写,否则执行人无法定位数据。复核阶段需要补齐数据量、敏感级别、迁移优先级和依赖关系,交接阶段检查三张表的对象编号是否一一对应。
盘点清单和迁移计划、验证环节怎么衔接?
分批子表的批次、对象范围、前置依赖、计划窗口、交接人确认后,作为迁移计划的输入;批次调整时同步更新主表的迁移优先级和依赖关系。每批迁移完成后,在分批子表更新批次状态,并把该批对象编号清单交给验证环节,用于核对条数、附件容量和权限结构是否与盘点记录一致。
