Legacy sync
TFS 数据导入
把旧版 WinCode 的 TFS 配置与在线文档导入到新版。
TFS 数据导入
TFS 配置与在线文档是 WinCode 中两项与企业环境强相关的数据。legacySync 模块在迁移时会一并处理它们,保证开发者升级到新版后,不必重新输入 PAT 或重新收藏文档。
TFS 配置导入
旧版的 TFS 配置包含 serverUrl、patToken、默认集合、默认可访问集合列表等。新版把 TFS 配置存储在 tfs 服务的数据库中,并且对 PAT 采用加密存储。
迁移时:
- 如果新版尚未配置 TFS(即
tfsLoad()返回的patToken为空),旧版配置会被直接导入,PAT 经过加密后存入数据库。 - 如果新版已经配置过 TFS,默认行为是跳过旧版配置,避免把旧版的 PAT 覆盖到已经调通的新版上。此时对话框会显示一个"替换当前 TFS 配置"开关(
replaceTfs选项)。打开该开关后,旧版配置才会覆盖新版。
LegacySyncApplyResult.tfs 的 imported / merged / skipped / failed 字段会反映这次迁移的结果。
在线文档导入
旧版的在线文档(即 URL、标题、分类等)也会一并迁移。新版 onlineDocuments 模块使用分类加文档的两层结构,迁移时:
- 旧版的分类会被转换为新版的
OnlineDocumentCategory。 - 旧版的文档条目会被转换为新版的
OnlineDocumentRecord,保留原有关联的分类。 - 同名分类会合并,不会重复创建。
LegacySyncApplyResult.onlineDocuments 的统计字段会告诉你到底导入了多少条文档。
校验建议
迁移完成后,建议打开 TFS 设置页做一次连接测试(tfsTest),确认 PAT 在新版下仍然可用。如果旧版使用的是较旧的 PAT,可能已经过期,需要重新生成。
在线文档导入后,可以在 OnlineDocumentsWorkspace 中浏览确认分类和条目是否正确。