SysML v2
Edytor tekstu i Przeglądarka
Pisz i sprawdzaj tekst SysML v2 w Edytorze, przeglądaj drzewo modelu w Przeglądarce, utrzymuj synchronizację tekstu i widoków oraz przywracaj usunięte elementy z Kosza.
Na tej stronie
Przegląd
Edytor (Model → Edytor) edytuje model SysML v2 jako tekst. Przeglądarka (Model → Przeglądarka) pokazuje ten sam model jako drzewo pakietów i ich składowych.
Oba działają na jednym modelu. Wpisany tekst jest stosowany do modelu, gdy zostanie poprawnie przeanalizowany. Zmiana wprowadzona w dowolnym innym miejscu, na przykład w widoku, tabeli lub inspektorze, od razu pojawia się w tekście. Przyciski Pokaż w tekście i Otwórz tekst w całej aplikacji otwierają Edytor w miejscu elementu.
Pojęcia
Dokumenty tekstowe
Edytor pokazuje jeden dokument tekstowy na każdy pakiet najwyższego poziomu. Lista Pakiety po lewej stronie przełącza między nimi. Elementy najwyższego poziomu, które nie należą do pakietu, mają wspólny dodatkowy dokument Poza pakietami.
Projekt nie przechowuje plików: dokumenty są generowane z modelu. Aby uzyskać pliki .sysml, wyeksportuj model (zobacz Wymiana modeli SysML v2).
Stosowanie tekstu do modelu
Pisanie początkowo zmienia tylko tekst. Tekst jest stosowany do modelu w punkcie zatwierdzenia:
- gdy na chwilę przestaniesz pisać (około 0.6 s);
- gdy opuścisz edytor;
- gdy naciśniesz ⌘S / Ctrl+S lub ⌘↩ / Ctrl+Enter.
Każde zatwierdzenie można cofnąć jednym poleceniem Cofnij. Holarch porównuje tekst z modelem i zmienia tylko to, co się różni, więc elementy zachowują swoją tożsamość. Element o zmienionej nazwie pozostaje tym samym elementem: jego położenie w widokach, komentarze, powiązania śledzenia i łącza podążają za nim.
Błędy i wersje robocze
Tekst z błędem nie przepada. Składowe, które są poprawnie analizowane, zostają zastosowane; składowa z błędem nie jest stosowana i zachowuje w modelu ostatni poprawny stan. Wiersz stanu pokazuje Nie zastosowano: popraw wiersz N.
Tekst, który nie został jeszcze zastosowany, pozostaje wersją roboczą w tej przeglądarce, dopóki nie zostanie poprawnie przeanalizowany. Przy ponownym otwarciu pakietu baner informuje: Ten tekst zawiera zmiany z <date>, które nie zostały zastosowane do modelu. Popraw tekst, aby go zastosować, lub kliknij Odrzuć wersję roboczą, aby wrócić do tekstu modelu.
Wersje robocze są przechowywane tylko w przeglądarce, w której zostały wpisane. Inne osoby widzą ostatni poprawny stan modelu.
Jak z niego korzystać
Otwieranie tekstu pakietu
- Otwórz Model → Edytor. Otwiera się pierwszy pakiet. Jeśli model nie ma pakietów, kliknij + Nowy pakiet.
- Kliknij pakiet na liście Pakiety, aby otworzyć jego tekst.
- Aby przejść do elementu, użyj Pokaż w tekście w Przeglądarce, inspektorze lub widoku. Edytor otwiera jego pakiet i zaznacza jego deklarację.
Edycja i stosowanie tekstu
- Pisz jak w każdym edytorze kodu. Enter zachowuje wcięcie i dodaje wcięcie po
{; wpisanie}wyrównuje go z wierszem otwierającym. - Przestań pisać. Wiersz stanu pod tekstem pokazuje Jeszcze nie zastosowano, potem Stosowanie…, a następnie Zastosowano. Przeglądarka, widoki i strony pokazują teraz zmianę.
- Naciśnij ⌘Z / Ctrl+Z, aby cofnąć pisanie. Gdy w Edytorze nie ma już pisania do cofnięcia, ⌘Z / Ctrl+Z cofa ostatnią zmianę projektu, tak jak wszędzie indziej w Holarch.
Zmiana, która tylko przeformatowuje tekst, pokazuje Brak zmian w modelu.
Wstawianie konstrukcji
Wstaw ▾ zapisuje konstrukcję SysML za użytkownika, na przykład część z jej typem i krotnością.
- Umieść kursor w pustym wierszu w treści, do której należy konstrukcja.
- Kliknij Wstaw ▾ w nagłówku strony lub naciśnij ⌃⇧Space / Ctrl+Shift+Space. Lista pokazuje tylko konstrukcje pasujące w miejscu kursora, w czterech grupach: Struktura, Zachowanie, Wymagania i Inne. Jej nagłówek podaje bieżące położenie, na przykład Poziom pakietu lub Wewnątrz definicji części.
- Pisz, aby filtrować listę. Podgląd pokazuje tekst i jego znaczenie.
- Naciśnij Enter (lub kliknij), aby wstawić konstrukcję w osobnym wierszu.
- Wpisz tekst w miejsce zaznaczonego pola (nazwy, typu lub krotności), a następnie naciśnij Tab, aby przejść do następnego pola. ⇧Tab / Shift+Tab wraca. Pola typów wymieniają definicje modelu: naciśnij Enter (lub wybierz za pomocą ↑ ↓), aby przyjąć jedną z nich; Tab zachowuje wpisany tekst.
- Naciśnij Tab po ostatnim polu lub Esc, aby opuścić fragment. Konstrukcja zostaje zastosowana do modelu.
Uzupełnianie oferuje te same fragmenty: wpisanie par proponuje słowo kluczowe part i fragment Część.
Uzupełnianie nazw i słów kluczowych
- Wpisz dwie litery nazwy lub słowa kluczowego albo
::lub.po nazwie. Możesz też nacisnąć ⌃Space / Ctrl+Space. Lista proponuje słowa kluczowe, nazwy i fragmenty pasujące w miejscu kursora. - Poruszaj się za pomocą ↑ i ↓ (PageUp i PageDown przeskakują o 8 wierszy).
- Naciśnij Enter lub Tab, aby przyjąć, albo Esc, aby zamknąć listę. Lista otwarta podczas pisania zamyka się też po 4 sekundach bez naciśnięcia klawisza, gdy nazwa jest kompletna, gdy nic nie pasuje albo gdy kursor zostanie przesunięty lub edytor opuszczony.
Przechodzenie do definicji i zmiana nazwy
- Wskaż nazwę, aby zobaczyć kartę z jej rodzajem, nazwą kwalifikowaną i dokumentacją oraz ewentualnym problemem. ⌘I / Ctrl+I pokazuje tę samą kartę z klawiatury. Karta zamyka się po edycji, naciśnięciu Esc, przewinięciu, opuszczeniu edytora lub odsunięciu wskaźnika i nigdy nie zasłania listy uzupełniania.
- Kliknij nazwę z klawiszem ⌘ / Ctrl lub naciśnij F12, aby przejść do jej deklaracji. Deklaracja w innym pakiecie otwiera ten pakiet.
- Aby zmienić nazwę, umieść kursor na zadeklarowanej nazwie i naciśnij F2. Wpisz Nowa nazwa i potwierdź. Każde odwołanie do niej zmienia się we wszystkich pakietach, a jedno polecenie Cofnij wycofuje całość. Komunikat brzmi Zmieniono nazwę na “name”.
Znajdowanie i zastępowanie
- Naciśnij ⌘F / Ctrl+F lub kliknij Znajdź w nagłówku strony.
- Wpisz szukany tekst. Pasek pokazuje n z m dopasowań.
- W razie potrzeby włącz Aa (uwzględniaj wielkość liter), W (całe słowo) lub .* (wyrażenie regularne).
- Naciśnij Enter lub ⌘G / Ctrl+G, aby przejść do następnego dopasowania, a ⇧Enter / Shift+Enter lub ⇧⌘G / Ctrl+Shift+G, aby przejść do poprzedniego.
- Kliknij Zamień…, wpisz tekst zastępczy, a następnie kliknij Zamień (to dopasowanie) lub Zamień wszystko.
- Naciśnij Esc lub kliknij ✕, aby zamknąć pasek.
Poprawianie błędów
- Spójrz na wiersz stanu: podaje liczbę problemów, na przykład 2 błędy, 1 ostrzeżenie, lub komunikat Brak problemów.
- Naciśnij F8, aby przejść do następnego problemu (⇧F8 / Shift+F8: do poprzedniego). Możesz też kliknąć znacznik na marginesie. Problem zostaje zaznaczony i pojawia się jego komunikat: najpierw problem, potem sposób poprawki.
- Popraw tekst. Gdy składowa zostanie poprawnie przeanalizowana, zostaje zastosowana.
Przeglądanie drzewa modelu
- Otwórz Model → Przeglądarka.
- Kliknij ▸ obok pakietu, aby go otworzyć, lub kliknij Rozwiń wszystko.
- Wpisz tekst w polu Filtruj według nazwy lub wybierz rodzaj, na przykład part def, w Wszystkie rodzaje. Drzewo pokazuje dopasowania wraz z ich właścicielami. Licznik pokazuje n z N elementów.
- Zaznacz element, aby zobaczyć jego szczegóły w inspektorze.
- Kliknij go dwukrotnie lub naciśnij Enter, aby pokazać go w Edytorze.
Usuwanie i przywracanie elementów
- W Przeglądarce otwórz menu wiersza (⋯, kliknięcie prawym przyciskiem lub Shift+F10) i wybierz Usuń…. Potwierdź. Element i jego składowe trafiają do Kosz projektu. Usunięcie tekstu w Edytorze ma ten sam skutek.
- Aby go przywrócić, otwórz narzędzie Kosz na dole paska nawigacji i kliknij Przywróć w jego wierszu. Wraca z tą samą tożsamością, więc odwołania do niego znów są rozpoznawane.
Przykład: dodanie czujnika koła do Hybrid Car
Ten przykład korzysta z projektu demonstracyjnego Hybrid Car (SysML v2).
- Otwórz Model → Edytor i kliknij Vehicles na liście Pakiety.
- Znajdź
part def Wheel :> Component. Umieść kursor w nowym pustym wierszu wewnątrz jego treści, poport hub : ~TorquePort;. - Naciśnij ⌃⇧Space / Ctrl+Shift+Space. Nagłówek pokazuje Wewnątrz definicji części. Wpisz
atti naciśnij Enter, aby wstawić Atrybut. - Wpisz
speedSensorMassw polu nazwy, naciśnij Tab, wpiszMassValuew polu typu i ponownie naciśnij Tab, aby opuścić fragment. Wiersz ma postaćattribute speedSensorMass : MassValue;i zostaje zastosowany. - Wpisz
= 0.2 [kg]przed;i przestań pisać. Wiersz stanu pokazuje Zastosowano. - Otwórz Model → Przeglądarka i wpisz
speedSensorw polu Filtruj według nazwy. Atrybut pojawia się pod Vehicles › Wheel; jego inspektor pokazuje Właściciel Wheel i Typowany przez MassValue. - Z powrotem w Edytorze naciśnij F2 na
speedSensorMass, wpiszsensorMassi potwierdź. Przeglądarka pokazuje nową nazwę. - Usuń wiersz i zrób przerwę w pisaniu. Atrybut trafia do Kosz; przywróć go tam przyciskiem Przywróć.
Wskazówki i typowe błędy
- Zapisywanie jest automatyczne. ⌘S / Ctrl+S tylko natychmiast stosuje tekst; nie ma nic innego do zapisania.
- Jeden błąd nie blokuje reszty. Składowe przed uszkodzoną składową i po niej są nadal stosowane.
- Pisanie równocześnie ze współpracownikiem. Jeśli model zmienił się podczas pisania, Holarch scala tekst z nowym modelem. Gdy obie strony zmieniły tę samą składową, wybierz Zachowaj moje lub Przyjmij ich.
- Zmiana nazwy przez ponowne wpisanie. Zmiana nazwy w miejscu również zachowuje element (Holarch dopasowuje go według położenia i rodzaju), ale odwołania w innych miejscach nadal używają starej nazwy i przestają być rozpoznawane. Użyj F2, aby zmienić nazwę wszędzie.
- Usuwanie używanego elementu. Gdy usunięty tekst usuwa element, którego używają inne elementy lub widoki, Holarch najpierw pyta. Anuluj, aby go zachować; tekst pozostaje wtedy niezastosowany, dopóki nie naciśniesz ⌘S / Ctrl+S, aby zdecydować ponownie.
- Na limicie elementów. Gdy tekst dodaje elementy, przez które projekt przekroczyłby limit elementów planu, nic z tej zmiany nie zostaje zastosowane. Tekst pozostaje wersją roboczą, a wiersz stanu pokazuje Nie zastosowano: projekt przekroczyłby limit 1,000 elementów. Usuń nowe deklaracje lub nieużywane elementy. W projekcie SysML v2 elementami są elementy modelu inne niż relacje: liczą się pakiety, definicje i użycia (części, atrybuty, odwołania, porty, akcje, stany, wymagania, …), a relacje nie (importy i ekspozycje, połączenia, interfejsy, przepływy, wiązania, następstwa, przejścia, alokacje, spełnienia i weryfikacje, zależności, podklasyfikacje, typowania, podzbiory, redefinicje). Projekt demonstracyjny Hybrid Car ma 549 elementów, a Earth Observation Satellite 1,549, więc w planie Free Nowy projekt demonstracyjny wyłącza pozycję Earth Observation Satellite z komunikatem “Wymaga planu Individual (1,549 elementów)”. Zobacz Plany i limity.
Edytor
Układ
- Pakiety (po lewej): jedna pozycja na każdy pakiet najwyższego poziomu oraz w razie potrzeby Poza pakietami. Liczba po otwartym pakiecie podaje liczbę jego błędów. We wspólnym projekcie inicjały pokazują, kto jeszcze ma otwarty pakiet.
- Nagłówek strony: + Nowy pakiet, Wstaw ▾ i Znajdź.
- Obszar tekstu: wyróżnianie składni, numery wierszy i margines ze znacznikami problemów. Kliknij numer wiersza, aby zaznaczyć wiersz; kliknij znacznik, aby zaznaczyć problem i pokazać jego komunikat.
- Wiersz stanu (pod tekstem): położenie kursora (Ln 12, Col 5), liczba problemów i stan stosowania.
Czytelnicy widzą tekst tylko do odczytu.
Konstrukcje Wstaw ▾
| Grupa | Konstrukcje |
|---|---|
| Struktura | Pakiet, Definicja części, Część, Atrybut, Definicja atrybutu, Definicja portu, Port, Interfejs, Połączenie, Definicja alokacji, Alokacja, Obiekt, Wyliczenie, Zmienność, Wariant, Konfiguracja, Wybór wariantu |
| Zachowanie | Definicja akcji, Akcja, Następstwo, Definicja stanu, Stan, Przejście, Przepływ, Akcja następna, Wykonanie, Rozwidlenie, Decyzja, Złączenie, Scalenie, Przyjęcie, Wysłanie, Przypisanie, If, Pętla while, Pętla for, Akcje stanu, Stan początkowy, Przejście z przyjęciem, Definicja stanu równoległego, Wykazywany stan, Komunikat |
| Wymagania | Definicja wymagania, Wymaganie, Wartość TBD, Wartość TBR, Definicja weryfikacji, Spełnienie, Weryfikacja, Ograniczenie, Obliczenie, Podmiot, Aktor, Interesariusz, Założenie, Przypadek użycia, Przypadek analizy, Zagadnienie, Punkt widzenia, Widok |
| Inne | Import, Alias, Komentarz, Dokumentacja |
Każda konstrukcja jest proponowana tylko tam, gdzie jest poprawna. Wartość TBD i Wartość TBR wymagają private import HolarchMetadata::*; w pakiecie (zobacz Oznaczanie wartości jako TBD lub TBR). Wariant jest proponowany tylko wewnątrz zmienności, która zawiera wyłącznie swoje warianty. Konfiguracja zapisuje użycie oznaczone @HolarchConfiguration i wymaga private import HolarchVariability::*;; wewnątrz niej Wybór wariantu wybiera wariant jednego punktu zmienności (zobacz Zmienności, warianty i konfiguracje).
Skróty klawiszowe
W systemach Windows i Linux używaj Ctrl zamiast ⌘. / Ctrl+.
| Klawisze | Czynność |
|---|---|
| ⌘S / Ctrl+S lub ⌘↩ / Ctrl+Enter | Zastosuj tekst teraz |
| ⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Z | Cofnij / ponów (w systemach Windows i Linux Ctrl+Y również ponawia) |
| ⌃Space / Ctrl+Space | Uzupełnij w miejscu kursora |
| ⌃⇧Space / Ctrl+Shift+Space | Otwórz Wstaw ▾ |
| Tab / ⇧Tab / Shift+Tab | Zwiększ / zmniejsz wcięcie; we fragmencie następne / poprzednie pole |
| Esc, a następnie Tab | Opuść edytor (w przeciwnym razie Tab dodaje wcięcie) |
| ⌘/ / Ctrl+/ | Dodaj lub usuń komentarz // w zaznaczonych wierszach |
| ⌘F / Ctrl+F | Znajdź; ⌥⌘F / Ctrl+Alt+F otwiera wyszukiwanie z zamianą |
| ⌘G / Ctrl+G lub F3 / ⇧⌘G / Ctrl+Shift+G | Następne / poprzednie dopasowanie |
| F8 / ⇧F8 / Shift+F8 | Następny / poprzedni problem |
| F12 lub kliknięcie z ⌘ / Ctrl | Przejdź do deklaracji |
| F2 | Zmień nazwę w miejscu kursora wszędzie |
| ⌘I / Ctrl+I | Pokaż kartę informacji w miejscu kursora |
Tekst i widoki pozostają zsynchronizowane
Tekst, widoki, tabele i inspektor to różne sposoby edycji jednego modelu.
- Z tekstu do modelu. Tekst jest stosowany w każdym punkcie zatwierdzenia, a jedno polecenie Cofnij wycofuje całość. Widoki, tabele i strony aktualizują się natychmiast.
- Z modelu do tekstu. Zmiana w widoku, Przeglądarce, tabeli, inspektorze, wniosku o zmianę lub cofnięcie jest od razu zapisywana w tekście. Jeśli w tym samym pakiecie jest niezastosowany tekst, Holarch scala go ze zmianą; zobacz Praca z innymi.
- Każda zmiana jest najpierw sprawdzana. Edycja widoku jest zapisywana jako tekst SysML i sprawdzana przed zastosowaniem. Jeśli nie da się jej zapisać jako poprawnego tekstu, zostaje odrzucona: Zmiany nie można zapisać jako tekstu SysML: …. Na przykład warunek dozoru, który nie jest poprawnym wyrażeniem, zostaje odrzucony w widoku przepływu akcji.
- Formatowanie zostaje zachowane. Elementy, które nie zostały zmienione, zachowują dokładny tekst, w tym komentarze, puste wiersze i pisownię słów kluczowych (na przykład
subsetszamiast:>). Zmieniona część elementu lub nowy element są zapisywane w standardowym układzie, z wcięciem takim jak u sąsiednich elementów. - Układy zostają zachowane. Położenia w widokach są przechowywane według tożsamości elementu. Edycja elementu lub zmiana jego nazwy w tekście zachowuje jego miejsce w każdym widoku.
Dane Holarch (stan, wyniki, etykiety, układy, ustawienia symulatora) nigdy nie są zapisywane w tekście. Zobacz Dane modelu i dane Holarch.
Praca z innymi
We wspólnym projekcie kilka osób może jednocześnie edytować model.
- Lista Pakiety pokazuje inicjały innych osób, które mają otwarty tekst pakietu. Wskaż je, aby zobaczyć nazwiska.
- Gdy model zmienia się podczas pisania, Holarch scala niezastosowany tekst ze zmianą, składowa po składowej. Przy czystym scaleniu można pisać dalej.
- Gdy Ty i ktoś inny zmieniliście tę samą składową, baner informuje: Element <Package> zmienił się podczas pisania. Kliknij Zachowaj moje, aby zastosować swój tekst zamiast cudzego, lub Przyjmij ich, aby zastąpić swój tekst tekstem modelu.
- Jeśli ktoś usunie lub przeniesie otwarty pakiet, baner informuje: Ten pakiet został usunięty lub przeniesiony. Jego tekst pozostaje tutaj do opuszczenia strony.
Przeglądarka
Przeglądarka pokazuje model jako drzewo: pakiety najwyższego poziomu, a pod nimi ich składowe w kolejności.
Nagłówek strony i filtry
- Rozwiń wszystko i Zwiń wszystko otwierają lub zamykają każdy element. Przeglądarka zapamiętuje w tej przeglądarce, co jest otwarte.
- Filtruj według nazwy dopasowuje nazwy i nazwy skrócone.
- Wszystkie rodzaje ogranicza drzewo do jednego rodzaju, na przykład part def, requirement lub port. Wymienione są tylko rodzaje występujące w modelu. Indywidua (wymienione, gdy model zawiera indywidua) pokazuje każdy element zadeklarowany jako
individual, dowolnego rodzaju. - Przy filtrze drzewo pokazuje dopasowania wraz z ich właścicielami, wszystkie rozwinięte. Licznik pokazuje n z N elementów.
Wiersze
Każdy wiersz pokazuje rodzaj elementu, jego nazwę i nazwę skróconą w nawiasach ostrych (<VR-1.1>). Elementy bez nazwy są wyświetlane jako (unnamed kind), na przykład (unnamed succession), z następującymi wyjątkami:
- Deklaracja zapisana tylko z własnym słowem kluczowym pokazuje to słowo kluczowe jako swój rodzaj, na przykład #fault def dla
#fault def BatteryOverheat;. - Wyzwalacz i efekt przejścia są składowymi przejścia. Są wyświetlane jako trigger i effect, nazwane swoim tekstem, na przykład trigger StartRequest.
- Nienazwana akcja zakończenia jest wyświetlana jako terminate lub terminate drive, gdy wskazuje, co kończy.
- Indywidua, migawki i wycinki czasu pokazują swoje słowa kluczowe wraz z rodzajem, na przykład individual part def, snapshot lub timeslice part, po ikonie: pierścień dla indywiduum, kropka na osi czasu dla migawki, pasek na osi czasu dla wycinka czasu.
Inspektor
Zaznacz element, aby zobaczyć go w inspektorze, czyli tym samym panelu elementu co na stronie Baza danych. Jego grupy:
- Definicja (Wymaganie w przypadku wymagania): nazwa skrócona, nazwa, dokumentacja i etykiety.
- Przepływ pracy: pasek przeglądu wymagania, osoba przypisana, termin i obserwowanie.
- Cechy: typ lub specjalizacja, krotność, wartość, definicja lub jej użycia oraz Wystąpienie: pole wyboru Indywidualne, a dla użycia Całe istnienie, Wycinek czasu lub Migawka. Atrybuty, wyliczenia i zwykłe odwołania nie są wystąpieniami, więc te kontrolki są wyłączone.
- Połączenie (nazwy końców i krotności połączenia), Przejście (wyzwalacz, warunek dozoru i efekt przejścia) oraz Zakończ (co kończy akcja zakończenia), tam gdzie mają zastosowanie.
- Reprezentacja: reprezentacje tekstowe elementu, każda z polem Język, na przykład
Python, i tekstem treści, z przyciskami Dodaj reprezentację i Usuń. Ustalenia mechanizmu sprawdzającego dotyczące treści SysML i KerML są pokazywane pod nimi. - Symulacja (tam gdzie ma zastosowanie), Śledzenie, Dyskusja i Szczegóły (rodzaj, nazwa kwalifikowana, właściciel, historia).
Edycje są zapisywane w modelu, a jedno polecenie Cofnij wycofuje każdą z nich. Zobacz Funkcje Holarch.
Menu wiersza
Otwórz je za pomocą ⋯ w wierszu, kliknięcia prawym przyciskiem, Shift+F10, klawisza menu kontekstowego lub F2.
| Element | Działanie |
|---|---|
| Otwórz widok elementu | Otwiera element na osobnej stronie, tak jak widok elementu LML |
| Pokaż w tekście | Otwiera pakiet elementu w Edytorze i zaznacza jego deklarację |
| Pokaż na diagramie Spider | Otwiera Diagram Spider wyśrodkowany na elemencie (tam gdzie ma zastosowanie) |
| Eksportuj jako .sysml, Eksportuj jako JSON | Dla pakietu: pobiera go jako tekst SysML lub SysML v2 JSON |
| Nowa migawka…, Nowy wycinek czasu… | Dla definicji lub użycia wystąpienia: pyta o nazwę i dodaje migawkę lub wycinek czasu jako ostatnią składową |
| Zmień nazwę… | Zmienia nazwę elementu; odwołania podążają za nią |
| Usuń… | Po potwierdzeniu przenosi element i jego składowe do Kosza projektu |
Klawiatura
| Klawisze | Czynność |
|---|---|
| ↑ / ↓ | Poprzedni / następny wiersz |
| Home / End | Pierwszy / ostatni wiersz |
| → | Otwórz element lub przejdź do jego pierwszej składowej |
| ← | Zamknij element lub przejdź do jego właściciela |
| Enter | Pokaż w tekście |
| F2, Shift+F10 | Otwórz menu wiersza |
Elementy, które nie są interpretowane
Elementy rodzajów, których Holarch nie interpretuje, zachowane z importu SysML v2 JSON, pokazują w Przeglądarce swój oryginalny rodzaj (na przykład behavior) i znacznik Bez interpretacji. Nie mają tekstu: Edytor pomija je i ich składowe, podając nad tekstem ich liczbę, a ich menu wiersza nie ma pozycji Pokaż w tekście ani Zmień nazwę…. Ich inspektor pokazuje rodzaj, identyfikator w pliku i to, na co wskazują ich relacje. Zobacz Elementy, których Holarch nie interpretuje.
Elementy bez właściwego miejsca
Element, którego właściciela brakuje, na przykład gdy współpracownik w tej samej chwili usunął jego pakiet, jest wymieniony w sekcji Niewłaściwie umieszczone (brak właściciela): przenieś je do pakietu. Strona główna również pokazuje kartę Elementy bez właściwego miejsca. Otwórz element w Edytorze i przenieś jego tekst do pakietu.
Usunięte elementy
Usunięcie elementu w projekcie SysML v2 przenosi go do Kosz projektu. Zabiera ze sobą wszystko, co posiada, połączenia i relacje spełnienia, które go wskazują, jego układy w widokach i komentarze.
- Otwórz narzędzie Kosz na dole paska nawigacji. Każdy wiersz pokazuje rodzaj elementu, nazwę, czas usunięcia, przyczynę (Usunięto wraz z 3 składowymi) i czas przechowywania.
- Przywróć przywraca go z tą samą tożsamością, więc odwołania do niego znów są rozpoznawane. Przywróć wszystko przywraca każdą pozycję.
- ⋯ → Podgląd pokazuje jego rodzaj, nazwę skróconą, dokumentację, składowe oraz elementy, które nadal się do niego odwołują (Odwołania z).
- ⋯ → Usuń trwale… od razu usuwa jedną pozycję. Opróżnij kosz usuwa wszystkie. Obie operacje można cofnąć za pomocą ⌘Z / Ctrl+Z.
- Pozycje są usuwane automatycznie po 30 dniach.
Gdy usunięty tekst usuwa element, który jest nadal używany, Edytor najpierw pyta: <n> odwołań i <m> widoków używa <name>. Usunąć go?
Dostępność
Edytor i Przeglądarka działają z samą klawiaturą i z czytnikiem ekranu.
- Edytor to opisane pole tekstowe. Tab dodaje wcięcie; aby opuścić edytor, naciśnij Esc, a potem Tab.
- F8 i Shift+F8 przechodzą do następnego i poprzedniego problemu i odczytują go wraz z wierszem. Problemy są też ogłaszane około sekundy po ich zmianie.
- F12 przechodzi do definicji, F2 zmienia nazwę, ⌘F / Ctrl+F wyszukuje, Ctrl+Space uzupełnia, a Ctrl+Shift+Space otwiera Wstaw. Uzupełnianie i Wstaw to listy, które ogłaszają zaznaczoną pozycję. We fragmencie ogłaszane jest każde pole (“Pole 1 z 3: name”).
- Przeglądarka to drzewo. Każdy wiersz jest odczytywany swoją nazwą i rodzajem, na przykład “Car, definicja części”. Klawisze strzałek poruszają się po nim; → otwiera pakiet, a ← go zamyka. Shift+F10 otwiera menu wiersza.
Komunikaty
| Wiadomość | Znaczenie i rozwiązanie |
|---|---|
| Jeszcze nie zastosowano | Trwa pisanie; tekst zostanie zastosowany po przerwie w pisaniu. |
| Zastosowano / Brak zmian w modelu | Tekst jest w modelu / tekst był już zgodny z modelem. |
| Nie zastosowano: popraw wiersz N. | Składowa zawiera błąd. Popraw wiersz N; reszta tekstu zostaje zastosowana. |
| Nie zastosowano: model zmienił się podczas pisania. Wybierz Zachowaj moje lub Przyjmij ich. | Tekst i inna zmiana dotyczą tej samej składowej. |
| Nie zastosowano: anulowano usunięcie <name>. Naciśnij ⌘S / Ctrl+S, aby zdecydować ponownie. | Usunięcie zostało odrzucone. Przywróć tekst lub naciśnij ⌘S / Ctrl+S i potwierdź. |
| Moduł sprawdzający SysML zatrzymał się. Tekst został zachowany; moduł uruchomiono ponownie. | Mechanizm sprawdzający uruchomił się ponownie. Pisz dalej; tekst jest bezpieczny. |
| Kontrole są wstrzymane: moduł sprawdzający SysML zatrzymał się dwukrotnie. Tekst został zachowany. Wybierz Ponów w powiadomieniu lub załaduj stronę ponownie. | Mechanizm sprawdzający zatrzymał się dwa razy z rzędu, zwykle dlatego, że model jest dla niego za duży, i został wstrzymany. Wybierz Ponów w powiadomieniu lub załaduj stronę ponownie. Zobacz Mechanizm sprawdzający jest wstrzymany. |
| Umieść kursor na nazwie, aby ją zmienić. | Naciśnięto F2 na słowie kluczowym lub pustym miejscu. |
| Popraw błędy w tym tekście przed zmianą nazwy. | Zmiana nazwy wymaga tekstu, który jest poprawnie analizowany. |
| Nie można zmieniać nazw elementów biblioteki. Zmień nazwę jednego z własnych elementów. | Nazwa należy do biblioteki standardowej. |
| Deklaracja znajduje się w bibliotece lub innym pliku i nie można jej tutaj otworzyć. | Przejście do definicji znalazło element biblioteki standardowej. Sprawdź go na stronie Biblioteka standardowa. |
| Nie znaleziono deklaracji “name”. | Nazwa nie jest rozpoznawana. Sprawdź jej pisownię lub importy. |
| <Snippet> nie pasuje w tym miejscu. Przenieś kursor do pustego wiersza w treści, która na to pozwala. | Konstrukcja nie jest poprawna w miejscu kursora. |
| Żaden fragment kodu nie pasuje wewnątrz komentarza ani ciągu znaków. Przenieś kursor poza niego. | Wstaw ▾ otwarto wewnątrz komentarza lub ciągu znaków. |
| Ten wzorzec nie jest poprawnym wyrażeniem regularnym. Popraw go lub wyłącz .* | Wzorzec wyszukiwania nie jest poprawny przy włączonym .*. |
| Ten model nie ma jeszcze pakietów. Utwórz pakiet, aby zacząć pisać w SysML. | Kliknij + Nowy pakiet. |
| Żaden element nie pasuje. Zmień filtr. | Filtr Przeglądarki niczego nie dopasowuje. |
| Nie przywrócono: element już istnieje w modelu. | Element o tej tożsamości już istnieje. |
| Tylko do wglądu: poproś właściciela o dostęp do edycji. | Masz dostęp tylko do wglądu; tekst jest tylko do odczytu. |
Komunikaty mechanizmu sprawdzającego dotyczące samego tekstu SysML są wymienione na stronie Notacja tekstowa SysML v2.
Limity
- Jeden dokument tekstowy na każdy pakiet najwyższego poziomu; projekt nie zawiera plików.
- Dokument większy niż 8 MB, wiersz dłuższy niż 64 KB lub zagnieżdżenie głębsze niż 256 poziomów nie są sprawdzane.
- Nazwa, która sięga przez więcej niż 512 zagnieżdżonych importów lub specjalizacji (pakiet
P2importującyP1, który importujeP0, i tak dalej), jest sprawdzana tylko częściowo; lista problemów wskazuje gdzie. Skróć łańcuch. - Wersje robocze istnieją tylko w przeglądarce, w której zostały wpisane.
- Wyszukiwanie pokazuje najwyżej 10,000 dopasowań (10,000+).
- Usunięte elementy pozostają w Koszu przez 30 dni.
- Mechanizm sprawdzający SysML działa w przeglądarce. W Safari obsługuje modele do około 750,000 wierszy tekstu SysML.
Mechanizm sprawdzający jest wstrzymany
Pojawia się komunikat Ten model jest za duży dla modułu sprawdzającego SysML w tej przeglądarce. Edycja i diagramy nadal działają; kontrole są wstrzymane. (lub Moduł sprawdzający SysML zatrzymał się dwukrotnie na tym modelu…) w powiadomieniu z przyciskiem Ponów.
- Przyczyna: mechanizm sprawdzający zatrzymał się dwa razy z rzędu na tym modelu, najczęściej dlatego, że model jest większy, niż może obsłużyć. Zamiast ponownego uruchomienia zostaje wstrzymany.
- Rozwiązanie: pracuj dalej: strony, diagramy i edycje poza Edytorem nadal działają. Kontrole, wyszukiwanie nazw i stosowanie tekstu z Edytora czekają, aż mechanizm sprawdzający znów zacznie działać. Wybierz Ponów w powiadomieniu lub załaduj stronę ponownie. Jeśli znów się zatrzyma, podziel model na kilka projektów lub wyślij zgłoszenie do pomocy technicznej z rozmiarem projektu.
Powiązane strony
SysML® i OMG® są zastrzeżonymi znakami towarowymi Object Management Group, Inc. w Stanach Zjednoczonych i innych krajach.