Benutzerzuordnungsdatei-Schema
Aktualisiert: November 2007
Die Benutzerzuordnungsdatei gibt an, wie zwischen ClearQuest und Team Foundation Benutzer zugeordnet werden. ClearQuest verfügt über eine eigene Benutzerdatenbank, und Team Foundation Server verwendet für seine Benutzer Windows-Benutzernamen. Möglicherweise stimmen die Benutzernamen in ClearQuest und Windows nicht überein. Mithilfe der Benutzerzuordnungsdatei können Sie jedoch entsprechende Zuordnungen angeben. Sie müssen keine Benutzerzuordnungen angeben. Wenn Sie keine Zuordnungen angeben, verwendet der Konverter die Benutzernamen aus der ClearQuest-Datenbank für die Arbeitsaufgaben in Team Foundation. Dies ist möglich, weil der Konverter in einem Modus mit gelockerten Regeln ausgeführt wird. Wenn Sie nach der Migration mit der Bearbeitung dieser Arbeitsaufgaben beginnen, können einige Felder Benutzer enthalten, die in Team Foundation nicht gültig sind. Wenn für diese Felder Regeln gelten, nach denen nur gültige Benutzer enthalten sein dürfen, müssen Sie einen gültigen Benutzernamen eingeben, bevor Sie die Arbeitsaufgabe speichern können.
Betrachten Sie die folgenden Szenarien, bevor Sie eine Entscheidung treffen:
Die Windows-Benutzernamen in ClearQuest und Team Foundation sind identisch. Sie müssen keine Zuordnungen angeben.
Die Windows-Benutzernamen in ClearQuest und Team Foundation sind nicht identisch. Sie haben verschiedene Möglichkeiten:
Ordnen Sie die ClearQuest-Benutzer den Team Foundation-Benutzern in dieser Datei zu, und der Konverter führt die Zuordnungen zur Migrationszeit durch.
Wählen Sie aus, die Zuordnungen zur Migrationszeit nicht anzugeben. Wenn Regeln für einige Felder vorhanden sind, dass nur gültige Benutzer eingeben werden dürfen, müssen Sie gültige Benutzer angeben, wenn Sie diese Arbeitsaufgaben nach der Migration bearbeiten.
Wählen Sie aus, Zuordnungen nicht anzugeben, und löschen Sie die Regeln, nach denen ein Feld nur gültige Benutzer enthalten darf. Dieser Schritt wird nicht empfohlen.
Wählen Sie aus, Zuordnungen nicht anzugeben, fügen Sie aber <ALLOWEXISTINGVALUE/> hinzu, um festzulegen, dass Felder mit vorhandenen Werten diese Werte beibehalten dürfen, auch wenn sie manche Regeln verletzen.
Wenn keine Benutzer zugeordnet werden, kann dies gewisse Probleme mit sich bringen. Migrierte Arbeitsaufgaben würden die ClearQuest-Benutzernamen enthalten, und neue Arbeitsaufgaben oder Arbeitsaufgaben, die von Benutzern bearbeitet werden, würden Team Foundation Server-Benutzernamen aufweisen. Es wird empfohlen, Zuordnungen immer dann bereitzustellen, wenn der ClearQuest-Benutzername über einen zugehörigen, unterschiedlichen Windows-Anmeldenamen verfügt, und alle Benutzernamen beizubehalten, die keine zugehörigen Windows-Anmeldenamen besitzen.
Benutzerzuordnungsdatei-Schema
In dieser Datei können Sie die folgenden Knoten und Attribute verwenden:
<UserMappings> Knoten der obersten Ebene, der alle Zuordnungen enthält. Nur eine Instanz dieses Knotens pro Datei.
<UserMap> Untergeordneter Knoten von <UserMappings>. Gibt eine Benutzerzuordnung an. Verwenden Sie mehrere Knoten, um mehrere Zuordnungen anzugeben. Die Zuordnungen werden als Attribute dieses Knotens angegeben. Folgende Attribute stehen zur Verfügung:
From Der Benutzername in ClearQuest. Geben Sie den Namen aus ClearQuest ein, den Sie einem anderen Benutzernamen in Team Foundation zuordnen möchten.
To Der Benutzername in Team Foundation. Geben Sie den Benutzernamen in Team Foundation ein, dem der angegebene ClearQuest-Name zugeordnet werden sollte.