Rückverfolgbarkeitsdokumente aus CLM-Anwendungen mithilfe des POX-Profils erstellen

Es ist jetzt noch einfacher, Rückverfolgbarkeitsdokumente aus CLM-Anwendungen zu erstellen. Sie können OSLC-URLs konfigurieren, die Reportable REST-Darstellungsdaten zurückgeben, wenn ein bestimmter Header in der Anforderung mithilfe von POX (Plain Old XML) eingeschlossen wurde.

Vorbereitende Schritte

Sie müssen Rational Publishing Engine ab Version 2.1.0 und Rational solution for CLM ab Version 6.0.2 installiert haben.

Informationen zu diesem Vorgang

Bisher war es schwierig, Rückverfolgbarkeitsdokumente zu erstellen, da einige Anwendungen, wie beispielsweise Rational Quality Manager und Rational Team Concert OSLC-URLs verwenden, Rational Publishing Engine jedoch Reportable REST-URLs erfordert. Dieser Umstand hat das Entwerfen von Vorlagen erschwert, weil die URLs von OSLC in Reportable REST konvertiert werden mussten. Manchmal enthält die OSLC-Darstellung eines Artefakts nicht genügend Informationen, wie z. B. Rich Text, die für die Generierung von Dokumenten erforderlich sind.

Mithilfe des POX-Profils können Sie OSLC-URLs wie Reportable REST-APIs verwenden. Sie können das POX-Profil in Rational Publishing Engine verwenden, um Reportable REST-Daten direkt anzufordern und zu empfangen, indem Sie einen zusätzlichen Header bereitstellen. Sie müssen keine URLs mehr konvertieren oder Anforderungen duplizieren. Der Dokumentgenerierungsservice gibt die zusätzlichen XML-Daten im Header zurück.

Beispiel: Rückverfolgbarkeitsdokument aus Rational DOORS Next Generation in Design Management erstellen

Vorgehensweise

  1. Fügen Sie in Document Studio ein Rational DOORS Next Generation-Schema hinzu.
  2. Erstellen Sie Vorlagenelemente, um die Informationen aus einem Artefakt auszugeben.
    DNG-Element
  3. Iterieren Sie die Linkinformationen in der Anforderung.
    DNG-Link
  4. Kopieren Sie in Design Management die URL des Artefakts, indem Sie im Breadcrumb auf das Symbol Permalink anzeigen klicken.
  5. Öffnen Sie in Document Studio den Assistenten "Datenquellenschema hinzufügen".
  6. (Neu) Fügen Sie die URL in das Feld Schema ein und hängen Sie die Angabe &metadata=schema an das Ende der URL an.
  7. (Neu) Wählen Sie im Feld Zusätzliche Header den POX-Profilheader aus.
    DM-Schema mit POX-Profil hinzufügen
  8. Klicken Sie auf Weiter und dann auf Fertigstellen.
  9. Erstellen Sie in Ihrer Vorlage die Vorlagenelemente, die dem Link zurück zu Rational DOORS Next Generation folgen. Öffnen Sie die Datenquellenkonfiguration in der Sicht "Eigenschaften" und klicken Sie auf das Register "Dynamische Konfiguration":
    1. (Neu) Geben Sie im Feld URI den HREF (Hyperlink-Referenz) aus Rational DOORS Next Generation ein.
    2. (Neu) Geben Sie im Feld Accept-Header application/xml ein.
    3. (Neu) Wählen Sie im Feld Zusätzliche Header den POX-Profillink aus. Das Feld "Zusätzliche Header" weist die Anwendung an, mit Reportable REST-Informationen zu antworten, obwohl eine OSCL-URL verwendet wird.
      Datenquellenkonfiguration für POX-Profil
  10. Erstellen Sie Vorlagenelemente, um die Design Management-Informationen auszugeben.
    DM-Element
  11. Rufen Sie RPE Launcher auf, um das Dokument zu generieren.
  12. Klicken Sie in der Sicht "Dokumentspezifikation" mit der rechten Maustaste auf die Rational DOORS Next Generation-Datenquelle und wählen Sie Datenquelle konfigurieren aus.
    1. URL: Geben Sie die Permalink-URL aus Rational DOORS Next Generation ein.
    2. Sofern erforderlich, geben Sie einen Benutzernamen und ein Kennwort ein.
    3. Authentifizierung: Wählen Sie OAuth aus.
    4. Accept-Header: Geben Sie application/xml ein.
    5. (Neu) Zusätzliche Header: Wählen Sie den POX-Profillink, um Reportable REST-Daten aus Rational DOORS Next Generation anzufordern.
  13. Klicken Sie in der Hauptsymbolleiste auf Dokument generieren. In der Konsolenansicht sehen Sie, dass Rational Publishing Engine Daten aus Design Management und Rational DOORS Next Generation unter Verwendung der OSLC-URLs anfordert. Design Management und Rational DOORS Next Generation leiten diese Informationen auf die Reportable REST-URLs um. Das Ausgabedokument enthält das Anforderungsformular aus Rational DOORS Next Generation und die zugeordneten Modelldaten aus Design Management.
    Ergebnis, in dem DNG-Daten und DM-Daten angezeigt werden