Polarion – das neue Plug-in für den ReQonsult MATLAB Connector

Die Lücke, die jeder kennt

Anforderungen werden in Polarion verwaltet, Modelle in MATLAB. Um beide aufeinander abzustimmen, sind Exporte, Tabellenkalkulationen oder benutzerdefinierte Skripte erforderlich. Diese versagen jedoch oder veralten. Die Pflege kostet Zeit, die Ingenieure eigentlich für die Konstruktion aufwenden sollten.

Es gibt zwar Alternativen, wie beispielsweise den ReqIF-Austausch zwischen ALM-/PLM-Systemen und der MATLAB Requirements Toolbox. Für die tägliche Arbeit ist dies jedoch keine Lösung, denn: man muss Dateien manuell hin- und herverschieben, Verknüpfungen und Löschungen abgleichen – somit verlagert sich der Aufwand lediglich auf den Schreibtisch eines Anderen.

Die MATLAB-Integrationen von ReQonsult schließen diese Lücke. So lassen sich beispielsweise Ihre MATLAB- und Simulink-Artefakte direkt mit Polarion Work Items verknüpfen und so die Traceability vollumfänglich in Polarion abbilden.

Polarion-Integration auf einen Blick

Mit einem Klick verbinden

Fügen Sie im Ihnen bereits bekannten Dialogfeld „Serverkonfiguration“ einen Polarion-Server hinzu. Geben Sie die Server-URL und ein persönliches Zugriffstoken ein, bestätigen Sie die Eingabe – und schon sind Sie drin. Mehrere Projekte auf demselben Server stehen sofort zur Verfügung – ganz ohne zusätzliche Einrichtung.

Mehrere Polarion-Server (zum Beispiel für interne Server und kundenorientierte Server) sind dabei konfigurierbar. Um Schritt für Schritt Hilfe beim Abrufen eines Personal Access Tokens (PAT) aus Polarion zu erhalten, können Sie den KI-Assistenten nutzen.

Abbildung 1: Serverkonfiguration: Der Polarion-Server wurde neben anderen Systemen hinzugefügt. Der Projektfilter sorgt dafür, dass der Fokus auf Verknüpfungen und Importen liegt.

ReQonsult MATLAB Connector

Der ReQonsult MATLAB Connector verbindet MATLAB mit ALM-/PLM-Systemen und ermöglicht bidirektionale Rückverfolgbarkeit. Anforderungen, Tests und Änderungen werden effizient verknüpft – das spart erheblich Zeit.

Connector entdecken

Einstellungen vornehmen und anpassen

Das Verhalten des Connectors wird über Einstellungen gesteuert, darunter die Konfiguration von Surrogaten, die Ausführlichkeit der Debug-Ausgabe und die Zuordnung des Datenmodells. Für Teams bietet dies zudem eine teamweite Basis mit der Möglichkeit, lokale Anpassungen vorzunehmen.

Abbildung 2: Systemunabhängige Einstellungen

Abbildung 3: Polarionspezifische Einstellungen

Abbildung 4: Teambezogene Einstellungen

Importieren Sie nur, was Sie brauchen

Öffnen Sie den Importdialog und durchsuchen Sie Ihren Polarion-Server wie eine Dateistruktur. Projekte lassen sich aufklappen und zeigen Folgendes an:

• Documents: nach Arbeitsbereichen organisiert, unter Beibehaltung der Überschriftenhierarchie

• Collections: kuratierte projektübergreifende Elementgruppen mit optionaler Revisionsfixierung

• Work Item Types: abfragebasierte flache Importe nach Typ (Anforderungen, Testfälle, Risiken usw.)

Das importierte ReqSet spiegelt die Dokumentstruktur wider: Überschriftenebenen, Reihenfolge der Elemente und Typklassifizierung. Überschriften werden zu Containern. Konfigurieren Sie die Container- und Informationstypen entsprechend Ihrer MATLAB-Konfiguration.

Alle Standard-Polarion-Feldtypen werden unterstützt. Aufzählungen werden in lesbare Bezeichnungen umgewandelt; Standard- und benutzerdefinierte Felder werden über die konfigurierbare Liste „Zu importierende Felder“ übernommen.

Select Document or Query to import to Simulink Requirements or to preview in System Browser

Abbildung 5: Importdialog: Polarion-Projekte mit Documents, Collections und Work Item Types

Das importierte ReqSet spiegelt die Dokumentstruktur wider: Überschriftenebenen, Reihenfolge der Elemente und Typklassifizierung. Headings werden zu Containers. Konfigurieren Sie die Containers und Informational Types entsprechend Ihrer MATLAB-Konfiguration.

Alle Standard-Polarion-Feldtypen werden unterstützt. Aufzählungen werden in lesbare Formate umgewandelt.

Frozen Items und Document Baselines

Wenn ein Dokument an eine bestimmte Revision gebundene (frozen) Elemente enthält, behält das ReqSet jede gebundene Revision bei. Es wird ein Revisionskennzeichen angezeigt; der Inhalt entspricht genau dem Stand dieser Revision – nicht dem aktuellen Stand.

Beim Importieren eines Baselined Document (URL mit ?revision=N) wird das Dokument in dem Zustand importiert, in dem es zu diesem Zeitpunkt vorlag. Elemente, die seit der Baseline hinzugefügt oder entfernt wurden, werden entsprechend angezeigt oder ausgeblendet – der Vergleich mit der Baseline bleibt unkompliziert.

Direkt verlinken – kein Import erforderlich

Verknüpfen Sie MATLAB-Artefakte mit Polarion-Elementen, ohne sie zuvor zu importieren. Lassen Sie das Dialogfeld „Direct Linking“ geöffnet, wählen Sie Diagrammobjekte aus und verknüpfen Sie diese mit Polarion-Artefakten. Wählen Sie den Kontext (Dokument, Abfrage usw.) aus, wenn Sie im Dialogfeld „Open view for Direct Linking“ auf „Select to import“ klicken.

Abbildung 6: Direct Linking-Dialog

Eine URL mit Ihren bevorzugten Inhalten registrieren

Sie sind nicht verpflichtet, die Knoten aus der Projekthierarchie für den Import oder die direkte Verknüpfung zu verwenden. Stattdessen können Sie einfach eine beliebige passende URL aus Polarion registrieren. Sie können beispielsweise einen Filter für eine Tabellenansicht erstellen oder eine Baseline für ein Dokument auswählen. Beginnen Sie hier mit dem Import oder der direkten Verknüpfung.

ALM Consulting

Entdecken Sie Leistungen, die Ihre Produktentwicklung transformieren. Unsere Experten bieten tiefgreifende Beratung und maßgeschneiderte Lösungen für ein nahtloses Management von Anwendungslebenszyklen.

Beratung anfordern

Rückverfolgbarkeit an Polarion übermitteln

An dieser Stelle ist die Integration nicht mehr nur schreibgeschützt. Benötigen Sie Polarion-Berichte, aus denen hervorgeht, welche Anforderungen Ihr Team umgesetzt hat? Oder wie Simulink-Objekte und System Composer-Architekturen wiederverwendet werden? Übertragen Sie Verknüpfungsinformationen aus MATLAB mit „Update Backlinks“. Sie erstellen Vorwärtsverknüpfungen in MATLAB – Polarion spiegelt diese auf der anderen Seite wider.

Stellvertretende Work Items – Rückverfolgbarkeit, die beide Teams einsehen können

Verknüpfen Sie Simulink-Blöcke (oder System Composer-Komponenten) mit Polarion-Anforderungen und führen Sie „Backlinks aktualisieren“ aus. Der Connector erstellt in Polarion stellvertretende Work-Items – eines pro verknüpftem MATLAB-Artefakt. Jedes dieser Items enthält:

• Den Namen des MATLAB-Artefakts und einen Screenshot des Diagramms (wird bei jedem Backlink-Push automatisch aktualisiert)

• Einen Hyperlink zurück zum Live-Modell (öffnet sich am richtigen Block)

• Work Item Links zu jeder Anforderung, auf die das Artefakt zurückgeführt wird

Ein Block, viele Anforderungen: ein Ersatzobjekt, drei ausgehende Links. Viele Blöcke, eine Anforderung: drei Ersatzobjekte, jedes mit einem eigenen Hyperlink. Die Zuordnung bleibt von beiden Seiten korrekt.

Abbildung 7: Ein stellvertretendes Item in Polarion

Die Link-Semantik wird übernommen

Die Requirements Toolbox von MATLAB weist Verknüpfungssemantiken zu – „Relate“, „Implement“, „Verify“, „Derive“ und weitere. Der Connector ordnet diese direkt den Verknüpfungsrollen von Polarion zu.

Vollständig konfigurierbar: Weisen Sie „Implement“-Verknüpfungen einer „implements“-Rolle und „Verify“-Verknüpfungen einer „verifies“-Rolle zu – damit die Rückverfolgbarkeitsberichte genau das widerspiegeln, was Sie tatsächlich meinen.

Abbildung 8: MATLAB-Links den Polarion-Link-Rollen zuordnen

Inkrementelle Synchronisierung – Keine doppelten Platzhalter

Die Ausführung von „Update Backlinks“ erstellt nicht wahllos alles neu, sondern:

1. Ermittelt vorhandene Surrogate anhand der MATLAB-URL – nicht anhand des Namens. Wenn Sie einen Block umbenennen, entsteht kein Duplikat.

2. Aktualisiert nur das, was sich geändert hat – Titel, Beschreibung, Anhang oder Link-Rollen.

3. Bereinigt verwaiste Einträge – wenn Sie einen Block löschen oder alle Links entfernen, verschwindet dessen Surrogate aus Polarion.

Surrogate bleiben bei Umbenennungen, Neupositionierungen und Eigenschaftsänderungen erhalten. Der Hyperlink zurück zu MATLAB bleibt stabil.

Project Updater: Neues Release

Mit dem Release 2607 unseres Polarion Project Updaters steuern Sie Polarion-Templates von der Erstellung bis zum Rollout. Damit werden neu zentrales Template-Management, klare Konfliktlösung und sichere Updates vereint.

Pressemitteilung lesen

„Aktualisieren“ hält MATLAB auf dem neuesten Stand

Die Rückverfolgbarkeit funktioniert in beide Richtungen. Wenn sich eine Anforderung in Polarion ändert – Titel, Status, neuer Eintrag, gelöschter Eintrag –, klicken Sie in MATLAB auf „Aktualisieren“, um das ReqSet erneut abzurufen und zu aktualisieren:

• Neue Einträge erscheinen in der Hierarchie

• Gelöschte Einträge werden entfernt

• Geänderte Einträge werden als „suspected“ markiert, wenn sie bereits mit MATLAB-Artefakten verknüpft sind

Verdächtige Verknüpfungen sind ein integraler Bestandteil der Requirements Toolbox: Sie signalisieren, dass sich die Anforderung nach der Verknüpfung geändert hat. Überprüfen Sie, ob das Design der Aktualisierung weiterhin entspricht. Unser Connector setzt dieses Flag automatisch.

Für Polarion konfigurierbar

Die Polarion-Konfiguration ist bei jedem Team unterschiedlich. Über das Dialogfeld „Einstellungen“ lassen sich die wichtigsten Verhaltensanforderungen für jeden Server individuell steuern:

Setting	Zweck
Zu importierende Felder	Welche Polarion-Felder als ReqSet-Attribute angezeigt werden (durch Kommas getrennte Anzeigenamen)
Workitem-Typen für Container	Strukturelle Containertypen (z. B. Überschrift, Ordner), die Implementierungs- und Verifikationsstatistiken zusammenfassen
Workitem-Typen für Informationen	Informationstypen – siehe MATLAB-Dokumentation
Standard-Workitem-Typ für Surrogate	Polarion-Workitem-Typ für MATLAB-Surrogate
Typzuordnung für Surrogate	Als Erweiterung der Standardeinstellung können MATLAB-Objekttypen bestimmten Polarion-Workitem-Typen zugeordnet werden
Standard-Verknüpfungsrolle für Surrogate	Fallback-Link-Rolle, wenn keine Zuordnung festgelegt ist
Zuordnung von Verknüpfungstypen	Zuordnung von MATLAB-Link-Typen zu Polarion-Link-Rollen
Hyperlink-Rolle	Bezeichnung der Hyperlink-Rolle für Links zur Rücknavigation
Vereinfachter Vergleich von Anhängen	Anhänge nach Größe vergleichen, um die Synchronisierung zu beschleunigen; für CRC-basierten Vergleich deaktivieren

Mit einem Klick von MATLAB zu Polarion wechseln

Jede importierte Anforderung verfügt über die Aktion „Element auf dem Server öffnen“. Dadurch wird das Work Item in Polarion geöffnet – mit dem richtigen Projekt, Dokument und Element. Bei gesperrten Elementen wird über die Navigation die angeheftete Revision geöffnet. Projektübergreifende Verweise führen zum Quellprojekt, nicht zum importierenden Projekt.

Anhand realistischer Szenarien getestet

Angesichts der Komplexität der Lösung, einschließlich der Integration mit verschiedenen ALMs, unterschiedlichen Architekturen und Workflows, haben wir die Testautomatisierung priorisiert.

Wir haben die Integration anhand von über 50 verschiedenen End-to-End-Szenarien gründlich getestet, darunter Import, Verknüpfung, Änderungen in MATLAB und Polarion, Synchronisation, Konfiguration, End-to-End-Roundtrips sowie Infrastrukturkomponenten wie Authentifizierung, Paginierung und Parallelität. Insgesamt umfasst die Plattform über 1.400 Unit- und Funktionstests.

Erste Schritte

• Installieren Sie die ReQonsult-Toolbox in MATLAB (doppelklicken Sie auf „ReQonsult.mltbx“ oder führen Sie die Datei über das Kontextmenü aus)

• Öffnen Sie ein Modell in Simulink

• Wechseln Sie zur Symbolleiste

• Öffnen Sie „Serverkonfigurationen“ und fügen Sie einen Polarion-Server hinzu (URL und PAT).

• Öffnen Sie „Daten für die Verknüpfung auswählen“, navigieren Sie zu Ihrem Dokument oder Ihrer Abfrage und klicken Sie auf „In Simulink importieren“

• Erstellen Sie über die Perspektive „Requirements Toolbox“ Verknüpfungen von Modellblöcken zu Anforderungen (öffnen Sie die „Requirements View“ in der Symbolleiste)

• Klicken Sie auf „Backlinks aktualisieren“ – in Polarion werden Surrogate angezeigt.

Die Polarion-Integration ist in der Standard-ReQonsult-Lizenz für Polarion-fähige Konfigurationen enthalten. Kontaktieren Sie uns, um die Integration zu aktivieren oder eine Testversion anzufordern.

Über den Autor

Nick Entin ist Head of Research & Development bei ReQonsult und international anerkannter Experte für Application Lifecycle Management und Softwareentwicklung. Als einer der maßgeblichen Architekten hinter Siemens Polarion verbindet er jahrzehntelange Erfahrung mit strategischer Weitsicht und gutem Gespür für zukunftsfähige Produktentwicklung.

Mehr über den ReQonsult MATLAB Connector erfahren Sie auf unserer Produktseite.

Demo vereinbaren

Fordern Sie jetzt eine unverbindliche Demo an und lernen Sie den ReQonsult MATLAB® Connector kennen. Unsere Experten beraten Sie branchenspezifisch und zeigen live, wie Sie Effizienz und Compliance nachhaltig steigern.

Nick Entin – Head of Research & Development

Weitere Blogartikel

Finden Sie in unserem Blog praxisnahe Tipps, aktuelle Trends und wertvolle Einblicke, die Ihre Entwicklungprojekte effizienter gestalten, die Produktivität Ihres Teams steigern und Ihren Geschäftserfolg sichern.