Holarch

Wymagania

Powiązania z innymi projektami

Śledź element do wymagania, funkcji lub testu w innym projekcie; każda osoba widzi powiązany element tylko wtedy, gdy może otworzyć jego projekt.

Jak z niego korzystać →

Na tej stronie
  1. Przegląd
  2. Pojęcia
    1. Co zawiera powiązanie
    2. Kto co widzi
    3. Stany powiązań
    4. Zmienione cele
  3. Jak z niego korzystać
    1. Kiedy i dlaczego
    2. Dodawanie powiązania
    3. Otwieranie powiązanego elementu
    4. Usuwanie powiązań
    5. Przykład: podsystem ładunku użytecznego i demonstracja CubeSat EO-1
    6. Wskazówki i dobre praktyki
    7. Typowe błędy
    8. Powiązania z innymi funkcjami
  4. Eksporty i raporty
  5. API i MCP
  6. Komunikaty
  7. Limity
  8. Powiązane

Przegląd

Powiązanie z innym projektem to relacja śledzenia od elementu w tym projekcie do elementu w innym projekcie, np. wymaganie podsystemu śledzone (traced from) od wymagania w specyfikacji systemu albo procedura testowa, która weryfikuje (verifies) wymaganie prowadzone przez inny zespół.

Powiązanie jest częścią tego projektu. Przechowuje tylko identyfikatory dwóch elementów i relację. Numer, nazwa, klasa i status powiązanego elementu są odczytywane z jego własnego projektu przy każdym wyświetleniu, z Twoimi uprawnieniami:

  • Gdy możesz otworzyć drugi projekt, widzisz element i możesz do niego przejść.
  • Gdy nie możesz, widzisz Element w projekcie, którego nie można otworzyć. Nazwa nigdy do Ciebie nie trafia – ani w aplikacji, ani w eksportach, ani przez API, ani przez narzędzia AI.

Powiązania z innymi projektami są częścią planu Team. Decyduje plan właściciela projektu. W innych planach istniejące powiązania pozostają widoczne i można je usunąć, ale nie można dodawać nowych. Powiązania między projektami demonstracyjnymi Hybrid Car i Hybrid Car Battery Pack działają w każdym planie.

Pojęcia

CzęśćZnaczenie
ŹródłoElement tego projektu
RelacjaRelacja ze schematu tego projektu, np. traced from, satisfies lub verified by
CelIdentyfikator projektu i identyfikator elementu w nim

Relacja jest sprawdzana względem klasy źródła. Klasa celu nie jest sprawdzana przy tworzeniu powiązania, ponieważ powiązanie nigdy nie odczytuje treści drugiego projektu. Gdy klasa celu nie pasuje do relacji, sekcja Identyfikowalność pokazuje ⚠ z komunikatem “Ta relacja zwykle nie wskazuje …”.

Kto co widzi

Każda osoba widzi każdy powiązany element z rolą, jaką ma w jego projekcie:

Twój dostęp do drugiego projektuCo widać
Dowolna rola (Właściciel, Edytor, Recenzent, Czytelnik)Numer, nazwa, projekt i łącze, które otwiera element
Brak lub projekt już nie istniejeElement w projekcie, którego nie można otworzyć

Projekt, który nie istnieje, i projekt, którego nie możesz otworzyć, wyglądają tak samo, więc powiązanie nigdy nie zdradza, że projekt istnieje.

WyświetlaneZnaczenieCo zrobić
Numer i nazwaElement istnieje i możesz otworzyć jego projektNic
Usunięto w <projekt>Element znajduje się w koszu swojego projektuPoproś osobę, która może edytować ten projekt, o przywrócenie elementu lub usuń powiązanie
UsuniętoElement już nie istniejeUsuń powiązanie (Usuń przerwane powiązania)
Element w projekcie, którego nie można otworzyćNie masz dostępu do projektu lub projekt już nie istniejeW razie potrzeby poproś właściciela projektu o dostęp
Wczytywanie…Element jest odczytywanyPoczekaj chwilę

Nazwy są odczytywane, gdy strona pokazuje powiązanie, ponownie po powrocie na kartę po minucie oraz co pięć minut. Element o zmienionej nazwie pokazuje nową nazwę bez żadnej zmiany w tym projekcie.

Zmienione cele

Wiersz pokazuje Zmieniono, gdy powiązany element został edytowany w swoim projekcie po utworzeniu lub ostatnim przeglądzie powiązania. Wskaż go, aby zobaczyć datę. Sprawdź, czy powiązanie nadal obowiązuje, a następnie:

  • Kliknij ✓ w wierszu, aby oznaczyć to powiązanie jako przejrzane.
  • Kliknij ⋯ obok Inne projekty, a następnie Oznacz wszystkie jako przejrzane (n), aby oznaczyć wszystkie oflagowane powiązania elementu.
  • Możesz też otworzyć Potrzeby i wymagania → Powiązania do przeglądu: karta Zmienione w innych projektach wymienia wszystkie oflagowane powiązania projektu, z ✓ w każdym wierszu i przyciskiem Oznacz wszystkie jako przejrzane.

Oznaczenie jako przejrzane jest widoczne w historii elementu oraz w Aktywności, a jedno polecenie Cofnij je wycofuje. Recenzenci i czytelnicy widzą flagi, ale nie mogą ich wyczyścić. Powiązania z wydaniami bibliotek nie są oznaczane (wydanie się nie zmienia).

Jak z niego korzystać

Kiedy i dlaczego

Używaj powiązań z innymi projektami, gdy jeden model byłby za duży lub należy do różnych zespołów: specyfikacja systemu i specyfikacje podsystemów, wspólne wymagania linii produktów i każdy produkt albo wymagania klienta i Twój projekt. Powiązania przechowuj w projekcie niższego poziomu, skierowane w górę: każdy podsystem śledzi swoje wymagania od wymagań systemowych.

W obrębie jednego projektu używaj zwykłych relacji. Powiąż istniejący… w sekcji Identyfikowalność wiąże elementy tego samego projektu; powiązanie z innym projektem służy do elementów, które znajdują się gdzie indziej.

  1. Zaznacz element, np. wymaganie podsystemu.
  2. W inspektorze otwórz sekcję Identyfikowalność. W obszarze Inne projekty kliknij + (Dodaj powiązanie z innym projektem…).
  3. Wybierz Relacja, np. traced from.
  4. Wybierz Projekt. Jego elementy są wymienione według numeru.
  5. Dla biblioteki wybierz Wersja: Bieżąca (kopia robocza) lub wydanie, np. Wydanie 1.1. Powiązanie z wydaniem pokazuje jego etykietę zamiast bieżąca, a jego nazwa nie otwiera strony.
  6. Wpisz tekst w polu Szukaj, aby znaleźć element według numeru lub nazwy. Wybierz Klasa, aby wyświetlić tylko tę klasę.
  7. Kliknij element, a następnie Dodaj powiązanie. Powiadomienie brzmi “Dodano powiązanie.”, a element pojawia się w obszarze Inne projekty.

Jedno polecenie Cofnij usuwa powiązanie. Ponowne dodanie tego samego powiązania zachowuje istniejące.

Otwieranie powiązanego elementu

Kliknij nazwę powiązanego elementu. Jego projekt otwiera się na tym elemencie.

  • Kliknij × w wierszu powiązania, aby usunąć jedno powiązanie.
  • Gdy powiązania wskazują usunięte elementy, kliknij ⋯ obok Inne projekty, a następnie Usuń przerwane powiązania (n).

Usunięcie powiązania zmienia tylko ten projekt. Powiązanie nigdy nie zmienia drugiego projektu.

Przykład: podsystem ładunku użytecznego i demonstracja CubeSat EO-1

  1. Utwórz projekt o nazwie EO-1 Payload z wymaganiem PL.1 Detector pixel pitch shall be at most 5.5 µm.
  2. Zaznacz PL.1 i otwórz Identyfikowalność → Inne projekty → +.
  3. Wybierz traced from, projekt CubeSat EO-1, wyszukaj ground sample i kliknij 1.2 Ground Sample Distance. Kliknij Dodaj powiązanie.
  4. Wiersz brzmi traced from 1.2 Ground Sample Distance CubeSat EO-1 · bieżąca. Współpracownik, który może otworzyć tylko EO-1 Payload, widzi w tym samym wierszu Element w projekcie, którego nie można otworzyć.

Wskazówki i dobre praktyki

  • Wiąż od niższego poziomu do wyższego, aby projekt systemu nie musiał się zmieniać po dodaniu podsystemu.
  • Udostępnij projekt wyższego poziomu z rolą Czytelnik osobom pracującym nad projektem niższego poziomu, aby widziały nazwy.
  • Po reorganizacji projektu wyższego poziomu uruchom Usuń przerwane powiązania.

Typowe błędy

ProblemPrzyczynaNaprawa
“Ten element jest w tym projekcie. Zamiast tego użyj Powiąż istniejący….”Cel jest w tym samym projekcieUżyj Powiąż istniejący… w grupie relacji
Brak + w obszarze Inne projektyMożesz tylko wyświetlać projekt lub element jest zablokowanyPoproś o rolę Edytor lub odblokuj element
“Powiązania z elementami w innych projektach są dostępne w planie Team.”Właściciel projektu nie ma planu TeamZmień plan w Ustawienia konta → Plan i rozliczenia
Selektor pokazuje “Nie można odczytać tego projektu. Wybierz inny projekt.”Dostęp do tego projektu został utraconyPoproś jego właściciela o dostęp

Powiązania z innymi funkcjami

  • Macierz identyfikowalności: powiązania z wierszy przez wybrane relacje są wymienione pod siatką w obszarze Inne projekty; Eksportuj… je dodaje (zobacz Identyfikowalność).
  • Diagram Spider: powiązane elementy pojawiają się jako przerywane ramki wokół swojego elementu; można je wyłączyć opcją Opcje → Inne projekty.
  • Mapa programu: Zarządzaj projektami → Mapa programu pokazuje, jak łączą się wszystkie Twoje projekty, a Inne projekty ⋯ → Pokaż na Mapie programu śledzi ten element przez inne projekty (zobacz Mapa programu).
  • Pokrycie programu: projekt, z którym się wiążesz, wymienia te powiązania w Weryfikacja → Pokrycie programu, według elementu i projektu (zobacz Pokrycie programu).
  • Historia i Aktywność: dodanie i usunięcie powiązania jest rejestrowane przy elemencie.
  • Kosz: usunięcie elementu przenosi jego powiązania razem z nim do kosza; przywrócenie elementu je przywraca.
  • Wnioski o zmianę: Dodaj zmianę ▾ → Dodaj powiązanie z innym projektem… i Usuń powiązanie z innym projektem… przygotowują powiązania; są one dodawane lub usuwane po zastosowaniu wniosku.
  • Biblioteki: powiąż z elementem wydania biblioteki, używając wyboru Wersja (zobacz Biblioteki).

Eksporty i raporty

Eksporty nazywają powiązane elementy z uprawnieniami osoby, która eksportuje. Wszystko, czego ta osoba nie może odczytać, jest zapisywane jako “Element w innym projekcie”.

EksportCo dzieje się z powiązaniami z innymi projektami
JSON projektu (eksport z Bazy danych)Zachowywane w zapisanej postaci: tylko identyfikatory. Import pliku je zachowuje
ReqIF (Baza danych i Dokumenty)Atrybut External links przy każdym powiązanym elemencie: relacja, identyfikator projektu i identyfikator elementu oraz numer i nazwa, jeśli możesz je odczytać
XMIPomijane; raport eksportu liczy je jako “Powiązanie z innym projektem”
Macierz identyfikowalności (Excel)Osobny arkusz Other projects
Macierz identyfikowalności (CSV)Kolumna Other projects
Raport macierzy identyfikowalności wymagań (RTM)Kolumna Other Projects

API i MCP

API i MCP zwracają powiązania jako identyfikatory. Aby odczytać nazwy, wywołaj operację resolve; używa ona uprawnień tokenu i jego listy projektów. Mapa programu i Śledzenie elementu są dostępne jako GET /api/v1/program-map, GET /api/v1/projects/<project>/items/<item>/trace oraz narzędzia MCP program_map i trace_chain. Zobacz API i MCP.

Funkcje AI w aplikacji otrzymują powiązania tylko jako identyfikatory.

Komunikaty

WiadomośćZnaczenie
Dodano powiązanie.Powiązanie zostało zapisane
Ten element jest w tym projekcie. Zamiast tego użyj Powiąż istniejący….Wybrany element jest w tym samym projekcie
Wybierz element, a następnie dodaj powiązanie.Kliknięto Dodaj powiązanie bez wybrania elementu
Brak innych projektów do powiązania. Najpierw utwórz lub otwórz inny projekt.Masz tylko ten projekt
Powiązania z elementami w innych projektach są dostępne w planie Team.Właściciel projektu nie ma planu Team
Projekt może zawierać co najwyżej 20 000 powiązań z innymi projektami. Najpierw usuń część z nich.Projekt osiągnął limit

Limity

LimitWartość
Powiązania na projekt20,000
Elementy odczytywane na żądanie500
Elementy wyświetlane w selektorze100 na wyszukiwanie (zawęź wyszukiwanie, aby zobaczyć pozostałe)

Powiązanie wskazuje bieżącą wersję drugiego projektu lub kopię elementu w wydaniu biblioteki (zobacz Biblioteki).