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.
Na tej stronie
- Przegląd
- Pojęcia
- Jak z niego korzystać
- Kiedy i dlaczego
- Oznaczanie punktu zmienności
- Dodawanie reguły
- Tworzenie konfiguracji
- Zmiana wyborów konfiguracji
- Wyświetlanie modelu jako jednej konfiguracji
- Porównywanie konfiguracji w analizie kompromisów
- Przykład: projekt demonstracyjny Hybrid Car
- Wskazówki i dobre praktyki
- Typowe błędy
- Powiązania z innymi funkcjami
- Przeglądarka
- Inspektor
- Wyświetl jako konfigurację
- Komunikaty
- Limity
- 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 jakpart 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:
| Werdykt | Znaczenie |
|---|---|
| Poprawna | Dla każdego punktu wybrano jeden wariant i każda reguła jest spełniona. |
| Narusza regułę … | Reguła jest naruszona; werdykt ją wskazuje. |
| Niekompletna | Punkt nie ma jeszcze wybranego wariantu; werdykt go wskazuje. |
| Nieznana | Nie 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
- Otwórz Edytor i pakiet zawierający projekt.
- Wewnątrz definicji linii produktów wybierz Wstaw ▾ → Zmienność. Uzupełnij nazwę i typ punktu.
- Wewnątrz zmienności wybierz Wstaw ▾ → Wariant raz dla każdego wyboru.
- 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
- 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 }. - 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
- W Przeglądarce otwórz menu wiersza (⋯, kliknięcie prawym przyciskiem lub Shift+F10) linii produktów lub jej grupy Konfiguracje.
- Wybierz Nowa konfiguracja….
- Sprawdź pole Konfiguruje: linię produktów, do której należy konfiguracja.
- Wpisz Nazwa, na przykład
longRangeHybrid. - 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.
- 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
- Zaznacz konfigurację w Przeglądarce (lub w widoku).
- 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
- 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.
- 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
- Otwórz Ryzyka, problemy i decyzje → Analizy kompromisów i analizę (lub kliknij + Nowa analiza kompromisów).
- W sekcji Warianty kliknij + Z linii produktów….
- W polu Z wybierz Konfiguracje: … (linia produktów) lub Warianty: … (punkt zmienności).
- 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.
- Otwórz Model → Przeglądarka i rozwiń Vehicles.
BatteryPackiCarLinemają ikony linii produktów;CarLinema grupę Konfiguracje zlongRangeHybrid,plugInHybridiselfChargingHybrid. - Zaznacz
CarLine. Sekcja Linia produktów wymienia punktypack(standardPack, largePack) icharger(noCharger, wallbox), regułęwallboxNeedsLargePackoraz trzy konfiguracje, wszystkie z werdyktem Poprawna. Podaje 4 kombinacje: 3 dopuszczone przez reguły i 1 wykluczoną (wallbox ze standardowym pakietem akumulatorów). - Zaznacz
selfChargingHybridi zmień charger na wallbox. Werdykt zmienia się na Narusza regułę wallboxNeedsLargePack. Naciśnij ⌘Z / Ctrl+Z, aby cofnąć. - Otwórz widok
carLineVariants(Diagramy). Wybierz Wyświetl jako ▾ → plugInHybrid. PoleBatteryPackzachowuje tylkolargePack, a poleCarLinepokazuje pack : BatteryPack = largePack i variation charger : Component = wallbox. - 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 nielargePackWallbox). - 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 konfiguracja | Dodał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.
Powiązane strony
- Notacja tekstowa SysML v2: zmienności, warianty i konfiguracje
- Widoki SysML v2
- Analiza SysML v2: analizy kompromisów
SysML® i OMG® są zastrzeżonymi znakami towarowymi Object Management Group, Inc. w Stanach Zjednoczonych i innych krajach.