Sie können IBM® Rational ClearQuest als Datenquelle
in IBM Rational Publishing Engine definieren.
Anmerkung: Installieren und implementieren Sie
Rational Publishing Engine Data
Services mit dem Rational-ClearQuest-Adapter.
Weitere Informationen finden Sie unter
Anwendung "Data Services" implementieren.
Vorbereitende Schritte
- Machen Sie sich mit dem Rational-ClearQuest-REST-Service und mit den verschiedenen
URLs vertraut, die erforderlich sind, um Daten aus
Rational Publishing Engine
zu extrahieren, wenn Sie Rational ClearQuest verwenden.
Weitere Informationen finden Sie unter
About the Rational ClearQuest Information
Center.
- Stellen Sie eine Verbindung zu einem Datenquellenschema her. Weitere Informationen finden Sie unter Datenquellenschema hinzufügen.
- Das Schema kann sich im lokalen Dateisystem befinden. Rational Publishing Engine verwendet
Rational Data Services für die Schemaerkennung und die Datenabfrage.
Der URL zur Schemaerkennung
lautet https://Server:Port/DataServices/ClearQuest.
Weitere Informationen finden Sie unter REST-Datenquellenschema mit dem Schemaerkennungsassistenten hinzufügen.
- Das Schema kann jeder URI sein, der von Ihrem Computer aus zugänglich ist. Sie können einen URL erstellen, der auf das Datenquellenschema verweist.
Öffnen Sie das Datenquellenschema, und kopieren Sie aus der XML-Datei den URI einer bestimmten Ressource.
Fügen Sie am Ende des URI
die Angabe ?metadata=schema hinzu.
Beispiel: https://Server:Port/service/cq/records/defects?metadata=schema.
- Für die neuesten Versionen von Rational ClearQuest können Sie
auch die REST-v2-Schemaerkennung verwenden, um ein Datenquellenschema zu erstellen.
Weitere Informationen finden Sie unter REST-Datenquellenschema mit dem Schemaerkennungsassistenten hinzufügen.
Anmerkung: Bei Verwendung der
REST-v2-Schemaerkennung ist
Rational Data Services für
Rational Publishing Engine nicht erforderlich.
Rational Publishing Engine kann Schemas aus
Rational ClearQuest mit der
REST-v2-Ressourcenerkennung erkennen,
die über einen ServiceProvider-URL gestartet wird.
Benutzer können den
ServiceProvider-URL abrufen, indem Sie den ServiceCatalog-URL für
Rational ClearQuest REST v2 aufrufen, z. B.
https://Server:Port/context/oslc.
Setzen Sie die OSLC-Core-Version für HTTP-Header auf 2.0, und akzeptieren Sie
application/rdf+xml. Im zurückgegebenen Ergebnis finden Sie
den ServiceProvider-URL rdf:about.
- Wenn Sie die REST-V2-APIs für die Generierung des Dokuments verwenden, müssen Sie
einen Datenquellenschema-URL zum Service-Provider und nicht zum Stammeintrag angeben. Beispiel:
- Falsch: https://Server:Port/cqweb/oslc
- Richtig: https://Server:Port/cqweb/oslc/repo/Repository/db/Schemarepository/
- Nachdem Sie eine Verbindung zum Datenquellenschema hergestellt haben, können Sie ein Vorlagendesign erstellen oder importieren.
Mit Rational Publishing Engine Document
Studio können Sie ein Design für eine Berichtsvorlage erstellen. Dieses Design legt das Berichtslayout fest. Vorlagen mit Document Studio erstellen.
- Planen Sie die Struktur Ihres Dokuments, und definieren Sie den Inhalt, um Daten zu extrahieren.
Eine Übersicht über den Entwicklungsprozess für Vorlagen finden Sie unter
Dokumentvorlagen entwerfen.
Bei großen Dokumenten können Sie für jeden Dokumentblock eigene Vorlagen erstellen.
- Rational Publishing Engine verfügt über eine umfassende Menge an Vorlagenelementen, die Sie zum Strukturieren Ihres Dokuments verwenden können.
Sie können die Elemente in den Vorlageninhaltseditor ziehen.
Ausführliche Informationen hierzu finden Sie unter Vorlagenelemente in der Sicht "Palette".
- Verwenden Sie
Abfragen,
Attribute und
Variablen, um Daten in die Vorlage aufzunehmen.
- Sie können das Datenquellenkonfigurationselement verwenden, um einige Eigenschaften zu definieren, die zur Ausführungszeit nicht bekannt sind.
Weitere Informationen finden Sie unter Datenquellenkonfigurationselement hinzufügen.
- Mit Filtern, die spezifischere Versionen des allgemeinen Datenquellen-URI darstellen, können Sie auf bestimmte Untergruppen von
Daten verweisen, um zu vermeiden, dass
Rational Publishing Engine während der Berichterstellung mehr
Informationen als nötig aus dem Rational-ClearQuest-Repository abruft.
Diese Filter müssen umfassend genug sein, um alle erforderlichen Daten, die von der Vorlage
referenziert werden, abzurufen. Andernfalls ist der generierte Bericht nicht vollständig.
Weitere Informationen finden Sie unter
Daten mit nativen Filtern
extrahieren.
- Nachdem Sie die Berichtsvorlage erstellt und mit Rational-ClearQuest-Dateneinträgen
gefüllt haben, können Sie einen Bericht in verschiedenen Formaten generieren.
Beim Generieren eines Berichts müssen Sie mit der
Datenquelle verbunden sein. Unter
Verbindung zu einer Datenquelle herstellen ist beschrieben, wie Sie auf die relevanten Daten verweisen.
- Werden einer Vorlage Datenquellenschemas hinzugefügt, nachdem die Vorlage einer Dokumentspezifikation zugeordnet wurde,
ist die Dokumentspezifikation nicht mehr synchron.
Sie können die Dokumentspezifikation manuell
synchronisieren oder eine Vorgabeoption auswählen, damit die Dokumentspezifikation automatisch mit der aktuellen Vorlage synchronisiert wird.
Informationen zum Festlegen der Vorgabe
Dokumentspezifikation mit aktueller Vorlage synchron halten? finden Sie unter
Vorgaben für das Dokumentdesign festlegen.
- Bevor Sie Ihr Dokument veröffentlichen, lesen Sie unter
Ausgabeeigenschaften angeben
die Informationen zu den verfügbaren Ausgabeoptionen, unter denen Sie auswählen können, und zu der Ausgabeoption, die für die in dieser Vorlage
verwendeten Elemente am besten geeignet ist.
- Jetzt können Sie Ihr Dokument veröffentlichen. Weitere Informationen finden Sie unter Dokument generieren.