Holarch

SysML v2

Wymiana modeli SysML v2

Importuj pliki .sysml, archiwa zip i SysML v2 JSON do projektu SysML v2 z podglądem oraz eksportuj model lub pakiet jako tekst .sysml lub SysML v2 JSON.

Jak z niego korzystać →

Na tej stronie
  1. Przegląd
  2. Pojęcia
    1. Formaty plików
    2. Identyfikatory i dopasowywanie
    3. Identyfikatory elementów w tekście
    4. Foldery stają się pakietami
    5. Co porównuje podgląd
  3. Jak z niego korzystać
    1. Kiedy i dlaczego
    2. Importowanie plików do tego projektu
    3. Importowanie plików do nowego projektu
    4. Aktualizacja pakietu z nowej wersji
    5. Zmiana nazw i przenoszenie elementów w tekście z zachowaniem identyfikatorów
    6. Duże importy w usłudze hostowanej
    7. Eksport modelu lub pakietu
    8. Import i eksport wymagań ReqIF
    9. Pobieranie z repozytorium i wysyłanie do niego
    10. Przykład: projekt demonstracyjny Hybrid Car
    11. Wskazówki i dobre praktyki
    12. Typowe błędy
    13. Powiązania z innymi funkcjami
  4. Strona Import i eksport
    1. Import
    2. Eksport
  5. Repozytorium
  6. Jak odczytywane są pliki
    1. Elementy, których Holarch nie interpretuje
  7. Komunikaty
  8. Limity
  9. Powiązane strony

Przegląd

Projekty SysML v2 wymieniają modele z innymi narzędziami SysML v2 w postaci plików. Strona Import i eksport (Model → Import i eksport) obsługuje obie operacje:

  • Importuj odczytuje pliki .sysml, archiwum .zip z plikami .sysml lub plik SysML v2 JSON. Pokazuje podgląd zmian, a następnie stosuje je w tym projekcie (jedno polecenie Cofnij wycofuje całość) lub tworzy nowy projekt SysML v2.
  • Eksport zapisuje cały model lub jeden pakiet jako tekst SysML v2 (.sysml) lub jako SysML v2 JSON (.json).
  • Pliki ReqIF (.reqif, .reqifz) z narzędzi do zarządzania wymaganiami są importowane jako wymagania SysML v2, a wymagania są eksportowane jako ReqIF: zobacz Import i eksport wymagań ReqIF.

Projekt można też utworzyć bezpośrednio z plików: na stronie Zarządzaj projektami kliknij Pliki projektów ▾ → Importuj pliki SysML v2….

Wskazówka: aby utrzymywać model w zgodzie z repozytorium modeli SysML v2, które udostępnia Systems Modeling API, użyj sekcji Repozytorium na tej samej stronie: zobacz Pobieranie z repozytorium i wysyłanie do niego.

Pojęcia

Formaty plików

FormatZawartośćImportEksport
Tekst SysML v2 (.sysml)Notacja tekstowa, jeden plik na pakiet najwyższego poziomu.TakTak
Archiwum zip (.zip)Kilka plików .sysml. Foldery stają się pakietami.TakTak, gdy eksportowanych jest kilka plików
SysML v2 JSON (.json)Płaska lista elementów, każdy z @id i @type, tak jak w Systems Modeling API.TakTak
ReqIF (.reqif, .reqifz)Wymagania z ich atrybutami, hierarchią i relacjami z DOORS, Polarion, Jama, codebeamer i innych narzędzi do zarządzania wymaganiami.Tak, po przekształceniu w wymaganiaTak, wymagania

Pliki KerML (.kerml) nie są jeszcze importowane.

Identyfikatory i dopasowywanie

Każdy element w projekcie SysML v2 ma identyfikator. Oba formaty przechowują go inaczej:

  • JSON zachowuje identyfikatory. Element ponownie zaimportowany z JSON jest dopasowywany do elementu o tym samym identyfikatorze.
  • Odwołania do biblioteki standardowej są rozpoznawane. JSON z Systems Modeling API, SysML v2 Pilot Implementation lub innego repozytorium wskazuje elementy biblioteki standardowej (jednostki, takie jak ISQ::mass, ScalarValues::Real, Parts::Part) za pomocą standardowych identyfikatorów. Import odczytuje je jako te same elementy biblioteki, więc jednostki i typy pozostają rozwiązane.
  • Tekst zachowuje identyfikatory, gdy o to poprosisz. Zaznacz Dołącz identyfikatory elementów przy eksporcie tekstu .sysml. Każda nazwana definicja, każde nazwane użycie i każdy pakiet mają wtedy swój identyfikator jako pierwszy wiersz treści, @HolarchMetadata::ElementId { id = "…"; }. Gdy ten tekst zostanie ponownie zaimportowany, każdy element z identyfikatorem jest dopasowywany do elementu o tym samym identyfikatorze, nawet jeśli zmieniono jego nazwę, przeniesiono go do innego właściciela lub innego pakietu najwyższego poziomu albo zmieniono kolejność. Jego pozycje na diagramach, komentarze, ślady i powiązania pozostają.
  • Tekst bez identyfikatorów jest dopasowywany po nazwie. Holarch dopasowuje pakiety najwyższego poziomu po nazwie, a elementy w nich po nazwach i pozycjach. Identyfikatory są zachowywane tam, gdzie elementy się zgadzają. Element o zmienionej nazwie jest nadal dopasowywany, gdy pozostaje na swoim miejscu; element, któremu jednocześnie zmieniono nazwę i który przeniesiono, staje się nowym elementem.

Eksport informuje o tym pod kontrolkami eksportu: “Identyfikatory elementów są zachowywane w JSON. W tekście .sysml zaznacz Dołącz identyfikatory elementów, aby je zachować: elementy zachowują wtedy pozycje na diagramach, komentarze i ślady, gdy edytowany tekst zostanie ponownie zaimportowany, nawet po zmianie nazwy lub przeniesieniu. Bez identyfikatorów elementy są dopasowywane po nazwie.”

Identyfikatory elementów w tekście

@HolarchMetadata::ElementId { id = "…"; } to zwykłe metadane SysML v2: ElementId to definicja metadanych we własnym pakiecie biblioteki Holarch HolarchMetadata (w Bibliotece standardowej w gałęzi Holarch), obok TBD i TBR. Inne narzędzia SysML v2 odczytują ten wiersz jako adnotację metadanych; aby rozwiązać jej nazwę, potrzebują pliku HolarchMetadata.sysml z tej biblioteki.

  • Identyfikator należy do elementu, którego treść zawiera ten wiersz. Elementy bez nazwy (połączenia, następstwa, komentarze) nie mają identyfikatora i są dopasowywane po zawartości, tak jak dotychczas.
  • Holarch nie przechowuje tego wiersza jako elementu. Edytor pokazuje model bez tych wierszy, a element, którego treść zawierała tylko ten wiersz, jest wyświetlany jako part engine : Engine;.
  • Identyfikatory muszą być unikatowe. Gdy ten sam identyfikator występuje dwa razy (na przykład po skopiowaniu bloku w tekście), pierwszy element go zachowuje, a kopia staje się nowym elementem.
  • Identyfikator, który nie jest UUID (na przykład "R-17"), jest zamieniany na stały UUID, więc ten sam ciąg zawsze daje ten sam element, tak jak przy imporcie JSON.
  • Identyfikator, którego projekt nie ma, zostaje zachowany dla nowego elementu. Usunięcie elementu w Holarch i ponowny import tekstu przywraca go z dawnym identyfikatorem.
  • W Edytorze wklejony wiersz działa w obrębie edytowanego pakietu: identyfikator należący do elementu innego pakietu jest tam ignorowany, a element jest dopasowywany po nazwie. Aby przenosić elementy między pakietami z zachowaniem identyfikatorów, wyeksportuj je z identyfikatorami i zaimportuj edytowane pliki.

Definicja części Car w projekcie demonstracyjnym Hybrid Car ma taki wiersz w pliku źródłowym, więc jej identyfikator jest taki sam w każdej kopii projektu demonstracyjnego.

Foldery stają się pakietami

W archiwum zip każdy folder staje się pakietem zawierającym jego pliki i podfoldery. Plik powertrain/engine.sysml w archiwum jest odczytywany tak, jakby był zapisany wewnątrz package powertrain { … }. Pliki na najwyższym poziomie archiwum są odczytywane bez zmian. Foldery i pliki są odczytywane w kolejności nazw.

Co porównuje podgląd

Podgląd ma jeden wiersz na pakiet najwyższego poziomu (lub, dla nowego projektu, na element najwyższego poziomu). Każdy wiersz ma wynik:

WynikZnaczenieDomyślnie importowane
NoweProjekt nie ma pakietu o tej nazwie (lub identyfikatorze). Zostaje on dodany.Tak
ZmienionoProjekt ma ten pakiet; import dodaje, zmienia lub usuwa w nim elementy. Szczegóły podają ile, na przykład “3 dodano, 1 zmieniono (identyfikatory zachowane tam, gdzie elementy się zgadzają)”.Tak
Bez zmianPakiet jest taki sam jak w tym projekcie.Nie (nic do zrobienia)
KonfliktPakietu nie można scalić. Szczegóły podają przyczynę i dalsze kroki.Nie

Jak z niego korzystać

Kiedy i dlaczego

Używaj Importu i eksportu, gdy model przechodzi między Holarch a innym narzędziem SysML v2 lub między projektami Holarch:

  • Rozpoczęcie projektu Holarch od modelu napisanego gdzie indziej.
  • Wprowadzenie pakietu utrzymywanego przez inny zespół, na przykład biblioteki komponentów, i jego aktualizacja, gdy prześlą nową wersję.
  • Przekazanie pakietu dostawcy lub narzędziu, które odczytuje tekst lub JSON SysML v2.
  • Przechowywanie plików .sysml we własnym systemie kontroli wersji obok projektu Holarch.

Importowanie plików do tego projektu

  1. Otwórz Model → Import i eksport.
  2. W sekcji Import wybierz Do tego projektu.
  3. Upuść pliki na strefę upuszczania lub kliknij ją i wybierz pliki.

    Widać “Odczytywanie plików…”, a następnie podgląd: liczbę pakietów najwyższego poziomu i plików, ewentualne problemy oraz tabelę z kolumnami Import, Pakiet, Elementy i Wynik.

  4. Przeczytaj listę problemów, jeśli się pojawi. Wymienia ona każdy plik i wiersz, którego nie da się przeanalizować, oraz każdy pominięty plik.
  5. Odznacz każdy pakiet, którego nie chcesz importować. Aby zastąpić pakiet, który koliduje nazwą, zaznacz go.

    W planie z limitem elementów podgląd liczy elementy, które projekt miałby po imporcie (relacje się nie liczą). Jeśli ta liczba przekracza limit, podgląd o tym informuje, na przykład “Ten import zwiększyłby projekt do 1804 elementów; plan Free dopuszcza 1000.”, a przycisk Importuj N pakietów pozostaje nieaktywny, dopóki nie odznaczysz wystarczającej liczby pakietów. Nic nie zostaje zastosowane ani wysłane na serwer. Importy do nowego projektu są w ten sam sposób sprawdzane względem limitu na projekt w Twoim planie.

  6. Kliknij Importuj N pakietów.

    Komunikat brzmi “Zaimportowano N pakietów.” Strona podaje “Zaimportowano N pakietów (M elementów). Cofnij wycofuje import w jednym kroku.” Kliknij Otwórz tekst, aby je zobaczyć.

Importowanie plików do nowego projektu

  1. Otwórz Model → Import i eksport i wybierz Do nowego projektu SysML v2.
  2. Upuść lub wybierz pliki.

    Podgląd wymienia elementy najwyższego poziomu, wszystkie zaznaczone.

  3. Odznacz te, których nie chcesz, i zmień Nazwa projektu. Domyślnie jest to nazwa pojedynczego pliku lub pierwszego pakietu.
  4. Kliknij Utwórz projekt.

    Nowy projekt otwiera się w Edytorze.

Na stronie Zarządzaj projektami polecenie Pliki projektów ▾ → Importuj pliki SysML v2… robi to samo w jednym kroku. Jeśli części plików nie da się odczytać, najpierw pyta: “Znaleziono N problemów: części plików zostały pominięte. Utworzyć projekt z resztą? Aby najpierw zobaczyć problemy, otwórz projekt SysML v2 i użyj strony Import i eksport.” Kliknij Utwórz projekt, aby kontynuować.

Aktualizacja pakietu z nowej wersji

  1. Wyeksportuj lub otrzymaj nową wersję jako pliki .sysml lub JSON.
  2. Zaimportuj ją Do tego projektu.

    Pakiet pokazuje Zmieniony z liczbą dodanych, zmienionych i usuniętych elementów.

  3. Kliknij Importuj 1 pakiet.

    Pasujące elementy zachowują swoje identyfikatory, więc powiązania z nimi (powiązania wymagań, ryzyka, układy widoków, komentarze) pozostają. Elementy, których nie ma już w pliku, trafiają do Kosza.

Zmiana nazw i przenoszenie elementów w tekście z zachowaniem identyfikatorów

  1. Wyeksportuj pakiety jako tekst SysML v2 z zaznaczoną opcją Dołącz identyfikatory elementów.
  2. Edytuj pliki: zmieniaj nazwy elementów, przenoś je do innych właścicieli lub do pliku innego pakietu, zmieniaj ich kolejność. Każdy wiersz @HolarchMetadata::ElementId pozostaw wewnątrz treści jego elementu.
  3. Zaimportuj edytowane pliki Do tego projektu.

    Pakiety pokazują Zmieniony. Elementy ze zmienioną nazwą i przeniesione liczą się jako zmienione, a nie jako dodane i usunięte.

  4. Kliknij Importuj N pakietów.

    Elementy zachowują swoje identyfikatory: ich położenia na diagramach, komentarze, ślady i powiązania pozostają. Elementy przeniesione do innego pakietu opuszczają pakiet, w którym były.

Duże importy w usłudze hostowanej

W usłudze hostowanej import 5000 lub więcej elementów stosuje serwer, a nie Twoja przeglądarka. Gdy każdy zaznaczony pakiet ma stan Nowy lub zastępuje pakiet w stanie Konflikt, serwer sam odczytuje pliki (kroki poniżej). Gdy zaznaczony pakiet ma stan Zmieniony, przeglądarka jak zwykle wylicza scalenie i jednorazowo przesyła zmiany; serwer zapisuje je następnie w jednym kroku, z tą samą kartą postępu oraz przyciskami Anuluj import i Cofnij import.

  1. Wybierz pliki i sprawdź podgląd jak przy każdym imporcie.
  2. Kliknij Importuj N pakietów (lub Utwórz projekt).

    Pliki są przesyłane jeden raz. Serwer odczytuje je z tymi samymi kontrolami i tymi samymi identyfikatorami elementów co podgląd i zapisuje wynik w jednym kroku.

  3. Śledź kartę postępu u dołu okna: pokazuje ona etap (przesyłanie, odczyt, sprawdzanie, stosowanie, aktualizacja indeksu projektu) i pozostały czas.

    Możesz opuścić stronę lub zamknąć kartę. Import trwa dalej na serwerze, a gdy ponownie otworzysz projekt, jego wynik już tam jest. Każda otwarta kopia projektu wczytuje się ponownie po zastosowaniu importu; niewysłane edycje są wysyłane ponownie po przeładowaniu.

  • Inni członkowie widzą “Nazwa importuje plik…” na tej samej karcie i na stronie Import i eksport.
  • Jeden import naraz: drugi duży import do tego samego projektu czeka, aż pierwszy się zakończy.
  • Anuluj import (osoba, która go rozpoczęła, lub właściciel) zatrzymuje import przed jego zastosowaniem. Nic nie zostaje zmienione.
  • Cofnij import: ⌘Z / Ctrl+Z w przeglądarce nie wycofuje importu na serwerze. Kliknij Cofnij import na stronie Import i eksport, aby przywrócić projekt do stanu sprzed ostatniego importu. Stan sprzed cofnięcia jest przechowywany w Historia, więc edycje wykonane po imporcie można stamtąd odzyskać.
  • Aktywność projektu i Historia pokazują import jako jeden wpis osoby, która go rozpoczęła.

Eksport modelu lub pakietu

  1. Otwórz Model → Import i eksport.
  2. W sekcji Eksportuj wybierz, co wyeksportować: Cały model lub pakiet według jego nazwy kwalifikowanej.
  3. Wybierz format: Tekst SysML v2 (.sysml; .zip dla kilku pakietów) lub JSON SysML v2 (.json).
  4. Dla tekstu, który będziesz edytować i ponownie importować, zaznacz Dołącz identyfikatory elementów.
  5. Kliknij Eksportuj.

    Pobierany jest jeden plik lub plik zip, gdy eksport obejmuje kilka plików. Komunikat brzmi “Wyeksportowano <file>.” lub “Wyeksportowano N plików jako zip.”

Aby szybko wyeksportować jeden pakiet, użyj Przeglądarki: menu wiersza pakietu ma polecenia Eksportuj jako .sysml i Eksportuj jako JSON.

Import i eksport wymagań ReqIF

ReqIF to format wymiany narzędzi do zarządzania wymaganiami. Plik ReqIF importuje się jako jeden pakiet wymagań SysML v2, a wymagania eksportują się z powrotem jako ReqIF, więc narzędzie do wymagań i projekt SysML v2 mogą wymieniać te same wymagania w obu kierunkach.

Import pliku ReqIF:

  1. Otwórz Model → Import i eksport (albo kliknij Importuj… na stronie Wymagania lub wybierz Importuj ReqIF… w ⌘K / Ctrl+K).
  2. Upuść plik .reqif lub .reqifz na pole albo kliknij pole, aby go wybrać. Jeden plik ReqIF na import.
  3. Panel ReqIF pokazuje liczbę wymagań, rozdziałów i relacji, ile z nich przekonwertowano, przybliżono lub pominięto, oraz czy tekst SysML v2 przechodzi kontrole bez problemów.
  4. W polu Nazwy skrócone z wybierz Obcy identyfikator (numer, który widzą użytkownicy narzędzia źródłowego, np. SRS-12) lub Identyfikator ReqIF (wewnętrzny identyfikator narzędzia). Wymagania bez obcego identyfikatora otrzymują identyfikator ReqIF.
  5. W sekcji Typy relacji wybierz, czym staje się każdy typ relacji: Wyprowadzenie, Uszczegółowienie, Zależność lub Pomiń. Podgląd jest wyliczany ponownie, a wybór zostaje zapamiętany na następny import tego samego pliku.
  6. Kliknij Importuj 1 pakiet. Jedno polecenie Cofnij wycofuje cały import. Komunikat brzmi “Zaimportowano: N wymagań z <title>.”

Co tworzy import:

ReqIFSysML v2
Wymaganie (obiekt specyfikacji)requirement z obcym identyfikatorem lub identyfikatorem ReqIF jako nazwą skróconą, nazwą i tekstem jako doc
Typ wymaganiarequirement def z jednym atrybutem na każdy atrybut ReqIF
Typ danych wyliczeniowyenum def
Atrybut statusu (Draft, Proposed, Approved itd.)Status wymagania w Holarch
Nagłówek rozdziałupackage z numerem rozdziału jako nazwą skróconą
Zagnieżdżone wymaganieZagnieżdżone requirement
Relacja derived fromPołączenie wyprowadzenia
Relacja refinesZależność z adnotacją Refinement
satisfies, verified by i inne relacjeZależność (raport podaje dlaczego)
Specyfikacjapackage wewnątrz pakietu pliku

Tabele stają się wierszami tekstu z | między komórkami, listy stają się wierszami zaczynającymi się od myślnika, a z formatowania i łączy zostaje tylko tekst; takie wymagania są oznaczone jako Przybliżone. Obrazy i osadzone obiekty nie są importowane; wymaganie, które je zawierało, jest wymienione wraz z przyczyną, aby można było dołączyć do niego plik. Pobierz raport zapisuje każde wymaganie i relację z wynikiem jako CSV; Pobierz tekst SysML v2 zapisuje tekst.

Import nowszej kopii pliku: zaimportuj ją do tego samego projektu. Holarch znajduje pakiet z wcześniejszego importu i porównuje wymaganie po wymaganiu:

  • Wymagania zachowują identyfikatory elementów, więc diagramy, powiązania satisfy i verify, przeglądy i Historia pozostają do nich przypięte. Wymagania ze zmienioną nazwą i przeniesione są aktualizowane w miejscu.
  • Wymagania, których brakuje w nowym pliku, są zachowywane. Zaznacz Usuń N wymagań, których brakuje w tym pliku, aby przenieść je do Kosza.
  • Części, przypadki weryfikacji i powiązania dodane w Holarch są zachowywane.
  • Wymaganie zmienione tylko w Holarch zachowuje Twoją zmianę. Wymaganie zmienione zarówno tutaj, jak i w pliku przyjmuje tekst z pliku; wcześniejszy tekst pozostaje w Historii. Podgląd wymienia je w sekcji Zmienione tutaj i w pliku.

Eksport jako ReqIF:

  1. W sekcji Eksportuj wybierz pakiet lub Cały model oraz ReqIF (.reqif) lub Archiwum ReqIF (.reqifz).
  2. Kliknij Eksportuj. Komunikat brzmi “Wyeksportowano N wymagań jako <file>.”

Eksportuj… → Wymagania (ReqIF) na stronie Bazy danych lub Wymagania eksportuje wymienione (lub zaznaczone) wymagania w ten sam sposób.

Plik zawiera nazwę skróconą każdego wymagania (jako ReqIF.ForeignID), nazwę, doc (jako XHTML), status i wartości atrybutów, hierarchię pakietów jako specyfikację oraz relacje derive, refine i dependency. Wymagania zaimportowane z ReqIF zachowują oryginalne identyfikatory, typy i typy relacji, więc narzędzie źródłowe aktualizuje swoje wymagania zamiast dodawać kopie; ponowny eksport i import pliku pokazuje każdy pakiet jako Bez zmian. Obliczane wartości atrybutów są zapisywane jako tekst. Powiązania satisfy i verify pozostają w Holarch: ReqIF nie ma części ani przypadków weryfikacji.

Pobieranie z repozytorium i wysyłanie do niego

Połącz projekt z jedną gałęzią repozytorium modeli SysML v2, aby odczytywać jego najnowszy commit i odsyłać swoje zmiany.

  1. Otwórz Model → Import i eksport i znajdź sekcję Repozytorium.
  2. Wpisz Adres repozytorium (adres https jego Systems Modeling API) oraz, jeśli repozytorium tego wymaga, Token dostępu.
  3. Kliknij Wczytaj projekty, a następnie wybierz Projekt i Gałąź. Aby utworzyć nowy projekt repozytorium z tego modelu, kliknij zamiast tego Nowy projekt repozytorium.
  4. Kliknij Ściągnij…. Holarch odczytuje najnowszy commit gałęzi i wymienia każdą różnicę: Nowy, Zmieniony, Usunięty lub Konflikt. Gdy nie ma czego pobrać, zobaczysz “Aktualne: brak zmian w repozytorium.”
  5. Odznacz różnice, których nie chcesz, a następnie kliknij Zastosuj pobranie. Jedno polecenie Cofnij wycofuje całe pobranie.
  6. Po zmianie modelu kliknij Wypchnij. Twoje zmiany od ostatniego zsynchronizowanego commita trafiają do gałęzi jako jeden nowy commit. Zobaczysz na przykład “Wypchnięto 3 zmienione jako commit 1a2b3c4d.”

Konflikt to element zmieniony zarówno tutaj, jak i w repozytorium od ostatniej synchronizacji. Odznaczony konflikt zachowuje wersję z tego projektu.

Uwaga: wypchnięcie jest odrzucane, gdy gałąź ma commity, których ten projekt nie pobrał: “Gałąź repozytorium ma commity, których ten projekt nie pobrał. Najpierw pobierz, a potem wypchnij ponownie.”

Przykład: projekt demonstracyjny Hybrid Car

Najpierw utwórz projekt demonstracyjny: na stronie Zarządzaj projektami kliknij Pliki projektów ▾ → Nowy projekt demonstracyjny → Hybrid Car (SysML v2).

  1. Otwórz Model → Import i eksport. W sekcji Eksportuj wybierz Cały model i Tekst SysML v2, a następnie kliknij Eksportuj.

    Pobiera się plik zip z jednym plikiem na każdy pakiet najwyższego poziomu, np. Vehicles.sysml, VehicleRequirements.sysml, VehicleBehavior.sysml i VehicleViews.sysml.

  2. Otwórz VehicleRequirements.sysml w edytorze tekstu. Zmień attribute maxCurbMass : MassValue = 1650 [kg]; na 1600 [kg] i zapisz.
  3. Na stronie Import i eksport wybierz Do tego projektu i upuść VehicleRequirements.sysml.

    Podgląd pokazuje VehicleRequirements jako Zmieniony z liczbą zmienionych elementów. Pozostałych pakietów nie ma w pliku, więc nie są wymienione.

  4. Kliknij Importuj 1 pakiet.

    Wartość zmienia się w modelu. Wymaganie Sedan Mass (VR-1.1) odwołuje się do maxCurbMass, więc jego powiązania zostają oznaczone do przeglądu (zob. Wymagania i weryfikacja w projektach SysML v2). Naciśnij ⌘Z / Ctrl+Z, aby cofnąć import.

  5. Aby utworzyć drugi projekt z tych samych plików, wybierz Do nowego projektu SysML v2, upuść plik zip i kliknij Utwórz projekt.

Wskazówki i dobre praktyki

  • Używaj JSON do przenoszenia modelu między narzędziami SysML v2, gdy identyfikatory mają znaczenie, na przykład gdy drugie narzędzie przechowuje powiązania według identyfikatorów. Używaj tekstu, gdy ludzie czytają lub przeglądają pliki; zaznacz Dołącz identyfikatory elementów, gdy tekst po edycji wraca do Holarch.
  • Pomiń identyfikatory w tekście przekazywanym osobom, które go tylko czytają: dodają one po jednym wierszu na element.
  • Trzymaj jeden pakiet najwyższego poziomu na plik. Eksport zapisuje pliki właśnie tak, a późniejszy import dopasowuje wtedy pakiet po pakiecie.
  • Pakiet od innego zespołu importuj do jego własnego pakietu najwyższego poziomu. Aktualizacje dotyczą wtedy tylko tego pakietu.
  • Przed importem sprawdź listę problemów. Składowe, których nie da się przeanalizować, są pomijane.

Typowe błędy

  • Pakiet pokazuje Konflikt: “Pakiet o nazwie X z innymi identyfikatorami już istnieje.” Projekt ma pakiet o tej nazwie, który nie został zaimportowany z tego JSON. Zaznacz wiersz, aby go zastąpić (stary pakiet trafia do Kosza), lub zaimportuj do nowego projektu.
  • “Import zawiera dwa pakiety najwyższego poziomu o nazwie X; importowany jest tylko pierwszy.” Dwa pliki deklarują ten sam pakiet najwyższego poziomu. Scal je w jeden plik lub zmień nazwę jednego z nich.
  • Element ze zmienioną nazwą został zaimportowany jako nowy. Tekst nie miał identyfikatorów elementów, a element jednocześnie zmienił nazwę i został przeniesiony (albo zmieniły się zarówno jego rodzaj, jak i nazwa). Wyeksportuj z opcją Dołącz identyfikatory elementów, wprowadź zmianę i zaimportuj ponownie.
  • Po imporcie brakuje elementów. Składowa, której nie da się przeanalizować, jest pomijana: “Tej składowej nie da się przeanalizować i zostaje pominięta.” Popraw wiersz wskazany na liście problemów, a następnie zaimportuj ponownie.
  • Import JSON zostaje odrzucony. Importuj jeden plik JSON SysML v2 naraz, bez plików .sysml.

Powiązania z innymi funkcjami

  • Edytor: zaimportowane pakiety otwierają się w nim; wyeksportowane pliki to tekst, który tam widzisz.
  • Cofanie i Kosz: jedno polecenie Cofnij wycofuje cały import do tego projektu; elementy, które import usuwa lub zastępuje, trafiają do Kosza.
  • Kontrola zmian: wartości i dokumentacja zmienione przez import oznaczają powiązania wymagań do przeglądu, jak każda inna edycja.
  • Pliki projektu Holarch: Eksportuj ten projekt… na stronie Zarządzaj projektami zapisuje cały projekt Holarch z ryzykami, dokumentami i innymi danymi Holarch. Pliki .sysml i JSON zawierają tylko model.
  • Konwersja: aby przenieść model między LML a SysML v2, utwórz przekonwertowaną kopię (zob. Konwersja między LML a SysML v2).

Strona Import i eksport

Import

Element sterującyZastosowanie
Do tego projektuScala pliki z otwartym projektem. Niedostępne dla osób, które mogą tylko wyświetlać projekt; dla nich importy tworzą nowy projekt.
Do nowego projektu SysML v2Tworzy nowy projekt z plików.
Strefa upuszczania“Upuść pliki tutaj lub kliknij, aby je wybrać”. Przyjmuje pliki .sysml, plik .zip z plikami .sysml lub jeden plik JSON SysML v2.
Tabela podgląduImportuj (pole wyboru), Pakiet (nazwa i rodzaj), Elementy (liczba), Wynik (Nowy, Zmieniony, Bez zmian lub Konflikt, ze szczegółami).
Nazwa projektu(Tylko nowy projekt) Nazwa nowego projektu, do 200 znaków.
Importuj N pakietów / Utwórz projektStosuje import.
AnulujZamyka podgląd bez importowania.

Elementy spoza jakiegokolwiek pakietu w tekście .sysml są wymienione razem w jednym wierszu, Poza pakietami.

Gdy model zmienia się, kiedy podgląd jest otwarty (inna karta, współpracownik lub Cofnij), podgląd jest wyliczany ponownie.

Eksport

Element sterującyZastosowanie
Eksportuj (zakres)Cały model lub dowolny pakiet według nazwy kwalifikowanej.
jako (format)Tekst SysML v2 (.sysml; .zip dla kilku pakietów) lub JSON SysML v2 (.json).
Dołącz identyfikatory elementów(Tylko tekst; domyślnie wyłączone) Zapisuje identyfikator każdego nazwanego elementu w tekście jako @HolarchMetadata::ElementId { id = "…"; }, aby edytowana kopia zaimportowana ponownie zachowała identyfikatory mimo zmian nazw i przeniesień.
EksportPobiera plik.

Eksport tekstu zapisuje jeden plik na każdy pakiet najwyższego poziomu, nazwany tak jak pakiet (Vehicles.sysml). Elementy spoza pakietów trafiają do Outside packages.sysml. Eksport JSON zapisuje jeden plik nazwany tak jak projekt lub pakiet.

Repozytorium

Sekcja Repozytorium łączy projekt z jedną gałęzią repozytorium udostępniającego Systems Modeling API.

  • Adres repozytorium: adres https API repozytorium. Holarch łączy się tylko z adresami https na hostach publicznych; administratorzy witryny mogą ograniczyć hosty i porty.
  • Token dostępu: przechowywany w postaci zaszyfrowanej dla Twojego konta i tego projektu i wysyłany tylko na ten adres. Nigdy nie jest ponownie wyświetlany; pozostaw pole puste, aby zachować zapisany token.
  • Wczytaj projekty, Projekt i Gałąź: wybierz, z czym synchronizować. Nowy projekt repozytorium tworzy w repozytorium projekt dla tego modelu.
  • Ściągnij…, Zastosuj pobranie: odczytaj najnowszy commit, przejrzyj różnice i zastosuj je; jedno polecenie Cofnij wycofuje całość. Holarch porównuje z commitem zsynchronizowanym ostatnio, dzięki czemu odróżnia Twoje zmiany od zmian w repozytorium.
  • Wypchnij: wyślij zmiany od ostatniego zsynchronizowanego commita jako jeden commit. “Nie ma nic do wypchnięcia: model jest zgodny z ostatnim zsynchronizowanym commitem.” oznacza, że nie ma nic nowego.
  • Ustawienia… zmienia połączenie. Rozłącz usuwa zapisany token i stan synchronizacji; model pozostaje.
  • Operacje na repozytorium wymagają roli edytora. Czytelnicy nie mogą pobierać ani wypychać.
  • Wypchnięcia są odrzucane dla projektów z oznaczeniami danych regulowanych.

Jak odczytywane są pliki

  • Pliki są sprawdzane, zanim cokolwiek zostanie odczytane: ich rozmiary, liczby, zagnieżdżenie i długości tekstów.
  • W pliku zip ukryte pliki i foldery __MACOSX są ignorowane. Łącza, pliki inne niż .sysml i druga kopia tej samej ścieżki są pomijane, a lista problemów podaje przyczynę.
  • Tekst musi być w UTF-8. Znacznik kolejności bajtów jest dozwolony.
  • Każdy importowany element jest sprawdzany przed zapisaniem. Odrzucony element pociąga za sobą swoje składowe; lista problemów je zlicza.
  • W JSON elementy rodzajów, których Holarch nie interpretuje, są zachowywane w postaci zaimportowanej: zob. Elementy, których Holarch nie interpretuje.

Elementy, których Holarch nie interpretuje

JSON SysML v2 może zawierać rodzaje elementów, których Holarch nie modeluje, np. zachowania, kroki lub interakcje KerML. Holarch zachowuje je zamiast pomijać:

  • Każdy z nich pozostaje w modelu ze swoim identyfikatorem, nazwą, właścicielem i oryginalnym JSON, łącznie z relacjami (typowania, specjalizacje i inne) oraz tym, co one posiadają. Jego składowe nadal mają go jako właściciela.
  • Przeglądarka pokazuje jego oryginalny rodzaj z etykietą Bez interpretacji; wskaż etykietę, aby zobaczyć wyjaśnienie. Inspektor pokazuje jego rodzaj, identyfikator w pliku i to, na co wskazują jego relacje.
  • Nie można zmienić jego nazwy ani go edytować w Holarch. Zmień go w narzędziu, z którego pochodzi, i zaimportuj ponownie. Można go przenieść lub usunąć.
  • Nie ma tekstu SysML. Edytor pomija go wraz ze wszystkim, co posiada, a uwaga nad tekstem podaje, ile elementów nie jest wyświetlanych. Edycja tekstu nigdy ich nie usuwa. Eksport .sysml również je pomija.
  • Eksport JSON zapisuje go z powrotem bez zmian. Dostosowywane jest tylko to, co zmieniło się w modelu: usunięta lub dodana składowa, składowa ze zmienioną nazwą albo nowy właściciel.
  • Podgląd importu wymienia każdy zachowany rodzaj raz, jako uwagę, na przykład 2 elementy Behavior są zachowane w postaci zaimportowanej. Uwagi nie są problemami.

Nie są zachowywane: nienazwana główna przestrzeń nazw, w którą niektóre narzędzia opakowują cały eksport (jej składowe stają się elementami najwyższego poziomu), oraz nieobsługiwane elementy wewnątrz wartości, które są wymieniane jako problemy. Element, którego JSON jest większy niż 256 KB, zachowuje tylko rodzaj i identyfikator.

Komunikaty

WiadomośćZnaczenie i rozwiązanie
Wybierz pliki .sysml, plik .zip z plikami .sysml lub plik JSON SysML v2.Nie wybrano plików.
Nie znaleziono plików .sysml. Wybierz pliki .sysml, plik .zip z plikami .sysml lub plik JSON SysML v2.Archiwum lub zaznaczenie nie zawiera plików .sysml.
Importuj jeden plik JSON SysML v2 naraz, bez plików .sysml.Wybrano kilka plików JSON lub JSON razem z tekstem.
<file> nie jest plikiem ReqIF (…). Wyeksportuj go z narzędzia źródłowego jako ReqIF 1.0 lub nowszy i zaimportuj ponownie.Plik nie jest plikiem XML ReqIF lub zawiera DOCTYPE, którego Holarch nie odczytuje.
<file> nie zawiera wymagań (brak elementów SPEC-OBJECT). Wyeksportuj specyfikacje z ich obiektami i zaimportuj plik ponownie.Plik ReqIF ma typy, ale nie ma wymagań.
<title> ma N wymagań, więcej niż przyjmuje jeden import (ok. M). Wyeksportuj specyfikacje jako osobne pliki ReqIF.Tekst SysML v2 przekroczyłby limit 8 MB. Importuj specyfikacje po jednym pliku.
<file> nie jest tekstem UTF-8. Zapisz go jako UTF-8 i zaimportuj ponownie.Przekonwertuj kodowanie pliku.
<file> nie jest prawidłowym archiwum ZIP. Utwórz archiwum ponownie.Archiwum jest uszkodzone.
<file> zawiera zaszyfrowane pliki. Utwórz archiwum bez hasła.Archiwa chronione hasłem nie są odczytywane.
<path> jest skompresowany w stopniu większym niż 200:1, co jest typowe dla bomby zip. Utwórz archiwum ponownie.Archiwum zostało odrzucone ze względów bezpieczeństwa.
Archiwum używa nieobsługiwanej metody kompresji. Utwórz je ze standardową kompresją ZIP.Użyj standardowej kompresji (deflate).
Pliki KerML nie są jeszcze importowane.Pliki .kerml są pomijane.
Z archiwum importowane są tylko pliki .sysml.Inne pliki w archiwum zip są pomijane.
Łącza nie są importowane.Dowiązania symboliczne w archiwum zip są pomijane.
Archiwum zawiera ten plik dwukrotnie; importowana jest pierwsza kopia.Dwa wpisy mają tę samą ścieżkę.
<file> nie jest prawidłowym JSON. Wyeksportuj model ponownie.Plik JSON jest uszkodzony.
<file> nie jest plikiem JSON SysML v2 (listą elementów z @id i @type). Wybierz eksport JSON SysML v2.JSON ma inny format.
Wiersz N pliku <file> jest dłuższy niż 64 KB. Podziel wiersz, a następnie zaimportuj plik ponownie.Bardzo długie wiersze są odrzucane.
Tej składowej nie da się przeanalizować i zostaje pominięta.Popraw wiersz wskazany na liście problemów.
Element o tym identyfikatorze znajduje się wewnątrz <element> w tym projekcie. Najpierw przenieś go na najwyższy poziom lub zaimportuj do nowego projektu.(Konflikt) Pakiet najwyższego poziomu z JSON istnieje już głębiej w modelu.
N jego identyfikatorów elementów jest używanych w innym miejscu tego projektu. Zamiast tego zaimportuj do nowego projektu.(Konflikt) JSON ponownie używa identyfikatorów innych elementów.
Tekst pakietu nie daje się przeanalizować po wydrukowaniu. Zaimportuj go do nowego projektu.(Konflikt) Nie udało się scalić pakietu.
N elementów <kind> jest zachowanych w postaci zaimportowanej (bez interpretacji): …(Uwaga) Elementy rodzaju, którego Holarch nie interpretuje, są zachowywane bez zmian. Zobacz Elementy, których Holarch nie interpretuje.
Element rodzaju <kind> wewnątrz wartości nie jest obsługiwany i zostaje pominięty.Wartość (wyrażenie) zawiera element, którego Holarch nie potrafi odczytać. Reszta wartości jest zachowywana jako tekst.
Element rodzaju <kind> jest zbyt duży, aby zachować go w całości; zachowywane są tylko jego rodzaj i identyfikator.Jego JSON jest większy niż 256 KB.
Import nie został zastosowany: … Nic nie zostało zmienione.Import się nie powiódł; projekt pozostał bez zmian.
Model jest pusty. Dodaj pakiet, a następnie wyeksportuj ponownie.Nie ma nic do wyeksportowania.
Pakiet do eksportu już nie istnieje. Wybierz inny.Pakiet został usunięty, gdy strona była otwarta.

Limity

LimitWartość
Pliki na import2,000
Tekst .sysml na import (po rozpakowaniu)8 MB
Archiwum zip16 MB, 10 000 wpisów
Zagnieżdżenie folderów w archiwum zip32 foldery
Elementy na import (tekst lub JSON)100,000
Plik JSON24 MB, zagnieżdżenie 64 poziomy
JSON jednego elementu, którego Holarch nie interpretuje256 KB, zagnieżdżenie 12 poziomów
Długość wiersza64 KB
Plik ReqIF (.reqif lub .reqif wewnątrz .reqifz)64 MB; utworzony z niego tekst SysML v2 musi zmieścić się w limicie tekstu 8 MB (ok. 8000 do 20 000 wymagań)
  • Odpowiedzi repozytorium są ograniczone do 64 MB na całe pobranie, a każda operacja na repozytorium zatrzymuje się po 120 sekundach.
  • Każde konto może wykonać najwyżej 300 operacji na repozytorium na godzinę.
  • Pliki KerML (.kerml) nie są jeszcze importowane.
  • W aplikacji hostowanej serwer odczytuje importy do 1,5 MB tekstu .sysml. Większe importy są odczytywane w przeglądarce, z tym samym wynikiem.
  • Dane Holarch obok modelu (status wymagań, ryzyka, budżety, ustawienia symulatora, układy widoków) nie są częścią plików .sysml ani JSON. Aby je zachować, użyj Eksportuj ten projekt… na stronie Zarządzaj projektami.

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