Wymagania
Mapa programu
Zobacz, jak projekty są ze sobą powiązane, z liczbą powiązań dla każdej pary projektów, i prześledź łańcuch powiązań jednego elementu przez inne projekty.
Na tej stronie
Przegląd
Program obejmujący kilka projektów (projekt systemu, projekty podsystemów, projekt testów, biblioteki) jest spajany przez powiązania z innymi projektami. Każde powiązanie jest przechowywane w projekcie, który je tworzy, więc żaden pojedynczy projekt nie pokazuje całego obrazu. Robi to Mapa programu: rysuje jedną ramkę na każdy projekt, który możesz otworzyć, i jedną strzałkę na każdą parę projektów, opisaną relacją i liczbą powiązań.
Strona ma dwa widoki:
- Projekty: każdy projekt, który możesz otworzyć, i powiązania między nimi, jako graf lub tabela.
- Śledzenie elementu: jeden element pośrodku i powiązane z nim elementy w innych projektach, pierścień po pierścieniu, do sześciu kroków.
Mapa programu jest dostępna dla każdego zalogowanego użytkownika. Same powiązania tworzy się w planie Team; powiązania przechowywane w projekcie, którego właściciel ma plan bez nich, są rysowane na szaro. Powiązania między projektami demonstracyjnymi Hybrid Car i Hybrid Car Battery Pack działają w każdym planie.
Pojęcia
Co pokazuje mapa
| Element | Znaczenie |
|---|---|
| Ramka | Projekt, który możesz otworzyć: jego nazwa, typ projektu i liczba elementów; jego nazwa dostępna dodaje powiązania, które przechowuje i otrzymuje |
| Strzałka | Powiązania przechowywane w projekcie przy początku strzałki, które wskazują elementy w projekcie przy grocie |
| Etykieta strzałki | relacja · powiązania · usunięte, np. traced from · 12 · 1 deleted |
| Projekty, których nie można otworzyć (N powiązań) | Jedna przerywana ramka, która liczy wszystkie powiązania z projektami, których nie możesz otworzyć |
| Ramka wydania biblioteki | Wydanie biblioteki, które możesz odczytać, powiązane z Twoich projektów |
Strzałki zwykle wskazują w górę: projekty podsystemów przechowują powiązania traced from i satisfies z projektem systemu, a projekty testów przechowują powiązania verifies. Mapa umieszcza projekty, które przechowują powiązania, poniżej projektów, które one wskazują.
Kto co widzi
Mapa jest tworzona tylko z projektów, które możesz otworzyć: projektów, w których jesteś członkiem z dowolną rolą, które nie są w koszu i których regułę logowania dwuetapowego organizacji spełniasz.
- Powiązanie z projektem, którego nie możesz otworzyć, jest liczone w ramce Projekty, których nie można otworzyć (N powiązań). Ta ramka nigdy nie podaje nazwy projektu ani elementu i wygląda tak samo niezależnie od tego, czy projekt istnieje, jest w koszu, czy nigdy nie istniał.
- Powiązania przechowywane w projekcie, którego nie możesz otworzyć, nie są nigdzie liczone, nawet gdy wskazują Twoje projekty.
- Rola administratora organizacji niczego nie dodaje: mapa używa członkostwa w projektach.
- Eksporty (CSV, SVG, PNG) zawierają dokładnie to, co pokazuje strona.
Kolory
| Kolor | Znaczenie |
|---|---|
| Niebieska strzałka | Powiązania między projektami, które możesz otworzyć |
| Bursztynowa strzałka | Część celów została usunięta (w koszu lub już nie istnieje) |
| Szara strzałka | Powiązania z projektami, których nie możesz otworzyć, z wydaniem biblioteki lub przechowywane w projekcie, którego właściciel ma plan bez powiązań z innymi projektami |
Jak z niego korzystać
Jak powiązane są Twoje projekty
- Kliknij Zarządzaj projektami, a następnie Mapa programu. Otwiera się widok Projekty z każdym projektem, który przechowuje lub otrzymuje powiązania.
- Odczytaj strzałki. Wskaż ramkę, aby przyciemnić wszystko, co nie jest z nią połączone.
- Kliknij strzałkę. Inspektor wymienia jej powiązania, po 100 naraz: element, który przechowuje każde powiązanie, relację i element docelowy. Kliknij dowolny element, aby otworzyć go w jego projekcie, lub Pokaż więcej, aby zobaczyć następne 100.
- Kliknij Eksportuj CSV w inspektorze, aby zapisać powiązania tej strzałki, lub Eksportuj ▾ na pasku, aby zapisać całą mapę jako CSV, SVG lub PNG.
Rozpoczęcie od jednego projektu
- Otwórz projekt, a następnie Weryfikacja → Pokrycie programu, i kliknij Otwórz Mapę programu.
- Mapa pokazuje tylko ten projekt i projekty z nim powiązane, bezpośrednio lub przez inne.
- Kliknij Pokaż wszystkie projekty, aby zobaczyć wszystko, co możesz otworzyć.
Możesz też kliknąć ramkę i wybrać Pokaż tylko powiązane projekty.
Śledzenie jednego elementu przez program
- Zaznacz element. W sekcji Identyfikowalność inspektora otwórz Inne projekty ⋯ i wybierz Pokaż na Mapie programu. Na liście powiązań strzałki kliknij zamiast tego Śledź ten element.
- Widok Śledzenie elementu pokazuje element pośrodku i powiązane z nim elementy w pierścieniach: pierwszy pierścień o jeden krok dalej, drugi o dwa kroki. Powiązania są śledzone w obu kierunkach.
- Wybierz Kroki (od 1 do 6, domyślnie 3), aby sięgnąć dalej lub pozostać bliżej.
- Elementy są kolorowane według projektu, z przerywaną ramką wokół elementów każdego projektu. Odznacz Grupuj według projektu, aby usunąć ramki.
- Kliknij element, aby użyć poleceń Otwórz element i Śledź od tego miejsca, które umieszcza go pośrodku.
Przykład: demonstracja CubeSat EO-1 i projekt ładunku użytecznego
- Utwórz demonstrację CubeSat EO-1, a następnie drugi projekt EO-1 Payload z wymaganiem PL.1 Imager resolution.
- W projekcie EO-1 Payload zaznacz PL.1. W sekcji Identyfikowalność → Inne projekty kliknij +, wybierz traced from, projekt CubeSat i jego wymaganie dotyczące obrazowania, a następnie kliknij Dodaj powiązanie.
- Utwórz trzeci projekt EO-1 Test Campaign z przypadkiem testowym TC.4 Resolution test i powiąż go relacją verifies z PL.1 w projekcie EO-1 Payload.
- Otwórz Zarządzaj projektami → Mapa programu. Mapa pokazuje EO-1 Test Campaign na dole, EO-1 Payload nad nim i projekt CubeSat na górze, ze strzałkami verifies · 1 i traced from · 1.
- Kliknij PL.1 → Identyfikowalność ⋯ → Pokaż na Mapie programu: przypadek testowy i wymaganie CubeSat znajdują się o jeden krok dalej, po obu stronach.
Przykład: Hybrid Car i jego pakiet akumulatorów
- Na stronie Zarządzaj projektami kliknij Pliki projektów ▾ → Nowy projekt demonstracyjny → Hybrid Car (SysML v2).
- Następnie utwórz Pliki projektów ▾ → Nowy projekt demonstracyjny → Hybrid Car Battery Pack (SysML v2). Wymagania pakietu od dostawcy akumulatorów, PackCapacity, PackMass i ChargeAcceptance, są powiązane relacją traced from z wymaganiami samochodu VR-3, VR-6 i VR-5 w najnowszej demonstracji Hybrid Car, niezależnie od tego, którą z dwóch utworzysz jako pierwszą; ponowne utworzenie demonstracji Hybrid Car przenosi powiązania do nowej. Te powiązania demonstracyjne działają w każdym planie. Bez projektu Hybrid Car demonstracja pakietu nie ma powiązań.
- Otwórz Zarządzaj projektami → Mapa programu. Mapa pokazuje dwa projekty SysML v2 ze strzałką traced from · 3.
Wskazówki i dobre praktyki
- Uzgodnij relacje używane przez podprojekty (traced from lub satisfies dla wymagań, verifies dla testów), aby strzałki czytały się wszędzie tak samo.
- Wyłącz Grupuj relacje, aby zobaczyć jedną strzałkę na relację, np. aby odróżnić powiązania wymagań od powiązań testów między tymi samymi dwoma projektami.
- Przeciągaj ramki, aby rozmieścić mapę. Położenia są przechowywane w tej przeglądarce dla każdego zakresu.
- Użyj widoku Tabela, aby posortować pary projektów według liczby powiązań lub usuniętych celów.
- Bursztynowa strzałka oznacza powiązania wymagające naprawy: otwórz jej listę powiązań, a następnie napraw lub usuń powiązania w sekcji Identyfikowalność → Inne projekty elementu.
Typowe błędy
| Problem | Przyczyna | Naprawa |
|---|---|---|
| Brakuje projektu | Nie jesteś jego członkiem, jest w koszu lub nie ma powiązań | Poproś właściciela o dostęp; zaznacz Pokaż niepowiązane projekty, aby wyświetlić projekty bez powiązań |
| Wszystko trafia do Projekty, których nie można otworzyć | Powiązania wskazują projekty, których nie jesteś członkiem | Poproś właściciela projektu o dostęp |
| Szare strzałki pośrodku mapy | Właściciel projektu przechowującego powiązania nie ma planu Team | Właściciel zmienia plan w Ustawienia konta → Plan i rozliczenia |
| Nowe powiązanie jeszcze się nie pokazuje | Mapa nadal odczytuje ostatnie zmiany | Po minucie kliknij Odśwież |
Powiązania z innymi funkcjami
- Powiązania z innymi projektami: mapa je odczytuje; niczego nie dodaje ani nie zmienia. Powiązania tworzy się w sekcji Identyfikowalność → Inne projekty elementu (zobacz Powiązania z innymi projektami).
- Pokrycie programu: widok powiązań z jednym projektem według elementów, z lukami (zobacz Pokrycie programu). Otwórz Mapę programu otwiera tam mapę od tego projektu.
- Biblioteki: powiązania z elementem wydania biblioteki pojawiają się jako strzałki do ramki wydania (zobacz Biblioteki).
- Diagram Spider: śledzenie wewnątrz projektu, z przerywanymi ramkami dla powiązanych elementów w innych miejscach. Śledzenie elementu używa tego samego układu pierścieni.
- API i MCP: ta sama mapa i to samo śledzenie dla narzędzi (zobacz API i MCP).
Strona Mapa programu
Pasek
| Element sterujący | Co robi |
|---|---|
| Projekty / Śledzenie elementu | Przełącza widok |
| Zakres | Wszystkie moje projekty, jedna organizacja (gdy należysz do organizacji) lub jeden folder z podfolderami (gdy masz foldery; zobacz Foldery projektów) |
| Pokaż wszystkie projekty | Pokazywane po otwarciu mapy z projektu; opuszcza zbiór projektów powiązanych z tym projektem |
| Pokaż niepowiązane projekty | Pokazuje też projekty bez powiązań |
| Grupuj relacje | Jedna strzałka na parę projektów (etykiety wymieniają każdą relację) lub jedna strzałka na relację |
| Kroki | Śledzenie elementu: od 1 do 6 kroków |
| Grupuj według projektu | Śledzenie elementu: przerywane ramki wokół elementów każdego projektu |
| Graf / Tabela | Diagram lub tabela z sortowaniem; na wąskim ekranie najpierw otwiera się tabela |
| Odśwież | Ponownie odczytuje powiązania |
| Eksportuj ▾ | Eksportuj CSV, Eksportuj SVG, Eksportuj PNG |
Graf
- Kliknij ramkę, aby pokazać jej projekt w inspektorze: Otwórz projekt i Pokaż tylko powiązane projekty. Kliknij dwukrotnie ramkę lub naciśnij na niej Shift+Enter, aby otworzyć projekt.
- Kliknij strzałkę, aby wyświetlić jej powiązania w inspektorze.
- Przeciągaj ramki, aby je przesuwać; przewiń lub zsuń palce, aby powiększyć; przeciągnij tło, aby przesunąć widok.
- Naciśnij Tab, aby przejść do mapy, a następnie klawisze strzałek, aby poruszać się między ramkami i strzałkami; Enter przechodzi do inspektora. Każda ramka i strzałka ma nazwę odczytywaną przez czytnik ekranu, np. “EO-1 Payload, LML project, 1 link out, 1 in”.
Tabela
| Widok | Kolumny |
|---|---|
| Projekty | Projekt źródłowy, Relacja, Projekt docelowy, Powiązania, Usunięte |
| Śledzenie elementu | Projekt, Numer, Nazwa, Klasa, Kroki od elementu, Stan |
Kliknij nagłówek kolumny, aby sortować.
Inspektor
| Zaznaczenie | Zawartość |
|---|---|
| Pole projektu | Nazwa, typ, liczba elementów, powiązania wychodzące i przychodzące; Otwórz projekt, Pokaż tylko powiązane projekty |
| Strzałka | Projekt źródłowy i docelowy, powiązania według relacji, lista powiązań (po 100 naraz, Pokaż więcej), Eksportuj CSV, Śledź ten element w każdym wierszu |
| Element (Śledzenie elementu) | Numer i nazwa, klasa, projekt, kroki od śledzonego elementu, stan; Otwórz element, Śledź od tego miejsca |
| Projekty, których nie można otworzyć | “Powiązania z projektami, których nie można otworzyć. Poproś właściciela projektu o dostęp.” |
API i MCP
REST API i MCP dają te same odpowiedzi z uprawnieniami tokenu i jego listą projektów. Projekty organizacji, która wyłączyła dostęp przez API, są pomijane, podobnie jak projekty, których nie możesz otworzyć.
| Wywołanie | Zwraca |
|---|---|
GET /api/v1/program-map | Projekty, wydania, strzałki (from, to, relation, links, deleted, plan) i liczbę ukrytych; from, unlinked, org jak na stronie |
GET /api/v1/projects/<project>/items/<item>/trace | Śledzenie elementu: węzły z projektem, numerem, nazwą, klasą i krokami, powiązania między nimi i liczbę ukrytych; steps 1–6 (domyślnie 3) |
MCP program_map | To samo co GET /program-map |
MCP trace_chain | To samo co wywołanie trace; elementy w projektach z oznaczeniami danych regulowanych zwracają withheld |
Zobacz API i MCP.
Komunikaty
| Wiadomość | Znaczenie |
|---|---|
| Brak powiązań między projektami. Dodaj je z sekcji Śledzenie elementu. | Żaden z Twoich projektów nie przechowuje ani nie otrzymuje powiązania, które możesz zobaczyć |
| Ten projekt nie ma powiązań z innymi projektami. Dodaj je z sekcji Śledzenie elementu. | Mapę otwarto z projektu bez powiązań |
| Ten element nie ma powiązań z innymi projektami. Dodaj je z jego sekcji Śledzenie. | Śledzony element nie ma powiązań |
| Niektóre projekty są wciąż odczytywane. Odśwież za minutę. | Ostatnie zmiany w dużych projektach są wciąż odczytywane; mapa pokazuje to, co jest gotowe |
| Pokazano pierwsze 500 elementów. Zmniejsz liczbę kroków. | Śledzenie elementu osiągnęło swój limit |
| N powiązań z projektów, których plan właściciela nie obejmuje powiązań z innymi projektami, nie jest uwzględnianych. | Śledzenie elementu pominęło powiązania przechowywane w planie, który ich nie obejmuje |
| Nie udało się odczytać mapy programu. Odśwież stronę. | Żądanie nie powiodło się |
Limity
| Limit | Wartość |
|---|---|
| Kroki śledzenia elementu | 1 do 6 |
| Elementy w śledzeniu elementu | 500 |
| Powiązania wymieniane na stronę listy strzałki | 100 |
| Powiązania na projekt | 20 000 (zobacz Powiązania z innymi projektami) |