Berichtsdesigner können die Anwendung "Document Studio" verwenden, um Datenquellenschemas zu importieren und
Berichtsvorlagen zu erstellen.
Die Funktionen der Anwendung "Requirements Management" (RM) sind unter IBM® Rational DOORS Next
Generation lizenziert. Die Informationen zur Integration der Anwendung "Requirements Management" gelten für
Rational DOORS Next Generation und bestimmte Versionen von IBM Rational Requirements Composer.
Vorbereitende Schritte
Tipp: Die Installation von
Rational Publishing Engine umfasst eine Reihe von Beispielberichten.
Bevor Sie mit der Veröffentlichung von Dokumenten beginnen, können Sie dieses Beispielszenario einer Dokumentgenerierung ansehen.
Weitere Informationen finden Sie unter
REST-Beispielvorlage erstellen.
Machen Sie sich mit dem REST-Service der RM-Anwendung (Requirements Management) und mit den verschiedenen URLs vertraut, die erforderlich sind, um Daten aus der RM-Anwendung zu extrahieren, wenn Sie
Rational Publishing Engine verwenden. Angaben zum Information Center für Ihre Version der RM-Anwendung finden Sie unter
About the Rational Requirements Composer information
center.
Informationen zu diesem Vorgang
Die Daten werden
über die REST-API extrahiert.
Diese Schnittstelle wird mit der Datenquellenanwendung
installiert und implementiert und arbeitet unabhängig von
Rational Publishing Engine.
Weitere Informationen zur REST-API für eine Datenquelle finden Sie in der Dokumentation zur entsprechenden Datenquelle.
Vorgehensweise
- Eine Übersicht über den Entwicklungsprozess für Vorlagen finden Sie unter
Dokumentvorlagen entwerfen. Planen Sie die Struktur Ihres Dokuments und die Daten, die darin enthalten sein können. Legen Sie beispielsweise fest, ob das endgültige Dokument aus einer Vorlage generiert wird
oder aus mehreren Vorlagendateien mit wiederverwendbarem Inhalt.
- Erstellen Sie eine Dokumentvorlage in der Anwendung "Document Studio".
- Bestimmen Sie ein Datenquellenschema in Ihrer Datenquelle. Zum Hinzufügen bestimmter Daten aus Ihrem RM-Anwendungsprojekt geben Sie die URL im folgenden Format ein:
- https://Server:Port/rm/publish/artifact
Beispiel:
- https://Server:Port/rm/publish/resources
- Fügen Sie das Datenquellenschema Ihrer Dokumentvorlage hinzu. Für die RM-Anwendung können die folgenden Schritte ausgeführt werden:
- Klicken Sie in Document Studio auf .
- Wählen Sie unter Typ den Typ des Schemas aus der Liste aus. Wählen Sie für die RM-Anwendung den Eintrag Generic XML aus.
- Fügen Sie im Feld
Schemadatei die URL ein, die Sie als Datenquellenschema ermittelt haben.
- Fügen Sie am Ende der URI die Angabe ?metadata=schema hinzu.
- Beispiel: https://Server:Port/rm/publish/artifact?metadata=schema
- Wenn sich die Ressource in einem sicheren Server befindet, geben Sie den Namen des Benutzers an.
- Wenn sich die Ressource in einem sicheren Server befindet, geben Sie das Kennwort an.
- Wählen Sie den Authentifizierungstyp in der Liste aus. Der Authentifizierungstyp für die RM-Anwendung ist OAuth. Wenn Sie OAuth nicht auswählen, wird jeder Authentifizierungstyp getestet, bis der richtige Typ gefunden wird. Dies kann die Dokumentgenerierungszeit verlängern.
- Fügen Sie Elemente zur Vorlage hinzu. 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.
Beispielsweise können Sie ein Containerelement für mehrere Absätze hinzufügen.
Jeder Absatz kann von einer Testbedingung gesteuert sein,
die ihm nur spezifische Daten zuordnet.
Weitere Informationen finden Sie unter
Vorlagenelemente in der Sicht "Palette" und
Elemente einer Vorlage hinzufügen.
- Tabellenelemente
- Wenn Tabellendaten aus der RM-Anwendung eingegeben werden, müssen die Breitenangaben für die Verarbeitung durch Rational Publishing Engine auf Spaltenebene, d. h. für jede Zelle und nicht auf Tabellenebene angegeben werden.
- Verwenden Sie
Abfragen,
Attribute und
Variablen, um Daten in eine Vorlage aufzunehmen.
Diese Abfragen legen fest, welche Informationen
im Bericht generiert werden.
- Fügen Sie den Elementen
Formatierung und Stile hinzu, um festzulegen, wie sie in der Ausgabe angezeigt werden.
- Erstellen Sie
Filter, um die Daten einzugrenzen, die in den Bericht aufgenommen werden. Mit Hilfe von Filtern, bei denen es sich um detaillierte Versionen der allgemeinen Datenquellen-URI handelt,
können Sie auf bestimmte Datenteilmengen verweisen, um zu vermeiden, dass
Rational Publishing Engine während der Berichterstellung mehr
Informationen als nötig aus der Datenquelle 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 Rational Requirements Composer data sources.
- Erstellen Sie
Sortierungen,
um die Daten in Ihrem Bericht zu strukturieren.