Praktisches Lernprogramm für das IBM Rational Publishing Engine-Tool

ibm rational publishing engine tool hands tutorial

Eingehende Überprüfung des IBM Rational Publishing Engine-Tools. Erfahren Sie mehr über Installation, erweiterte Berichtsformatierung, Generieren von Anforderungsberichten und Bereitstellen von Vorlagen für DNG:

Was ist RPE?

IBM Rational Publishing Engine (RPE) ist ein Tool zur Automatisierung des Generierungsberichts aus verschiedenen Datenquellen. Das Hauptziel von IBM RPE besteht darin, die Daten aus verschiedenen Datenquellen abzurufen. Dies kann entweder ein IBM Toolset oder ein anderes Tool von Drittanbietern sein, um menschliches Versagen und manuellen Aufwand zu reduzieren.

Das Tool kann fünf Ausgaben gleichzeitig generieren, z. B. WORD, PDF, XSL-FO, Excel, HTML.

In diesem Tutorial erklären wir die ausführliche Verwendung von IBM Rational Publishing Engine. Schauen wir uns vorher die Grundlagen von IBM Rational DOORS Next Generation über den folgenden Link an:

Empfohlene Lektüre => Einführung in IBM Rational DOORS Next Generation

Was du lernen wirst:

• Übersicht über Rational Publishing Engine
  • Installation von RPE
  • Erkunden der Desktop-Oberfläche von Rational Publishing Engine
  • Anforderungsbericht für Türen der nächsten Generation
  • Erweiterte Formatierung des Berichts
  • Hinzufügen einer Masterseite (Kopf- und Fußzeile) zum Bericht
  • Hinzufügen von Variablen und Java Script
  • Bereitstellen der Vorlage in DNG
• Fazit
  • Literatur-Empfehlungen

Übersicht über Rational Publishing Engine

Da wir oben bereits die Hauptfunktionen von RPE erläutert haben, werden wir in diesem Lernprogramm auf die Funktionen von RPE und den Installationsteil eingehen.

Die Hauptmerkmale der Tools umfassen:

• Es kann Stile und Kundenformate anwenden.
• Es können mehrere Datenquellen hinzugefügt werden, um die Kundenerwartungen zu erfüllen.
• Wiederverwendung von Vorlagen im gesamten Unternehmen für alle Projekte.
• Kann mithilfe der REST-API in Tools von Drittanbietern integriert werden.
• Unterstützt die umfassenden Rückverfolgbarkeits- und alle anderen komplexen Formatberichte

Installation von RPE

Bitte stellen Sie sicher, dass die unten genannte Software verfügbar ist, bevor Sie mit der Installation beginnen

• IBM Installation Manager 1.8.9
• IBM RPE-Setup-Datei

Hinweis: Sie möchten den IBM Passport-Vorteil für den Zugriff darauf nutzen .

• Hostname des bereitgestellten Servers der IBM Floating License.

Schritte zum Installieren von RPE ::

1. Öffnen Sie den IBM Installation Manager
2. Gehen Sie zu Datei >> Einstellungen
3. Navigieren Sie zum RPE-Repository disktag.inf
4. Klicken Sie auf OK
5. Installieren
6. Klicken Sie auf Weiter, wenn Sie nach der Lizenz gefragt werden. Geben Sie dem Hostnamen des RLKS-Servers (Rational License Key Server) die Portnummer im folgenden Format an. Beispiel: 27000 @ oder // 27000 ist die Standardportnummer.
7. Installieren.

Erkunden der Desktop-Oberfläche von Rational Publishing Engine

RPE besteht aus zwei Hauptkomponenten:

• RPE Studio : Wo wir die Vorlage entwerfen und Datenquellen hinzufügen.
• RPE Launcher : Wo wir den Stil entwerfen, ausgeben, die Datenquellen ausführen und den Bericht generieren.

RPE-Hauptartefakte sind wie folgt:

• Dokumentvorlage (* .dta) : Dies ist das Vorlagenformat, das wir wiederverwenden können.
• Dokumentenspezifikation / Bericht (* .dsx) : Es verbindet eine oder mehrere Vorlagen und wird zum Generieren des Berichts verwendet

Anforderungsbericht für Türen der nächsten Generation

Beginnen wir mit der Erstellung von Vorlagen zum Generieren des DNG-Anforderungsdokuments. Befolgen Sie die unten genannten Schritte, um dasselbe zu erstellen.

# 1) Öffnen Sie Document Studio.

#zwei) Um einen Bericht aus dem Tool zu erstellen, müssen Sie zunächst eine Datenquelle hinzufügen. Klicken Sie zum Hinzufügen der Datenquelle auf Daten >> Datenquelle hinzufügen

Wählen Sie auf der zweiten Seite des Assistenten aus DNG-Modul aus der Liste der vordefinierten Datenquellen. In dem Schema Feld Geben Sie den Hostnamen und die Portnummer des DNG-Servers an. https: // Hostname: 9443 / rm / Publish / Module? Metadaten = Schema

Zum Beispiel, https: // softwaretestinghelp: 9443 / rm / publish / modules? metadata = schema

#3) Geben Sie die DNG-Anmeldeinformationen in Benutzername und Kennwort ein, wählen Sie die Option Auto als Authentifizierungstyp aus und klicken Sie dann auf Weiter.

# 4) Jetzt können Sie sehen, dass die Datenquelle im Abschnitt Datenquelle in der Vorlage hinzugefügt wurde.

# 5) Der nächste Schritt besteht darin, Elemente entsprechend den Anforderungen hinzuzufügen.

• Wähle aus Container und ziehen Sie aus der Palette auf die Vorlage

Hinweis: Container ist wie eine Seite, die den Ausgabeinhalt nicht beeinflusst, und wird hauptsächlich zum Hinzufügen von Datenquellen verwendet .

• Füge eins hinzu Absatz und Text aus der Palette, die sich im Behälter befinden sollte, wie in der Abbildung unten gezeigt. Wobei Absatz die Ausgabe beschreibt und einen Footprint im Ausgabedokument hat.
• Ziehen Sie die Datenquelle> Artefakt Abfrage aus der Datenquellenansicht.

• Doppelklicken Sie auf ein Textelement, wählen Sie die Registerkarte Datenausdruck und erweitern Sie die Datenquelle> Artefakt abfragen und auswählen Titel Dadurch wird der DNG-Modultitel gedruckt.

• Speichern Sie die Vorlage. Die Erweiterung wird sein. Dta.

# 6) Jetzt konfigurieren wir den URI, der die DNG-Module beschreibt.

• Ändern Sie oben rechts die Perspektive auf den Launcher, um die Navigation zu vereinfachen, sodass Sie problemlos zum Launcher navigieren können.

• Wenn Sie die Vorlage gespeichert haben, sehen Sie unter Datenquellenkonfiguration DNG-Modul-Datenquellen in roter Farbe.
• Klicken Sie mit der rechten Maustaste auf die Datenquelle und wählen Sie Datenquellenkonfiguration konfigurieren.
• Geben Sie die URL als an https: // Hostname: 9443 / rm / Publish / Module? reourceURI =

Wo Modul-ID ist,

• Navigieren Sie im Browser auf URL, https: // Hostname: 9443 / rm / web
• Wählen Sie das Projekt nach der Anmeldung bei der Anwendung aus

Öffnen Sie das Modul, für das wir den Bericht erstellen möchten.

Klicken Sie auf Link zu Artefakt freigeben, kopieren Sie die im Bild unten gezeigte ID und ersetzen Sie die Modul-ID in der obigen URL.

• Die URL in RPE Launcher sieht nun wie im folgenden Bild aus. Bietet Benutzeranmeldeinformationen mit dem Auto Authentifizierungsmethode.

• Klicken Sie auf Dokument generieren.

• Die Ausgabe sieht aus wie:

# 7) Hier druckt die Vorlage nur den Titel des DNG-Moduls. Wenn Sie die Datenquelle des DNG-Moduls verwenden, können Sie Moduldetails wie Beschreibung, Modul-ID usw. drucken. Um die Anforderung unter den DNG-Modulen zu drucken, müssen Sie eine DNG-Textdatenquelle hinzufügen. Dafür,

• Gehen Sie zu Daten >> Datenquelle hinzufügen
• Wählen Sie auf der zweiten Seite des Assistenten DNG-Text aus Vordefiniert aus und geben Sie den Hostnamen, den Port, das Benutzername-Passwort und die automatische Authentifizierung an, die wir für die Moduldatenquelle angegeben haben.

Klicken Sie auf Weiter und Fertig stellen.

• Jetzt können wir in der Datenquellenansicht DNG-Text sehen.

Hinweis: Der wichtige Punkt ist, dass wir im DNG-Modul die URL im Launcher konfigurieren. Wenn wir also DNG-Text hinzufügen, müssen wir ihn dynamisch konfigurieren. Für diese automatische Konfiguration müssen wir ein weiteres Element verwenden Dynamische Datenquelle aus der Palette, die sich in einem Behälter befinden sollte. Die Abfrage, die das DNG-Modul und den DNG-Text verknüpft, lautet Daten / Quelle / Modul / Kontext Bindung der Datenquelle des DNG-Moduls .

# 8) Ziehen Sie einen Container per Drag & Drop aus der Palette, der im Abfragecontainer des DNG-Moduls platziert werden soll.

# 9) Ziehen Sie die Abfrage Daten / Quelle / Modul / Kontext Bindung zum Container , wenn Eingabeaufforderung Kontext auswählen Popup wählt die Datenquelle / das Artefakt der Hauptcontainerabfrage aus.

# 10) Klicken Sie mit der rechten Maustaste auf den Container und wählen Sie Einfügen >> Datenquellenkonfiguration. Jetzt kann der Benutzer ein Element sehen, das dem Container hinzugefügt wurde.

#elf) Der nächste Schritt besteht nun darin, diese Datenquelle dynamisch zu konfigurieren. Dafür,

• Wählen Sie das Datenquellenelement aus, um zur Registerkarte Eigenschaften zu gelangen: Datenquellenkonfiguration >> Daten
• Klicken Sie auf Zieldatenquelle und wählen Sie DNG-Text
• Wählen Sie DNG-Modul aus der Konfiguration der geerbten Daten aus

# 12) Klicken Sie auf den Container und wählen Sie erneut das Datenquellenelement aus, wie Sie auf der Registerkarte Eigenschaften unter Daten sehen können. Eine neue Eigenschaft wird als dynamische Konfiguration hinzugefügt.

# 13) Klicken Sie auf URI und wählen Sie im Assistenten den Skriptausdruck aus.

Hinweis: Wie oben beschrieben, werden die Anforderungsdetails und der Link in Daten >> Artefakt >> Kontextbindung >> über gespeichert. Dies Über enthält die jeweilige Anforderungs-URL, die nicht direkt verwendet werden kann, nicht dieselbe Format-URL. Wir müssen also einen Skriptausdruck verwenden, um die URL in unser Format zu konvertieren. Machen Sie dafür dasselbe wie in Bild.

• Der Ausdruck ist: about.replace ('/ resources /', '/ publish / text? resourceURI =');
• Klicken Sie auf OK.
• Geben Sie in der dynamischen Konfiguration Benutzername und Passwort an.

# 14) Hier sind wir, jetzt wird die Anforderung iteriert, also werden wir verwenden Absätze und Text im Behälter und verwenden Sie die DNG-Text Datenquelle Datenquelle / Artefakt Abfrage im Absatz.

#fünfzehn) Um dem Format zu folgen, da die Überschrift der Anforderung fett sein sollte, verwenden wir eine Bedingung, um nur die Überschrift zu filtern. Dafür,

• Klicken Sie mit der rechten Maustaste auf den Absatz und klicken Sie auf Daten >> Bedingung bearbeiten

• Alle Anforderungen innerhalb eines Moduls beziehen sich auf grundlegende Dinge, die im DNG-Modul gespeichert sind Datenquelle / Artefakt / Kontextbindung .
• Erweitern Sie Attribute und den Abfragekontext, der sie bindet, und überprüfen Sie die isHeading Attribut .
• Geben Sie das Skript wie folgt ein:

isHeading == 'true'

• OK klicken.

# 16) Als nächstes müssen wir die Anforderung drucken, die keine Überschrift enthält. Wir werden eine Bedingung zum Filtern nur verwenden, die keine Überschrift enthält. Fügen Sie dazu mit der Abfrage DNGText noch einen Absatz und Text hinzu. Datenquelle / Artefakt / Inhalt / Text / Richtextbody und,

• Klicken Sie mit der rechten Maustaste auf den Absatz und klicken Sie auf Daten >> Bedingung bearbeiten
• Alle Anforderungen innerhalb eines Moduls beziehen sich auf grundlegende Dinge, die im DNG-Modul Datenquelle >> Artefakte >> Kontextbindung gespeichert sind.
• Erweitern Sie Attribute und fragen Sie den Kontext ab und klicken Sie auf das Kontrollkästchen isHeading.
• Geben Sie das Skript wie folgt ein:

isHeading! = 'Wahr'

• OK klicken.

Die Vorlage sieht also so aus:

# 17) Nach der dynamischen Konfiguration des DNG-Texts wird die Datenquelle vor dem Launcher ausgeblendet. Wählen Sie dazu aus einer Gliederung Datenquellen aus und klicken Sie in der Konfiguration, die für die Auswahl von Versteckt erforderlich ist, auf der Registerkarte Eigenschaften auf DNG-Text.

bestes kostenloses Windows 10-Bereinigungsprogramm

# 18) Speichern Sie und klicken Sie auf Bericht erstellen.

Erweiterte Formatierung des Berichts

In diesem Abschnitt wird beschrieben, wie Sie den Absatz formatieren, Stile, Inhaltsverzeichnisse und Textgrößen hinzufügen, um Ihren Bericht auf standardmäßige Weise zu erstellen.

Wie im DNG-Bericht, den wir generiert haben, befindet sich der Modulname und seine Position auf der linken Seite. Die Agenda besteht darin, die Größe an den Überschriftenstil anzupassen und in der Mitte der Seite zu platzieren. Dafür,

# 1) Wählen Sie den Absatz aus, in dem sich der Modultitel befindet, gehen Sie zu den Eigenschaften bis zur Vorlage und wählen Sie die Option Auffüllen, Einrückungen und Abstand. Wählen Sie in der Ausrichtungsoption Mitte aus der Dropdown-Liste.

#zwei) Zum Erhöhen der Größe Gehen Sie in den Eigenschaften zur Option Schriftart und legen Sie die Größe Ihrer Überschrift fest.

#3) Um den Stil anzuwenden, klicken Sie mit der rechten Maustaste auf den Absatz und wählen Sie Stil >> Titel

# 4) Um ein Inhaltsverzeichnis oben auf der Seite hinzuzufügen, wie es nach dem Modultitel erscheinen soll, sollten Sie das Inhaltsverzeichnis aus der Palette hinzufügen. Klicken Sie dazu mit der rechten Maustaste auf das Leerzeichen, nachdem das Titelelement des Moduls vorhanden ist, und wählen Sie Inhaltsverzeichnis aus.

# 5) Damit der Bericht ansprechender aussieht, geben Sie nach dem Inhaltsverzeichnis einen Seitenumbruch an.

# 6) Das Inhaltsverzeichnis-Element fügt nicht die Überschrift Inhaltsverzeichnis hinzu, für die statischer Text vor dem Inhaltsverzeichnis hinzugefügt werden muss (siehe Abbildung unten). Der Text ist a einfacher Wert.

# 7) Versuchen wir nun, den Bericht zu erstellen.

Hinzufügen einer Masterseite (Kopf- und Fußzeile) zum Bericht

Das Masterseitenkonzept in RPE fügt in unserem Dokument Kopf- und Fußzeilen hinzu. Dazu müssen wir die folgenden Schritte ausführen:

# 1) Klicken Sie mit der rechten Maustaste auf den Hauptcontainer und wählen Sie Masterseite >> Neue Masterseite, Geben Sie einen Namen ein.

#zwei) Wir erhalten also eine neue Registerkarte mit dem von Ihnen angegebenen Namen, auf der Sie das vorhandene Kopf- und Fußzeilenelement sehen können.

#3) Ab sofort fügen wir die Seitenzahl in Fußzeile und Kopfzeile hinzu und fügen ein Logo auf der linken Seite hinzu.

# 4) Fügen Sie in der Fußzeile einen Absatz hinzu und klicken Sie mit der rechten Maustaste auf das Element zur Auswahl der Seitenzahl.

# 5) Fügen Sie in der Kopfzeile einen Absatz hinzu und fügen Sie ein Bildelement hinzu. Klicken Sie mit der rechten Maustaste auf Bild durchsuchen und laden Sie das gewünschte Bild.

# 6) Stellen Sie die Auffüllung nach Wunsch nach links oder rechts ein, indem Sie das Absatzelement auswählen.

# 7) Speichern Sie die Vorlage und generieren Sie den Bericht.

Hinzufügen von Variablen und Java Script

Es gibt zwei Arten von Variablen:

Externe Variablen : Hiermit werden Eingaben während der Ausführung des Berichts vorgenommen. Beispielsweise muss ein Benutzer seinen Namen angeben, während er den Bericht generiert, der vom Textfeld erstellt wird.

Interne Variable : Wenn Sie eine Berechnung haben oder ein Programm schreiben muss, um das aktuelle Systemdatum zu erhalten, können wir dies verwenden.

• Zum Erstellen eines variablen Abschnitts für die Gliederung Variable Rechtsklick Einfügen >> Neue Variable
• Gib einen Namen ' Datum' auf Variable und Zugriff auf Intern für die interne Variable.
• Gehen Sie nun zum Abschnitt Fußzeile, fügen Sie einen Absatz nach unten hinzu und füllen Sie ihn auf der rechten Seite auf, wobei das aktuelle Datum auf der rechten Fußzeile gedruckt wird.
• Fügen Sie einen Absatz hinzu und fügen Sie einen Text hinzu, doppelklicken Sie und gehen Sie zum Skriptausdruck.

Datum = Datum (Date.now ()); // welches das aktuelle Datum liefert.

• Speichern Sie die Vorlage. Diese Datumsvariable hat also nur internen Zugriff.
• Jetzt konfigurieren wir eine externe Variable, die Eingaben vom Benutzer entgegennimmt.
• Gehen Sie dazu genauso vor: Klicken Sie mit der rechten Maustaste auf Variable >> Einfügen >> Neue Variable
• Geben Sie den Namen Prepared By ein und wählen Sie select Extern
• Wir werden dies direkt unter dem Modulnamen in der Vorlage bereitstellen, wie im folgenden Bild gezeigt.

• Hier habe ich einen einfachen Text hinzugefügt, der von vorbereitet wurde, und einen weiteren Text auf dem hinzugefügt rechte Seite und hinzugefügte Daten Ausdrucksvariable: Vorbereitet von der wir erstellt haben.
• Die Vorlage sieht also so aus:

• Und im Launcher sehen Sie die Variable PreparedBy in roter Farbe. Klicken Sie einfach auf und geben Sie den Wert nach unten ein.

• Führen Sie den Bericht aus. Sie sehen die in RPE generierte Kopf- und Fußzeile.

Bereitstellen der Vorlage in DNG

Stellen Sie die standardisierte Vorlage für DNG bereit, um die Verwendung von RPE jedes Mal zu vermeiden. Für einen Bericht mit nur einem Klick stellen wir die Vorlage in der DNG-Anwendung bereit.

Das Verfahren ist wie folgt:

• Navigieren Sie zum IBM JTS-Installationsordner / server / conf / rm / reporting / initialization / rrdng
• Stellen Sie sicher, dass der Name der DNG-Modul-Datenquelle Module ist und der DNG-Text bei der Bereitstellung immer _text sein sollte.
• Um in Gliederung umzubenennen, wählen Sie Datenquellenschemata aus, wählen Sie die Datenquelle aus und benennen Sie sie um.
• Kopieren Sie die Vorlage, die wir in RPE erstellt haben, in diesen Ordner.
• Jetzt müssen wir dies bei DNG registrieren, dafür navigieren und die Datei / server / conf / rm / reporting / initialization / META-INF öffnen
• Machen Sie einen Eintrag:

Name: DNG-Bericht
Ort: templates / rrdg / DNG Report.dta
Etikette: DNG-Bericht
Beschreibung: DNG-Bericht
Inhaltstyp: Anwendung / Oktett-Stream
Is-Report: wahr
Kontext: Ansicht, Modul, Sammlung

• Gehen Sie zum Browser und navigieren Sie zur URL. https: // hotsname: 9443 / rm / admin
• Gehen Sie zur Registerkarte Debug.
• Wählen Sie unter Dienste die Option Dienst veröffentlichen aus und klicken Sie auf Dienst initialisieren.

• Gehen Sie zu Projektbereich >> Berichte

• Generieren Sie den Bericht nahtlos.

Fazit

Wenn Sie diesen Artikel gelesen haben, haben Sie verstanden, wie wichtig Rational Publishing Engine für die Erstellung standardisierter Berichte aus DNG ist.

Dieser Artikel richtet sich an Personen mit einem grundlegenden Verständnis von RPE, die ihre Karriere beginnen möchten oder neue Fähigkeiten erlernen möchten. RPE kann problemlos Berichte aus RTC und RQM, CQ, DOORS, Rhapsody und vielen anderen Tools von Drittanbietern erstellen.

Die wichtigen Punkte, die wir in diesem Tutorial besprochen haben, sind:

• Übersicht über Rational Publishing Engine
• Installation der Rational Publishing Engine
• Erkunden der Desktop-Oberfläche von Rational Publishing Engine
• Entwerfen und erstellen Sie grundlegende RPE-Vorlagen
• Anforderungsbericht für Türen der nächsten Generation
• Erweiterte Formatierung des Berichts
• Hinzufügen einer Masterseite (Kopf- und Fußzeile) zum Bericht .
• Hinzufügen einer externen und einer internen Variablen .
• Bereitstellen von Vorlagen in DNG

Viel Spaß beim Lernen !!

Literatur-Empfehlungen

• Lerngrundlagen von Rational Robot - IBM Test Automation Tool
• IBM Rational Quality Manager (RQM) Integration mit Rational Functional Tester (RFT)
• Lernprogramm für die Migration von SVN zu IBM Rational Team Concert
• Einführung in das Tricentis TOSCA Automation Tool
• Tutorial zum IBM Rational Team Concert-Fehlermanagement-Tool
• Eine Schritt-für-Schritt-Anleitung zum IBM Rational ClearQuest Tool
• IBM Rational Team Concert (RTC) und SVN-Integration unter Windows
• Datenpoolfunktion in IBM Rational Quality Manager für Testdatenverwaltung