Holarch

SysML v2

Warianty i konfiguracje SysML v2

Modeluj linię produktów w projekcie SysML v2: punkty zmienności, warianty, reguły i konfiguracje w Przeglądarce i inspektorze, Nowa konfiguracja…, widoki pokazywane jako jedna konfiguracja oraz analizy kompromisów konfiguracji.

Jak z niego korzystać →

Na tej stronie
  1. Przegląd
  2. Pojęcia
    1. Punkty zmienności i warianty
    2. Linie produktów
    3. Reguły
    4. Konfiguracje
  3. Jak z niego korzystać
    1. Kiedy i dlaczego
    2. Oznaczanie punktu zmienności
    3. Dodawanie reguły
    4. Tworzenie konfiguracji
    5. Zmiana wyborów konfiguracji
    6. Wyświetlanie modelu jako jednej konfiguracji
    7. Porównywanie konfiguracji w analizie kompromisów
    8. Przykład: projekt demonstracyjny Hybrid Car
    9. Wskazówki i dobre praktyki
    10. Typowe błędy
    11. Powiązania z innymi funkcjami
  4. Przeglądarka
  5. Inspektor
    1. Linia produktów
    2. Konfiguracja
    3. Punkt zmienności i wariant
  6. Wyświetl jako konfigurację
  7. Komunikaty
  8. Limity
  9. Powiązane strony

Przegląd

Linia produktów to jeden projekt z kilkoma punktami, w których produkty się różnią, na przykład rozmiarem akumulatora lub tym, czy zamontowano ładowarkę. Linię modeluje się raz, a następnie można oglądać, sprawdzać i porównywać dowolny produkt bez kopiowania modelu.

SysML v2 ma to wbudowane w język. Holarch pokazuje to w całej aplikacji:

  • Przeglądarka oznacza linie produktów, punkty zmienności, warianty i konfiguracje oraz wymienia konfiguracje każdej linii produktów.
  • Inspektor pokazuje punkty, reguły i konfiguracje linii produktów wraz z werdyktem dla każdej z nich i pozwala zmieniać wybory konfiguracji.
  • Nowa konfiguracja… tworzy konfigurację z okna, które sprawdza reguły w trakcie wybierania.
  • Wyświetl jako ▾ na górnym pasku pokazuje widoki, Bazę danych, inspektor i stronę Linia produktów jako jedną konfigurację.
  • Analizy kompromisów mogą porównywać konfiguracje linii produktów lub warianty punktu.

Zmienność w tekście jest dostępna w każdym planie. W planie Free strona Linia produktów, Nowa konfiguracja… i zmiana wyborów konfiguracji w inspektorze są tylko do odczytu; ich edycja jest częścią planów Individual i Team. Zobacz Linie produktów: plany.

Pojęcia

Punkty zmienności i warianty

Punkt zmienności to miejsce w projekcie, w którym produkty się różnią. Jego warianty to dozwolone wybory.

  • Użycie zmienności to punkt wewnątrz jednego projektu: variation part charger : Component { variant part noCharger; variant part wallbox; }.
  • Definicja zmienności to zbiór wyborów wielokrotnego użytku: variation part def BatteryPack { variant part standardPack; variant part largePack; }. Użycie przez nią typowane, takie jak part pack : BatteryPack;, również jest punktem.

Linie produktów

Linia produktów to definicja lub użycie, które posiada lub dziedziczy punkty zmienności. W projekcie demonstracyjnym Hybrid Car linią produktów jest CarLine: specjalizuje Car i dodaje punkty pack i charger. Definicja specjalizująca linię produktów również jest linią produktów.

Reguły

Reguła to assert constraint linii produktów. Wyklucza kombinacje wariantów. W projekcie demonstracyjnym wallboxNeedsLargePack określa, że ładowarka wallbox wymaga dużego pakietu akumulatorów:

assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }

Dopóki punkt nie ma wyboru, reguła na nim nie jest ani spełniona, ani naruszona: jej werdykt jest nieznany.

Konfiguracje

Konfiguracja to jeden produkt z linii. Jest to użycie typowane linią produktów, które wiąże jeden wariant z każdym punktem. Holarch oznacza ją przez @HolarchConfiguration (pakiet HolarchVariability), więc Edytor wskazuje każdy punkt, który nie został jeszcze wybrany:

part plugInHybrid : CarLine {
  @HolarchConfiguration;
  part :>> pack = BatteryPack::largePack;
  part :>> charger = charger::wallbox;
}

Każda konfiguracja ma werdykt:

WerdyktZnaczenie
PoprawnaDla każdego punktu wybrano jeden wariant i każda reguła jest spełniona.
Narusza regułę …Reguła jest naruszona; werdykt ją wskazuje.
NiekompletnaPunkt nie ma jeszcze wybranego wariantu; werdykt go wskazuje.
NieznanaNie można było ocenić reguły, na przykład dlatego, że brakuje odczytywanej przez nią wartości.

Holarch liczy też kombinacje wariantów i to, ile z nich dopuszczają reguły. W przypadku bardzo dużej linii produktów sprawdza tylko pierwsze kombinacje i podaje, ile sprawdził.

Jak z niego korzystać

Kiedy i dlaczego

Używaj zmienności, gdy kilka produktów ma wspólną większość jednego projektu: wersje wyposażenia pojazdu, wersje eksportowe, zestawy czujników, produkt z opcją i bez niej. Zamodeluj wspólny projekt raz, oznacz punkty, w których produkty się różnią, i dodaj konfigurację dla każdego produktu. Każdy produkt pozostaje wtedy zgodny z każdą zmianą wspólnego projektu.

Oznaczanie punktu zmienności

  1. Otwórz Edytor i pakiet zawierający projekt.
  2. Wewnątrz definicji linii produktów wybierz Wstaw ▾ → Zmienność. Uzupełnij nazwę i typ punktu.
  3. Wewnątrz zmienności wybierz Wstaw ▾ → Wariant raz dla każdego wyboru.
  4. Aby wielokrotnie użyć zbioru wyborów, wybierz Wstaw ▾ → Zmienność na poziomie pakietu. Zapisuje to definicję zmienności; otypuj nią część.

Przeglądarka pokazuje teraz linię produktów z ikoną ułożonych pól, a punkt z rombem.

Dodawanie reguły

  1. Wewnątrz definicji linii produktów napisz asercję ograniczenia na jej punktach, na przykład assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack }.
  2. Zaznacz linię produktów w Przeglądarce.

Reguła jest widoczna w polu Reguły w sekcji Linia produktów inspektora, wraz z liczbą wykluczanych przez nią kombinacji.

Tworzenie konfiguracji

  1. W Przeglądarce otwórz menu wiersza (⋯, kliknięcie prawym przyciskiem lub Shift+F10) linii produktów lub jej grupy Konfiguracje.
  2. Wybierz Nowa konfiguracja….
  3. Sprawdź pole Konfiguruje: linię produktów, do której należy konfiguracja.
  4. Wpisz Nazwa, na przykład longRangeHybrid.
  5. W sekcji Wybory wariantów wybierz jeden wariant dla każdego punktu zmienności. Werdykt pojawia się od razu pod wyborami, na przykład Poprawna: spełnia każdą regułę lub Narusza regułę wallboxNeedsLargePack.
  6. Kliknij Utwórz.

Konfiguracja jest zapisywana w tekście po ostatniej konfiguracji linii produktów, oznaczona @HolarchConfiguration, a jedno polecenie Cofnij wycofuje całość. Przeglądarka zaznacza ją w grupie Konfiguracje linii produktów.

Okno można też otworzyć przyciskiem Nowa konfiguracja… w sekcji Linia produktów inspektora lub z ⌘K / Ctrl+K.

Zmiana wyborów konfiguracji

  1. Zaznacz konfigurację w Przeglądarce (lub w widoku).
  2. W sekcji Konfiguracja inspektora wybierz inny wariant z listy punktu.

Wiązanie w tekście zostaje przepisane (part :>> pack = BatteryPack::standardPack;), a werdykt się aktualizuje; jedno polecenie Cofnij wycofuje całość. Wybierz Nie wybrano, aby usunąć wybór. Wybór, który dodałby błąd do modelu, jest odrzucany z podaniem przyczyny.

Wyświetlanie modelu jako jednej konfiguracji

  1. Na górnym pasku kliknij Wyświetl jako ▾ (do czasu wyboru widnieje tam Wszystkie konfiguracje ▾) i wybierz konfigurację. Baner pod górnym paskiem pokazuje na przykład Wyświetlana konfiguracja: plugInHybrid. oraz liczbę elementów, których dotyczy. W widokach ogólnych, połączeń i siatki warianty, których konfiguracja nie wybiera, oraz pozostałe konfiguracje są ukryte, a każdy punkt zmienności pokazuje swój wybór, na przykład pack : BatteryPack = largePack. Baza danych, inspektor i strona Linia produktów stosują ten sam wybór.
  2. Aby wrócić, wybierz Wyświetl jako ▾ → Wszystkie konfiguracje lub kliknij Opuść na banerze.

W planach Individual i Team można edytować podczas wyświetlania konfiguracji; każda edycja jest edycją tekstu SysML v2, sprawdzaną przed zastosowaniem, a jedno polecenie Cofnij wycofuje każdą z nich:

  • Wybór wariantu zapisuje wiązanie w konfiguracji (part :>> pack = BatteryPack::largePack;).
  • Zmieniona wartość atrybutu staje się własną wartością konfiguracji; definicja zachowuje swoją wartość.
  • Nowe części i akcje należą do konfiguracji.
  • Usunięcie odziedziczonego elementu, który można pominąć, zapisuje part :>> roofBox[0]; w konfiguracji. Wymaganego odziedziczonego elementu nie można tam usunąć; zmień go w Edytorze.
  • Ryzyko, zadanie lub inny element Holarch utworzony w tym czasie dotyczy konfiguracji.

W planie Free widok konfiguracji jest tylko do odczytu. Z inspektora konfiguracji Pokaż w widoku ▾ otwiera widok jej linii produktów wyświetlony jako ta konfiguracja.

Porównywanie konfiguracji w analizie kompromisów

  1. Otwórz Ryzyka, problemy i decyzje → Analizy kompromisów i analizę (lub kliknij + Nowa analiza kompromisów).
  2. W sekcji Warianty kliknij + Z linii produktów….
  3. W polu Z wybierz Konfiguracje: … (linia produktów) lub Warianty: … (punkt zmienności).
  4. Odznacz niepotrzebne pozycje i kliknij Dodaj.

Każda konfiguracja lub każdy wariant staje się wariantem analizy, powiązanym z elementem modelu. Dodaj kryteria i wartości jak w każdej analizie kompromisów lub użyj Pobierz wartości z modelu.

Przykład: projekt demonstracyjny Hybrid Car

Utwórz projekt demonstracyjny przez Pliki projektów ▾ → Nowy projekt demonstracyjny → Hybrid Car (SysML v2) na stronie Zarządzaj projektami.

  1. Otwórz Model → Przeglądarka i rozwiń Vehicles. BatteryPack i CarLine mają ikony linii produktów; CarLine ma grupę Konfiguracje z longRangeHybrid, plugInHybrid i selfChargingHybrid.
  2. Zaznacz CarLine. Sekcja Linia produktów wymienia punkty pack (standardPack, largePack) i charger (noCharger, wallbox), regułę wallboxNeedsLargePack oraz trzy konfiguracje, wszystkie z werdyktem Poprawna. Podaje 4 kombinacje: 3 dopuszczone przez reguły i 1 wykluczoną (wallbox ze standardowym pakietem akumulatorów).
  3. Zaznacz selfChargingHybrid i zmień charger na wallbox. Werdykt zmienia się na Narusza regułę wallboxNeedsLargePack. Naciśnij ⌘Z / Ctrl+Z, aby cofnąć.
  4. Otwórz widok carLineVariants (Diagramy). Wybierz Wyświetl jako ▾ → plugInHybrid. Pole BatteryPack zachowuje tylko largePack, a pole CarLine pokazuje pack : BatteryPack = largePack i variation charger : Component = wallbox.
  5. Otwórz Analizy kompromisów → Configuration Line-up (TR-2). Jej warianty to trzy konfiguracje, oceniane pod względem ceny, zasięgu elektrycznego i wygody ładowania.

Wskazówki i dobre praktyki

  • Zachowuj wspólny projekt w linii produktów, a w wariantach tylko różnice. Wariant redefiniuje to, co zmienia (attribute :>> capacity = 12 [kW*h];).
  • Pisz reguły, gdy tylko wiadomo, że jakaś kombinacja jest niedozwolona. Werdykty od razu wychwytują wtedy błędną konfigurację.
  • Nazywaj konfiguracje od produktu, a nie od wyborów (plugInHybrid, a nie largePackWallbox).
  • Używaj jednego widoku na linię produktów i przełączaj go między konfiguracjami zamiast tworzyć jeden widok na konfigurację.

Typowe błędy

  • Konfiguracja nie jest wymieniona pod swoją linią produktów. Musi być typowana linią produktów (part x : CarLine). Sprawdź jej pole Typ w inspektorze.
  • Werdykt pozostaje Nieznana. Reguła odczytuje wartość, która w tej konfiguracji nie istnieje. Wybierz wariant dla każdego punktu lub nadaj wartości wartość domyślną.
  • Wybór jest odrzucany. Wariant nie należy do wariantów danego punktu. Wybierz z listy w inspektorze lub popraw nazwę w tekście.

Powiązania z innymi funkcjami

  • Edytor: Wstaw ▾ zapisuje Zmienność, Wariant, Konfigurację i Wybór wariantu. Wszystko tutaj to zwykły tekst SysML v2, więc odczytują go importy, eksporty i inne narzędzia SysML v2.
  • Analizy kompromisów: konfiguracje i warianty jako warianty analizy.
  • Diagramy blokowe niezawodności: warianty punktu zmienności są alternatywami, więc diagram uwzględnia tylko wariant wybrany przez konfigurację w Wyświetl jako ▾. Gdy wyświetlane są wszystkie konfiguracje, punkt jest jednym blokiem z własnymi wartościami, a panel informuje o konieczności wyboru konfiguracji.
  • Kontrole modelu: Weryfikacja → Kontrole modelu zgłasza każdą konfigurację, która narusza regułę lub pozostawia punkt zmienności bez wariantu (ProductLine.3, błąd). Uwaga zawiera werdykt, na przykład Narusza regułę wallboxNeedsLargePack, a naruszone reguły są wymienione jako elementy powiązane. Napraw → Otwórz element otwiera konfigurację. API i MCP zgłaszają to samo ustalenie (run_model_checks, GET …/model-checks).
  • Wnioski o zmianę i historia: każda zmiana jest zwykłą zmianą modelu, a jedno polecenie Cofnij wycofuje każdą z nich.

Przeglądarka

  • Ikony: ułożone pola dla linii produktów, romb dla punktu zmienności, wypełniony romb dla wariantu, suwaki dla konfiguracji. Każda ikona ma etykietkę.
  • Grupa Konfiguracje: pierwsza składowa wiersza linii produktów. Wymienia konfiguracje linii produktów, gdziekolwiek są zadeklarowane; każdy wiersz w niej oznacza samą konfigurację. Jej menu wiersza ma pozycję Nowa konfiguracja….
  • Menu wiersza: Nowa konfiguracja… przy linii produktów i przy każdej z jej konfiguracji.
  • Czytniki ekranu: nazwa wiersza mówi, czym on jest, na przykład CarLine, part def, linia produktów lub plugInHybrid, part, konfiguracja CarLine.

Inspektor

Linia produktów

  • Punkty zmienności: każdy punkt z wariantami, spośród których wybiera.
  • Reguły: asercje ograniczeń linii produktów lub Brak reguł: dozwolona jest każda kombinacja wariantów.
  • Konfiguracje: tabela konfiguracji i ich werdyktów.
  • Kombinacje: ile kombinacji wariantów istnieje i ile z nich reguły dopuszczają, wykluczają lub pozostawiają jako nieznane.
  • Nowa konfiguracja…

Konfiguracja

  • Konfiguruje: linia produktów.
  • Stan: werdykt, ogłaszany czytnikom ekranu, gdy się zmienia.
  • Jedna lista na punkt zmienności: wybrany wariant lub Nie wybrano. Jedno polecenie Cofnij wycofuje zmianę.
  • Reguły: każda reguła jako Spełniona, Naruszona lub Nieznana.
  • Pokaż w widoku ▾: widoki ogólne, połączeń i siatki, które pokazują linię produktów, otwierane jako ta konfiguracja.

Punkt zmienności i wariant

  • Punkt zmienności wymienia swoje Warianty, a w polu Wybrane przez to, co wybiera każda konfiguracja.
  • Wariant pokazuje, czego jest wariantem (Wariant), i które konfiguracje go wybierają.

Wyświetl jako konfigurację

  • Gdzie: górny pasek, gdy model ma konfigurację. Jeden wybór na kartę przeglądarki: stosują go widoki ogólne, połączeń i siatki, Baza danych, inspektor i strona Linia produktów.
  • Kontrolka: Wyświetl jako ▾ (do czasu wyboru widnieje tam Wszystkie konfiguracje ▾). Menu wymienia Wszystkie konfiguracje, konfiguracje każdej linii produktów z ich werdyktami, Zakres obowiązywania ▸ (pokazanie modelu dla numeru seryjnego, daty produkcji lub obu: Numer seryjny i data… to egzemplarz o tym numerze seryjnym wyprodukowany w tym dniu) oraz Zarządzaj linią produktów. Baner pod górnym paskiem ma przyciski Zmień ▾ i Opuść.
  • Co się zmienia: warianty, których konfiguracja nie wybiera, oraz pozostałe konfiguracje tej samej linii produktów są ukryte wraz z tym, co posiadają. Punkty zmienności pokazują swój wybór. Układy nie są przestawiane i są wspólne dla wszystkich konfiguracji.
  • Edycja: plany Individual i Team. Edycje podlegają zasadom opisanym w Pokazywanie modelu jako jednej konfiguracji. W planie Free i dla osób z dostępem tylko do wglądu widok jest tylko do odczytu, a baner wyjaśnia dlaczego.
  • Siatka: Tabela pomija ukryte elementy i podaje wybory nad tabelą. Macierz pokazuje całą linię produktów.
  • Na kartę: wybór jest zachowywany dla karty przeglądarki do czasu jego zmiany. Obrazy widoku na liście Diagramy pokazują całą linię produktów.
  • Czytniki ekranu: przełączenie ogłasza konfigurację i liczbę elementów, których dotyczy, na przykład Wyświetlana konfiguracja: plugInHybrid. … elementów., z dodanym Tylko odczyt., gdy edycja nie jest możliwa.

Komunikaty

WiadomośćCo zrobić
Model nie ma jeszcze punktów zmienności. Dodaj zmienność w Edytorze (Wstaw ▾ → Zmienność), a następnie spróbuj ponownie.Najpierw oznacz punkt zmienności.
Model nie ma jeszcze konfiguracji ani wariantów. … (+ Z linii produktów…)Najpierw dodaj punkt zmienności lub konfigurację.
Wpisz nazwę konfiguracji.Wpisz nazwę w polu Nazwa.
Nazwa … jest już używana w …. Wybierz inną nazwę.Inny element w tym samym pakiecie ma tę nazwę.
Nazwy mają od 1 do 1,000 znaków i nie zawierają podziałów wierszy. Zmień nazwę.Skróć nazwę lub usuń podział wiersza.
Odrzucony wybór lub odrzucona konfiguracjaDodałby błąd do modelu; komunikat wskazuje ten błąd. Popraw tekst lub wybierz inny wariant.
Mechanizm sprawdzający SysML jest niedostępny, więc nie można odczytać punktów zmienności.Załaduj stronę ponownie lub utwórz konfigurację w Edytorze za pomocą Wstaw ▾ → Konfiguracja.

Limity

  • W przypadku bardzo dużej linii produktów liczba kombinacji obejmuje sprawdzenie tylko pierwszych kombinacji; konfiguracje są zawsze sprawdzane w całości.
  • W planie Free widok pokazany jako jedna konfiguracja jest tylko do odczytu.
  • Jeszcze nie: wydawanie lub wycofywanie konfiguracji SysML v2. Każda konfiguracja SysML v2 ma stan Wersja robocza, więc zarządzanie konfiguracją jej nie blokuje.
  • Zmienność obejmuje model SysML v2. Elementy Holarch obok niego (ryzyka, testy, zadania, sekcje dokumentów) dotyczą każdej konfiguracji, z wyjątkiem tych utworzonych podczas wyświetlania konfiguracji: te dotyczą tej konfiguracji. Ich pola Dotyczy nie można jeszcze edytować w projekcie SysML v2.

SysML® i OMG® są zastrzeżonymi znakami towarowymi Object Management Group, Inc. w Stanach Zjednoczonych i innych krajach.