Holarch

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.

Jak z niego korzystać →

Na tej stronie
  1. Przegląd
  2. Pojęcia
    1. Co pokazuje mapa
    2. Kto co widzi
    3. Kolory
  3. Jak z niego korzystać
    1. Jak powiązane są Twoje projekty
    2. Rozpoczęcie od jednego projektu
    3. Śledzenie jednego elementu przez program
    4. Przykład: demonstracja CubeSat EO-1 i projekt ładunku użytecznego
    5. Przykład: Hybrid Car i jego pakiet akumulatorów
    6. Wskazówki i dobre praktyki
    7. Typowe błędy
    8. Powiązania z innymi funkcjami
  4. Strona Mapa programu
    1. Pasek
    2. Graf
    3. Tabela
    4. Inspektor
  5. API i MCP
  6. Komunikaty
  7. Limity
  8. Powiązane

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

ElementZnaczenie
RamkaProjekt, 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łkaPowiązania przechowywane w projekcie przy początku strzałki, które wskazują elementy w projekcie przy grocie
Etykieta strzałkirelacja · 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 bibliotekiWydanie 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

KolorZnaczenie
Niebieska strzałkaPowiązania między projektami, które możesz otworzyć
Bursztynowa strzałkaCzęść celów została usunięta (w koszu lub już nie istnieje)
Szara strzałkaPowią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ć

  1. Kliknij Zarządzaj projektami, a następnie Mapa programu. Otwiera się widok Projekty z każdym projektem, który przechowuje lub otrzymuje powiązania.
  2. Odczytaj strzałki. Wskaż ramkę, aby przyciemnić wszystko, co nie jest z nią połączone.
  3. 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.
  4. 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

  1. Otwórz projekt, a następnie Weryfikacja → Pokrycie programu, i kliknij Otwórz Mapę programu.
  2. Mapa pokazuje tylko ten projekt i projekty z nim powiązane, bezpośrednio lub przez inne.
  3. 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

  1. 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.
  2. 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.
  3. Wybierz Kroki (od 1 do 6, domyślnie 3), aby sięgnąć dalej lub pozostać bliżej.
  4. Elementy są kolorowane według projektu, z przerywaną ramką wokół elementów każdego projektu. Odznacz Grupuj według projektu, aby usunąć ramki.
  5. 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

  1. Utwórz demonstrację CubeSat EO-1, a następnie drugi projekt EO-1 Payload z wymaganiem PL.1 Imager resolution.
  2. 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.
  3. 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.
  4. 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.
  5. 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

  1. Na stronie Zarządzaj projektami kliknij Pliki projektów ▾ → Nowy projekt demonstracyjny → Hybrid Car (SysML v2).
  2. 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ń.
  3. 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

ProblemPrzyczynaNaprawa
Brakuje projektuNie 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łonkiemPoproś właściciela projektu o dostęp
Szare strzałki pośrodku mapyWłaściciel projektu przechowującego powiązania nie ma planu TeamWłaściciel zmienia plan w Ustawienia konta → Plan i rozliczenia
Nowe powiązanie jeszcze się nie pokazujeMapa nadal odczytuje ostatnie zmianyPo 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ącyCo robi
Projekty / Śledzenie elementuPrzełącza widok
ZakresWszystkie moje projekty, jedna organizacja (gdy należysz do organizacji) lub jeden folder z podfolderami (gdy masz foldery; zobacz Foldery projektów)
Pokaż wszystkie projektyPokazywane po otwarciu mapy z projektu; opuszcza zbiór projektów powiązanych z tym projektem
Pokaż niepowiązane projektyPokazuje też projekty bez powiązań
Grupuj relacjeJedna 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 / TabelaDiagram 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

WidokKolumny
ProjektyProjekt źródłowy, Relacja, Projekt docelowy, Powiązania, Usunięte
Śledzenie elementuProjekt, Numer, Nazwa, Klasa, Kroki od elementu, Stan

Kliknij nagłówek kolumny, aby sortować.

Inspektor

ZaznaczenieZawartość
Pole projektuNazwa, typ, liczba elementów, powiązania wychodzące i przychodzące; Otwórz projekt, Pokaż tylko powiązane projekty
StrzałkaProjekt ź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łanieZwraca
GET /api/v1/program-mapProjekty, 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_mapTo samo co GET /program-map
MCP trace_chainTo 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

LimitWartość
Kroki śledzenia elementu1 do 6
Elementy w śledzeniu elementu500
Powiązania wymieniane na stronę listy strzałki100
Powiązania na projekt20 000 (zobacz Powiązania z innymi projektami)