Die Konfigurationsdatei für den Arbeitsaufgabenkonverter

Artikel
08/20/2008

Aktualisiert: November 2007

Die Arbeitsaufgaben-Konfigurationsdatei ist eine XML-Datei, die Einstellungen für den ClearQuest-Konverter bereitstellt. Die einzelnen Abschnitte in dieser Datei werden später in diesem Thema beschrieben, gefolgt von einer Beispielkonfigurationsdatei, mit deren Hilfe Sie eine eigene Konfigurationsdatei erstellen können.

Die Abschnitte der Konfigurationsdatei

Die XML-Konfigurationsdatei für den Arbeitsaufgabenkonverter enthält verschiedene Abschnitte, in denen angegeben wird, wie Arbeitsaufgaben von ClearQuest nach Team Foundation migriert werden. Diese Abschnitte werden später in diesem Thema im Detail beschrieben.

<ClearQuest>

Der Abschnitt ClearQuest enthält Informationen über die ClearQuest-Datenbank, die Sie migrieren möchten.

ConnectionName ClearQuest-Verbindungsname.
UserDatabase Name der ClearQuest-Benutzerdatenbank.
QueryName Name einer in ClearQuest gespeicherten Abfrage.
UserID ClearQuest-Benutzer-ID. Sie müssen die Benutzer-ID "admin" verwenden. Dieser Benutzer sollte berechtigt sein, alle Arbeitsaufgabentypen zu erstellen.

<VSTS>

Der Abschnitt VSTS enthält Informationen über den Arbeitsaufgabenverfolgung in Team Foundation-Server und das Teamprojekt, zu dem Sie migrieren.

URI Der angezeigte Name für Team Foundation Server oder der vollständige URI. Beispiel: "MyAtServer" oder "http://MyAtServer:8080."
ProjectName Arbeitsaufgabenverfolgung in Team Foundation-Teamprojektname.

Andere Konfigurationseinstellungen

Mit den anderen Abschnitten in der XML-Datei können Sie Folgendes steuern:

ExitOnError Dieser Abschnitt akzeptiert die Werte True oder False. Wählen Sie True aus, wenn der Konverter im Fehlerfall beendet werden soll. Dies bedeutet, dass der ClearQuest-Konverter beendet wird, wenn bei der Migration von Arbeitsaufgaben Fehler auftreten.

Hinweis:
Diese Einstellung gilt nur für nicht schwerwiegende Fehler. Bei schwerwiegenden Fehlern, z. B. wenn der ClearQuest-Konverter keine Verbindung zu ClearQuest herstellen kann, wird der Konverter immer beendet; dies gilt auch dann, wenn die Einstellung False lautet.

OutputDirectory Geben Sie das Verzeichnis an, in dem die generierten Dateien gespeichert werden sollen. Wenn Sie kein Ausgabeverzeichnis angeben, erstellt der Konverter ein Verzeichnis mit dem Namen der Basisentität für das Generieren von Ausgabedateien. Ist das Verzeichnis bereits vorhanden, überschreibt der Konverter die Dateien in diesem Verzeichnis.

Beispielkonfigurationsdatei für den Arbeitsaufgabenkonverter

Im Folgenden finden Sie eine Beispielkonfigurationsdatei für den Arbeitsaufgabenkonverter, mit dem die ClearQuest-Datenbank TEST über die CQRep-Verbindung mit der Abfrage All Defects in das Teamprojekt JoseLugoProjectX in Team Foundation migriert wird. Außerdem wird angegeben, dass der Konverter bei Fehlern beendet werden soll, und das Verzeichnis für die vom Konverter erstellten Ausgabedateien wird festgelegt.

<?xml version="1.0" encoding="utf-8"?>
<WorkItemConverter>
  <Source id="ClearQuest">
    <ClearQuest>
      <ConnectionName>CQRep</ConnectionName> 
      <UserDatabase>TEST</UserDatabase> 
      <QueryName>Public Queries/All Defects</QueryName> 
      <UserID>admin</UserID>
    </ClearQuest>
  </Source>
  <VSTS>
    <URI>JoseLugo</URI>
    <ProjectName>JoseLugoProjectX</ProjectName> 
  </VSTS>
  <ExitOnError>true</ExitOnError>
  <OutputDirectory>DefectSchema</OutputDirectory>
</WorkItemConverter>