Schéma de fichier de mappage utilisateur
Mise à jour : novembre 2007
Le fichier de mappage utilisateur spécifie comment les utilisateurs sont mappés entre ClearQuest et Team Foundation. ClearQuest possède sa propre base de données utilisateur et Team Foundation Server utilise des noms d'utilisateurs Windows. Les noms d'utilisateurs dans ClearQuest et Windows ne peuvent pas correspondre et le fichier de mappage utilisateur vous donne la possibilité de spécifier des mappages appropriés. Vous ne devez pas spécifier de mappages utilisateur. Si vous ne spécifiez pas de mappage, le convertisseur transférera les noms d'utilisateurs de votre base de données ClearQuest dans les éléments de travail de Team Foundation. Le convertisseur peut effectuer ce transfert parce qu'il s'exécute en mode "Règles souples". Après la migration, lorsque vous commencez à modifier ces éléments de travail, certains champs peuvent avoir des utilisateurs qui ne sont pas valides dans Team Foundation. Si vous avez des règles obligeant ce champ à contenir uniquement des utilisateurs valides, vous devrez puis fournir un utilisateur valide avant de pouvoir enregistrer l'élément de travail.
Pour prendre une décision, vous devez tenir compte des scénarios suivants :
Les noms d'utilisateurs Windows sont les mêmes pour ClearQuest et Team Foundation. Vous ne devez pas spécifier de mappages.
Les noms d'utilisateurs Windows sont différents pour ClearQuest et Team Foundation. Plusieurs choix sont possibles :
Mappez les utilisateurs ClearQuest aux utilisateurs de Team Foundation dans ce fichier pour que le convertisseur puisse effectuer les mappages au cours de la migration.
Choisissez de ne pas spécifier les mappages lors de la migration. Si vous avez des règles obligeant certains champs à avoir uniquement des utilisateurs valides, vous devez fournir des utilisateurs valides lorsque vous modifiez ces éléments de travail après la migration.
Choisissez de ne pas spécifier de mappage et supprimez les règles qui obligent un champ à contenir uniquement des utilisateurs valides. Cela n'est pas recommandé.
Choisissez de ne pas spécifier de mappage, mais vous pouvez ajouter <ALLOWEXISTINGVALUE/> pour spécifier que les champs contenant des valeurs existantes doivent être autorisés à conserver les valeurs existantes, même s'ils violent certaines règles.
Ne pas mapper les utilisateurs peut provoquer quelque confusion. Vos éléments de travail migrés contiendraient les noms d'utilisateurs ClearQuest et les nouveaux éléments de travail, ou les éléments de travail modifiés par les utilisateurs, afficheraient des noms d'utilisateurs Team Foundation Server. Nous vous recommandons de fournir des mappages là où le nom d'utilisateur ClearQuest porte un nom d'utilisateur associé, différent du nom d'utilisateur de connexion Windows, et laisse tous les noms d'utilisateurs qui ne portent pas de nom d'utilisateur de connexion Windows associé.
Schéma de fichier de mappage utilisateur
Les nœuds et attributs que vous pouvez utiliser dans ce fichier sont les suivants :
<UserMappings> Nœud de niveau supérieur qui contient tous les mappages. Une seule instance de ce nœud par fichier.
<UserMap> Nœud enfant de <UserMappings>. Spécifie un seul mappage d'utilisateur. Utilisez plusieurs nœuds pour spécifier plusieurs mappages. Les mappages sont spécifiés en tant qu'attributs de ce nœud. Les attributs sont :
From Le nom d'utilisateur dans ClearQuest. Renseignez le nom de ClearQuest que vous souhaitez mapper à un nom d'utilisateur de Team Foundation.
To Nom d'utilisateur dans Team Foundation. Renseignez le nom d'utilisateur de Team Foundation auquel le nom ClearQuest spécifié doit être mappé.