用户映射文件架构

更新:2007 年 11 月

用户映射文件指定如何在 ClearQuest 和 Team Foundation 之间映射用户。ClearQuest 有自己的用户数据库,而 Team Foundation Server 使用用户的 Windows 用户名。因此 ClearQuest 和 Windows 中的用户名可能不匹配,而用户映射文件正是用于指定对应的映射。指定用户映射不是必须的。如果不指定任何映射,则转换器会将 ClearQuest 数据库中的用户名放入 Team Foundation 工作项中。转换器之所以能执行此操作,是因为它以“宽松规则”模式运行。迁移后,开始编辑这些工作项时,某些字段可能具有在 Team Foundation 中无效的用户。如果有针对该字段的规则限定该字段只能包含有效的用户,则必须为该字段提供有效用户之后才能保存工作项。

若要确定必须执行的操作,请考虑以下情况:

  • ClearQuest 和 Team Foundation Windows 用户名相同。不需要指定任何映射。

  • ClearQuest 和 Team Foundation Windows 用户名不同。有几种选择:

    • 在此文件中将 ClearQuest 用户映射到 Team Foundation 用户,转换器将在迁移过程中执行此映射。

    • 选择不指定迁移时执行的映射。如果对某些字段设定了所含用户必须有效的规则,则在迁移后编辑这些工作项时必须提供有效用户。

    • 选择不指定任何映射,并删除限定字段所含用户必须有效的规则。不建议这么做。

    • 选择不指定任何映射,但可添加 <ALLOWEXISTINGVALUE/> 以指定应允许具有某些现有值的字段保留现有值,即使这会违反某些规则。

不映射用户会导致混乱。可能导致迁移的工作项包含 ClearQuest 用户名和新的工作项,或者用户编辑的工作项显示 Team Foundation Server 用户名。建议只要 ClearQuest 用户名具有关联的、不同的 Windows 登录用户名,就提供映射,同时保留所有没有关联 Windows 登录用户名的用户名。

用户映射文件架构

在此文件中可以使用的节点和属性如下:

  • <UserMappings>   包含所有映射的顶级节点。每个文件只能有此节点的一个实例。

  • <UserMap>  <UserMappings> 的子节点。此节点指定一个用户映射。请使用多个节点来指定多个映射。映射被指定为此节点的属性。这些属性包括:

    • From  ClearQuest 中的用户名。填写 ClearQuest 中要映射为不同的 Team Foundation 用户名的用户名。

    • To  Team Foundation 中的用户名。填写指定的 ClearQuest 用户名应映射为的 Team Foundation 用户名。

请参见

任务

如何:编辑用户映射文件