研发迁移数据盘点清单模板:字段、分类与填写示例

研发迁移数据盘点清单用于在迁移前把“要搬什么、在哪里、有多少、谁负责、多敏感、先搬哪批、依赖谁”记录成可交接的表格。它以一行一个待迁移对象集合为基本粒度,至少覆盖对象类型、来源位置、数据量、负责人、敏感级别、迁移优先级、依赖关系七类字段。源系统对象类型多、项目并行、存在多套用户目录时,先按对象类型和项目分批登记,再用敏感级别与依赖关系校正优先级,最后形成盘点总表与分批迁移清单。



要点总览(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日导出”。附件容量影响传输窗口安排,版本数影响文档类对象的处理工作量,这两类信息在分批时都会用到。


同一项目下需求、任务、缺陷要不要合并成一行?


建议按对象类型拆行。同一项目下的需求、任务、缺陷各占一行,同一类对象跨多个项目时再按项目拆。一行混装多种对象时,数据量无法对应到具体类型,负责人也难以界定,复核阶段容易返工。


两套用户目录存在重名账号,映射时怎么区分?


以“所属用户目录+源账号”作为唯一识别,在账号映射附表中逐条登记源账号、所属目录、目标账号和映射状态。映射未完成的账号,在主表依赖关系中标注,相关对象不排入该批次,等映射确认后再调整批次。


初盘阶段数据量填不准,可以先空着吗?


初盘阶段允许填估算值并标注“估”,复核阶段再替换为统计值。对象类型、来源位置、负责人三项在初盘阶段就应填写,否则执行人无法定位数据。复核阶段需要补齐数据量、敏感级别、迁移优先级和依赖关系,交接阶段检查三张表的对象编号是否一一对应。


盘点清单和迁移计划、验证环节怎么衔接?


分批子表的批次、对象范围、前置依赖、计划窗口、交接人确认后,作为迁移计划的输入;批次调整时同步更新主表的迁移优先级和依赖关系。每批迁移完成后,在分批子表更新批次状态,并把该批对象编号清单交给验证环节,用于核对条数、附件容量和权限结构是否与盘点记录一致。