Bericht für die Verwendung in einem integrierten Produkt von Rational Reporting for Document Generation erstellen

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.

Unterstützende Konzepte
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.
  1. Starten Sie Rational Publishing Engine Document Studio, um ein Design für eine Berichtsvorlage zu erstellen.
  2. 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.
  1. Ü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.
  2. Erstellen Sie einen URL, der auf das Datenquellenschema verweist.
  3. 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 eine URI an, die auf das Anwendungsrepository mit den relevanten Daten verweist.

Sie können Filter, d. h. genauere Versionen der allgemeinen Datenquellen-URI, verwenden, um bestimmte Datenteilmengen anzugeben, damit Rational Publishing Engine nicht versucht, während der Berichtgenerierung mehr Daten aus dem Anwendungsrepository abzurufen als nötig. Diese Filter müssen breit angelegt sein, um alle erforderlichen von der Vorlage referenzierten Daten abzurufen. Ansonsten ist der generierte Bericht nicht vollständig.

  1. Geben Sie die Vorlagen an, die Sie in den Bericht einfügen möchten.
  2. Geben Sie das Ausgabeformat und die Ausgabeposition an.
  3. 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.
  4. Geben Sie den Datenquellen-URI ein.
  5. 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 den Datenquellen verbunden sein, die die Daten für den Bericht liefern. Informationen zur Dokumentgenerierung mit Rational Publishing Engine, Dokumentspezifikationen ohne den Assistenten für Dokumentgenerierung definieren

7: Angepasstes Berichtsdokument importieren

Sie können diesen Bericht in Ihre Anwendung importieren. Benutzer können anschließend mit dem Assistenten Bericht erstellen in der Webschnittstelle Berichtsdokumente erstellen. Weitere Informationen zum Import des Berichts finden Sie im Information Center für Ihr Produkt.


Feedback