Connector-Serviceparameter ändern

Die Datei cqconnector.properties enthält die Parametereinstellungen, mit denen das ClearQuest-Gateway und das Befehlszeilendienstprogramm 'synctool' ausgeführt werden.

Der Assistent für die Konfiguration des ClearQuest-Connectors aktualisiert die Datei cqconnector.properties auf der Basis der Optionen, die Sie im Assistenten auswählen. Wenn Sie vorhaben, den ClearQuest-Connector auf demselben Computer auszuführen, auf dem Sie den Assistenten ausführen, ist die Bearbeitung der Datei cqconnector.properties nicht erforderlich. Wenn Sie vorhaben, den ClearQuest-Connector auf einem anderen Computer zu implementieren, beispielsweise auf einem Linux®-Computer, kopieren Sie die Datei cqconnector.properties auf diesen Computer und bearbeiten die Datei anschließend so, dass die in den Parametern angegebenen Computerpfadnamen korrekt sind.

In der folgenden Tabelle werden die Parameter für den ClearQuest-Connector beschrieben.
Tabelle 1. Parameter für den ClearQuest-Connector
Parameter Beschreibung
com.ibm.rational.interop.pollingPeriod Das Überwachungsintervall, das steuert, wie häufig das ClearQuest-Gateway die ClearQuest-Benutzerdatenbank nach Änderungen abfragt. Das Standardüberwachungsintervall beträgt 60 Sekunden.
com.ibm.team.uris Der URI (Uniform Resource Identifier) für den Jazz-Server. Der Standard-URI ist https://cqconnector:cqconnector@localhost:9443/jazz. Bei Angabe mehrerer Jazz-Server trennen Sie die Einträge durch Semikola voneinander. Sie müssen entweder einen Jazz-Benutzer mit dem Namen 'cqconnector' erstellen oder den Namen 'cqconnector' durch den Namen eines anderen Jazz-Benutzers ersetzen. Der Jazz-Benutzer ('cqconnector' oder ein anderer) muss über eine Jazz ClearQuest Connector- oder Developer-Lizenz verfügen. Wenn Sie 'cqconnector' als Benutzer-ID verwenden, stellen Sie sicher, dass Sie das Kennwort vom Standardwert 'cqconnector' in einen anderen Wert geändert wird.
cq.dbSetDbName Das ClearQuest-Schemarepository und die Benutzerdatenbank. Das Standardschemarepository heißt 'sample_schema_repo'. Die Standardbenutzerdatenbank hat den Namen SAMPL. Das Format ist name-der-verbindung-für-schemarepository/benutzerdatenbankname.
cq.orderedProperties.datensatztyp Eine durch Kommas getrennte Liste von Feldern, die die Reihenfolge angibt, in der der ClearQuest-Connector die Werte dieser Felder während der abgehenden Synchronisationsoperationen festlegen soll. Sie können den Parameter für jeden Datensatztyp definieren, der eine Synchronisationsregel hat. Felder, die Sie in der Liste nicht angeben, werden nach denen in der Liste verarbeitet. Sie müssen die Reihenfolge möglicherweise angeben, wenn Ihre ClearQuest-Datensatztypen Hooks enthalten, die Abhängigkeiten zwischen Feldern festlegen.

Eine andere Methode zur Angabe der Reihenfolge ist die Verwendung der Eigenschaft Webabhängige Felder für Felder in der Formulardefinition in ClearQuest Designer. Wenn Sie sowohl die Eigenschaft 'Webabhängige Felder' als auch den Parameter 'cq.orderedProperties' angeben, verwendet der ClearQuest-Connector die Reihenfolge, die durch den Parameter 'cq.orderedProperties' angegeben wird.

cq.password Das Kennwort für die Anmeldung an der ClearQuest-Benutzerdatenbank. Das ClearQuest-Gateway und das Importtool verwenden dieses Kennwort und den Benutzernamen, den Sie im Parameter 'cq.userId' angeben, für die Anmeldung an der ClearQuest-Benutzerdatenbank und zum Abrufen von Datensätzen, die Sie in ein Jazz-Repository importieren wollen. Der Standardwert ist 'cqconnector'. Stellen Sie sicher, dass Sie das Kennwort vom Standardwert in einen anderen Wert ändern.
cq.userId Der Benutzername zur Anmeldung an der ClearQuest-Benutzerdatenbank. Das ClearQuest-Gateway und das Importtool verwenden diesen Benutzernamen und das Kennwort, das Sie im Parameter 'cq.password' angeben, für die Anmeldung an der ClearQuest-Benutzerdatenbank und zum Abrufen von Datensätzen, die Sie in ein Jazz-Repository importieren wollen. Der Standardwert ist 'cqconnector'. Dieser Benutzer muss über die SQL-Editorberechtigung verfügen.
cq.queryTreeRoot Der vollständige Pfadname des Stammordners, der den bzw. die projektbereichsspezifischen Ordner mit Abfragen enthält, die Sie zum Filtern der Datensätze verwenden, die mit Rational Team Concert-Elementen synchronisiert werden sollen. Sie können eine Abfrage für jeden zu synchronisierenden Datensatztyp pro Projektbereich angeben. Sie müssen die Abfragen so schreiben, dass sie nicht einen ClearQuest-Datensatz zur Synchronisation mit mehreren Projektbereichen auf demselben Jazz-Team-Server auswählen.

Der Stammordner kann sich auf einer beliebigen Ebene der Ordnerhierarchie unter 'Öffentliche Abfragen' oder 'Persönliche Abfragen' befinden, jedoch muss die Hierarchie wie folgt aussehen: stammordner/ordner-mit-projektbereichsnamen. Abfragen müssen direkt in den Projektbereichsordnern gespeichert werden. Sie können mehrere Projektbereichsordner haben. Der Name der einzelnen Projektbereichsordner muss mit dem entsprechenden Projektbereichsnamen im Jazz-Repository übereinstimmen.

Sie müssen einen Wert für diesen Parameter angeben. Der Stammabfrageordner, den Sie angeben, muss vorhanden sein und muss einen Ordner für jeden Projektbereich enthalten, mit dem Sie Datensätze und Arbeitselemente synchronisieren möchten. Wenn ein Projektbereichsordner keine Abfrage für einen Datensatztyp enthält, der eine Synchronisationsregel hat, versucht der ClearQuest-Connector, alle Datensätze dieses Datensatztyps zu synchronisieren.

   

Gehen Sie wie folgt vor, um die Parameter zu ändern:

  1. Navigieren Sie zum Ordner installationsverzeichnis\gateway. Öffnen Sie die Datei 'cqconnector.properties'.
  2. Ändern Sie die Parameterwerte nach Bedarf, sodass sie Ihrer Umgebung entsprechen.
    1. Bearbeiten Sie den Wert des Parameters 'com.ibm.team.uris', sodass er auf die Position des Jazz-Servers bzw. der Jazz-Server zeigt. Standardmäßig versucht das ClearQuest-Gateway, sich beim Jazz-Server als Benutzer 'cqconnector' anzumelden. Sie müssen entweder einen Jazz-Benutzer mit dem Namen 'cqconnector' erstellen oder den Namen 'cqconnector' durch den Namen eines anderen Jazz-Benutzers ersetzen. Der Jazz-Benutzer (cqconnector oder ein anderer Benutzer) muss über eine Rational Team Concert ClearQuest-Connector- oder Entwicklerlizenz verfügen. Zur Angabe eines anderen Benutzers fügen Sie benutzername[:kennwort]@ vor dem Hostnamen ein. Beispiel: https://chris:chris_pw@localhost:9443/jazz. Bei Angabe mehrerer Jazz-Server trennen Sie die Einträge durch Semikola voneinander.
    2. Bearbeiten Sie den Wert des Parameters 'cq.dbSetDbName', um Ihr Schemarepository und Ihre Benutzerdatenbank anzugeben.
    3. Bearbeiten Sie den Wert des Parameters 'com.ibm.rational.interop.pollingPeriod', wenn Sie das Standardabfrageintervall von 60 Sekunden ändern möchten.
    4. Erstellen Sie zum Filtern der zu synchronisierenden ClearQuest-Datensätze Abfragen für jeden Datensatztyp, der eine Synchronisationsregel hat. Speichern Sie die Abfragen in projektbereichsspezifischen Ordern unter dem Stammordner. Bearbeiten Sie den Parameter 'cq.queryTreeRoot', um den vollständigen Pfadnamen des Stammordners anzugeben. Beispiel: Öffentliche Abfragen/Jazz CQ Connector. Selbst wenn Sie Datensätze nicht filtern wollen, müssen Sie einen Stammordner erstellen und Sie müssen einen Projektbereichsordner für jeden Projektbereich erstellen, mit dem Sie die Synchronisation von Datensätzen und Arbeitselementen planen.
    5. Geben Sie die Benutzernamen und Kennwörter für die Anmeldung an ClearQuest in den Parametern 'cq.userId' und 'cq.password' an. Der Benutzer, den Sie im Parameter 'cq.userId' angeben, muss über SQL-Editorberechtigungen verfügen.
    6. Wenn Felder in den zu synchronisierenden ClearQuest-Datensatztypen Hooks enthalten, die Abhängigkeiten zu anderen Feldern definieren, und Sie die Eigenschaft 'Webabhängige Felder' in der ClearQuest-Formulardefinition nicht verwenden, um die Reihenfolge anzugeben, in der die Werte der Felder festgelegt werden sollen, definieren Sie den Parameter 'cq.orderedProperties.datensatztyp'. Ein Hook, der einem Feld zugeordnet ist, könnte anhand des Werts, den ein Benutzer in dieses Feld eingibt, zum Beispiel ermitteln, wie der Wert eines anderen Felds festzulegen ist. In diesem Szenario müssen Sie die Reihenfolge angeben, in der die Hooks während der abgehenden Synchronisationsoperationen ausgeführt werden sollen, um sicherzustellen, dass die ClearQuest-Datensatzfelder auf die richtigen Werte gesetzt werden. Beispiel: cq.orderedProperties.Defect=Headline,Type,Product,Component. In diesem Beispiel wird angegeben, dass das Feld 'Headline' (Überschrift) im Datensatztyp 'Defect' (Fehler) zuerst und anschließend die Felder 'Type', 'Product' und 'Component' gesetzt werden sollen.

      Wenn Sie sowohl die Eigenschaft 'Webabhängige Felder' als auch den Parameter 'cq.orderedProperties' angeben, verwendet der ClearQuest-Connector die Reihenfolge, die durch den Parameter 'cq.orderedProperties' angegeben wird.

    7. Schließen und speichern Sie die Datei 'cqconnector.properties'.
Anmerkung: Da die Datei 'cqconnector.properties' Anmeldenamen und Kennwörter für ClearQuest- und Jazz-Benutzeraccounts enthält, müssen Sie sicherstellen, dass die Berechtigungen für diese Datei nur berechtigten Benutzern Lesezugriff gewähren.

Feedback

War dies eine Hilfe? Sie können Ihr Feedback bei Jazz.net (Registrierung erforderlich) geben: Geben Sie Ihre Kommentare in den Foren oder senden Sie einen Bug.