Holarch

Wymagania

Wymagania

Pisz, sprawdzaj, zatwierdzaj, umieszczaj w liniach bazowych i importuj wymagania oraz śledź otwarte pozycje TBD/TBR i powiązania do przeglądu.

Jak z niego korzystać →

Na tej stronie
  1. Przegląd
  2. Pojęcia
    1. Requirement i Statement
    2. Atrybuty wymagań
    3. Etykiety wymagań
    4. Przepływ pracy wymagań
    5. Otwarte kwestie: TBD, TBR i TBS
    6. Linie bazowe
  3. Jak z niego korzystać
    1. Kiedy i dlaczego
    2. Pisanie wymagania
    3. Sprawdzanie sformułowań
    4. Pisanie według szablonów EARS
    5. Zatwierdzanie wymagań
    6. Zamrażanie dokumentu na potrzeby przeglądu
    7. Obsługa zmiany po linii bazowej
    8. Zamykanie kwestii TBD i TBR
    9. Import istniejącej specyfikacji
    10. Przykład: demo CubeSat EO-1
    11. Wskazówki i dobre praktyki
    12. Typowe błędy
    13. Powiązania z innymi funkcjami
  4. Strona Wymagania
  5. Jakość wymagań
    1. Układ strony
    2. Filtrowanie strony Jakość
    3. Kryteria i kontrole
    4. Dwa wymagania w jednym (R19)
    5. Wymagania w innych językach
    6. Ręczne nadpisania
    7. Nieaktualne wyniki
    8. Sprawdzanie jakości z dokumentu
    9. Kontrola wymagań przez AI
    10. Eksporty jakości
  6. Zatwierdzenia
    1. Pole zatwierdzenia
  7. Rejestr TBD/TBR
  8. Powiązania do przeglądu
    1. Co oznacza powiązanie do przeglądu
    2. Gdzie są pokazywane powiązania do przeglądu
    3. Strona Powiązania do przeglądu
  9. Linie bazowe i porównywanie wersji
    1. Linie bazowe dokumentów
    2. Porównywanie wersji
    3. Strona Linie bazowe i wersje
  10. Import wymagań
    1. Krok 1: Plik
    2. Krok 2: Mapowanie
    3. Krok 3: Przegląd
    4. Jak jest odczytywany każdy format
    5. Aktualizacja wymagań z arkusza kalkulacyjnego
    6. Komunikaty importu
  11. Skróty dla wymagań
  12. Ustawienia
  13. Komunikaty
  14. Limity
  15. Powiązane

Przegląd

Strony wymagań służą do pisania, sprawdzania, zatwierdzania wymagań i obejmowania ich liniami bazowymi oraz do śledzenia tego, co jest jeszcze otwarte. Wymaganie to encja klasy LML Requirement: zdolność, cecha lub czynnik jakości, który system musi mieć.

Wymagania zwykle znajdują się w dokumencie wymagań (zobacz Dokumenty). Każde z nich jest nadal encją w modelu. Dlatego to samo wymaganie pojawia się w Bazie danych, na diagramach, w Macierzy identyfikowalności i w RVTM.

Grupa Potrzeby i wymagania na pasku nawigacji zawiera wszystkie strony wymagań:

StronaCo pokazuje
DokumentySpecyfikacje i ich konspekty. Tutaj pisze się wymagania.
WymaganiaKażde wymaganie w jednej tabeli (Baza danych przefiltrowana do class:Requirement).
JakośćJakość wymagań: ocena według dziewięciu kryteriów dla każdego wymagania.
TBD/TBRRejestr otwartych wartości, które trzeba jeszcze ustalić lub przejrzeć.
Powiązania do przegląduPowiązania, których wymaganie nadrzędne w łańcuchu zmieniło się po ostatnim przeglądzie powiązania.
ZatwierdzeniaWymagania, których Status to In Review.
Import i eksportImport z plików Word, Excel, CSV, ReqIF, tekstowych, XMI i plików projektu przez jedną strefę upuszczania oraz eksporty modelu.

Linie bazowe to zamrożone migawki na potrzeby przeglądów. Twórz je z dokumentu lub z Kontrola i przeglądy → Linie bazowe i wersje. Powiązania z funkcjami, zasobami i testami opisuje Identyfikowalność.

Pojęcia

Requirement i Statement

Statement to klasa nadrzędna klasy Requirement.

  • Używaj Statement dla tekstu, który nie jest wiążący: nagłówków sekcji, założeń, kontekstu.
  • Używaj Requirement dla każdego wiążącego stwierdzenia ze słowem “shall”.

Tylko obiekty Requirement są oceniane przez kontrolę jakości, wymieniane w rejestrze TBD/TBR, oznaczane do przeglądu po zmianie i liczone w RVTM. Obiekty Statement są pomijane.

Wymaganie ma wspólne pola encji Numer, Nazwa i Opis. Opis to samo stwierdzenie wymagania, jako tekst sformatowany. Pozostałe informacje dodają poniższe atrybuty.

Atrybuty wymagań

AtrybutTyp i wartościZnaczenie
UzasadnienieDługi tekstPowód, dla którego istnieje wymaganie.
StatusDraft, In Review, Approved, RejectedMiejsce wymagania w przepływie pracy zatwierdzania.
PriorityHigh, Medium, LowJak ważne jest wymaganie dla interesariuszy.
CriticalityHigh, Medium, LowSkutek dla misji lub bezpieczeństwa, jeśli wymaganie nie zostanie spełnione.
WłaścicielTekstOsoba lub zespół odpowiedzialny za wymaganie.
ŹródłoTekstInteresariusz, dokument lub norma, z której pochodzi wymaganie.
Verification MethodWielokrotny wybór: Analysis, Demonstration, Inspection, TestSposób weryfikacji wymagania.
Verification LevelComponent, Subsystem, SystemPoziom montażu, na którym wymaganie jest weryfikowane.
Success CriteriaDługi tekstMierzalny wynik, który pokazuje, że wymaganie jest spełnione.
TBD/TBRNone, TBD, TBRTBD = wartość trzeba jeszcze ustalić; TBR = wartość trzeba przejrzeć. Po zamknięciu ustaw z powrotem na None.
TBD OwnerTekstOsoba odpowiedzialna za zamknięcie TBD/TBR.
TBD Due DateData i godzinaData, do której TBD/TBR musi zostać zamknięte. Termin w grupie Przepływ pracy pokazuje i ustawia tę samą datę (zobacz Rejestr TBD/TBR).
Quality ScoreProcent, obliczanyWynik ostatniego uruchomienia Sprawdź jakość.
Appropriate, Complete, Conforming, Correct, Feasible, Necessary, Singular, Unambiguous, Verifiable (Właściwe, Kompletne, Zgodne, Poprawne, Wykonalne, Konieczne, Pojedyncze, Jednoznaczne, Weryfikowalne)Tak/Nie, obliczane lub ustawiane ręcznieDziewięć kryteriów jakości.

Inspektor grupuje pola wymagania (zobacz Inspektor): Requirement (Number, Name, Description, Labels, Rationale, Source, Success Criteria), Przepływ pracy (pasek przeglądu ze Status, Priority, Criticality, Owner, osobą przypisaną, terminem, TBD/TBR, TBD Owner, TBD Due Date), Weryfikacja (Verification Method i Level, Weryfikowane przez oraz pola zamknięcia przy Programie formalnym), Wartości (Budget Quantity, Threshold, Objective i bieżąca Value, Units), Zgodność (Program formalny) i Jakość.

Wynik i dziewięć kryteriów znajdują się w grupie Jakość, początkowo zwiniętej. Jej nagłówek brzmi np. “89% · 8 z 9 spełnionych” lub “jeszcze niesprawdzone”. Holarch pamięta dla każdej klasy, czy grupa została otwarta.

Projekty mogą dodawać własne atrybuty wymagań i wybory; zobacz Rozszerzenia schematu.

Etykiety wymagań

Etykiety klasyfikują wymagania bez zmiany ich klasy. Wbudowane etykiety wymagań to:

  • Functional Requirement, Performance Requirement, Interface Requirement.
  • Environmental Requirement, Reliability Requirement, Safety Requirement.
  • Verification Requirement.
  • Stakeholder Need: potrzeba zgłoszona przez interesariusza, zanim zostanie przekształcona w wymagania systemowe.

Verification Method jest też grupą etykiet z etykietami Analysis, Demonstration, Inspection i Test. Etykieta i atrybut pozostają zsynchronizowane w tym samym kroku cofania:

  • Dodanie etykiety Test ustawia Verification Method na Test.
  • Wybranie Test w atrybucie dodaje etykietę.

Starsze projekty i importy, które zawierają tylko etykiety, są scalane do atrybutu przy otwarciu projektu.

Przepływ pracy wymagań

Każde wymaganie przechodzi przez cztery statusy:

  1. Draft: w trakcie pisania.
  2. In Review: czeka na decyzję. Wymienione na stronie Zatwierdzenia.
  3. Approved lub Rejected: rozstrzygnięte. Każda decyzja zapisuje, kto ją podjął, kiedy, oraz opcjonalny powód.

Po zatwierdzeniu trzy mechanizmy dbają o rzetelność zapisu:

  • Ponowny przegląd po edycji. Edycja nazwy lub opisu wymagania Approved przenosi je z powrotem do In Review z notatką “Tekst zmieniony po zatwierdzeniu”.
  • Nieaktualna jakość. Edycja nazwy lub opisu oznacza wyniki jakości jako nieaktualne i czyści ręczne nadpisania jakości.
  • Powiązania do przeglądu. Edycja nazwy, opisu lub kluczowego atrybutu oznacza do przeglądu powiązania z elementami, które od niego zależą.

Wszystkie trzy są częścią edycji, więc jedno polecenie Cofnij (⌘Z / Ctrl+Z) cofa je razem.

Otwarte kwestie: TBD, TBR i TBS

Otwarta kwestia to wartość, która nie jest jeszcze ustalona. Wymaganie jest otwartą kwestią, gdy spełniony jest którykolwiek warunek:

  • Jego atrybut TBD/TBR ma wartość TBD lub TBR.
  • Jego nazwa lub opis zawiera słowo TBD, TBR lub TBS.

Otwarte kwestie pojawiają się w rejestrze TBD/TBR, dopóki nie zostaną zamknięte.

Linie bazowe

Linia bazowa to migawka tylko do odczytu. Są dwa rodzaje:

  • Linia bazowa dokumentu obejmuje jeden dokument. Zawiera artefakt dokumentu, jego elementy i ich atrybuty, relacje, które ich dotyczą, encje odległe o jeden krok oraz ustawienia konspektu dokumentu.
  • Linia bazowa projektu obejmuje każdą encję i relację w projekcie.

Linie bazowe mogą zawierać zapisy zatwierdzeń (imię i nazwisko, rola, oświadczenie, data). Po zapisaniu zapisy są zablokowane.

Jak z niego korzystać

Kiedy i dlaczego

Praca nad wymaganiami obejmuje lewą stronę modelu V inżynierii systemów:

  1. Zbierz potrzeby interesariuszy.
  2. Wyprowadź wymagania systemowe.
  3. Sprawdź, czy każde stwierdzenie jest dobrze sformułowane.
  4. Uzyskaj zatwierdzenie wymagań.
  5. Zamroź je na przeglądzie (SRR, PDR, CDR).

Po linii bazowej praca przechodzi w kontrolę zmian. Każda zmiana jest ponownie przeglądana, a jej wpływ na dalsze elementy sprawdzany. Otwarte wartości TBD/TBR są zamykane przed zatwierdzeniem projektu technicznego.

Strony wymagań odpowiadają na te pytania:

PytanieStrona
Czy każde wymaganie jest dobrze napisane?Jakość
Które wartości są nadal nieznane, kto za nie odpowiada i czy są opóźnione?TBD/TBR
Co trzeba ponownie sprawdzić, bo zmieniło się wymaganie?Powiązania do przeglądu
Co czeka na decyzję?Zatwierdzenia
Co się zmieniło od przeglądu?Wersja ▾ → Porównaj wersje… w dokumencie, Linie bazowe i wersje
Czy każde wymaganie jest alokowane i zweryfikowane?Macierz identyfikowalności i RVTM

Strony Jakość, Powiązania do przeglądu, TBD/TBR i Zatwierdzenia znajdują się obok siebie w grupie Potrzeby i wymagania na pasku nawigacji. Stamtąd przejdź kolejno przez wszystkie cztery kontrole.

Pisanie wymagania

  1. Otwórz Potrzeby i wymagania → Dokumenty.
  2. Otwórz dokument wymagań.

    Aby rozpocząć nowy, kliknij + Nowy dokument (zobacz Dokumenty).

  3. Na pasku Szybkie dodawanie pod dokumentem wybierz, gdzie trafi element, np. Pod 3 Electrical Power.
  4. Wpisz stwierdzenie wymagania i naciśnij Enter.

    Holarch dodaje element domyślnej klasy dokumentu (Requirement w dokumencie wymagań). Otrzymuje numer po elementach równorzędnych.

  5. Przy zaznaczonym wymaganiu otwórz inspektor po prawej stronie.
  6. Wypełnij Uzasadnienie, Źródło i Kryteria sukcesu w grupie Requirement, Priorytet, Criticality i Właściciel w grupie Przepływ pracy oraz Verification Method i Poziom weryfikacji w grupie Weryfikacja.
  7. Dodaj etykietę typu przez + Etykieta w grupie Requirement inspektora, np. Performance Requirement. (Kolumna Etykiety jest w Widok ▾ → Kolumny ▸).

Wymaganie ma Status Draft i pojawia się w Potrzeby i wymagania → Wymagania.

Jeśli wartość nie jest jeszcze znana:

  1. Wpisz w stwierdzeniu najlepsze oszacowanie.
  2. Ustaw TBD/TBR na TBD.
  3. Wypełnij TBD Owner i ustaw datę w polu Termin w grupie Przepływ pracy.

    Wymaganie pojawia się teraz także w rejestrze TBD/TBR z tym terminem.

Sprawdzanie sformułowań

  1. Otwórz Potrzeby i wymagania → Jakość.

    W dokumencie wybierz zamiast tego Sprawdź ▾ → Sprawdź jakość.

  2. Na pasku zakresu wybierz Wszystkie wymagania lub Dokument: <name>.
  3. Kliknij Sprawdź jakość w nagłówku strony.

    Komunikat brzmi “Sprawdzono 32 wymagania” (lub Twoja liczba). Każde wymaganie otrzymuje wynik od 0 do 100% oraz ✔ lub ✘ dla każdego kryterium.

    Przy ponad 2000 wymagań kontrola działa w tle: karta postępu pokazuje “Sprawdzanie wymagań”, liczbę i pozostały czas, a pracę można kontynuować. Kliknij Anuluj na karcie, aby przerwać; nic się nie zmienia. Następnie karta pokazuje “Zapisywanie wyników jakości” z liczbą zapisanych; podczas zapisywania inne edycje są odrzucane komunikatem “Zapisywanie wyników jakości. Spróbuj ponownie po zakończeniu.” Zapisywane są tylko wymagania, których wyniki się zmieniły, więc ponowne sprawdzenie bez zmian niczego nie zapisuje. Cała kontrola to jeden krok: jedno ⌘Z / Ctrl+Z ją usuwa.

  4. Odczytaj kafelki: Wymagania, Średni wynik, Dobre (≥ 67%), Wymaga poprawek (< 67%) oraz, jeśli takie istnieją, Nieaktualne (tekst się zmienił).
  5. Dla każdego wymagania poniżej 67% przeczytaj kolumnę Sugestie.

    Możesz też wskazać ✘, aby zobaczyć komunikaty dla tego kryterium.

  6. Kliknij nazwę wymagania, aby je otworzyć, i popraw tekst.
  7. Uruchom kontrolę ponownie.

Correct i Feasible zawsze wymagają oceny człowieka. Kontrola nigdy nie oznacza ich jako spełnionych, niezależnie od wyników pozostałych kontroli. Dlatego kontrola automatyczna osiąga najwyżej 7 z 9 kryteriów (78%). Wymaganie bez weryfikującego testu lub wymagania osiąga 6 z 9 (67%). Rozstrzygnij je samodzielnie dla każdego wymagania:

  • Po przejrzeniu wymagania kliknij ✘, aby oznaczyć kryterium jako Tak.
  • Aby uzyskać pierwszą opinię, użyj ✦ AI ▾ → Sprawdź z AI (wymagania: N)… (Kontrola wymagań przez AI).

Uwaga: wyniki zapisane przez wcześniejsze wersje mogły liczyć Correct lub Feasible jako spełnione, gdy inna kontrola się nie powiodła. Uruchom kontrolę ponownie, aby je zaktualizować.

Pisanie według szablonów EARS

EARS (Easy Approach to Requirements Syntax) zapisuje każde wymaganie jako jedno zdanie: opcjonalny warunek, a potem “the [system] shall [response]”. Pierwsze słowo warunku wyznacza wzorzec.

WzorzecSzablonPrzykład
UbiquitousThe [system] shall [response].The pump controller shall record every start command with its time.
Event-drivenWhen [trigger], the [system] shall [response].When the tank level falls below 20 %, the pump controller shall start the backup pump.
State-drivenWhile [state], the [system] shall [response].While the vehicle is charging, the battery manager shall keep each cell below 45 °C.
Unwanted behaviorIf [unwanted condition], then the [system] shall [response].If the supply voltage drops below 10 V, then the flight computer shall switch to the reserve battery.
Optional featureWhere [feature is included], the [system] shall [response].Where a heated windshield is fitted, the climate controller shall clear frost within 5 minutes.
ComplexWhile [state], when [trigger], the [system] shall [response].While the drill is in standby, when the operator presses Start, the drill controller shall reach full speed within 3 s.
  1. Otwórz wymaganie w inspektorze lub Widoku elementu.
  2. Kliknij EARS ▾ obok pola Opis.

    Pierwszy wiersz pokazuje wzorzec stwierdzenia (✓ Event-driven) lub to, co trzeba poprawić (Brak wzorca EARS: 1 do poprawienia).

  3. Wybierz wzorzec.

    Jego szablon staje się opisem. Jeśli wymaganie ma już opis, potwierdź przez Zastąp; poprzednie stwierdzenie pozostaje w historii elementu. Jedno ⌘Z / Ctrl+Z cofa tę zmianę.

  4. Zastąp słowa w nawiasach kwadratowych.

Aby sprawdzić każde wymaganie, ustaw Requirement.11 na Ostrzeżenie lub Błąd w Kontrole modelu → Ustawienia. Domyślnie jest wyłączona.

W projekcie SysML v2 EARS ▾ znajduje się pod polem Dokumentacja wymagania w inspektorze i zapisuje jego komentarz doc.

Zatwierdzanie wymagań

  1. Gdy wymaganie jest gotowe, ustaw jego Status na In Review.

    Zrób to w inspektorze (Status na pasku przeglądu w grupie Przepływ pracy), w Bazie danych lub w kolumnie dokumentu.

  2. Recenzent otwiera Potrzeby i wymagania → Zatwierdzenia.

    Strona wymienia każde wymaganie, którego Status to In Review.

  3. Kliknij wiersz.

    Grupa Przepływ pracy inspektora pokazuje pasek przeglądu: Status, kto go ustawił i kiedy (“przez: J. Rivera · 9 mar 2026, 9:58”) oraz przyciski.

  4. Kliknij Zatwierdź.

    Albo kliknij Odrzuć… i wpisz opcjonalny powód.

    Komunikat brzmi “Zatwierdzono” lub “Odrzucono”. Decyzja zostaje zapisana z Twoim imieniem i nazwiskiem oraz czasem, a wymaganie znika z listy Zatwierdzenia.

    Gdy wymaganie jest objęte linią bazową, a śledzą je elementy weryfikacji lub dokumenty, Zatwierdź najpierw otwiera okno, które wymienia je w sekcji Wymaga ponownego przeglądu (Wpływ). Kliknij wiersz, aby go obejrzeć, a następnie kliknij Zatwierdź, aby potwierdzić.

Aby odesłać rozstrzygnięte wymaganie do ponownego przeglądu, kliknij Otwórz ponownie. Komunikat brzmi “Przeniesiono do: In Review”.

Jeśli projekt ma przepływ pracy dla Status wymagań (Schemat → Przepływ pracy), pasek przeglądu pokazuje przejścia tego przepływu pracy zamiast Zatwierdź, Odrzuć… i Otwórz ponownie. Przejście wymagające zatwierdzenia kończy się na … i otwiera Poproś o zatwierdzenie: zobacz Prośba o zatwierdzenie zmiany stanu. Dla wymagania objętego linią bazową Poproś o zatwierdzenie i okno Zatwierdź… wniosku o zmianę pokazują tę samą listę Wymaga ponownego przeglądu.

Zamrażanie dokumentu na potrzeby przeglądu

  1. W tabliczce tytułowej dokumentu kliknij Wersja ▾.
  2. Wybierz Zapisz linię bazową….

    Albo wybierz Dostarcz ▾ → Wersja ▸ Zapisz linię bazową….

  3. Zachowaj lub zmień Nazwa. Domyślna to “<document> Baseline <n>”.
  4. W sekcji Zatwierdzenia wypełnij jeden wiersz dla każdego zatwierdzającego: Nazwa, Rola i Oświadczenie (domyślnie “Zatwierdzono do wydania.”).

    + Dodaj zatwierdzającego dodaje wiersz; × usuwa wiersz.

  5. Kliknij Utwórz.

    Komunikat brzmi “Zapisano linię bazową”. Wersja ▾ pokazuje “Bieżący · ostatnia linia bazowa <name>”.

Od tej pory każdy wiersz otrzymuje pasek zmian, gdy różni się od najnowszej linii bazowej.

Obsługa zmiany po linii bazowej

  1. Edytuj tekst wymagania w dokumencie.

    Komunikat podsumowuje, co się stało, np. “1 zatwierdzone wymaganie przeniesiono do In Review; 6 powiązań oznaczono do przeglądu.” W ramach Twojej edycji (jedno polecenie Cofnij wycofuje całość):

    • Wymaganie Approved przechodzi do In Review.
    • Jego wyniki jakości stają się nieaktualne (“Jakość: nieaktualna — uruchom ponownie”).
    • Jego powiązania z dalszymi elementami zostają oznaczone do przeglądu.
  2. Otwórz Potrzeby i wymagania → Powiązania do przeglądu.
  3. W każdym wierszu kliknij Różnice, aby zobaczyć zmianę tekstu, i przejrzyj powiązany element.
  4. Gdy powiązany element nadal obowiązuje, kliknij Oznacz jako przejrzane… w jego wierszu.

    Aby oznaczyć kilka naraz, zaznacz ich wiersze i kliknij Oznacz zaznaczone jako przejrzane….

  5. Opisz, co sprawdzono, i kliknij Oznacz jako przejrzane.
  6. Ponownie uruchom Sprawdź jakość.
  7. Przeprowadź wymaganie ponownie przez zatwierdzanie.
  8. Kliknij Wersja ▾ → Porównaj wersje…, wybierz linię bazową w polu Od i Bieżąca wersja w polu Do.

    Raport wymienia każdą zmianę od linii bazowej.

  9. Kliknij Zmiany (Excel) dla rady ds. zmian.

Zamykanie kwestii TBD i TBR

  1. Otwórz Potrzeby i wymagania → TBD/TBR.
  2. Odczytaj kafelki: Otwarte TBD/TBR, Po terminie, Brak właściciela oraz liczbę dla każdego dokumentu.
  3. Najpierw zajmij się wierszami po terminie. Są podbarwione i mają “Po terminie” pod terminem.
  4. Gdy właściciel pokazuje “—”, przypisz TBD Owner.
  5. Gdy wartość zostanie ustalona, zmień tekst wymagania na wartość ostateczną.
  6. Kliknij Zamknij w wierszu.

    Zamknięcie ustawia TBD/TBR na None, a wiersz znika z rejestru.

Aby wysłać rejestr do właścicieli, kliknij Eksportuj XLSX.

Import istniejącej specyfikacji

  1. Otwórz Potrzeby i wymagania → Import i eksport.
  2. Upuść plik na strefę upuszczania albo kliknij ją, aby wybrać plik: Word (.docx), Excel lub CSV, ReqIF albo zwykły tekst.

    Wiersz stanu brzmi np. “Przeanalizowano “SRS.docx”: 48 wierszy, 5 kolumn.” Format pokazuje wykryty format.

  3. Kliknij Dalej.
  4. Sprawdź, na co jest mapowana każda kolumna, i ustaw Klasa dla wierszy bez klasy na Requirement.
  5. Kliknij Dalej.
  6. Pozostaw zaznaczone Utwórz dokument wymagań z tych N wymagań, sprawdź typ i nazwę dokumentu oraz nowe i zaktualizowane elementy i ostrzeżenia.
  7. Kliknij Importuj N elementów.

    Bez ostrzeżeń Holarch otwiera nowy dokument. Z ostrzeżeniami wymienia je karta Import zakończony.

Karta Import zakończony ma przyciski otwierające dokument, Bazę danych, Diagram Spider lub drzewa albo Sprawdź jakość. Jedno ⌘Z / Ctrl+Z usuwa cały import.

Przykład: demo CubeSat EO-1

Utwórz projekt demonstracyjny CubeSat EO-1 — Earth Observation Demo z Zarządzaj projektami. Ma on specyfikację z 32 wymaganiami, SRS-001 EO-1 System Requirements Specification, z linią bazową SRR i zmianami wprowadzonymi po niej.

Jakość.

  1. Otwórz Potrzeby i wymagania → Jakość i kliknij Sprawdź jakość.

    Kafelki pokazują 32 wymagania, średnią 92%, 29 dobrych i 3 wymagające poprawek.

Trzy słabe wymagania celowo są tak napisane. Każde uzyskuje 44%:

  • 2.5 Safe Mode Recovery: “The spacecraft should recover from safe mode quickly and resume imaging as appropriate”. Sugestie obejmują:
    • “R34 - Terminy dotyczące wydajności, których nie można zmierzyć: [quickly]”
    • “R8 - Klauzule wyjątków osłabiają wymaganie: [as appropriate]”
    • “R19 - Łączy dwa wymagania; podziel je na osobne wymagania: [and]”
    • “Zakończ stwierdzenie kropką.”
    • “Powiąż weryfikujący je Test Case lub Requirement.”
  • 3.5 Battery Thermal Control: “…keep the battery warm enough (TBD).” Sugestie to “R21 - Zawiera nawiasy; przenieś tekst w nawiasach do Rationale.” i “Zastąp symbole zastępcze TBD/TBR.”
  • 6.4 Operator Interface: “…shall be user friendly and/or easy to use.” Sugestie to “R34 - Terminy dotyczące wydajności, których nie można zmierzyć: [user friendly, easy to use]” i “R19 - “and/or” jest niejednoznaczne; podaj, czy chodzi o oba, czy o jedno: [and/or]”.

Aby poprawić 2.5:

  1. Przepisz je jako “The spacecraft shall resume imaging within 6 hours of a safe mode entry.”
  2. Powiąż przypadek testowy relacją verified by.
  3. Uruchom kontrolę ponownie.

    Komunikaty o spójnikach łączących, klauzulach wyjątków i niejasnych terminach znikają.

TBD/TBR. Otwórz TBD/TBR. Pokazuje trzy otwarte kwestie:

  • 3.5 Battery Thermal Control: TBD, za które odpowiada Thermal Engineer. Jest po terminie.
  • 2.4 Target Slew (ADCS Lead) i 5.3 Downlink Link Margin (Comms Lead): TBR z późniejszym terminem.

Zmiana po linii bazowej. Wersja ▾ dokumentu wymienia SRR Baseline. Zatwierdzili ją J. Rivera (Systems Lead), R. Okafor (Mission Principal Investigator) i L. Brandt (Program Manager).

Po SRR wymaganie 3.1 Orbit Average Power zmieniło się z 28 W na 30 W. Ponieważ 3.1 miało status Approved, wróciło do In Review z notatką “Tekst zmieniony po zatwierdzeniu”.

Powiązania do przeglądu wymienia sześć powiązań od 3.1:

  • 1.3.1 Solar Arrays
  • F3 Generate and Store Power i F3.1 Convert Sunlight to Power
  • EQ-1.1 Solar Power Generation i EQ-1.4 Power Margin Check
  • TC-06 Solar Array Power Test

Kliknij Różnice w dowolnym wierszu: “28 W” jest przekreślone, a “30 W” wstawione. Następnie przejrzyj elementy:

  • TC-06 oczekuje mocy szczytowej ≥ 72 W i zmierzył 75,1 W. Przez EQ-1.3 Orbit-Average Array Power (szczyt × 0,62 udziału oświetlenia × 0,6 sprawności toru zasilania) 75,1 W daje 27,9 W średnio na orbicie, poniżej nowych 30 W. Pozostaw to powiązanie nieprzejrzane i dodaj komentarz “75.1 W peak = 27.9 W orbit average; re-test against about 80.6 W peak”. Test wymaga nowego oczekiwanego wyniku i nowego przebiegu.
  • Przed oznaczeniem 1.3.1 jako przejrzanego sprawdź, czy dobór rozmiaru paneli słonecznych nadal się bilansuje.

Porównaj z bieżącym. Wybierz SRR Baseline w Wersja ▾, a następnie kliknij Porównaj z bieżącym na jej banerze. Raport wymienia:

  • Zmiany pól Description, Rationale, Status i Quality Score wymagania 3.1.
  • Zmianę statusu 2.4 Target Slew (Draft → In Review).
  • Nowe wymaganie 4.4 Downlink Encryption z jego dwoma nowymi powiązaniami satisfies.

Zatwierdzenia. Otwórz Zatwierdzenia. Dziewięć wymagań ma status In Review, w tym 3.1, 1.5 Daily Collection Volume i 5.3 Downlink Link Margin.

Wskazówki i dobre praktyki

  • Pisz jedno “shall” na wymaganie, w stronie czynnej, z liczbą, jednostką i warunkiem. Kontrola jakości nagradza dokładnie to.
  • Umieszczaj uzasadnienie w polu Uzasadnienie, a nie w stwierdzeniu. Wyrażenia celu (“so that”, “in order to”) i nawiasy są oznaczane jako R20 i R21.
  • Wypełniaj Verification Method podczas pisania. Wymaganie z metodą, ale bez przypadku testowego, jest wtedy pokazywane w RVTM jako tylko zaplanowane, a nie jako niezweryfikowane.
  • Ustawiaj TBD/TBR z właścicielem i terminem, zamiast tylko wpisywać “TBD” w tekście. Atrybut daje rejestrowi właściciela i termin do śledzenia.
  • Twórz linię bazową przed każdym przeglądem. Paski zmian i Porównaj z bieżącym działają tylko względem linii bazowej.
  • Oznaczaj powiązania jako przejrzane z komentarzem. Komentarz zostaje dodany do powiązanego elementu i zapisany przy powiązaniu, więc przegląd pozostawia ślad audytowy.

Typowe błędy

ObjawPrzyczynaNaprawa
Wymaganie nie jest oceniane, nie ma go w rejestrze lub nie ma go w RVTM.Jest to Statement, a nie Requirement.Zmień jego klasę na Requirement w inspektorze.
Correct i Feasible pokazują ✘ przy każdym wymaganiu.Wymagają oceny człowieka (“Wymaga oceny recenzenta”).Przejrzyj każde z nich i kliknij ✘, aby oznaczyć je jako Tak, albo uruchom Kontrolę wymagań przez AI.
Wynik pokazuje “Nieaktualne — uruchom ponownie”.Tekst zmienił się po ostatniej kontroli.Kliknij Sprawdź jakość albo włącz Sprawdzaj ponownie automatycznie po zmianie tekstu.
Ręczne nadpisania Tak/Nie zniknęły.Edycja tekstu je czyści.Ustaw je ponownie po przeglądzie; Cofnij je przywraca, a w Historii pozostają.
Wymaganie zostało w stanie Approved po poprawieniu literówki.Każda edycja nazwy lub opisu ponownie otwiera zatwierdzone wymaganie.Zatwierdź je ponownie. Poprawiaj literówki przed zatwierdzeniem.
W wierszu TBD/TBR brakuje “Zamknij”.Otwarta kwestia wynika tylko z tekstu.Edytuj tekst, aby usunąć TBD, TBR lub TBS.
Import utworzył kopie zamiast aktualizacji.Dopasuj istniejące encje według nie znalazło dopasowania.Wyeksportuj z kolumną ID, edytuj i zaimportuj z Dopasuj istniejące encje według: Globalny ID (zobacz Aktualizacja wymagań z arkusza kalkulacyjnego).

Powiązania z innymi funkcjami

  • Źródła danych: dane wejściowe interesariuszy i istniejące specyfikacje przez Import oraz dokumenty napisane w Dokumentach.
  • Przekazuje dane do:
  • AI: menu ✦ AI ▾ dokumentu i Widoku elementu zawiera Przeredaguj jasno…, Dodaj mierzalne kryteria…, Uprość…, Podziel wymaganie złożone…, Napisz uzasadnienie…, Zaproponuj nazwę… oraz Sprawdź z AI (Kontrola wymagań przez AI). Zmiany AI są pokazywane w podglądzie przed zastosowaniem. Zobacz Zapytaj AI i narzędzia AI.

Strona Wymagania

Strona Wymagania pozwala zobaczyć i edytować wszystkie wymagania w jednej tabeli. Potrzeby i wymagania → Wymagania to Baza danych przefiltrowana do class:Requirement.

Działa tu każda funkcja Bazy danych:

  • Sortuj i filtruj kolumny oraz edytuj komórki w miejscu.
  • Zaznacz wiersze dla paska operacji zbiorczych, aby ustawić atrybuty lub etykiety wielu wymagań naraz.
  • Eksportuj i otwieraj Macierz identyfikowalności dla zaznaczonych wierszy.

Kliknij wiersz, aby pokazać wymaganie w inspektorze. Kliknij go dwukrotnie, aby otworzyć jego Widok elementu. Wymaganie z powiązaniem do przeglądu ma w wierszu plakietkę ⚠ Przegląd. Kliknij wiersz prawym przyciskiem myszy, aby otworzyć jego menu: do trzech sugerowanych działań z uzasadnieniem (np. ✦ Dodaj mierzalne kryteria…, gdy wymaganie nie spełnia kryterium Unambiguous, ✦ Generuj przypadek testowy…, gdy nie jest zweryfikowane), ✦ Więcej AI ▸, następnie Otwórz, Zmień nazwę…, Duplikuj, Dodaj element podrzędny…, Status ▸, Priorytet ▸, Powiąż z ▸, Dodaj do dokumentu ▸, Pokaż na diagramie ▸, Kopiuj łącze, Kopiuj numer i Usuń… (zobacz Menu kontekstowe).

Tabelę, zapytania i edycję zbiorczą opisuje Model i baza danych.

Przydatne zapytania:

ZapytaniePokazuje
class:RequirementKażde wymaganie.
Requirement:"Status=In Review"Lista Zatwierdzenia.
Requirement:"Status=Draft"Wymagania jeszcze niewysłane do przeglądu.
class:Requirement AND is:leafWymagania liście (bez wymagań podrzędnych).
class:Requirement AND NOT relationship:"verified by"Wymagania bez elementu weryfikującego.

Jakość wymagań

Strona Jakość (tytuł “Jakość wymagań”) pozwala znaleźć źle sformułowane wymagania. Ocenia każde wymaganie według dziewięciu kryteriów.

Dziewięć kryteriów i numery reguł w sugestiach (R2, R19 itd.) odpowiadają cechom i regułom z Guide to Writing Requirements INCOSE. Listy słów i wzorce Holarch przybliżają te reguły; nie są tekstem przewodnika, a niektóre reguły wymagają oceny recenzenta.

  • Wynik = 100 × (spełnione kryteria) / 9, zaokrąglony. Kryterium, które nie zostało sprawdzone (–, zobacz Wymagania w innych językach), jest pomijane: 100 × spełnione / 8.
  • 67% lub więcej to Dobre. Poniżej 67% to Wymaga poprawek.
  • Pasek jest czerwony poniżej 34%, żółty od 34% do 66% i zielony od 67%.

Układ strony

  • Nagłówek strony:
    • Więcej ▾: Wyczyść oceny ręczne resetuje każdą ręczną ocenę Tak/Nie pokazanych wymagań i ponownie uruchamia kontrolę. Otwórz w Wymaganiach otwiera pokazane wymagania w tabeli Wymagania. Otwórz dokument pojawia się, gdy zakresem jest dokument.
    • Eksportuj ▾: Excel (.xlsx) i CSV z pokazanymi wymaganiami.
    • Sprawdź jakość: sprawdza każde wymaganie w zakresie, niezależnie od tego, co pokazują filtry (reguła duplikatów porównuje każde wymaganie z pozostałymi w zakresie).
  • ✦ AI ▾ (na górnym pasku): Sprawdź z AI (wymagania: N)…, czyli Kontrola wymagań przez AI dla pokazanych wymagań.
  • Pasek zakresu: Zakres (Wszystkie wymagania lub Dokument: <name>) i pole wyboru Sprawdzaj ponownie automatycznie po zmianie tekstu. Powiązania do przeglądu, TBD/TBR i Zatwierdzenia są obok Jakość na pasku nawigacji.
  • Pasek zapytania: + Filtr, żetony filtrów i tekst wyszukiwania, Wyczyść, ? (składnia wyszukiwania) i Widoki ▾: ten sam pasek co na stronie Wymagania (zobacz Filtrowanie strony Jakość).
  • Kafelki: Wymagania (“12 z 40” pod Pokazane wymagania, gdy filtry część ukrywają), Średni wynik, Dobre (≥ 67%), Wymaga poprawek (< 67%) oraz Nieaktualne (tekst się zmienił), gdy któreś są nieaktualne. Nieaktualne wyniki są pomijane w średniej.
  • Uwaga pod kafelkami: “Kontrole automatyczne obejmują najwyżej 7 z 9 atrybutów (78%); Poprawne i Wykonalne wymagają weryfikacji przez człowieka — kliknij ✘, aby oznaczyć Tak. Każde kliknięcie przełącza kolejno: Tak ręcznie, Nie ręcznie i z powrotem automatycznie.”
  • Tabela: Numer, Nazwa (z opisem pod spodem), Wynik jakości, jedna kolumna na kryterium oraz Sugestie. Sugestie wymieniają każdy komunikat poprzedzony jego kryterium. Wiersze są posortowane według numeru. Kliknij wiersz prawym przyciskiem myszy lub naciśnij na nim Shift+F10, aby otworzyć menu wiersza Bazy danych: sugerowane działania z uzasadnieniem (najpierw przeredagowanie, które naprawia niespełnione kryterium), ✦ Więcej AI ▸, Otwórz, Zmień nazwę…, Duplikuj, Dodaj element podrzędny…, Status ▸, Priorytet ▸, Powiąż z ▸, Dodaj do dokumentu ▸, Pokaż na diagramie ▸, Kopiuj łącze, Kopiuj numer i Usuń…. Wiersz staje się zaznaczeniem.
  • Kilka wierszy: kliknięcie z ⌘ / Ctrl (Ctrl+kliknięcie w systemach Windows i Linux) przełącza wiersz, kliknięcie z ⇧ / Shift zaznacza zakres od ostatnio klikniętego wiersza, kliknięcie z ⌘ / Ctrl+⇧ / Shift dodaje ten zakres, a ⌘A / Ctrl+A lub ⇧ / Shift+↑ / ⇧ / Shift+↓ na wierszu z fokusem zaznacza wszystkie wiersze lub rozszerza zaznaczenie. Pasek narzędzi pokazuje liczbę; Esc ją czyści. Kliknij zaznaczony wiersz prawym przyciskiem myszy, aby działać na wszystkich: ✦ Sprawdź z AI (wymagania: n)…, ✦ Przeredaguj (n) ▸, ✦ Generuj przypadki testowe (n)…, ✦ Zapytaj AI o te elementy (n)…, ✦ Zaproponuj ślady (n)… (każde z jednym podglądem; zobacz AI dla kilku zaznaczonych elementów), Duplikuj encje (n), Ustaw status ▸, Ustaw priorytet ▸, Dodaj do dokumentu ▸ i Usuń elementy (n)…; jedno polecenie Cofnij wycofuje każde z nich. Rejestr TBD/TBR i Powiązania do przeglądu działają tak samo; w Powiązaniach do przeglądu zaznaczenie zaznacza też wiersze dla Oznacz zaznaczone jako przejrzane….

Przypadki szczególne:

  • Wiersz bez wyniku pokazuje “Nieuruchomione” w kolumnie wyniku.
  • Nieaktualny wiersz pokazuje “Nieaktualne — uruchom ponownie”.
  • Gdy zakres nie ma wymagań, strona pokazuje “Brak wymagań” i “Oceniane są tylko encje klasy Requirement; obiekty Statement są pomijane.”
  • Gdy filtry lub tekst wyszukiwania ukrywają wszystkie wymagania, strona pokazuje “Brak pasujących wymagań” i “Żadne wymaganie nie pasuje do wyszukiwania lub filtrów. Wyczyść je, aby zobaczyć wszystkie wymagania.”

Filtrowanie strony Jakość

Pasek zapytania działa jak na stronie Wymagania (zobacz Jak wpisane filtry stają się żetonami): wpisane terminy filtrów stają się żetonami po naciśnięciu Enter, reszta tekstu dopasowuje nazwę, numer i opis, Backspace w pustym polu wyszukiwania usuwa ostatni żeton, a Wyczyść usuwa wszystkie. Kafelki, tabela, Eksportuj ▾ i ✦ AI ▾ → Sprawdź z AI podążają za filtrami.

+ Filtr wymienia, z liczbami dla zakresu:

GrupaFiltryTermin
JakośćDobre (≥ 67%), Wymaga poprawek (< 67%), Nieuruchomione, Nieaktualne (tekst się zmienił), Oceny ręczne, Ustalenie AIquality:good, quality:rework, quality:notrun, quality:stale, quality:manual, quality:ai
Nie spełnia kryteriumJeden na kryterium: ocenione na Niequality:Verifiable=no (=yes: ocenione na Tak)
Ustalenie regułyReguły znalezione w zakresie, np. R7 Imprecise wording lub R30 Closely resembles (możliwe duplikaty)quality:R7
Struktura, Klasa, Atrybuty wymagania, Etykieta, Relacja, DiagramJak na stronie Wymagania; atrybuty wymagania są wymienione bez żetonu klasyis:tbd, Requirement:"Status=Draft", label:"…"

Filtry jednej grupy łączą się przez lub; różne grupy łączą się przez i. Zakresy wyników używają atrybutu: Requirement:"Quality Score>=50". Terminy quality: działają też na stronie Wymagania i w Bazie danych.

Widoki ▾ stosuje widok wbudowany (Wymaga poprawek, Jeszcze niesprawdzone, Nieaktualne wyniki, Niejednoznaczne, Nieweryfikowalne, Możliwe duplikaty, Oceny ręczne) lub jeden z zapisanych widoków. Zapisz widok… zapisuje bieżące filtry i tekst wyszukiwania w tej przeglądarce dla każdego projektu; Usuń “<name>” pojawia się, gdy używany jest zapisany widok. Wszystkie wymagania czyści filtry. Adres quality?q=<query> otwiera stronę przefiltrowaną.

Filtrowanie odczytuje zapisane wyniki i nie sprawdza ponownie. Przy 50 000 wymagań zmiana filtru lub wyszukiwania trwa znacznie poniżej jednej dziesiątej sekundy.

Kryteria i kontrole

Każde kryterium pokazuje jeden z trzech znaków:

  • ✔ (Tak): brak komunikatów.
  • ✘ (Nie): co najmniej jeden komunikat.
  • –: niesprawdzone.

Kontrole dopasowują całe słowa i wyrażenia, bez rozróżniania wielkości liter. Liczą się tylko wymienione formy: “effective” i “effectively” są wymienione, “effectiveness” nie. Liczą się też słowa w cudzysłowie. Poniższe komunikaty to dokładny pokazywany tekst. Lista w nawiasach kwadratowych na końcu komunikatu podaje znalezione słowa.

Jednoznaczne

RegułaWiadomośćWyzwalane przez
R6R6 - Nierozpoznane jednostki; użyj standardowych jednostek SI, amerykańskich lub imperialnych: [...]Liczba, po której następuje słowo niebędące znaną jednostką (np. “12 sorties”). Znane jednostki obejmują jednostki SI, amerykańskie i imperialne oraz ich skróty, %, stopnie, °C i °F.
R2R2 - Użyj strony czynnej: [...]“shall/must/will/should be”, po którym następuje imiesłów bierny (“shall be measured”).
R5R5 - Użyj określeń jednoznacznych (“the”) zamiast: [...]“a” lub “an”.
R7R7 - Nieprecyzyjne sformułowanie: [...]some, many, several, few, little, much, various, appropriate(ly), adequate(ly), efficient(ly), effective(ly), sufficient(ly), reasonable, reasonably, suitable, suitably, significant(ly), minimal(ly), maximal(ly), approximately, almost, nearly, generally, usually, typically, normally, robust(ly), flexible, flexibly, easy, easily, etc, similar, relevant, substantial(ly), large, small, good, bad, better, best, worst, proper, properly, acceptable, acceptably, accurate(ly), extreme, high-contrast, high contrast.
R8R8 - Klauzule wyjątków osłabiają wymaganie: [...]if necessary, where possible, as appropriate, as practicable, as far as possible, if practical, as required, as needed, to the extent possible, if possible.
R10R10 - Zbędne wyrażenia w bezokoliczniku: [...]to be designed to, to be able to, to be capable of, to enable, to allow, be able to, be capable of.
R16R16 - Unikaj przeczeń: [...]not, n't, never.
R17R17 - Unikaj ukośnika (“/”).Ukośnik między dwoma słowami, z wyjątkiem km/h, m/s, and/or i jego odpowiedników w języku niemieckim, francuskim, hiszpańskim, włoskim i niderlandzkim.
R24R24 - Zaimki zamiast jawnych rzeczowników: [...]it, its, they, them, their, he, she, him, her, someone, something, anyone, anything, anybody, somebody, this, these, those.
R32R32 - Użyj słowa “each” zamiast kwantyfikatorów ogólnych: [...]all, any, both, every, everything, everyone.
R34R34 - Terminy dotyczące wydajności, których nie można zmierzyć: [...]fast, quick, quickly, user friendly, user-friendly, high speed(s), high-speed, best practice(s), state of the art, state-of-the-art, seamless(ly), intuitive(ly), easy to use, timely, rapid, rapidly, real-time, real time. “Real-time clock” nie liczy się: nazywa komponent.
R35R35 - Niejasne określenia czasu: [...]as, eventually, before, after, until, meanwhile, simultaneous(ly), soon, later, sometimes, occasionally, often, subsequently, previously.
—Zastąp symbole zastępcze TBD/TBR.TBD, TBR lub TBS w opisie (wielkimi literami).
—AI: niejednoznaczne — <reason>Zaakceptowane ustalenie AI z Kontroli wymagań przez AI.
—Podaje wartość maksymalną (“up to”); jeśli chodzi o minimum, użyj “at least”.“up to”, po którym następuje liczba zapisana cyframi lub słownie (“up to 72 hours”, “up to five tonnes”). “Up to date” się nie liczy.

Kompletne

RegułaWiadomośćWyzwalane przez
—Brak opisu.Pusty opis.
—Brak nazwy.Pusta nazwa.
R9R9 - Sformułowania otwartych list: [...]including but not limited to, etc, and so on, and so forth, such as, among others.

Pojedyncze

RegułaWiadomośćWyzwalane przez
R18R18 - Napisz jedno zdanie (znaleziono: N).Więcej niż jedno zdanie (także zdania japońskie i chińskie zakończone znakiem 。, ! lub ?).
—Zakończ stwierdzenie kropką.Opis, który nie kończy się znakiem “.” (lub 。).
R19R19 - Łączy dwa wymagania; podziel je na osobne wymagania: [...]and, or, but, however lub whereas łączące dwa działania lub dwa obowiązki (“shall log and report each fault”, “… and the operator shall …”), “nor shall”, drugie zdanie składowe po “;”; “and/or” przed drugim działaniem. Zobacz Dwa wymagania w jednym (R19).
R19R19 - “and/or” jest niejednoznaczne; podaj, czy chodzi o oba, czy o jedno: [and/or]“and/or” między wartościami lub w warunku.
R19R19 - Łączy dwie wartości; podziel je, jeśli każda jest weryfikowana osobno: [...]and, or łączące dwa obiekty lub dwie wartości po jednym działaniu (“measure the temperature and the humidity”). Uwaga: Singular pozostaje Tak.
R20R20 - Zawiera wyrażenia celu; przenieś je do Rationale: [...]purpose of, in order to, so that, for the purpose of, so as to.
R21R21 - Zawiera nawiasy; przenieś tekst w nawiasach do Rationale.“(” lub “[” (także nawiasy pełnej szerokości).

Zgodne z konwencją

WiadomośćWyzwalane przez
Użyj czasownika modalnego: [need, shall, will, should, must]Nie występuje żadne z tych słów.

Odpowiednie

RegułaWiadomośćWyzwalane przez
R31R31 - Narzuca rozwiązanie: [...]using, by means of, utilizing, utilising, implemented in, implemented with, via a, via the, built with, written in.

Niezbędne

RegułaWiadomośćWyzwalane przez
R30R30 - Bardzo przypomina: [3.2 Battery Capacity (81.3% similar), ...]Inne wymaganie w zakresie, którego opis jest podobny w co najmniej 75% (podobieństwo par znaków). Ustalenie wymienia do pięciu takich wymagań i zlicza pozostałe (“and 3 more”). Bezpośredni element nadrzędny wymagania i jego elementy podrzędne (decomposed by, decomposes) nie są porównywane: doprecyzowanie często powtarza sformułowania elementu nadrzędnego. Elementy równorzędne i niepowiązane wymagania są porównywane.

Weryfikowalne

WiadomośćWyzwalane przez
Powiąż weryfikujący je Test Case lub Requirement.Wymaganie nie ma powiązania verified by z Requirement ani Test Case.
AI: nieweryfikowalne w obecnym brzmieniu — <reason>Zaakceptowane ustalenie AI z Kontroli wymagań przez AI.

Wykonalne

RegułaWiadomośćWyzwalane przez
R26R26 - Terminy absolutne, rzadko osiągalne: [...]always, never, 100%, 100 percent, all the time, totally, completely, absolutely, zero defects, forever, continuous, continuously, uninterrupted.
—Wymaga oceny recenzentaNie znaleziono terminów absolutnych ani bliskich duplikatów; decyzję musi podjąć człowiek.

Poprawne

WiadomośćWyzwalane przez
Wymaga oceny recenzentaKażda kontrola tekstu (Appropriate, Complete, Conforming, Necessary, Singular, Unambiguous) zakończyła się powodzeniem; decyzję musi podjąć człowiek.

Ponieważ Correct i Feasible kończą się komunikatem “Wymaga oceny recenzenta”, dopóki ktoś nie zdecyduje, najwyższy wynik automatyczny to 7 z 9 (78%).

Dwa wymagania w jednym (R19)

Wymaganie stwierdza jedną rzecz. R19 analizuje każde “and”, “or”, “nor”, “but”, “however”, “whereas”, “as well as” i “and/or” i przypisuje je do jednego z tych rodzajów:

RodzajPrzykładWynik
Dwa wymagania“The unit shall log and report each fault.” “The pump shall stop, and the operator shall be alerted.” “… to acknowledge alarms and to silence the horn.” “…; it shall also …”Ustalenie. Singular to Nie.
Niejednoznaczne “and/or”“The log shall record the user ID and/or the badge number.”Ustalenie: podaj, czy chodzi o oba, czy o jedno. Singular to Nie.
Dwie wartości“The station shall measure the temperature and the humidity.”Uwaga: podziel je, jeśli każda wartość jest weryfikowana osobno. Singular pozostaje Tak; uwaga jest pokazywana na szaro i nie obniża wyniku.
Brak ustalenia“between 5 °C and 30 °C”; “When A and B, the unit shall …”; “… when the door is open and the fan is off”; “requirements 2.1 and 2.2”; tekst w cudzysłowie; “The command and control unit shall …”; “ASME Boiler and Pressure Vessel Code”; “5 Nm at 3000 rpm and 24 V”; “including batteries and strap”; “either open or closed”Nic.

Dwie wartości jednej wielkości (“at -20 °C and 60 °C”) otrzymują uwagę. “, and” kończy warunek: “… when the level falls below 10 %, and restart when …” jest ustaleniem. Podmiot, który działa jako jeden (“The Owner and the Contractor shall agree …”, “The power and data connector shall …”), nie otrzymuje uwagi; dwa podmioty, z których każdy działa (“The pump and the valve shall close …”), otrzymują uwagę. Komparatory (“12 or more”) nie są oznaczane. Nazwy po działaniu nie da się odróżnić od dwóch wartości, więc wpisz ją w Nazwy złożone.

Nazwy złożone. Na stronie Jakość Więcej ▾ → Nazwy złożone… otwiera listę projektu z nazwami, które zawierają “and” lub “or”, ale oznaczają jedną rzecz, po jednej w wierszu (np. “power and data connector”). R19 ich nie oznacza. Liczą się też rozwinięcia ze słownika akronimów projektu (Statement typu Acronym, zobacz Znajdowanie akronimów), a kilka popularnych nazw jest wbudowanych (“command and control”, “research and development”, “operations and maintenance”, …). Lista jest zapisywana z projektem i można ją cofać. Kliknij ponownie Sprawdź jakość, aby zastosować zmianę.

Wymagania w innych językach

Holarch wykrywa język każdego wymagania na podstawie jego tekstu. Reguły słownikowe (R2–R10, R16, R19, R20, R24, R26, R31–R35, “up to”, czasownik modalny, jednostki) oceniają wymagania w języku angielskim.

Niemiecki, francuski i hiszpański (beta). Te wymagania otrzymują te same reguły we własnym języku, np. “angemessen” lub “bei Bedarf” po niemiecku, “approprié” lub “si possible” po francusku, “adecuado” lub “según corresponda” po hiszpańsku. Dopóki reguły dla języka są w wersji beta:

  • każde ustalenie jest sugestią oznaczoną (beta). Jest pokazywane na szaro razem z innymi uwagami i nigdy nie obniża kryterium ani wyniku;
  • pokazywana jest uwaga “Reguły sformułowań dla tego języka są w wersji beta: tylko sugestie, bez punktacji. Kontrole struktury obowiązują.”, a Unambiguous ma wartość – (niesprawdzone), dopóki sformułowania nie zostaną sprawdzone z AI lub ocenione ręcznie;
  • słowa oznaczające “each” (jede, chaque, cada) są właściwym wyborem i nie są oznaczane; nie są też oznaczane “alle 5 s” ani “tous les 5 s” (co 5 s).

Reguła zaczyna się liczyć dla języka dopiero po zmierzeniu jej na co najmniej 300 stwierdzeniach napisanych w tym języku i przejrzeniu przez inżyniera wymagań będącego rodzimym użytkownikiem języka (co najmniej 90 % jej ustaleń poprawnych) oraz po jej zatwierdzeniu przez recenzenta. Gdy to nastąpi, wyniki dla tego języka mogą się zmienić przy następnej kontroli; informują o tym informacje o wydaniu.

Inne języki (japoński, włoski, chiński i pozostałe) otrzymują:

  • uwagę “Reguły sformułowań dotyczą angielskiego. Kontrole struktury obowiązują.” oraz – (niesprawdzone) dla Unambiguous: kryterium jest pomijane w wyniku, dopóki sformułowania nie zostaną sprawdzone lub ocenione ręcznie. Inne ustalenie Unambiguous, np. TBD, nadal powoduje jego niespełnienie;
  • kontrole dla każdego języka: R18 (także 。), kropkę końcową (także 。), R17, R21, TBD/TBR, R30, nazwę, opis i powiązanie weryfikacji.

Każdy język, w wersji beta czy nie, otrzymuje też te kontrole. Sugestie są zapisywane po angielsku ze słowami zacytowanymi w oryginalnej postaci (“R7 - Imprecise wording: [angemessen] (beta)”), więc filtr quality:R7 i eksporty działają tak samo w każdym języku. Publiczne API zwraca je z regułą, słowami i trybem (findings).

Sprawdź sformułowanie z AI. ✦ AI ▾ → Sprawdź sformułowanie z AI… na stronie Jakość (lub ✦ Więcej AI ▸ przy jednym wymaganiu) stosuje te same reguły przez skonfigurowane AI w języku każdego wymagania. Podgląd wymienia ustalenia i opcjonalne przeredagowanie w tym języku (odznaczone). Zastosuj wybrane dodaje ustalenia jako ustalenia AI i usuwa uwagę (sugestie beta pozostają uwagami) w jednym kroku cofania. Edycja tekstu je czyści. Wymaga planu z AI.

Ręczne nadpisania

Nadpisz kryterium, gdy nie zgadzasz się z wynikiem automatycznym, lub aby zapisać decyzję recenzenta.

  • Na stronie Jakość: kliknij komórkę kryterium, aby przełączać jej wartość: pierwsze kliknięcie ustawia ręczne Tak (✔), następne ręczne Nie (✘), a trzecie czyści wartość ręczną, więc ponownie decyduje kontrola automatyczna. Komórka ręczna ma znacznik ręcznego ustawienia; jej podpowiedź mówi “(ustawione ręcznie)” i co zrobi następne kliknięcie.
  • W inspektorze lub Widoku elementu: każde kryterium to lista z Tak i Nie. Kryterium ustawione ręcznie oferuje też Automatycznie (sprawdź ponownie), co przywraca wynik automatyczny. Wartości ustawione ręcznie pokazują “ręcznie”.

Wartość ręczna jest zachowywana przy ponownym uruchomieniu kontroli. Ręczne Nie bez innego komunikatu pokazuje “Oznaczono ręcznie jako Nie.”

Nadpisania są czyszczone w dwóch przypadkach:

  • Zmienia się nazwa lub opis wymagania. Nadpisania pozostają w Historii, a Cofnij je przywraca.
  • Wybierasz Więcej ▾ → Wyczyść oceny ręczne. To czyści także zaakceptowane ustalenia AI.

Nieaktualne wyniki

Gdy nazwa lub opis wymagania zmieni się po kontroli, jego wyniki są oznaczane jako nieaktualne:

  • Strona Jakość pokazuje “Nieaktualne — uruchom ponownie” z podpowiedzią “Tekst zmienił się po ostatniej kontroli. Ponownie sprawdź jakość.”
  • Kolumna Wynik jakości dokumentu pokazuje znacznik Nieaktualne z ikoną zegara (wskaż go, aby zobaczyć powód).
  • Inspektor pokazuje “Jakość: nieaktualna — uruchom ponownie”.

Włącz Sprawdzaj ponownie automatycznie po zmianie tekstu, aby uniknąć nieaktualnych wyników. Holarch od razu ponownie uruchamia wtedy kontrolę reguł dla edytowanego wymagania. Ustawienie jest zapamiętywane w tej przeglądarce.

Sprawdzanie jakości z dokumentu

W dokumencie wybierz Sprawdź ▾ → Sprawdź jakość. Gdy zaznaczone jest wymaganie, pozycja brzmi Sprawdź jakość tego wymagania i sprawdza tylko je. Gdy żadne wymaganie nie jest zaznaczone, sprawdza każde widoczne wymaganie w dokumencie.

Wyniki otwierają się w oknie Kontrola jakości — <name> z kafelkami i tabelą. Jego przyciski to Eksportuj CSV, Eksportuj XLSX, Otwórz w Jakości i Zamknij.

Dokument bez wymagań pokazuje “Ten dokument nie ma elementów Requirement do sprawdzenia. Elementy Statement nie są oceniane.”

Kontrola wymagań przez AI

Używaj Kontroli wymagań przez AI, aby uzyskać pierwszą opinię o kryteriach, których reguła nie rozstrzyga: Correct, Feasible i Necessary. Szuka ona także sformułowań pominiętych przez reguły w ramach Unambiguous (np. “up to 72 hours”, gdy wydaje się, że chodzi o minimum, albo “accurately” bez miary) i Verifiable (żaden test, analiza, inspekcja ani demonstracja nie mogłyby pokazać, że wymaganie w obecnym brzmieniu jest spełnione). AI otrzymuje ustalenia reguł i zgłasza tylko to, co one pomijają.

  1. Wybierz ✦ AI ▾ → Sprawdź z AI (wymagania: N)….

    Dla jednego wymagania wybierz Sprawdź z AI (to wymaganie)… w jego menu ✦ AI ▾ lub ✦ Więcej AI ▸ → ✦ Sprawdź z AI… w jego menu kontekstowym.

    Claude przegląda wymagania. Są wysyłane w grupach po 20, z maksymalnie 300 innymi wymaganiami do kontroli duplikatów. W ramach AI w cenie planu kontrola zużywa jedno zapytanie na 100 wymagań (w zaokrągleniu w górę); zanim uruchomi się kontrola ponad 100 wymagań, okno podaje, ile zapytań zużyje, np. “Ta weryfikacja zużywa 3 z 52 pozostałych w tym miesiącu zapytań AI w cenie (1 zapytanie na 100 wymagań).” Kontrola, która wymaga więcej zapytań, niż pozostało, nie rozpoczyna się.

  2. Przejrzyj każde wymaganie w oknie.

    Wiersz u góry mówi, co jest początkowo zaznaczone: “Zaznaczone elementy zostaną zastosowane. Przeredagowania są początkowo odznaczone, aby można je było najpierw przeczytać. Wymagania zablokowane, zatwierdzone i objęte linią bazową są początkowo odznaczone.”

  3. Zaznacz akceptowane zmiany i przeredagowania.

    Wiersz nad przyciskami podaje, co zrobi Zastosuj, np. “Stosuje 7 wartości i 2 przeredagowania do 5 wymagań.” Gdy nic nie jest zaznaczone, brzmi “Nic nie zaznaczono.”, a Zastosuj wybrane jest wygaszone.

  4. Kliknij Zastosuj wybrane.

    Zaznaczone elementy zostają zastosowane, a jedno polecenie Cofnij wycofuje całość. Komunikat brzmi “Zastosowano zmiany AI: N”.

Dla każdego wymagania okno pokazuje:

  • Ocenę Tak/Nie i uzasadnienie dla Correct, Feasible, Necessary, Unambiguous i Verifiable.
  • Pod każdą oceną pole wyboru z etykietą opisującą, co zmieni jej zastosowanie, albo “bez zmian” bez pola wyboru, gdy zapisana wartość już się zgadza:
    • Correct, Feasible i Necessary: “Nie → Tak” lub “Tak → Nie”, gdy ocena różni się od zapisanej wartości, “Ustaw na Tak” lub “Ustaw na Nie”, gdy wartości nie ma.
    • Unambiguous i Verifiable: “Dodaje ustalenie”, gdy AI znalazło problem, oraz “Usuwa wcześniejsze ustalenie”, gdy wcześniejsze ustalenie AI już nie obowiązuje.
  • Opcjonalny komentarz.
  • Jeśli AI proponuje przeredagowanie, pole wyboru Zastosuj przeredagowaną wersję: z porównaniem słów.

Co jest początkowo zaznaczone:

  • Każda zmiana wartości jest początkowo zaznaczona.
  • Przeredagowania są początkowo odznaczone, aby można je było najpierw przeczytać.
  • Wymagania zatwierdzone, objęte linią bazową i zablokowane są początkowo odznaczone i oznaczone flagą.

Zaznaczenie przeredagowania wygasza pola Unambiguous i Verifiable tego wymagania i opisuje je jako “Sprawdzono ponownie po przeredagowaniu”: kontrole reguł działają ponownie na nowym tekście. Odznaczenie przeredagowania przywraca pola do poprzedniego stanu. Correct, Feasible i Necessary nadal są stosowane.

PrzyciskSkutek
Zaznacz wszystkie zmiany wartościZaznacza każdą zmianę wartości, z wyjątkiem wymagań zatwierdzonych, objętych linią bazową i zablokowanych.
Zaznacz wszystkie przeredagowaniaZaznacza każde przeredagowanie, z wyjątkiem oznaczonych flagą.
Odznacz wszystkoOdznacza wszystko.

Co robi Zastosuj:

  • Correct, Feasible i Necessary stają się ręcznymi wartościami Tak/Nie.
  • Nie dla Unambiguous lub Verifiable staje się ustaleniem AI: strona Jakość wymienia je razem z ustaleniami reguł jako “AI: niejednoznaczne — <reason>” lub “AI: nieweryfikowalne w obecnym brzmieniu — <reason>”, a kryterium pokazuje ✘. Tak usuwa wcześniejsze ustalenie AI.
  • Ustalenia AI są czyszczone, gdy zmienia się nazwa lub opis wymagania (także przez zaakceptowane przeredagowanie), oraz przez Więcej ▾ → Wyczyść oceny ręczne.

Co robi Zastosuj wybrane:

  • Oceny stają się wartościami ręcznymi z komunikatem “AI: <reason>”. Są zachowywane przy ponownym uruchomieniu kontroli.
  • Przeredagowania zastępują opis i ponownie uruchamiają kontrolę.

Eksporty jakości

EksportZawartość
Eksportuj ▾ → CSV (quality_report.csv)Jeden wiersz na wymaganie i kryterium: Number, Name, Description, Quality Score, Attribute, Message, Result.
Eksportuj ▾ → Excel (.xlsx) (quality_report.xlsx)Number, Name, Description, Rationale, Quality Score, Attribute, Message, Result, z komórkami wymagania scalonymi w jego dziewięciu wierszach, Yes na zielono i No na czerwono oraz Ocena w raporcie (odpowiedzi Yes wśród wszystkich odpowiedzi) na końcu.
Dostarcz ▾ → Wszystkie eksporty… → Ustalenia jakości (Excel) w dokumencieTen sam układ dla jednego dokumentu, z kolumnami wyświetlania dokumentu.

Zatwierdzenia

Użyj Potrzeby i wymagania → Zatwierdzenia, aby zobaczyć wszystko, co czeka na decyzję. Strona otwiera Bazę danych z zapytaniem Requirement:"Status=In Review".

Ma każdą funkcję Bazy danych:

  • Zaznacz kilka wierszy i użyj paska operacji zbiorczych, aby razem ustawić Status lub etykiety.
  • Eksportuj listę.
  • Kliknij wiersz dwukrotnie, aby otworzyć Widok elementu i pełną historię.

Pole zatwierdzenia

Pole zatwierdzenia pojawia się w inspektorze i Widoku elementu każdego wymagania. Pokazuje:

  • Bieżący status jako kolorowy żeton (Draft, gdy nic nie jest ustawione).
  • Ostatnią zapisaną decyzję: “<status> przez: <name> · <data i godzina>”, po której następuje “— <note>”, gdy jest notatka (np. “— Tekst zmieniony po zatwierdzeniu”), lub “Nie zapisano zatwierdzenia”.
  • Przyciski odpowiednie dla bieżącego statusu:
PrzyciskPokazywany, gdySkutek
ZatwierdźStatus to ani Approved, ani RejectedUstawia Approved i zapisuje Ciebie oraz czas. Komunikat: “Zatwierdzono”.
Odrzuć…Status to ani Approved, ani RejectedProsi o Powód (opcjonalnie) w oknie Odrzuć wymaganie, a następnie ustawia Rejected. Komunikat: “Odrzucono”.
Otwórz ponownieStatus to Approved lub RejectedUstawia In Review. Komunikat: “Przeniesiono do: In Review”.

Zapisywane imię i nazwisko to nazwa Twojego konta. Ręczne ustawienie Status w tabeli lub inspektorze również zapisuje decyzję z Twoim imieniem i nazwiskiem oraz czasem. Czytelnicy widzą pole bez przycisków.

Gdy przepływ pracy kieruje przejście do Approved przez wniosek o zmianę, pole pokazuje zamiast tego otwarty wniosek i jego licznik, np. CR-4: 1 z 3 zatwierdzeń. Po zastosowaniu decyzja wymienia każdego zatwierdzającego i wniosek: “Approved przez: Ann Lead, Bob Discipline · <data i godzina> · CR-4”.

Uwaga: edycja nazwy lub opisu wymagania Approved ustawia je na In Review z notatką “Tekst zmieniony po zatwierdzeniu”. Komunikat podaje “Zatwierdzone wymagania przeniesione do In Review: N.” Zmiana innych atrybutów nie otwiera go ponownie.

Rejestr TBD/TBR

Używaj rejestru, aby śledzić każdą otwartą kwestię do jej zamknięcia. Otwórz Potrzeby i wymagania → TBD/TBR. W dokumencie wybierz Sprawdź ▾ → Rejestr TBD/TBR, aby otworzyć rejestr ograniczony do tego dokumentu.

  • Nagłówek strony: Eksportuj XLSX (wyłączone, gdy rejestr jest pusty).
  • Pasek zakresu: Zakres (Wszystkie wymagania lub Dokument: <name>).
  • Kafelki: Otwarte TBD/TBR, Po terminie, Brak właściciela oraz żetony Według dokumentu (“<document>: <count>”), które otwierają każdy dokument.
  • Otwarte elementy w czasie: wykres spalania liczby otwartych kwestii. Jest odtwarzany z historii wymagań, z maksymalnie 60 punktami od najstarszego wymagania do teraz. Wskaż punkt, aby zobaczyć jego datę i liczbę. Przy zbyt krótkiej historii pokazuje “Za mało historii dla wykresu spalania.”
  • Kolumny Tabela:
    • Numer oraz Nazwa z opisem.
    • Dokument.
    • Typ: TBD, TBR lub TBS, z oznaczeniem “atrybut”, “w tekście” lub oboma.
    • Właściciel: TBD Owner, w przeciwnym razie Owner wymagania, w przeciwnym razie “—”.
    • Termin: jedyny termin wymagania, ta sama data co Termin w grupie Przepływ pracy inspektora i w Widoku elementu. Jest to atrybut TBD Due Date, gdy zawiera datę, w przeciwnym razie termin wymagania. Pod datą z przeszłości pokazuje “Po terminie”. Wiersze po terminie są podbarwione.
    • Wiek: dni od otwarcia kwestii.
    • Zamknij.

Kliknij wiersz prawym przyciskiem myszy lub naciśnij na nim Shift+F10, aby otworzyć to samo menu wiersza co w Bazie danych: sugerowane działania z uzasadnieniem, ✦ Więcej AI ▸, Otwórz, Zmień nazwę…, Duplikuj, Dodaj element podrzędny…, Status ▸, Priorytet ▸, Powiąż z ▸, Dodaj do dokumentu ▸, Pokaż na diagramie ▸, Kopiuj łącze, Kopiuj numer i Usuń…. W innych menu kontekstowych wymaganie z otwartym TBD lub TBR zaczyna się od Rozstrzygnij TBD…, co otwiera ten rejestr z zaznaczonym wymaganiem.

Rejestr jest tylko do odczytu. Aby zmienić termin, zaznacz wiersz i ustaw Termin w inspektorze. Holarch ustawia termin wymagania oraz, gdy atrybut TBD Due Date zawiera datę, także ten atrybut (zachowując jego godzinę), a jedno polecenie Cofnij wycofuje całość. Wyczyszczenie pola Termin czyści oba.

Zamknij pojawia się tylko wtedy, gdy atrybut TBD/TBR jest ustawiony. Ustawia atrybut na None:

  • Gdy w tekście nic nie zostało, komunikat brzmi “Zamknięto”.
  • Gdy TBD, TBR lub TBS nadal jest w tekście, komunikat brzmi “Atrybut zamknięty; tekst nadal zawiera TBD.”
  • Kwestia wynikająca tylko z tekstu nie ma przycisku Zamknij; edytuj tekst, aby ją zamknąć.

Gdy nic nie jest otwarte, strona pokazuje “Brak otwartych elementów TBD/TBR. Ustaw atrybut TBD/TBR wymagania lub wpisz TBD, TBR lub TBS w jego tekście, aby pojawiło się tutaj.”

Eksportuj XLSX zapisuje TBD-TBR Register.xlsx z kolumnami Number, Name, Document, Type, Source (attribute, text lub both), Owner, Due Date, Opened, Age (days), Overdue (Yes na czerwono) i Description.

Używaj Powiązania do przeglądu (w innych narzędziach nazywanych powiązaniami podejrzanymi), aby znaleźć to, co trzeba ponownie sprawdzić po zmianie wymagania. Powiązanie wymaga przeglądu, gdy element na jego drugim końcu zmienił się po ostatnim przeglądzie powiązania: sprawdź, czy powiązanie nadal obowiązuje, a następnie oznacz je jako przejrzane. Wymienia je Potrzeby i wymagania → Powiązania do przeglądu. W dokumencie użyj Sprawdź ▾ → Powiązania do przeglądu.

Te zmiany wymagania oznaczają jego powiązania do przeglądu:

  • Name lub Description.
  • Priority, Criticality, Verification Method lub Verification Level.
  • Dowolny atrybut liczbowy, procentowy lub czasu trwania.

Holarch oznacza wtedy każde powiązanie wymagania tych typów: decomposed by, derived by, refined by, satisfied by, verified by i traced to.

Zmieniona Verification Method lub Verification Level oznacza tylko powiązania verified by. Ustawienie pierwszej metody lub pierwszego poziomu wymagania niczego nie oznacza: planuje to weryfikację i nie zmienia niczego, co zostało przejrzane.

Drugi koniec każdego powiązania to element do przeglądu: wymaganie podrzędne, funkcja lub zasób, które je spełniają, weryfikujący przypadek testowy itd. Kolejne zmiany tego samego wymagania dopisują się do listy zmienionych pól w tym samym oznaczeniu.

  • Strona Powiązania do przeglądu: jeden wiersz na powiązanie do przeglądu.
  • Dokumenty i Baza danych: plakietka ⚠ Przegląd w wierszu elementu (“Element na drugim końcu zmienił się po ostatnim przeglądzie tego powiązania. Sprawdź, czy powiązanie nadal obowiązuje, a następnie oznacz je jako przejrzane. Kliknij, aby przejrzeć.”).
  • Inspektor i Widok elementu: baner “⚠ Przegląd: <requirement> zmienił się po ostatnim przeglądzie tego powiązania. Sprawdź, czy powiązanie nadal obowiązuje, a następnie oznacz je jako przejrzane.” Jego przycisk Przejrzyj… otwiera okno Powiązania do przeglądu — <item> dla tego elementu z przyciskami Otwórz Powiązania do przeglądu i Zamknij.
  • Sekcja Identyfikowalność inspektora: ⚠ obok każdego powiązania do przeglądu, ze zmienionymi polami i datą w podpowiedzi.
  • RVTM: ⚠ za wymaganiem z powiązaniem do przeglądu na którymkolwiek końcu (zmieniło się ono lub zmienił się element nad nim w łańcuchu); kliknij, aby przejrzeć te powiązania. ⚠ za przypadkiem testowym w Verified by oznacza to powiązanie weryfikacji.

Strona wyjaśnia regułę u góry i pokazuje tabelę:

KolumnaZawartość
(pole wyboru)Zaznacz dla Oznacz zaznaczone jako przejrzane…. Pole wyboru w nagłówku zaznacza wszystkie.
ZmienionoWymaganie, które się zmieniło.
ZmianaPola, które się zmieniły, np. “Description” lub “Priority, Verification Level”.
Kiedy / KtoData i godzina zmiany oraz osoba, która ją wprowadziła.
RelacjaTyp powiązania, odczytywany od strony zmienionego wymagania (np. “satisfied by”).
Element do przegląduElement na drugim końcu powiązania.
(działania)Różnice i Oznacz jako przejrzane….

Kliknij wiersz prawym przyciskiem myszy lub naciśnij na nim Shift+F10, aby otworzyć menu wiersza elementu, jak w Bazie danych: sugerowane działania, ✦ Więcej AI ▸, Otwórz, Zmień nazwę…, Duplikuj, Dodaj element podrzędny…, Status ▸, Priorytet ▸, Powiąż z ▸, Dodaj do dokumentu ▸, Pokaż na diagramie ▸, Kopiuj łącze, Kopiuj numer i Usuń…. W innych menu kontekstowych (Baza danych, dokumenty) element z powiązaniem do przeglądu zaczyna się od Przejrzyj powiązanie…, co otwiera jego przegląd.

Różnice otwiera Zmiana — <requirement> z porównaniem słów nazwy i opisu. Gdy zmieniły się tylko atrybuty, pokazuje “Zmieniły się tylko atrybuty: <fields>. Szczegóły w historii elementu.” Historia… otwiera historię wymagania.

Aby oznaczyć powiązania jako przejrzane:

  1. Kliknij Oznacz jako przejrzane… w wierszu, Oznacz zaznaczone jako przejrzane… dla zaznaczonych wierszy lub Oznacz wszystkie jako przejrzane (N)….

    Otwiera się Oznacz jako przejrzane: N powiązań: “Potwierdź, że powiązane elementy nadal obowiązują po zmianie. Do każdego powiązanego elementu zostanie dodany komentarz.”

  2. Wpisz opcjonalny komentarz, np. “Element podrzędny nadal aktualny; zmiana niepotrzebna.”
  3. Kliknij Oznacz jako przejrzane.

    Komunikat brzmi “Oznaczono jako przejrzane: N powiązań.”

Oznacz zaznaczone jako przejrzane… bez zaznaczenia pokazuje “Najpierw zaznacz powiązania do oznaczenia jako przejrzane.”

Oznaczenie powiązania jako przejrzanego zapisuje przegląd przy powiązaniu: kto, kiedy, komentarz i pola. Jeśli wpisano komentarz, Holarch dodaje też do komentarzy każdego elementu “Przejrzano powiązanie (zmiana <requirement>: <fields>): <comment>”. Cofnij odwraca tę operację.

Gdy nie ma powiązań do przeglądu, strona pokazuje “Brak powiązań do przeglądu. Powiązanie wymaga przeglądu, gdy element na jego drugim końcu zmieni się po ostatnim przeglądzie powiązania.”

Linie bazowe i porównywanie wersji

Linie bazowe dokumentów

Twórz linie bazowe dokumentu i korzystaj z nich przez Wersja ▾ w tabliczce tytułowej dokumentu. Wymienia ono:

  • Bieżąca wersja: dokument roboczy.
  • Każdą linię bazową tego dokumentu, od najnowszej, z datą.
  • W sekcji Linie bazowe projektu każdą linię bazową projektu.
  • Zapisz linię bazową… i Porównaj wersje… (wygaszone, dopóki dokument nie ma linii bazowej: “Najpierw zapisz linię bazową”).

Zapisz linię bazową… otwiera Zapisz linię bazową:

  • Nazwa * (wymagane).
  • Zatwierdzenia: wiersze z polami Nazwa, Rola i Oświadczenie oraz + Dodaj zatwierdzającego. Pierwszy wiersz jest wypełniony Twoim imieniem i nazwiskiem. Gdy pusto: “Brak zatwierdzających.”
  • Uwaga “Linia bazowa zachowuje tę wersję dokumentu (jego elementy, ich atrybuty i relacje), aby można ją było później wyświetlić, porównać i przywrócić. Zapisy zatwierdzeń otrzymują bieżącą datę i nie można ich potem edytować.”

Wybierz linię bazową w Wersja ▾, aby ją wyświetlić. Dokument staje się tylko do odczytu, z banerem “Linia bazowa “<name>”, tylko do odczytu, zapisana <date>” i listą zatwierdzeń. Pojawiają się te przyciski:

PrzyciskSkutek
Wróć do bieżącejWraca do dokumentu roboczego.
EdycjaEdytuj linię bazową: zmień jej nazwę i dodaj zapisy zatwierdzeń. Zatwierdzenia (zablokowane) wymienia istniejące zapisy, których nie można zmienić; nowe zapisy “otrzymują bieżącą datę i są dodawane do listy”. Tylko linie bazowe dokumentu.
Porównaj z bieżącymOtwiera Porównaj wersje od tej linii bazowej. Tylko linie bazowe dokumentu.
Przywróć linię bazowąLinia bazowa dokumentu: “Zastąpić encje, kolejność i strukturę tego dokumentu linią bazową “<name>”? Encje dodane od tego czasu zostaną usunięte z dokumentu (nie skasowane). Można cofnąć.” Linia bazowa projektu: Zastąp projekt linią bazową, “Zastąpić cały projekt linią bazową projektu “<name>”? Można cofnąć.”
Usuń“Usunąć linię bazową “<name>”?”

W dokumencie roboczym każdy wiersz ma pasek zmian: nowy od linii bazowej, zmieniony od linii bazowej lub bez zmian. Porównanie dotyczy najnowszej linii bazowej dokumentu albo, gdy dokument jej nie ma, najnowszej linii bazowej projektu.

Porównywanie wersji

Użyj raportu zmian, aby zobaczyć dokładnie, co się zmieniło od przeglądu.

  1. Kliknij Wersja ▾ → Porównaj wersje… lub Porównaj z bieżącym na banerze linii bazowej.

    Otwiera się Porównaj wersje.

  2. Wybierz Od: linię bazową.
  3. Wybierz Do: późniejszą linię bazową lub Bieżąca wersja.

    Tabela wymienia Numer, Nazwa, Typ zmiany, Pole i Zmiana (porównanie słów dla zmienionego tekstu).

Typy zmian:

Typ zmianyZnaczenie
Dodano / UsuniętoEncja dołączyła do dokumentu lub go opuściła.
ZmodyfikowanoZmieniło się pole: Nazwa, Numer, Opis, Klasa, Obraz lub dowolny atrybut (pole jest wskazane).
Dodano etykietę / Usunięto etykietęEtykieta została dodana lub usunięta.
Dodano relację / Usunięto relacjęPowiązanie dotyczące dokumentu zostało dodane lub usunięte.
Atrybut relacjiZmieniły się atrybuty relacji.

Zmiany (Excel) zapisuje “<document> (Changes).xlsx” z kolumnami Number, Name, Class, Change Type, Field, Old Value i New Value. Zmiany śledzone (Word) zapisuje to samo porównanie jako zmiany śledzone programu Word.

Dostarcz ▾ → Zmiany (Excel)… dokumentu (także w Wszystkie eksporty…) eksportuje ten sam raport z polami Od i Do. Gdy nie ma linii bazowej, kończy się błędem “Ten dokument nie ma linii bazowej. Najpierw ją zapisz.”

Dokument (Word) wypełnia tabele Revision History i Approvals w wyniku Word na podstawie linii bazowych dokumentu.

Strona Linie bazowe i wersje

Użyj Kontrola i przeglądy → Linie bazowe i wersje, aby zarządzać każdą linią bazową w projekcie. Linie bazowe projektu obejmują każdą encję; linie bazowe dokumentu obejmują jeden dokument i są tworzone przez Wersja ▾ → Zapisz linię bazową… dokumentu. Nagłówek strony ma Przywróć poprzednią wersję…, co przywraca wcześniejszy automatyczny zapis całego projektu, oraz + Zapisz linię bazową….

Aby utworzyć linię bazową projektu:

  1. Kliknij + Zapisz linię bazową… w nagłówku strony.

    Okno Zapisz linię bazową projektu pokazuje bieżącą liczbę encji i relacji. Nazwa domyślna to “Baseline <n>”; tekst zastępczy brzmi “Nazwa, np. “SRR””.

  2. Wpisz nazwę, a następnie naciśnij Enter lub kliknij Zapisz linię bazową. Pusta nazwa jest odrzucana (“Wprowadź nazwę.”).

    Komunikat brzmi “Zapisano linię bazową”.

Karty strony:

  • Karta Linie bazowe: bieżące liczby (“Bieżące: <n> elementów, <n> relacji”) i filtr: Wszystkie linie bazowe, Linie bazowe całego projektu lub Dokument: <name>. Kolumny:
    • Nazwa.
    • Dokument: łącze do widoku dokumentu w tej linii bazowej lub “Projekt”.
    • Utworzono.
    • Zatwierdzenia: “✔” i nazwiska zatwierdzających. Wskaż je, aby zobaczyć rolę, datę i oświadczenie. “przez: <name>” wskazuje twórcę.
    • Encje i Relacje.
    • Porównaj: ustawia tę linię bazową jako Od, a bieżącą kopię roboczą jako Do.
    • ⋯ (Więcej działań):
      • Zmień nazwę…: Zmień nazwę linii bazowej.
      • Eksportuj (JSON): pobiera “<name>.json” (format holarch-baseline, z migawką i zatwierdzeniami).
      • Przywróć linię bazową… (linia bazowa projektu): “Zastąpić wszystkie bieżące encje i relacje linią bazową “<name>”? Można cofnąć (⌘Z / Ctrl+Z).” Komunikat: “Przywrócono “<name>””.
      • Przywróć dokument… (linia bazowa dokumentu): “Przywrócić dokument “<doc>” do linii bazowej “<name>”? Zmienią się tylko encje i struktura tego dokumentu. Można cofnąć.” Wyłączone, gdy dokument został usunięty.
      • Usuń…. W usłudze hostowanej tylko właściciele projektu zmieniają nazwę linii bazowej lub ją usuwają; dla pozostałych te pozycje są wyszarzone z podaniem powodu.
  • Osierocone linie bazowe (pokazywane w razie potrzeby): “N linii bazowych usuniętych dokumentów”. Każda ma Przywróć dokument, co odtwarza artefakt dokumentu i jego encje z linii bazowej, oraz Usuń.
  • Karta Porównaj: wybierz Od (starsza) i Do (nowsza). Do to Bieżąca wersja lub inna linia bazowa o tym samym zakresie.
    • Kafelki: Dodane encje, Usunięte encje, Zmienione encje, Zmiany relacji.
    • Tabela pokazuje Encja, Zmiana, Pole i Różnica (porównanie słów). Atrybuty dat są pokazywane w formacie daty aplikacji.
    • Eksportuj CSV i Eksportuj XLSX zapisują “Changes <from> to <to>”.
    • Gdy nie ma nic do pokazania: “Brak różnic między “<from>” a “<to>”.”

Gdy nie ma linii bazowych: “Brak linii bazowych. Utwórz linię bazową, aby zarejestrować bieżący stan projektu.”

Uwaga: linie bazowe są zapisywane w projekcie i przenoszone razem z nim w eksporcie projektu. Linia bazowa projektu obejmuje encje i relacje. Linia bazowa dokumentu obejmuje też ustawienia konspektu dokumentu.

Import wymagań

Użyj Potrzeby i wymagania → Import i eksport, aby wczytać wymagania z plików. Import przebiega w czterech krokach: Plik → Mapowanie → Przegląd → Import.

  • Wstecz i Dalej przechodzą między krokami. Importuj N elementów w kroku Przegląd importuje, a jedno polecenie Cofnij wycofuje całość.
  • Jedna strefa upuszczania przyjmuje każdy format. Format jest wykrywany z pliku (z jego nazwy, a gdy to nie wystarcza, z zawartości) i pokazywany w polu Format, gdzie można go zmienić.

Formaty to Word (.docx), pliki projektu Holarch (.holarch, .json), Excel / CSV (.xlsx, .csv), Zwykły tekst (.txt), UML/SysML (.xmi, .uml, .mdzip) i ReqIF (.reqif).

Ta sekcja opisuje formaty wymagań. Pliki projektu, XMI i wszystkie pozostałe importy i eksporty opisuje Import i eksport.

Krok 1: Plik

Upuść plik na “Upuść tu plik lub kliknij, aby go wybrać” albo wklej tekst do pola i kliknij Analizuj tekst (CSV z wierszem nagłówka, ReqIF XML, XMI, JSON lub tekst dokumentu).

OpcjaWartościSkutek
FormatSześć powyższych formatówPokazuje wykryty format. Wybierz inny, aby odczytać tę samą zawartość w inny sposób.
Kodowanie tekstu (CSV, tekst)Automatycznie, UTF-8, ISO-8859-1 / Windows-1252, Shift_JIS, Big5, UTF-16Sposób odczytu bajtów pliku. Zmiana powoduje ponowne odczytanie pliku.
Arkusz (skoroszyty)“<name> (N wierszy)”Arkusz do importu. Wstępnie wybrany jest pierwszy arkusz z danymi.
  • Zwykły tekst: pole pozwala dalej edytować zaimportowaną zawartość. Edytuj ją i kliknij Uruchom analizę ponownie.
  • Wiersz stanu brzmi “Przeanalizowano “<file>”: N wierszy, M kolumn.” (oraz “(arkusz “<name>”)”, a dla Worda “, tabele: N”).

Krok 2: Mapowanie

Każda kolumna pliku to jeden wiersz: Kolumna pliku (tytuł i położenie), Przykładowe wartości (pierwsze trzy wiersze) i Pole Holarch. Wybierz Pomiń, aby pominąć kolumnę. Pola dopasowane na podstawie tytułu kolumny są oznaczone auto.

Pole HolarchZawartość
Nazwa, Numer, OpisWłasne pola elementu.
Klasa, EtykietyNazwa klasy; nazwy etykiet rozdzielone znakami ; , lub |.
Numer elementu nadrzędnego, Globalny IDNumer elementu nadrzędnego; ID używany do dopasowania istniejących encji.
AtrybutDowolny atrybut klasy dla wierszy bez klasy.
RelacjaKilka celów rozdziel znakiem ;.
ID wiersza, ID wiersza nadrzędnego, Nowy atrybut (dodany do schematu)Struktura z plików ReqIF i XMI oraz nowe atrybuty.

✦ AI ▾ → Zaproponuj mapowanie proponuje pole dla każdej kolumny. Proponowane mapowanie wymienia zmiany, zaznaczone, z uzasadnieniem AI; Zastosuj zaznaczone zmienia mapowanie. Nic nie jest jeszcze importowane.

Holarch odgaduje mapowanie na podstawie nagłówka:

NagłówekMapowanie na
Number, No, Num, #, ID Number, Req Number, Requirement NumberNumer
Name, Title, Short Name, Requirement NameImię i nazwisko
Description, Text, Requirement, Requirement Text, Statement, DescOpis
Class, Type, Entity ClassKlasa
Labels, Label, TagsEtykiety (wartości rozdzielone znakami ; , lub |)
Parent, Parent NumberNumer elementu nadrzędnego
Global ID, ID, GUID, UUIDGlobalny ID
Nazwa atrybutu (np. Priority, Rationale, Status)Ten atrybut. “Method” i “Verification” są mapowane na Verification Method.
Nazwa grupy etykiet (np. Verification Method, gdy taki atrybut nie istnieje)Etykiety
Nazwa relacji (np. satisfied by)Ta relacja; kilka celów rozdziel znakiem ;
Object Identifier, Origin IDGlobalny ID
Object Number, ReqIF.ChapterName, ReqIF.ForeignIDNumer
Object Heading, ReqIF.Name, Long NameImię i nazwisko
Object Text, ReqIF.Text, ReqIF.DescriptionOpis
ReqIF.CategoryKlasa
ReqIF ID, XMI ID, Row ID / Parent IDID wiersza / ID wiersza nadrzędnego

Nowy atrybut tworzy atrybut nazwany według kolumny w każdej importowanej klasie. Jego typ zależy od wartości:

  • Liczba, gdy każda wartość jest liczbą.
  • Lista wyboru, gdy jest niewiele krótkich, różnych wartości.
  • Długi tekst dla wartości dłuższych niż 120 znaków.
  • W pozostałych przypadkach tekst.

Kryteriów jakości, atrybutów obliczanych i atrybutów plików nie można mapować.

Pod kolumnami:

OpcjaWartościSkutek
Klasa dla wierszy bez klasyDowolna klasa; domyślnie RequirementKlasa wierszy bez wartości w kolumnie Class i bez pasującej reguły klasy.
Reguły klasOpis zawiera słowo lub wyrażenie → klasa+ Reguła dodaje regułę, × ją usuwa. Do wierszy bez wartości Class stosowana jest pierwsza pasująca reguła.
Dopasuj istniejące encje wedługGlobalny ID, Nazwa, NumerWiersze pasujące do istniejącej encji aktualizują ją, zamiast tworzyć kopię. Dopasowania według nazwy i numeru wymagają też tej samej klasy.
Dopasuj powiązane encje wedługGlobalny ID, Nazwa, NumerSposób, w jaki wartości w kolumnach relacji znajdują swoje cele.
Format daty w kolumnach dat (CSV)Automatycznie, yyyy-MM-dd HH:mm:ss, dd/MM/yyyy, MM/dd/yyyy, yyyyMMdd, Niestandardowy…Sposób odczytu komórek z datami. Niestandardowy… pokazuje pole na własny wzorzec (np. dd.MM.yyyy HH:mm) z użyciem yyyy, MM, dd, HH, mm i ss.
Wzorzec numeracji (Word, tekst)Pusty (automatycznie) lub znaczniki, np. 1. a) (i), albo numery ścieżek, np. 1.1 lub 1.1.aSposób, w jaki numerowane akapity tworzą konspekt. Dla tekstu wzorzec jest wykrywany z numeracji i wpisywany. Style nagłówków Worda i numeracja list nie wymagają wzorca. Zobacz Wzorzec numeracji.
Numeruj elementy podrzędne pod elementem nadrzędnym (1 → 1.1) (Word, tekst)Domyślnie włączoneWygenerowane numery elementów podrzędnych mają postać “3.1”, “3.2” zamiast “1”, “2”.

Hierarchia. Numery konspektu odtwarzają hierarchię: “1.2.3” staje się elementem podrzędnym “1.2”. Kolumna Numer elementu nadrzędnego lub para ID wiersza i ID wiersza nadrzędnego jawnie ustawia element nadrzędny. Elementy bez elementu nadrzędnego stają się elementami najwyższego poziomu dokumentu.

Tabele Worda. Dla pliku Word sekcja Tabele Worda wymienia każdą tabelę. Tabele powtarzające się z tym samym nagłówkiem w kolejnych sekcjach mają wspólne mapowanie. Sekcja wyjaśnia: “Zaimportuj tabelę wymagań jako encje, po jednej na wiersz, i zmapuj jej kolumny. Pozostałe tabele pozostają tabelami w opisie elementu, za którym występują.”

  • Ustaw każdą tabelę na Encje (po jednej na wiersz) lub Tabela w opisie.
  • Zmapuj jej kolumny na Numer, Nazwa, Opis, Klasa, Etykiety, Atrybut, Nowy atrybut lub Pomiń.
  • Nagłówki takie jak ID, Req ID, Requirement ID, Ref lub Paragraph są mapowane na Numer.
  • Shall, Shall Statement, Requirement Statement, Requirement Text, Statement lub Text są mapowane na Opis.

Tabela z kolumną numeru lub opisu i wierszami z “shall” jest początkowo ustawiona jako encje.

Dotychczas znalezione ostrzeżenia pojawiają się pod kolumnami, albo “Brak ostrzeżeń.”

Krok 3: Przegląd

Sprawdź wynik, zanim cokolwiek się zmieni. Przegląd pokazuje zmiany tak, jak Linie bazowe i wersje porównują wersje (zobacz Linie bazowe i porównywanie wersji):

  • Pierwszy wiersz podaje plik, format i liczbę elementów w każdej klasie.
  • Utwórz dokument wymagań z tych N wymagań pojawia się, zaznaczone, gdy każdy element jest typu Statement lub Requirement (albo podklasy). Dla innych plików brzmi Utwórz dokument z tych N elementów i jest odznaczone. Gdy jest zaznaczone, wybierz Typ dokumentu (domyślnie Dokument wymagań), Nazwa (domyślnie nazwa pliku) i to, czy Ponumeruj cały dokument po imporcie.
  • Następują ostrzeżenia.
  • Kafelki zliczają Nowe elementy, Zaktualizowane elementy, elementy Dopasowane, bez zmian i Relacje z pliku.
  • Tabela zmian wymienia każdy nowy element z jego opisem oraz każde zmienione pole zaktualizowanego elementu z porównaniem słów starej i nowej wartości (pierwsze 500 zmian).

Kliknij Importuj N elementów. Komunikat brzmi “Zaimportowano: nowe N, zaktualizowane M”.

  • Bez ostrzeżeń Holarch otwiera nowy dokument wymagań (lub Bazę danych).
  • W przeciwnym razie karta Import zakończony wymienia ostrzeżenia (“Import nie zgłosił ostrzeżeń.”, gdy ich nie ma). Jej przyciski to Otwórz dokument, Otwórz bazę danych, Diagram Spider, Diagram drzewa, Sprawdź jakość i Rozpocznij kolejny import.

Opis nowego dokumentu wymienia ostrzeżenia importu.

Jak jest odczytywany każdy format

Word (.docx):

  • Nagłówki i numeracja list Worda tworzą konspekt i zachowują swoje numery.
  • Nagłówek staje się Statement. Tekst pod nim staje się jego opisem.
  • Akapit z shall, must, will lub should staje się podrzędnym Requirement, nazwanym słowami po czasowniku modalnym. Tak samo element listy numerowanej; bez czasownika modalnego staje się Statement.
  • Punkty list wypunktowanych, obrazy i tabele dołączają do opisu elementu, za którym występują, z zachowaniem pogrubienia, kursywy, list i tabel.
  • Oryginalny plik .docx jest dołączany do nowego dokumentu, jeśli mieści się w limicie załączników na plik.
  • Obrazy PNG, JPEG, GIF, WebP i SVG są zachowywane. Inne formaty obrazów są pomijane z ostrzeżeniem.

Excel (.xlsx, .xlsm) i CSV:

  • Jeden wiersz na encję, dowolne kolumny. Pierwszy wiersz jest nagłówkiem.
  • Komórki wielowierszowe zachowują podziały wierszy.
  • Pliki Excel 97-2003 (.xls) nie są odczytywane. Najpierw zapisz je jako .xlsx lub .csv.

ReqIF (.reqif, .reqifz):

  • Każdy SPEC-OBJECT staje się wierszem z kolumnami ReqIF ID, Parent ID (z hierarchii specyfikacji), Type (jego typ obiektu, mapowany na Class), Long Name i po jednej kolumnie na definicję atrybutu.
  • Kolumny bez dopasowania są domyślnie ustawiane na Nowy atrybut. Atrybuty XHTML stają się atrybutami tekstu sformatowanego, a atrybuty wyliczeniowe listami wyboru.
  • Elementy SPEC-RELATION stają się relacjami według nazwy. Gdy nazwa nie pasuje do relacji dozwolonej przez schemat, stają się traced to.
  • Archiwum .reqifz jest rozpakowywane automatycznie.

Zwykły tekst (.txt) lub wklejony tekst:

  • Numerowany wiersz (“3.1 Battery”) lub krótki wiersz bez kropki staje się nagłówkiem (Statement).
  • Każde zdanie z shall, must, will lub should staje się Requirement pod bieżącym nagłówkiem.
  • Pozostały tekst dołącza do opisu poprzedniego elementu.
  • Przy wzorcu numeracji (wykrytym z tekstu lub wpisanym) poziomy wyznacza wzorzec.

Aktualizacja wymagań z arkusza kalkulacyjnego

Użyj tego, aby zmienić wiele wymagań naraz w arkuszu kalkulacyjnym.

  1. W Bazie danych (lub na stronie Wymagania) kliknij Eksportuj… i wybierz Tabela (CSV).
  2. Zaznacz atrybuty do edycji. W sekcji Uwzględnij zaznacz ID, a następnie kliknij Eksportuj.
  3. Edytuj wartości w arkuszu kalkulacyjnym. Nie zmieniaj kolumny ID.
  4. Zaimportuj plik. W kroku Mapowanie sprawdź, czy kolumna ID jest mapowana na Globalny ID, i ustaw Dopasuj istniejące encje według na Globalny ID.
  5. W kroku Przegląd odznacz Utwórz dokument….

    Dopasowane wiersze są liczone jako Zaktualizowane elementy, z wymienionym każdym zmienionym polem.

  6. Kliknij Importuj N elementów.

Wartość I_… z pliku wyeksportowanego przed tym wydaniem nie pasuje; użyj kolumny ID. Wszystkie kroki i opcje opisuje Import i eksport.

Co zapisuje aktualizacja:

  • Tylko zmapowane kolumny. Brak kolumny Description pozostawia każdy istniejący opis.
  • Etykiety z pliku są dodawane do istniejących etykiet.
  • Bez kolumny Class wiersz dopasowany według Globalnego ID zachowuje klasę swojej encji.

Komunikaty importu

WiadomośćZnaczenie i rozwiązanie
Żadna kolumna nie jest mapowana na Nazwa ani Numer. Zmapuj jedną z nich.Zmapuj co najmniej jedną kolumnę na Nazwa lub Numer.
Wiersz N: nieznana klasa “X”, użyto <class>.Wartość Class nie pasuje do żadnej klasy. Popraw wartość lub zmapuj kolumnę na Pomiń.
Wiersz N: zignorowano nieznaną etykietę “X”.Najpierw utwórz etykietę w schemacie albo popraw wartość.
Wiersz N: “<attribute>” nie dotyczy klasy <class>.Klasa wiersza nie ma tego atrybutu.
Wiersz N: “<value>” nie jest prawidłową wartością typu <type> dla “<attribute>”.Wartości nie można odczytać jako liczby, daty, wyboru itd. Sprawdź opcję formatu daty.
Wiersz N: nazwa jest dłuższa niż 255 znaków i została skrócona. / Wiersz N: numer jest dłuższy niż 255 znaków i został skrócony.Nazwy i numery są ograniczone do 255 znaków.
Powtórzony numer X (wiersze A i B).Dwa wiersze mają ten sam numer; hierarchia może dołączyć elementy podrzędne do pierwszego.
Wiersz N: brak numeru elementu nadrzędnego P dla X; dołączono do Q. / …; zaimportowano na najwyższym poziomie.Bezpośredniego numeru elementu nadrzędnego nie ma w pliku.
Wiersz N: nie znaleziono numeru elementu nadrzędnego P. / Wiersz N: nie znaleziono elementu nadrzędnego P.Parent Number lub Parent Row ID odwołuje się do wiersza, którego nie ma w pliku.
Wiersz N: nie znaleziono celu “X” relacji “<relationship>”.Kolumna relacji wskazuje encję, która nie istnieje. Sprawdź Dopasuj powiązane encje według.
Wiersz N: schemat nie pozwala na “<relationship>” od A do B (mimo to utworzono).Powiązanie zostało utworzone, choć schemat go nie wymienia.
Schemat nie pozwala na relację “X” między A a B; pominięto.Nie udało się utworzyć relacji ReqIF lub XMI, nawet jako traced to.
Obraz X: obrazy .ext nie są obsługiwane i zostały pominięte. Aby go zachować, zapisz obraz w Wordzie jako PNG lub JPEG.Obraz w Wordzie w nieobsługiwanym formacie.
Obraz X (rozmiar) przekracza limit załączników <limit> i został pominięty.Obraz jest większy niż limit na plik.
Nie znaleziono wierszy danych.Plik lub arkusz ma tylko nagłówek albo jest pusty.
Nie można odczytać pliku: pliki Excel 97-2003 (.xls) nie są obsługiwane. W Excelu zapisz plik jako .xlsx lub .csv, a następnie zaimportuj go ponowniePrzekonwertuj plik.
Nie można odczytać pliku: XML z deklaracją DOCTYPE lub ENTITY nie jest akceptowany. Zapisz plik bez niej i zaimportuj go ponownieUsuń deklarację z pliku ReqIF lub XML.
Nie można odczytać pliku: nieprawidłowy XMLPlik ReqIF nie jest poprawnie sformułowanym XML.
Import nie powiódł się: <reason>Import został przerwany; nic nie zostało zmienione.

Skróty dla wymagań

KlawiszeGdzieCzynność
EnterSzybkie wprowadzanie w dokumencieDodanie wpisanego wymagania.
⌘ / Ctrl+Enter / ⌥ / Alt+⌘ / Ctrl+EnterDokument, zaznaczony elementDodanie elementu równorzędnego / podrzędnego.
Enter lub SpaceWiersze Jakość, TBD/TBR i Powiązania do przegląduPokazanie w inspektorze wymagania lub elementu do przeglądu z danego wiersza.
↑ / ↓Te same wiersze, wiersz z fokusemPrzejście do poprzedniego lub następnego wiersza.
⌘ / Ctrl+kliknięcie, ⇧ / Shift+kliknięcie, ⌘ / Ctrl+⇧ / Shift+kliknięcieWiersze Jakość, TBD/TBR i Powiązania do przeglądu; wiersze Bazy danych; elementy dokumentuPrzełączenie wiersza, zaznaczenie zakresu od ostatnio klikniętego wiersza, dodanie tego zakresu.
⌘A / Ctrl+A, ⇧ / Shift+↑ / ⇧ / Shift+↓Te same wiersze, wiersz z fokusemZaznaczenie każdego pokazanego wiersza; rozszerzenie zaznaczenia od wiersza z fokusem.
Kliknięcie prawym przyciskiem myszy, Shift+F10 lub klawisz menuWiersze Wymagania, Jakość, TBD/TBR i Powiązania do przeglądu; elementy dokumentu i wpisy konspektuOtwarcie menu wiersza: najpierw sugerowane działania z uzasadnieniem i ✦ Więcej AI ▸, potem polecenia elementu.
EscJakość, TBD/TBR, Powiązania do przeglądu, RVTMOdznaczenie wiersza.
EnterPole nazwy na stronie Linie bazowe i wersjeUtworzenie linii bazowej projektu.
⌘Z / Ctrl+ZWszędzieCofnięcie ostatniej zmiany, w tym całego importu, oznaczenia powiązań jako przejrzanych lub zmiany statusu.

Wszystkie skróty w aplikacji opisuje Skróty klawiaturowe.

Ustawienia

UstawienieGdzieDomyślnieZakres
Sprawdzaj ponownie automatycznie po zmianie tekstuPasek zakresu strony JakośćWył.Ta przeglądarka
Grupy inspektora zwinięte lub otwarte (Jakość i pozostałe)Kliknij nagłówek grupy w inspektorze albo Zwiń wszystko / Rozwiń wszystko na końcu jego powiązańJakość zwinięta, pozostałe otwarteTa przeglądarka, osobno dla każdej klasy
Twoje imię i nazwisko przy zatwierdzeniach, decyzjach i komentarzachNazwa Twojego konta—Konto
Status śledzenia (kropki przy wymaganiach)Widok ▾ dokumentuNaDokument

Komunikaty

WiadomośćGdzieZnaczenie
Sprawdzono wymagania: NJakośćKontrola objęła zakres.
Brak wymagań w tym zakresie.JakośćZakres nie zawiera wymagań.
Ten dokument nie ma elementów Requirement do sprawdzenia. Elementy Statement nie są oceniane.Sprawdź jakość w dokumencieZmień elementy na Requirement lub sprawdź inny dokument.
Nieaktualne — uruchom ponownie / Nieaktualne / Jakość: nieaktualna — uruchom ponownieJakość, dokumenty, inspektorTekst zmienił się po ostatniej kontroli.
Wymaga oceny recenzentaJakość (Correct, Feasible)Decyzję musi podjąć człowiek; kliknij ✘, aby oznaczyć Tak.
Oznaczono ręcznie jako Nie.JakośćRecenzent ustawił kryterium na Nie.
Zatwierdzone wymagania przeniesione do In Review: N; powiązania oznaczone do przeglądu: N.Po edycjiEdycja ponownie otworzyła zatwierdzenia i oznaczyła powiązania do przeglądu.
Zatwierdzono / Odrzucono / Przeniesiono do: In ReviewPole zatwierdzeniaDecyzja została zapisana.
Oznaczono jako przejrzane: N powiązań.Powiązania do przegląduPrzeglądy zostały zapisane.
Najpierw zaznacz powiązania do oznaczenia jako przejrzane.Powiązania do przegląduZaznacz wiersze przed użyciem Oznacz zaznaczone jako przejrzane….
Zamknięto / Atrybut zamknięty; tekst nadal zawiera TBD.TBD/TBRAtrybut został ustawiony na None.
Tekst nadal zawiera TBD. Edytuj tekst, aby to zamknąć.TBD/TBRPokazywane przy zamykaniu kwestii wynikającej tylko z tekstu.
Zapisano linię bazowąDokumenty, Linie bazowe i wersjeMigawka została zapisana.
Ten dokument nie ma linii bazowej. Najpierw ją zapisz.Porównaj z bieżącym, raporty zmianDokument nie ma linii bazowej.
Przywrócono do “<name>” / Przywrócono “<name>”Linie bazoweDokument lub projekt został przywrócony; można cofnąć.
Brak wymagań do przeglądu. Najpierw zaznacz lub otwórz wymagania.Kontrola wymagań przez AIBrak wymagań w zakresie.

Limity

  • Sprawdź jakość: każde wymaganie w zakresie jest porównywane z pozostałymi pod kątem duplikatów (próg podobieństwa 75%).
  • Kontrola wymagań przez AI: 20 wymagań na zapytanie AI, z maksymalnie 300 innymi wymaganiami jako kontekstem.
  • Porównanie w przeglądzie powiązań zachowuje pierwsze 500 znaków starej nazwy i 4000 znaków starego opisu.
  • Wykres spalania TBD/TBR: do 60 punktów.
  • Import:
    • Nazwy i numery do 255 znaków.
    • Podgląd pokazuje pierwsze 500 wierszy. Wymienianych jest pierwszych 50 ostrzeżeń (“…i jeszcze N”).
    • Wzorzec numeracji ma najwyżej 6 poziomów (“Wzorzec numeracji ma więcej niż 6 poziomów. Użyj najwyżej 6 znaczników.”).
    • Pliki ReqIF/XML do 100 milionów znaków i 3 000 000 elementów.
    • Archiwa .reqifz i .docx do 10 000 wpisów, 300 MB na wpis i łącznie 600 MB.
    • Obrazy i oryginalny plik Word są zachowywane tylko w granicach limitu załączników na plik (10 MB w planie Free, 25 MB w Individual, 100 MB w Team).