Publishing URLs

Was es ist und warum es existiert

Spezifikationen, Testpläne und Compliance-Dokumente werden häufig mit IBM Engineering Publishing (früher Rational Publishing Engine) aus DOORS Next erzeugt. Jede Vorlage braucht Datenquellen-URLs, die auf das richtige Projekt, die richtige Konfiguration, das richtige Modul, die richtige Ansicht oder die richtigen Artefakte zeigen, dazu die passenden Schema-URLs.

Diese Reportable-REST-URLs von Hand zu schreiben, erfordert die Kenntnis vieler Parameter und der internen Kennungen von Projekten, Modulen und Konfigurationen. Ein einziger Fehler ergibt ein leeres oder falsches Dokument. Publishing URLs wurde entwickelt, um die korrekten URLs genau von der Stelle aus zu erzeugen, an der Sie sich in DOORS Next befinden.

Gelöste Probleme

• Datenquellen-URLs, die von Hand mit internen IDs und vielen Parametern geschrieben werden.
• Dokumente, die aus der falschen Konfiguration, dem falschen Datenstrom oder der falschen Baseline erzeugt werden.
• Zeitverlust bei der Suche nach dem richtigen Parameter in der Dokumentation.
• Abhängigkeit von wenigen Spezialisten, die die Reportable-REST-Schnittstelle kennen.

Vorteile

• Korrekte URLs in Sekunden für das Modul, seine Artefakte, eine Ansicht, die Auswahl oder das ganze Projekt.
• Schema-URLs inklusive, so wie die Publishing-Vorlage sie benötigt.
• Die richtige Konfiguration: Datenstrom, Baseline, Änderungsset oder globale Konfiguration, direkt aus Ihrem aktuellen Kontext übernommen.
• Kopieren und öffnen Sie jede URL mit einem Klick, oder kopieren Sie alle auf einmal.
• Nur lesend und sicher.

Verwendung

1. Öffnen Sie das Projekt, die Konfiguration und das Modul, um die es im Dokument geht, und wählen Sie Artefakte aus, falls nur diese veröffentlicht werden sollen.
2. Prüfen Sie den Bereich Context, der zeigt, woraus die URLs erzeugt werden.
3. Wählen Sie unter Settings das Artefaktformat, den Konfigurationsparameter, die Ansicht, die Attribute und Extras wie ein Deckblatt.
4. Kopieren Sie die benötigten URLs aus Data source URLs in Ihre Publishing-Vorlage.

Gut zu wissen

• URLs, die nicht zum aktuellen Kontext passen, werden mit Begründung aufgeführt, zum Beispiel wenn kein Modul geöffnet ist.
• Sehr lange URLs aus großen Auswahlen erhalten eine Warnung, da manche Tools die URL-Länge begrenzen.