Freigeben über

Gewusst wie: Generieren der Konverterkonfigurationsdatei

  • Artikel

Bei der Konverterkonfigurationsdatei handelt es sich um eine XML-Datei, die Einstellungen für den ClearQuest-Konverter enthält. Die Einstellungen werden wie folgt in Abschnitten der XML-Datei angegeben:

<ClearQuest>

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

  • ConnectionName   ClearQuest-Verbindungsname.

  • UserDatabase   ClearQuest-Datenbankname.

  • QueryName   Name einer in ClearQuest gespeicherten Abfrage.

  • UserID   Die ClearQuest-Benutzer-ID. Die angegebene Benutzer-ID muss über die admin-Berechtigung für die ClearQuest-Datenbank verfügen.

<VSTS>

Der Abschnitt VSTS enthält Informationen zum Arbeitsaufgabenverfolgung in Team Foundation-Server sowie zum Teamprojekt, die das Ziel Ihrer Migration darstellen.

  • URI   Angezeigter Name von Team Foundation Server oder vollständige URI in der Form http://MeinServer:MeinPort.

    Wenn Sie angezeigte Namen verwenden, stellen Sie sicher, dass der Team Foundation Server über Team Explorer hinzugefügt wurde, bevor Sie den Konverter ausführen.

  • 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 den Wert True oder False. Wählen Sie True aus, um den Konverter im Fehlerfall zu beenden. Der Wert True 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 migrierten Dateien gespeichert werden sollen. Wenn Sie kein Ausgabeverzeichnis angeben, wird vom Konverter ein Verzeichnis mit dem Namen der Basisentität zum Generieren von Ausgabedateien erstellt. Ist das Verzeichnis bereits vorhanden, überschreibt der Konverter die Dateien in diesem Verzeichnis.

So erstellen Sie die Konfigurationsdatei

  1. Erfassen Sie die folgenden Informationen:

    • ClearQuest-Verbindungsname

    • ClearQuest-Datenbankname

    • Benutzer-ID und Kennwort des ClearQuest-Administrators. Stellen Sie sicher, dass dieser Benutzer berechtigt ist, Probleme in ClearQuest abzusenden.

    • Team Foundation-Servername

    • Arbeitsaufgabenverfolgung in Team Foundation-Teamprojektname (das Teamprojekt, zu dem Sie die Arbeitsaufgaben migrieren möchten).

  2. Erstellen Sie eine Abfrage in ClearQuest, um die Arbeitsaufgaben auszuwählen, die Sie zu Arbeitsaufgabenverfolgung in Team Foundation migrieren möchten, und speichern Sie die Abfrage. Speichern Sie die Abfrage unter einem beliebigen Namen, z. B. TransitionQuery.

  3. Wählen Sie ein Verzeichnis aus, in dem die während der Analysephase erstellten Dateien gespeichert werden sollen.

  4. Kopieren Sie die folgende XML-Konfigurationsdatei in einen Text-Editor:

    <?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>

  5. Ändern Sie die Datei, um die Einstellungen mithilfe der zuvor gesammelten Informationen anzugeben. Geben Sie beispielsweise unter <QueryName> den Abfragenamen als TransitionQuery an, die den Abfragepfad enthält. Weitere Informationen über die für jeden Abschnitt erforderlichen Angaben finden Sie unter "Die Konfigurationsdatei" weiter oben in diesem Thema.

    Hinweis

    Das Kennwort wird nicht in die Datei eingegeben, das ClearQuest-Konvertertool erfragt es später im Migrationsprozess.

  6. Speichern Sie die Datei z. B. als CqConverterConfig.xml.

Hinweis

Speichern Sie die Datei in UTF-8-Codierung. Wenn Sie die Datei beispielsweise mit Editor speichern, wählen Sie im Dialogfeld Speichern unter im Feld CodierungUTF-8 aus.

Sicherheit

Zum Ausführen dieser Schritte müssen Sie über die Berechtigungen Active User und Public Folder Administrator für die ClearQuest-Datenbank verfügen. Weitere Informationen finden Sie im ClearQuest-Administratorhandbuch.

Siehe auch

Weitere Ressourcen

Definitionsschema "Arbeitsaufgabentyp"