Sie können Rational Publishing Engine verwenden, um Berichte
auf der Basis von Produkt- und Anwendungsdaten, die die Komponente
Rational Reporting for Document
Generation umfassen, wie z. B.
die Anwendungen der Rational-Lösung für
Collaborative Lifecycle Management.
Diese Vorlagen können in die Produkte oder Anwendungen importiert und in deren Schnittstellen verwendet werden.
Vorbereitungen
Bevor Sie
Rational Publishing Engine zum
Anpassen von Berichten verwenden können, muss ein Lizenzschlüsselserver mit gültigen Lizenzen
konfiguriert werden. Erkundigen Sie sich beim Administrator, ob diese Konfiguration erfolgt
ist, und fragen Sie nach dem Pfad des Lizenzservers. Wenn
Rational Publishing Engine
noch nicht installiert wurde, müssen Sie oder der zuständige Administrator die Installation ausführen und sicherstellen,
dass eine Verbindung zum Lizenzserver möglich ist.
Bestimmen Sie die Version von
Rational Reporting for Document
Generation, die im Lieferumfang des integrierten Produkts
(oder "Datenproviders") enthalten ist.
Diese Version legt fest, welche Vorlagenversion Sie verwenden müssen, wenn Sie Berichtsvorlagen für das Produkt entwerfen. Machen Sie sich unbedingt
mit den Einschränkungen vertraut, die hinsichtlich der Kompatibilität neuerer Versionen von
Rational Publishing Engine mit
älteren Version von Rational Reporting for Document
Generation bestehen.
Unterstützende Referenzinformationen:
Vorgehensweise
Rational Publishing Engine
ermöglicht das Erstellen neuer Vorlagen für Berichtsdokumente. Sie können Vorlagen entwerfen, die Daten
in einem Produkt oder einer Anwendung erfassen und zurückmelden, und wenn dieses Produkt oder diese Anwendung
Rational Reporting for Document
Generation einschließt,
können Sie diese Vorlagen importieren und Berichtsdokumente im Kontext des Produkts oder der Anwendung generieren.
Für das Authoring von
Vorlagen ist eine Lizenz für Rational Publishing Engine
erforderlich. Die Lizenz für Rational Publishing Engine
ist nicht erforderlich, wenn Sie Vorlagen importieren und anhand der Vorlagen Berichte
im Kontext eines Produkts oder einer Anwendung generieren möchten, das bzw. die
Rational Reporting for Document
Generation einschließt.
Führen Sie die folgenden Schritte aus, um mit
Rational Publishing Engine
Berichte zu erstellen, die Produkt- oder Anwendungsdaten verwenden:
1: Verbindung zu
Rational Publishing Engine
herstellen
Wenn
Rational Publishing Engine
noch nicht installiert wurde, müssen Sie oder der zuständige Administrator die Installation ausführen und sicherstellen,
dass eine Verbindung zum Lizenzserver möglich ist. Sie können mit
Rational Publishing Engine Document
Studio Anwendungsquellen importieren und Berichtsvorlagen erstellen. Sie können mit
Rational Publishing Engine Launcher
Dokumentspezifikationen erstellen, die Berichtsvorlagen enthalten, und Berichte generieren.
2: Berichtsvorlagen entwerfen
Wichtig: Sie
müssen eine Vorlagenversion verwenden,
die von der Version von
Rational Reporting for Document
Generation,
die im Lieferumfang des integrierten Produkts (oder
"Datenproviders") enthalten ist, unterstützt wird.
Um festzustellen, welche Version enthalten ist, fragen Sie beim Berichtsadministrator für das Produkt nach. Details finden Sie unter
Versionskompatibilität.
- Starten Sie
Rational Publishing Engine Document
Studio, um ein Design für eine Berichtsvorlage zu erstellen.
- Erstellen oder importieren Sie ein Vorlagendesign. Dieses Design legt das Berichtslayout fest. Im Lieferumfang von
Rational Publishing Engine sind
verschiedene Beispielberichte und Lernprogramme enthalten, die Sie studieren
können.
Wichtig: Aktualisieren Sie die Vorlagenversionsnummer in der API "Vorlage laden", damit Sie eine Version verwenden, die mit dem
Datenprovider kompatibel ist. Wenn die neue Vorlagenversion angegeben und eine ältere Vorlage geöffnet wird, wird die Vorlagenversion für diese Vorlage aktualisiert.
Unterstützende Konzepte im Information Center von
Rational Publishing Engine
Unterstützende Aufgaben im Information Center von
Rational Publishing Engine
Metadaten
und Vorlagenimport:
3: Verbindung zur Anwendungsdatenquelle herstellen
Bestimmen Sie, welches Datenquellenschema importiert werden soll. Anhand der Elemente in diesem Schema können
Abfragen für Anwendungsdaten zur Vorlage hinzugefügt werden.
Diese Abfragen geben an, welche Informationen
letztendlich im Bericht generiert werden.
- Überprüfen Sie die verfügbaren Datenschemas, die Sie im Bericht verwenden
möchten. Jedes Produkt verfügt über ein eindeutiges Schema oder eine Gruppe von Schemas.
- Erstellen Sie einen URL, der auf das Datenquellenschema verweist.
- Fügen Sie in Document Studio eine neue Datenquelle hinzu.
Unterstützende Aufgaben im Information Center von
Rational Publishing Engine
4: Anwendungsbasierte Datenabfragen
zur Vorlage hinzufügen
Verwenden Sie Document Studio, um Daten aus den Datenquellen zu einer vorhandenen Berichtsdesignvorlage hinzuzufügen. Die hinzugefügten Datenabfragen
legen fest, welche Daten in den verschiedenen Teilen der Berichtsausgabe generiert werden. Sie müssen
in der Sicht "Datenquellenschemas" Datenpunkte auswählen und diese in hierarchischer Reihenfolge in die Vorlage
einfügen.
Unterstützende Konzepte im Information Center von
Rational Publishing Engine
Unterstützende Aufgaben im Information Center von
Rational Publishing Engine
5: Dokumentspezifikation erstellen
Nachdem Sie die Berichtsvorlage
erstellt und mit Anwendungsdatenpunkten gefüllt haben, können Sie einen Bericht in verschiedenen Formaten
generieren. Beim Generieren eines Berichts müssen Sie eine Verbindung zu der Datenquelle mit den
Informationen herstellen, für die der Bericht ausgeführt werden soll. Geben Sie dazu einen URI an,
der auf das Anwendungsrepository mit den relevanten Daten verweist.
Sie können Filter,
d. h. genauere Versionen des allgemeinen Datenquellen-URI, verwenden, um bestimmte Datenteilmengen anzugeben, damit
Rational Publishing Engine nicht versucht,
während der Berichtsgenerierung mehr Daten aus dem Anwendungsrepository abzurufen als nötig. Diese Filter müssen breit genug sein, um alle erforderlichen von der Vorlage
referenzierten Daten abzurufen; ansonsten ist der generierte Bericht nicht vollständig.
- Geben Sie die Vorlagen an, die Sie in den Bericht einfügen möchten.
- Geben Sie das Ausgabeformat und die Ausgabeposition an.
- Legen Sie den Datenquellen-URI fest. Sie können auf eine allgemeine Datenquelle verweisen, die
alle zugehörigen Daten innerhalb des Repositorys abruft, oder Sie können optional Filter verwenden,
die spezifischere URIs darstellen, und Parameter angeben, die eine kleinere Datenmenge aus dem
Repository abrufen.
- Geben Sie den Datenquellen-URI ein.
- Optional: Geben Sie Berechtigungsnachweise für die Anmeldung ein, um auf die angegebene
Datenquelle zuzugreifen. Wenn die Dokumentspezifikation mit anderen Benutzern gemeinsam genutzt werden soll,
ist es unter Umständen sinnvoll, die Felder für die Berechtigungsnachweise leer zu lassen.
Wenn die Berechtigungsnachweise nicht angegeben werden und ein Benutzer versucht,
anhand der Dokumentspezifikation einen Bericht auszuführen, wird er zur Eingabe von
Berechtigungsnachweisen aufgefordert.
Wenn die Berechtigungsnachweise angegeben wurden und ein
Benutzer versucht, den Bericht auszuführen, werden die gespeicherten Berechtigungsnachweise für
den Zugriff auf das Repository verwendet, obwohl es sich nicht um die Berechtigungsnachweise
dieses Benutzers handelt.
Unterstützende Konzepte im Information Center von
Rational Publishing Engine
6: Bericht generieren
Sie können Berichte anhand von Dokumentspezifikationen generieren. Beim Generieren eines Berichts müssen Sie mit der oder
den Datenquellen verbunden sein, die die Daten für den Bericht liefern. Informationen zur Dokumentgenerierung mit
Rational Publishing Engine,
Dokumentspezifikationen mit Launcher definieren
7: Angepasstes Berichtsdokument importieren
Sie können diesen Bericht in Ihre Anwendung importieren, damit Benutzer
mit dem Assistenten Bericht erstellen in der Webschnittstelle Berichtsdokumente erstellen können. Weitere Informationen zum Import des Berichts finden Sie im Information Center für Ihr Produkt.