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.
Na tej stronie
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
Co zawiera powiązanie
| Część | Znaczenie |
|---|---|
| Źródło | Element tego projektu |
| Relacja | Relacja ze schematu tego projektu, np. traced from, satisfies lub verified by |
| Cel | Identyfikator 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 projektu | Co widać |
|---|---|
| Dowolna rola (Właściciel, Edytor, Recenzent, Czytelnik) | Numer, nazwa, projekt i łącze, które otwiera element |
| Brak lub projekt już nie istnieje | Element 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.
Stany powiązań
| Wyświetlane | Znaczenie | Co zrobić |
|---|---|---|
| Numer i nazwa | Element istnieje i możesz otworzyć jego projekt | Nic |
| Usunięto w <projekt> | Element znajduje się w koszu swojego projektu | Poproś osobę, która może edytować ten projekt, o przywrócenie elementu lub usuń powiązanie |
| Usunięto | Element już nie istnieje | Usuń 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 istnieje | W razie potrzeby poproś właściciela projektu o dostęp |
| Wczytywanie… | Element jest odczytywany | Poczekaj 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.
Dodawanie powiązania
- Zaznacz element, np. wymaganie podsystemu.
- W inspektorze otwórz sekcję Identyfikowalność. W obszarze Inne projekty kliknij + (Dodaj powiązanie z innym projektem…).
- Wybierz Relacja, np. traced from.
- Wybierz Projekt. Jego elementy są wymienione według numeru.
- 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.
- Wpisz tekst w polu Szukaj, aby znaleźć element według numeru lub nazwy. Wybierz Klasa, aby wyświetlić tylko tę klasę.
- 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.
Usuwanie powiązań
- 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
- Utwórz projekt o nazwie EO-1 Payload z wymaganiem PL.1 Detector pixel pitch shall be at most 5.5 µm.
- Zaznacz PL.1 i otwórz Identyfikowalność → Inne projekty → +.
- Wybierz traced from, projekt CubeSat EO-1, wyszukaj ground sample i kliknij 1.2 Ground Sample Distance. Kliknij Dodaj powiązanie.
- 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
| Problem | Przyczyna | Naprawa |
|---|---|---|
| “Ten element jest w tym projekcie. Zamiast tego użyj Powiąż istniejący….” | Cel jest w tym samym projekcie | Użyj Powiąż istniejący… w grupie relacji |
| Brak + w obszarze Inne projekty | Możesz tylko wyświetlać projekt lub element jest zablokowany | Poproś 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 Team | Zmień plan w Ustawienia konta → Plan i rozliczenia |
| Selektor pokazuje “Nie można odczytać tego projektu. Wybierz inny projekt.” | Dostęp do tego projektu został utracony | Poproś 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”.
| Eksport | Co 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ć |
| XMI | Pomijane; 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
| Limit | Wartość |
|---|---|
| Powiązania na projekt | 20,000 |
| Elementy odczytywane na żądanie | 500 |
| Elementy wyświetlane w selektorze | 100 na wyszukiwanie (zawęź wyszukiwanie, aby zobaczyć pozostałe) |
Powiązanie wskazuje bieżącą wersję drugiego projektu lub kopię elementu w wydaniu biblioteki (zobacz Biblioteki).