Anforderungen
Programmkarte
Sehen Sie, wie Ihre Projekte miteinander verknüpft sind, mit der Anzahl der Verknüpfungen je Projektpaar, und verfolgen Sie die Verknüpfungskette eines Elements durch andere Projekte.
Auf dieser Seite
- Überblick
- Konzepte
- So setzen Sie es ein
- Sehen, wie Ihre Projekte verknüpft sind
- Von einem Projekt aus beginnen
- Ein Element durch das Programm verfolgen
- Durchgehendes Beispiel: die CubeSat-EO-1-Demo und ein Nutzlastprojekt
- Durchgehendes Beispiel: das Hybridauto und sein Batteriepaket
- Tipps und bewährte Vorgehensweisen
- Häufige Fehler
- Zusammenhang mit anderen Funktionen
- Die Seite Programmkarte
- API und MCP
- Meldungen
- Grenzen
- Verwandte Themen
Überblick
Ein Programm, das sich über mehrere Projekte erstreckt (ein Systemprojekt, Subsystemprojekte, ein Testprojekt, Bibliotheken), wird durch Links zu anderen Projekten zusammengehalten. Jeder Link wird in dem Projekt gespeichert, das ihn anlegt, daher zeigt kein einzelnes Projekt das Gesamtbild. Die Programmkarte tut es: Sie zeichnet einen Kasten je Projekt, das Sie öffnen können, und einen Pfeil je Projektpaar, beschriftet mit der Relation und der Anzahl der Links.
Die Seite hat zwei Ansichten:
- Projekte: jedes Projekt, das Sie öffnen können, und die Links dazwischen, als Graph oder Tabelle.
- Elementnachverfolgung: ein Element in der Mitte und die damit verknüpften Elemente in anderen Projekten, Ring für Ring, bis zu sechs Schritte nach außen.
Die Programmkarte steht allen angemeldeten Personen offen. Die Links selbst werden im Tarif Team angelegt; Links in einem Projekt, dessen Besitzer einen Tarif ohne diese Links hat, werden grau gezeichnet. Die Links zwischen den Demoprojekten Hybridauto und Hybridauto-Batteriepaket funktionieren in jedem Tarif.
Konzepte
Was die Übersicht zeigt
| Element | Bedeutung |
|---|---|
| Kasten | Ein Projekt, das Sie öffnen können: sein Name, sein Projekttyp und seine Anzahl an Elementen; sein zugänglicher Name nennt zusätzlich die Links, die es enthält und empfängt |
| Pfeil | Links, die im Projekt am Pfeilende gespeichert sind und auf Elemente im Projekt an der Pfeilspitze zeigen |
| Pfeilbeschriftung | Relation · Links · gelöscht, zum Beispiel traced from · 12 · 1 gelöscht |
| Projekte, die Sie nicht öffnen können (N Links) | Ein gestrichelter Kasten, der jeden Link in ein Projekt zählt, das Sie nicht öffnen können |
| Kasten für ein Bibliotheksrelease | Ein Bibliotheksrelease, das Sie lesen können und auf das Ihre Projekte verlinken |
Pfeile zeigen meist nach oben: Subsystemprojekte speichern traced from- und satisfies-Links zum Systemprojekt, und Testprojekte speichern verifies-Links. Die Übersicht ordnet die Projekte, die Links enthalten, unter den Projekten an, auf die sie zeigen.
Wer was sieht
Die Übersicht wird nur aus den Projekten aufgebaut, die Sie öffnen können: Projekte, in denen Sie Mitglied mit irgendeiner Rolle sind, die nicht im Papierkorb liegen und deren Regel der Organisation zur Zwei-Schritt-Anmeldung Sie erfüllen.
- Ein Link in ein Projekt, das Sie nicht öffnen können, wird unter Projekte, die Sie nicht öffnen können (N Links) gezählt. Dieser Kasten nennt nie das Projekt oder Element und sieht gleich aus, ob das Projekt existiert, im Papierkorb liegt oder nie existiert hat.
- Links, die in einem Projekt gespeichert sind, das Sie nicht öffnen können, werden nirgends gezählt, auch wenn sie auf Ihre Projekte zeigen.
- Organisationsadmin zu sein, fügt nichts hinzu: Die Übersicht verwendet die Projektmitgliedschaft.
- Exporte (CSV, SVG, PNG) enthalten genau das, was die Seite zeigt.
Farben
| Farbe | Bedeutung |
|---|---|
| Blauer Pfeil | Links zwischen Projekten, die Sie öffnen können |
| Bernsteinfarbener Pfeil | Einige Ziele sind gelöscht (im Papierkorb oder verschwunden) |
| Grauer Pfeil | Links in Projekte, die Sie nicht öffnen können, zu einem Bibliotheksrelease oder gespeichert in einem Projekt, dessen Besitzer einen Tarif ohne Links zu anderen Projekten hat |
So setzen Sie es ein
Sehen, wie Ihre Projekte verknüpft sind
- Klicken Sie auf Projekte verwalten und dann auf Programmkarte. Die Ansicht Projekte öffnet sich mit jedem Projekt, das Links enthält oder empfängt.
- Lesen Sie die Pfeile. Zeigen Sie auf einen Kasten, um alles abzublenden, was nicht mit ihm verbunden ist.
- Klicken Sie auf einen Pfeil. Der Inspektor listet seine Links auf, jeweils 100: das Element, das jeden Link enthält, die Relation und das Zielelement. Klicken Sie auf eines der Elemente, um es in seinem Projekt zu öffnen, oder auf Mehr anzeigen für die nächsten 100.
- Klicken Sie im Inspektor auf CSV exportieren, um die Links dieses Pfeils zu speichern, oder in der Leiste auf Exportieren ▾, um die ganze Übersicht als CSV, SVG oder PNG zu speichern.
Von einem Projekt aus beginnen
- Öffnen Sie das Projekt, dann Verifikation → Programmabdeckung, und klicken Sie auf Programmkarte öffnen.
- Die Übersicht zeigt nur dieses Projekt und die Projekte, die direkt oder über andere damit verknüpft sind.
- Klicken Sie auf Alle Projekte anzeigen, um alles zu sehen, was Sie öffnen können.
Sie können auch auf einen Kasten klicken und Nur verknüpfte Projekte anzeigen wählen.
Ein Element durch das Programm verfolgen
- Wählen Sie das Element aus. Öffnen Sie im Abschnitt Nachverfolgung des Inspektors Andere Projekte ⋯ und wählen Sie In der Programmkarte anzeigen. Klicken Sie stattdessen in der Linkliste eines Pfeils auf Dieses Element nachverfolgen.
- Die Ansicht Elementnachverfolgung zeigt das Element in der Mitte und die damit verknüpften Elemente in Ringen: der erste Ring einen Schritt entfernt, der zweite zwei Schritte. Links werden in beide Richtungen verfolgt.
- Wählen Sie Schritte (1 bis 6, Standard 3), um weiter hinaus zu gehen oder näher zu bleiben.
- Elemente sind nach Projekt eingefärbt, mit einem gestrichelten Kasten um die Elemente jedes Projekts. Deaktivieren Sie Nach Projekt gruppieren, um die Kästen zu entfernen.
- Klicken Sie auf ein Element für Element öffnen und Ab hier nachverfolgen, was es in die Mitte setzt.
Durchgehendes Beispiel: die CubeSat-EO-1-Demo und ein Nutzlastprojekt
- Erstellen Sie die CubeSat-EO-1-Demo und dann ein zweites Projekt EO-1 Payload mit der Anforderung PL.1 Imager resolution.
- Wählen Sie in EO-1 Payload PL.1 aus. Klicken Sie in Nachverfolgung → Andere Projekte auf +, wählen Sie traced from, das CubeSat-Projekt und dessen Bildgebungsanforderung, und klicken Sie auf Link hinzufügen.
- Erstellen Sie ein drittes Projekt EO-1 Test Campaign mit dem Testfall TC.4 Resolution test und verknüpfen Sie ihn mit verifies mit PL.1 in EO-1 Payload.
- Öffnen Sie Projekte verwalten → Programmkarte. Die Übersicht zeigt EO-1 Test Campaign unten, EO-1 Payload darüber und das CubeSat-Projekt oben, mit den Pfeilen verifies · 1 und traced from · 1.
- Klicken Sie auf PL.1 → Nachverfolgung ⋯ → In der Programmkarte anzeigen: Der Testfall und die CubeSat-Anforderung liegen einen Schritt entfernt, je auf einer Seite.
Durchgehendes Beispiel: das Hybridauto und sein Batteriepaket
- Klicken Sie unter Projekte verwalten auf Projektdateien ▾ → Neues Demoprojekt → Hybridauto (SysML v2).
- Erstellen Sie dann Projektdateien ▾ → Neues Demoprojekt → Hybridauto-Batteriepaket (SysML v2). Die Pack-Anforderungen des Batterielieferanten PackCapacity, PackMass und ChargeAcceptance sind mit traced from mit den Anforderungen des Autos VR-3, VR-6 und VR-5 in Ihrer neuesten Hybridauto-Demo verknüpft, gleich welche der beiden Sie zuerst erstellen; wird die Hybridauto-Demo erneut erstellt, wandern die Links zur neuen. Diese Demo-Links funktionieren in jedem Tarif. Ohne ein Hybridauto-Projekt hat die Pack-Demo keine Links.
- Öffnen Sie Projekte verwalten → Programmkarte. Die Übersicht zeigt die beiden SysML-v2-Projekte mit dem Pfeil traced from · 3.
Tipps und bewährte Vorgehensweisen
- Vereinbaren Sie die Relationen, die Teilprojekte verwenden (traced from oder satisfies für Anforderungen, verifies für Tests), damit die Pfeile überall gleich zu lesen sind.
- Deaktivieren Sie Relationen gruppieren, um einen Pfeil je Relation zu sehen, zum Beispiel um Anforderungslinks von Testlinks zwischen denselben zwei Projekten zu unterscheiden.
- Ziehen Sie Kästen, um die Übersicht anzuordnen. Die Positionen werden in diesem Browser für jeden Bereich gespeichert.
- Verwenden Sie die Ansicht Tabelle, um Projektpaare nach Anzahl der Links oder gelöschter Ziele zu sortieren.
- Ein bernsteinfarbener Pfeil bedeutet Links, die repariert werden müssen: Öffnen Sie seine Linkliste und korrigieren oder entfernen Sie dann die Links in Nachverfolgung → Andere Projekte des Elements.
Häufige Fehler
| Problem | Ursache | Behebung |
|---|---|---|
| Ein Projekt fehlt | Sie sind kein Mitglied davon, es liegt im Papierkorb, oder es hat keine Links | Bitten Sie den Besitzer um Zugriff; aktivieren Sie Nicht verknüpfte Projekte anzeigen, um Projekte ohne Links aufzulisten |
| Alles landet unter Projekte, die Sie nicht öffnen können | Die Links zeigen auf Projekte, in denen Sie kein Mitglied sind | Bitten Sie den Besitzer eines Projekts um Zugriff |
| Graue Pfeile mitten in der Übersicht | Der Besitzer des Projekts, das die Links enthält, hat nicht den Tarif Team | Der Besitzer wechselt unter Kontoeinstellungen → Tarif & Abrechnung zu einem höheren Tarif |
| Ein neuer Link wird noch nicht angezeigt | Die Übersicht liest noch die letzten Änderungen | Klicken Sie nach einer Minute auf Aktualisieren |
Zusammenhang mit anderen Funktionen
- Links zu anderen Projekten: Die Übersicht liest sie; sie fügt nichts hinzu und ändert nichts. Legen Sie Links in Nachverfolgung → Andere Projekte eines Elements an (siehe Links zu anderen Projekten).
- Programmabdeckung: die Sicht je Element auf die Links in ein Projekt, mit Lücken (siehe Programmabdeckung). Programmkarte öffnen startet dort die Übersicht von diesem Projekt aus.
- Bibliotheken: Links zu einem Element eines Bibliotheksreleases erscheinen als Pfeile zum Kasten des Releases (siehe Bibliotheken).
- Spinnendiagramm: die Nachverfolgung innerhalb eines Projekts, mit gestrichelten Kästen für verknüpfte Elemente anderswo. Die Elementnachverfolgung verwendet dasselbe Ringlayout.
- API und MCP: dieselbe Übersicht und Nachverfolgung für Werkzeuge (siehe API und MCP).
Die Seite Programmkarte
Leiste
| Steuerelement | Was sie tut |
|---|---|
| Projekte / Elementnachverfolgung | Wechselt die Ansicht |
| Umfang | Alle meine Projekte, eine Organisation (wenn Sie einer angehören) oder ein Ordner mit seinen Unterordnern (wenn Sie Ordner haben; siehe Projektordner) |
| Alle Projekte anzeigen | Angezeigt, nachdem die Übersicht aus einem Projekt geöffnet wurde; verlässt die verknüpfte Gruppe dieses Projekts |
| Nicht verknüpfte Projekte anzeigen | Zeigt auch Projekte ohne Links |
| Relationen gruppieren | Ein Pfeil je Projektpaar (die Beschriftungen listen jede Relation) oder ein Pfeil je Relation |
| Schritte | Elementnachverfolgung: 1 bis 6 Schritte nach außen |
| Nach Projekt gruppieren | Elementnachverfolgung: gestrichelte Kästen um die Elemente jedes Projekts |
| Graph / Tabelle | Das Diagramm oder eine sortierbare Tabelle; auf einem schmalen Bildschirm öffnet sich zuerst die Tabelle |
| Aktualisieren | Liest die Links erneut |
| Exportieren ▾ | CSV exportieren, SVG exportieren, PNG exportieren |
Graph
- Klicken Sie auf einen Kasten, um sein Projekt im Inspektor anzuzeigen: Projekt öffnen und Nur verknüpfte Projekte anzeigen. Doppelklicken Sie auf einen Kasten oder drücken Sie darauf Shift+Enter, um das Projekt zu öffnen.
- Klicken Sie auf einen Pfeil, um seine Links im Inspektor aufzulisten.
- Ziehen Sie Kästen, um sie zu verschieben; scrollen oder spreizen Sie zum Zoomen; ziehen Sie den Hintergrund, um zu schwenken.
- Drücken Sie Tab, um die Übersicht zu erreichen, und dann die Pfeiltasten, um zwischen Kästen und Pfeilen zu wechseln; Enter springt zum Inspektor. Jeder Kasten und jeder Pfeil hat einen Namen, den ein Screenreader vorliest, etwa "EO-1 Payload, LML-Projekt, 1 Link ausgehend, 1 eingehend".
Tabelle
| Ansicht | Spalten |
|---|---|
| Projekte | Quellprojekt, Relation, Zielprojekt, Links, Gelöscht |
| Elementnachverfolgung | Projekt, Nummer, Name, Klasse, Schritte vom Element, Zustand |
Klicken Sie auf eine Spaltenüberschrift, um zu sortieren.
Inspektor
| Auswahl | Inhalt |
|---|---|
| Projektkasten | Name, Typ, Anzahl der Elemente, ausgehende und eingehende Links; Projekt öffnen, Nur verknüpfte Projekte anzeigen |
| Pfeil | Quell- und Zielprojekt, Links je Relation, die Linkliste (jeweils 100, Mehr anzeigen), CSV exportieren, Dieses Element nachverfolgen je Zeile |
| Element (Elementnachverfolgung) | Nummer und Name, Klasse, Projekt, Schritte vom nachverfolgten Element, Zustand; Element öffnen, Ab hier nachverfolgen |
| Projekte, die Sie nicht öffnen können | "Links zu Projekten, die Sie nicht öffnen können. Bitten Sie den Besitzer eines Projekts um Zugriff." |
API und MCP
Die REST-API und MCP geben dieselben Antworten mit den eigenen Zugriffsrechten und der Projektliste des Tokens. Projekte einer Organisation, die den API-Zugriff abgeschaltet hat, werden ausgelassen, wie Projekte, die Sie nicht öffnen können.
| Aufruf | Liefert |
|---|---|
GET /api/v1/program-map | Projekte, Releases, Pfeile (from, to, relation, links, deleted, plan) und die Anzahl der verborgenen; from, unlinked, org wie auf der Seite |
GET /api/v1/projects/<project>/items/<item>/trace | Die Elementnachverfolgung: Knoten mit Projekt, Nummer, Name, Klasse und Schritten, die Links zwischen ihnen und die Anzahl der verborgenen; steps 1–6 (Standard 3) |
MCP program_map | Dasselbe wie GET /program-map |
MCP trace_chain | Dasselbe wie der Trace-Aufruf; Elemente in Projekten mit Kennzeichnungen für regulierte Daten antworten mit withheld |
Siehe API und MCP.
Meldungen
| Nachricht | Bedeutung |
|---|---|
| Keine Links zwischen Ihren Projekten. Fügen Sie einen im Abschnitt Nachverfolgung eines Elements hinzu. | Keines Ihrer Projekte enthält oder empfängt einen Link, den Sie sehen können |
| Dieses Projekt hat keine Links zu anderen Projekten. Fügen Sie einen im Abschnitt Nachverfolgung eines Elements hinzu. | Die Übersicht wurde aus einem Projekt ohne Links geöffnet |
| Dieses Element hat keine Links zu anderen Projekten. Fügen Sie einen in seinem Abschnitt Nachverfolgung hinzu. | Das nachverfolgte Element hat keine Links |
| Einige Projekte werden noch gelesen. Aktualisieren Sie in einer Minute. | Die letzten Änderungen in großen Projekten werden noch gelesen; die Übersicht zeigt, was bereit ist |
| Die ersten 500 Elemente werden angezeigt. Verringern Sie die Schritte. | Die Elementnachverfolgung hat ihre Grenze erreicht |
| N Links aus Projekten, deren Besitzer einen Tarif ohne Links zu anderen Projekten hat, werden nicht verfolgt. | Die Elementnachverfolgung hat Links übersprungen, die unter einem Tarif ohne diese Funktion gespeichert sind |
| Die Programmkarte konnte nicht gelesen werden. Laden Sie die Seite neu. | Die Anfrage ist fehlgeschlagen |
Grenzen
| Grenze | Wert |
|---|---|
| Schritte der Elementnachverfolgung | 1 bis 6 |
| Elemente in einer Elementnachverfolgung | 500 |
| Je Seite aufgelistete Links in der Liste eines Pfeils | 100 |
| Links je Projekt | 20.000 (siehe Links zu anderen Projekten) |