Import i eksport
Formaty importu i eksportu
Wprowadzaj do projektu Holarch specyfikacje, arkusze kalkulacyjne, pliki wymiany wymagań i modele, a wyprowadzaj model jako dokumenty, tabele, obrazy, pliki wymiany i kompletne pliki projektów. Ta strona wymienia każdy format, kierunek, w którym działa, co przenosi i jego znane ograniczenia.
Jak działają importy i eksporty
- Eksporty są dostępne dla każdego członka projektu, także dla czytelników. Importy wymagają roli Właściciel lub Edytor, bo zmieniają projekt.
- Import ze strony Import i eksport pokazuje podgląd, nadaje zaimportowanym elementom nowe identyfikatory i stanowi jeden krok cofania. Aby zaktualizować istniejące elementy zamiast dodawać nowe, dopasuj je po identyfikatorze, nazwie lub numerze.
- Importowana zawartość jest oczyszczana: tekst sformatowany traci skrypty i niebezpieczne łącza, obrazy SVG tracą skrypty i odwołania zewnętrzne, a XML z deklaracjami DOCTYPE lub ENTITY jest odrzucany.
- Eksporty CSV neutralizują tekst, który arkusz kalkulacyjny wykonałby jako formułę. Nazwy plików są oczyszczane pod kątem każdego systemu operacyjnego.
- Każdy projekt jest projektem LML albo projektem SysML v2. Importy z Worda, arkuszy kalkulacyjnych, tekstu i ReqIF są przeznaczone dla projektów LML. Projekty SysML v2 importują tekst i JSON SysML v2 oraz modele SysML 1.x jako XMI lub .mdzip, konwertowane do SysML v2. Projekty LML też importują XMI. Pliki projektów oraz eksporty do Worda, Excela i CSV ze wspólnych stron działają w obu.
Przejdź do: Wymagania i specyfikacje · Modele · Arkusze kalkulacyjne i tabele · Dokumenty i raporty · Obrazy · Pliki projektów · API i MCP
Wymagania i specyfikacje
| Format | Kierunek | Zakres | Znane ograniczenia |
|---|---|---|---|
| Word (.docx) | Import | Specyfikacja staje się numerowanym dokumentem. Nagłówki stają się zagnieżdżonymi według poziomu Statements; akapity zawierające „shall”, „must”, „will” lub „should” oraz numerowane elementy list stają się Requirements. Tabele stają się jednym elementem na wiersz albo pozostają tabelami w opisie. Pogrubienie, kursywa, listy i obrazy są zachowywane, wstawione śledzone zmiany są odczytywane, a oryginalny plik jest dołączany. | Obrazy w formatach EMF, WMF i innych niż PNG, JPEG, GIF, WebP i SVG są pomijane. Usunięty tekst ze śledzonych zmian nie jest importowany. |
| Zwykły tekst (.txt lub wklejony) | Import | Numerowane wiersze i zdania z „shall” stają się numerowanym dokumentem złożonym ze Statements i Requirements. Numeracja konspektu jest wykrywana lub wybierana: dziesiętna, rzymska, literowa, mieszane poziomy, styl DoD lub własny wzorzec. | Struktura wynika wyłącznie z numeracji i sformułowań. |
| ReqIF (.reqif, .reqifz) | Import i eksport | Import: każdy SPEC-OBJECT staje się elementem, z hierarchią specyfikacji, jego typem jako klasą oraz atrybutami tekstowymi, XHTML, logicznymi, datami, wyliczeniowymi, całkowitymi i rzeczywistymi. SPEC-RELATION stają się relacjami; satisfy, verify i deriveReqt stają się satisfies, verifies i traced from; trace i refine stają się traced to. Eksport z Bazy danych lub z dokumentu: jeden typ na klasę z numerem, nazwą, opisem i każdym atrybutem, relacje jako SPEC-RELATION, a dekompozycja jako hierarchia. | Typy relacji bez odpowiednika stają się traced to; powiązania, na które schemat nie pozwala, są pomijane z ostrzeżeniem. |
Modele
| Format | Kierunek | Zakres | Znane ograniczenia |
|---|---|---|---|
| UML i SysML 1.x XMI (.xmi, .uml, .xml, .mdzip) | Import i eksport | Import: XMI 2.x z UML 2.5 i profilem SysML od 1.3 do 1.7 oraz archiwa projektów .mdzip. Wymagania z identyfikatorami i tekstem, bloki, części, porty, właściwości wartości, typy wartości z jednostkami, generalizacje, łączniki i przepływy elementów, aktywności z przepływem sterowania, maszyny stanów ze stanami równoległymi i przejściami choice, junction, fork i join, diagramy sekwencji, przypadki testowe, pakiety, stereotypy i wartości oznaczone. Satisfy, verify, deriveReqt, refine, trace, copy i allocate stają się relacjami Holarch. Diagramy bloków, bloków wewnętrznych, maszyn stanów i akcji są rysowane z zaimportowanego modelu. Eksport: SysML 1.6 XMI (XMI 2.5.1) dla Cameo/MagicDraw, Enterprise Architect i Rhapsody albo Papyrus (Eclipse UML, .uml) dla Papyrus, z wymaganiami, blokami, częściami, portami, typami wartości z jednostkami, blokami ograniczeń, łącznikami z przepływami elementów, aktywnościami, przypadkami użycia, przypadkami testowymi, maszynami stanów i relacjami śladu. Zaimportowane elementy zachowują identyfikatory XMI, a eksport je zapisuje, więc import późniejszej wersji tego samego modelu aktualizuje elementy zamiast dodawać kopie. Z włączonymi atrybutami i etykietami Holarch plik importuje się z powrotem do Holarch bez strat. | Układy diagramów i operacje nie są importowane; przegląd wymienia to, co pominięto. Przepływ aktywności jest rysowany tylko wtedy, gdy ma poprawną strukturę. Artifacts, Tasks, Risks, Issues, Decisions oraz elementy Time i Cost nie są eksportowane. |
| Kod źródłowy Java (.java) | Import | Na diagramie klas: klasy, interfejsy i typy wyliczeniowe stają się Assets, pola stają się Characteristics, a metody stają się Actions z parametrami i wynikami jako Input/Outputs. | Jeden plik lub wklejony kod naraz. |
| Tekst SysML v2 (.sysml lub .zip z plikami .sysml) | Import i eksport | Import do projektu SysML v2 lub do nowego, z podglądem dla każdego pakietu: nowy, zmieniony, bez zmian lub konflikt. Foldery w archiwum zip stają się pakietami. Eksportuj cały model lub jeden pakiet; kilka pakietów jest pobieranych jako zip. | Tekst nie zawiera identyfikatorów elementów, więc ponowny import dopasowuje elementy po nazwie. Pliki KerML (.kerml) nie są importowane. Do 2000 plików, 8 MB tekstu i 16 MB archiwum zip na import; tekst musi być w UTF-8. |
| SysML v2 JSON (.json) | Import i eksport | Płaska lista elementów z @id i @type, której używa Systems Modeling API. Identyfikatory elementów są zachowywane, więc ponowny import dopasowuje po identyfikatorze. | Do 24 MB i 100 000 elementów. Rodzaje elementów, których Holarch nie interpretuje, są zachowywane w postaci zaimportowanej, oznaczane jako Bez interpretacji i zapisywane z powrotem bez zmian. |
| Repozytorium modeli SysML v2 | Pobieranie i wysyłanie | Połącz projekt SysML v2 z jedną gałęzią repozytorium udostępniającego Systems Modeling API. Pobierz najnowszy commit i przejrzyj każdą różnicę przed jej zastosowaniem; wyślij swoje zmiany jako jeden commit. | Tylko adresy https na hostach publicznych. Wysłanie jest odrzucane, gdy gałąź ma commity, które nie zostały pobrane. 64 MB na pobranie, 120 sekund na operację i 300 operacji na konto na godzinę. Wymaga roli Edytor. |
| Systems Modeling API w Holarch | Odczyt i commity przez inne narzędzia | Inne narzędzia SysML v2 odczytują elementy projektu SysML v2 jako SysML v2 JSON przez REST, z osobistym tokenem dostępu, i zatwierdzają zmiany w gałęziach wniosków o zmianę. | main jest tylko do odczytu; commity trafiają do wniosków o zmianę, które zatwierdzający stosuje w Holarch. Tylko czołowe commity gałęzi; bez tagów, scaleń i zapisanych zapytań. |
| SysML v1 do SysML v2 (.xmi, .uml, .xml, .mdzip) | Import | Model SysML 1.x z Cameo lub MagicDraw, Enterprise Architect, Rhapsody lub Papyrus jest konwertowany na tekst SysML v2, sprawdzany i importowany do projektu SysML v2 lub do nowego jako jeden krok cofania. Raport konwersji wymienia każdy element jako przekonwertowany, przybliżony lub pominięty, wraz z powodem, i można go pobrać jako CSV. | Diagramy i ich układ nie są konwertowane. Relacje do elementów bez nazwy są pomijane. |
| LML do SysML v2 i z powrotem | Przekonwertowana kopia, w obie strony | Nowy projekt w drugim języku: Assets, porty, Conduits, Input/Outputs, wymagania, powiązania satisfy, przypadki testowe, Actions z przepływem, stany i równania. Przenoszone są też ryzyka, decyzje, zadania, dokumenty, tablice, status wymagań i wyniki testów. Raport wymienia, co przekonwertowano, a czego nie, i można go pobrać jako CSV. | Układy diagramów, historia, linie bazowe i wnioski o zmianę nie są konwertowane. Elementy, dla których jeden z języków nie ma miejsca, takie jak Measures i Resources z LML albo obliczenia i przypadki analizy z SysML v2, są wymienione w raporcie. |
Dane Holarch przechowywane obok modelu SysML v2, takie jak status wymagań, ryzyka, budżety i układy widoków, nie są częścią plików .sysml ani SysML v2 JSON. Zachowuje je eksport projektu.
Arkusze kalkulacyjne i tabele
| Format | Kierunek | Zakres | Znane ograniczenia |
|---|---|---|---|
| Excel (.xlsx, .xlsm) i CSV | Import | Nowe lub zaktualizowane elementy dowolnej klasy, z mapowaniem kolumn proponowanym na podstawie nagłówków. Atrybuty, etykiety, relacje, hierarchia z kolumny elementu nadrzędnego lub z numerów oraz nowe atrybuty utworzone z danych. Dopasuj istniejące elementy po identyfikatorze, nazwie lub numerze, aby je zaktualizować. | Pliki Excel 97-2003 (.xls) i CSV rozdzielane średnikami nie są odczytywane. Nazwy i numery są obcinane do 255 znaków. |
| Excel i CSV z Bazy danych | Eksport | Dowolny zbiór elementów jako tabela z wybranymi atrybutami i relacjami, z hierarchią i agregacjami, jako definicje, jako macierz relacji, jako historia zmian lub jako komentarze. | Komórki Excela mieszczą do 32 000 znaków; dłuższy tekst jest obcinany. |
| Excel i CSV z innych stron | Eksport | RVTM, VCRM, RVM, RTM, RSM i TVM; wyniki oceny jakości wymagań; rejestr TBD/TBR; rejestr interfejsów; macierze N² i I²; budżety i TPM; rejestr ryzyk; analizy kompromisów; tabele analizy funkcjonalnej; porównania linii bazowych; dane wykresów; osie czasu, dzienniki zdarzeń i przebiegi symulatora. | Każda strona eksportuje własne kolumny. |
| Macierz identyfikowalności (.xlsx, .csv) | Import i eksport | Eksportuj dowolną relację jako macierz. Edytuj skoroszyt w arkuszu kalkulacyjnym i zaimportuj go z powrotem: podgląd pokazuje powiązania do dodania, powiązania do usunięcia i pominięte komórki. | Import dodaje i usuwa powiązania wyłącznie między istniejącymi elementami. Komórki niedozwolone przez schemat są pomijane i wymieniane na liście. |
Dokumenty i raporty
| Format | Kierunek | Zakres | Znane ograniczenia |
|---|---|---|---|
| Word (.docx) | Eksport | Dokumenty i konspekty ze stylami nagłówków Worda, oznaczeniami, stronami tytułowymi i numerami stron; wersje z naniesionymi zmianami (śledzenie zmian) między liniami bazowymi; rozbicia encji; raporty diagramów; ICD; przypadki testowe; macierze RVTM i identyfikowalności; podsumowania analiz kompromisów; raporty analizy funkcjonalnej; pakiet architektury DoDAF. | Strony mają format US Letter. |
| PowerPoint (.pptx) | Eksport | Prezentacje, jeden slajd na stronę, z polami tekstowymi, kształtami i notatkami prelegenta. Prezentacje można też eksportować do HTML i Worda. | Brak. |
| Markdown (.md) | Eksport | Dokument jako nagłówki i tekst Markdown. | Brak. |
| HTML | Eksport | Strony internetowe z diagramami, raportami diagramów, wykresami, prezentacjami i macierzami identyfikowalności. | Brak. |
| Druk i PDF | Eksport | Dokumenty, tabele i diagramy przez okno drukowania przeglądarki, które zapisuje PDF. Tablice eksportują PDF bezpośrednio. | Strony PDF tablic są obrazami. |
Obrazy
| Format | Kierunek | Zakres | Znane ograniczenia |
|---|---|---|---|
| PNG i SVG | Eksport | Diagramy, wykresy, slajdy, panele symulatora i karty galerii. PNG w wybranej skali, z tłem lub bez; SVG jako skalowalny obraz wektorowy. | Brak. |
| Tablice: PNG, JPG, SVG, PDF | Eksport | Plansza, zaznaczenie, bieżący widok, ramka lub wszystkie plansze. SVG zachowuje kształty i tekst jako edytowalne w narzędziach wektorowych. | Strony PDF są obrazami. |
| Obrazy i załączone pliki | Import | Obrazy w tekście sformatowanym, obrazy encji, atrybuty plików, tablice i slajdy. Grafiki PNG, JPEG lub SVG dla produktów DoDAF, na przykład OV-1 z aktywnymi obszarami. | Obrazy dłuższe niż 4000 px na dłuższym boku są zmniejszane. Pliki są ograniczone do 10 MB w planie Free, 25 MB w planie Individual i 100 MB w planie Team, a projekty do 100 MB w planie Free. |
Pliki projektu
| Format | Kierunek | Zakres | Znane ograniczenia |
|---|---|---|---|
| Kopia zapasowa Holarch (.holarch) i plik projektu (.json) | Import i eksport | Cały projekt jako kopia zapasowa lub do przeniesienia na inny serwer Holarch: elementy, relacje, diagramy, linie bazowe, komentarze, historia i preferencje strony głównej, wraz z załącznikami i obrazami. Kopia zapasowa .holarch zawiera sumę kontrolną każdej części i jest sprawdzana przed importem. Importuje się jako nowy projekt, którego jesteś właścicielem. Formaty kopii zapasowej i JSON są udokumentowane. | Zawsze nowy projekt; aby scalić z otwartym projektem, użyj importu scalającego poniżej. |
| Scalanie z projektem (.holarch, .json) | Import | Kopie zapasowe i pakiety Holarch z załączonymi plikami oraz eksporty projektów, Bazy danych i dokumentów Holarch, scalane z otwartym projektem. Klasy, atrybuty, etykiety i relacje są dopasowywane po nazwie, a brakujące elementy schematu można najpierw dodać. Komentarze, historia i układy diagramów są przenoszone, jeśli zostaną wybrane. | Skrypty symulacji z pliku są oznaczane jako zaimportowane, a symulator pyta przed ich uruchomieniem. |
| Pakiet projektu (.holarch) | Eksport | Wybrane elementy z ich relacjami, diagramami, komentarzami i schematem oraz każdy załączony plik, sprawdzane pod kątem uszkodzeń przy imporcie. | Zawiera wybrane elementy; linie bazowe i historia nie są dołączane. |
| Schemat (.json) | Import i eksport | Klasy, relacje, atrybuty i etykiety projektu. Import scala to, czego brakuje w projekcie, albo zastępuje schemat. | Brak. |
| Linie bazowe i dane dokumentu (.json) | Eksport; dane dokumentu również import | Linia bazowa z datą, dokumentem, zatwierdzeniami i migawką. Elementy, relacje i stan dokumentu, które można scalić z innym projektem. | Brak. |
| Produkty DoDAF (JSON) i podzbiór DM2 PES (XML) | Eksport | Opis architektury, każdy produkt z jego danymi oraz słownik. XML zapisuje słownik w terminach DoDAF Meta Model. | XML używa własnej przestrzeni nazw Holarch i nie jest walidowany względem schematu DM2 PES. |
| Harmonogram MS Project (.xml) | Eksport | Wiersze Gantta przebiegu symulacji jako harmonogram MS Project XML. | Tylko z przebiegów symulatora. |
API i MCP
Skrypty odczytują i zmieniają projekty przez REST API, z osobistym tokenem dostępu i opisem OpenAPI. Narzędzia AI, takie jak Claude, łączą się przez Model Context Protocol (MCP); ich zmiany przychodzą jako propozycje, które przeglądasz, zanim zostaną zastosowane. Zobacz API i MCP.