Import und Export
Import- und Exportformate
Bringen Sie Spezifikationen, Tabellen, Dateien für den Anforderungsaustausch und Modelle in ein Holarch-Projekt und geben Sie das Modell als Dokumente, Tabellen, Bilder, Austauschdateien und vollständige Projektdateien aus. Diese Seite listet jedes Format auf, in welche Richtung es geht, was es transportiert und seine bekannten Grenzen.
So funktionieren Importe und Exporte
- Exporte stehen jedem Projektmitglied offen, auch Betrachtern. Importe erfordern die Rolle Eigentümer oder Bearbeiter, weil sie das Projekt ändern.
- Ein Import über die Seite Import und Export zeigt eine Vorschau, gibt importierten Elementen neue IDs und ist ein Rückgängig-Schritt. Um vorhandene Elemente zu aktualisieren, statt neue hinzuzufügen, ordnen Sie sie nach ID, Name oder Nummer zu.
- Importierte Inhalte werden bereinigt: Rich Text verliert Skripte und unsichere Links, SVG-Bilder verlieren Skripte und externe Verweise, und XML mit DOCTYPE- oder ENTITY-Deklarationen wird abgelehnt.
- CSV-Exporte entschärfen Text, den eine Tabellenkalkulation als Formel ausführen würde. Dateinamen werden für jedes Betriebssystem bereinigt.
- Jedes Projekt ist ein LML-Projekt oder ein SysML-v2-Projekt. Die Importe aus Word, Tabellen, Text und ReqIF sind für LML-Projekte. SysML-v2-Projekte importieren SysML-v2-Text und JSON sowie SysML-1.x-Modelle als XMI oder .mdzip, umgewandelt in SysML v2. LML-Projekte importieren ebenfalls XMI. Projektdateien sowie die Word-, Excel- und CSV-Exporte der gemeinsamen Seiten funktionieren in beiden.
Springen zu: Anforderungen und Spezifikationen · Modelle · Tabellen · Dokumente und Berichte · Bilder · Projektdateien · API und MCP
Anforderungen und Spezifikationen
| Format | Richtung | Was es abdeckt | Bekannte Grenzen |
|---|---|---|---|
| Word (.docx) | Import | Eine Spezifikation wird zu einem nummerierten Dokument. Überschriften werden zu nach Ebene verschachtelten Statements; Absätze mit „shall“, „must“, „will“ oder „should“ und nummerierte Listeneinträge werden zu Requirements. Tabellen werden zu einem Element pro Zeile oder bleiben als Tabellen in einer Beschreibung. Fett, Kursiv, Listen und Bilder bleiben erhalten, eingefügte Überarbeitungen werden gelesen, und die Originaldatei wird angehängt. | Bilder in EMF, WMF und anderen Formaten außer PNG, JPEG, GIF, WebP und SVG werden übersprungen. Gelöschter überarbeiteter Text wird nicht importiert. |
| Klartext (.txt oder eingefügt) | Import | Nummerierte Zeilen und „shall“-Sätze werden zu einem nummerierten Dokument aus Statements und Requirements. Die Gliederungsnummerierung wird erkannt oder gewählt: dezimal, römisch, Buchstaben, gemischte Ebenen, DoD-Stil oder ein eigenes Muster. | Die Struktur ergibt sich nur aus Nummerierung und Wortlaut. |
| ReqIF (.reqif, .reqifz) | Import und Export | Import: Jedes SPEC-OBJECT wird zu einem Element, mit der Spezifikationshierarchie, seinem Typ als Klasse und Attributen vom Typ String, XHTML, Boolean, Datum, Aufzählung, Integer und Real. SPEC-RELATIONs werden zu Beziehungen; satisfy, verify und deriveReqt werden zu satisfies, verifies und traced from; trace und refine werden zu traced to. Export aus der Datenbank oder einem Dokument: ein Typ pro Klasse mit Nummer, Name, Beschreibung und jedem Attribut, Beziehungen als SPEC-RELATIONs und die Zerlegung als Hierarchie. | Beziehungstypen ohne Entsprechung werden zu traced to; Links, die das Schema nicht erlaubt, werden mit einer Warnung übersprungen. |
Modelle
| Format | Richtung | Was es abdeckt | Bekannte Grenzen |
|---|---|---|---|
| UML- und SysML-1.x-XMI (.xmi, .uml, .xml, .mdzip) | Import und Export | Import: XMI 2.x mit UML 2.5 und dem SysML-Profil 1.3 bis 1.7 sowie .mdzip-Projektarchive. Anforderungen mit ihren IDs und ihrem Text, Blöcke, Parts, Ports, Value Properties, Value Types mit Einheiten, Generalisierungen, Konnektoren und Item Flows, Aktivitäten mit ihrem Kontrollfluss, Zustandsautomaten mit parallelen Zuständen und Choice-, Junction-, Fork- und Join-Transitionen, Sequenzdiagramme, Testfälle, Pakete, Stereotypen und Tagged Values. Satisfy, verify, deriveReqt, refine, trace, copy und allocate werden zu Holarch-Beziehungen. Blockdiagramme, interne Blockdiagramme, Zustandsautomaten- und Action-Diagramme werden aus dem importierten Modell gezeichnet. Export: SysML-1.6-XMI (XMI 2.5.1) für Cameo/MagicDraw, Enterprise Architect und Rhapsody oder Papyrus (Eclipse UML, .uml) für Papyrus, mit Anforderungen, Blöcken, Parts, Ports, Value Types mit Einheiten, Constraint Blocks, Konnektoren mit Item Flows, Aktivitäten, Anwendungsfällen, Testfällen, Zustandsautomaten und den Trace-Beziehungen. Importierte Elemente behalten ihre XMI-IDs, und der Export schreibt sie zurück, sodass der Import einer späteren Version desselben Modells Elemente aktualisiert, statt Kopien hinzuzufügen. Mit eingeschalteten Holarch-Attributen und -Labels lässt sich die Datei ohne Verlust wieder in Holarch importieren. | Diagrammlayouts und Operationen werden nicht importiert; die Prüfung listet auf, was ausgelassen wird. Der Ablauf einer Aktivität wird nur gezeichnet, wenn er gut strukturiert ist. Artefakte, Aufgaben, Risiken, Issues, Entscheidungen, Zeit- und Kostenelemente werden nicht exportiert. |
| Java-Quellcode (.java) | Import | In einem Klassendiagramm: Klassen, Interfaces und Enums werden zu Assets, Felder zu Characteristics und Methoden zu Actions mit ihren Parametern und Ergebnissen als Input/Outputs. | Eine Datei oder ein eingefügter Quelltext auf einmal. |
| SysML-v2-Text (.sysml oder eine .zip mit .sysml-Dateien) | Import und Export | Import in ein SysML-v2-Projekt oder ein neues, mit einer Vorschau pro Paket: neu, geändert, unverändert oder Konflikt. Ordner in einer Zip-Datei werden zu Paketen. Exportieren Sie das ganze Modell oder ein Paket; mehrere Pakete werden als Zip heruntergeladen. | Text enthält keine Element-IDs, daher ordnet ein erneuter Import Elemente nach Namen zu. KerML-Dateien (.kerml) werden nicht importiert. Bis zu 2.000 Dateien, 8 MB Text und eine Zip-Datei von 16 MB pro Import; Text muss UTF-8 sein. |
| SysML-v2-JSON (.json) | Import und Export | Die flache Elementliste mit @id und @type, die die Systems Modeling API verwendet. Element-IDs bleiben erhalten, daher ordnet ein erneuter Import nach ID zu. | Bis zu 24 MB und 100.000 Elemente. Elementarten, die Holarch nicht interpretiert, werden wie importiert beibehalten, als Nicht interpretiert markiert und unverändert zurückgeschrieben. |
| SysML-v2-Modell-Repository | Abrufen und übertragen | Verbinden Sie ein SysML-v2-Projekt mit einem Branch eines Repositorys, das die Systems Modeling API anbietet. Rufen Sie den neuesten Commit ab und prüfen Sie jeden Unterschied, bevor Sie ihn anwenden; übertragen Sie Ihre Änderungen als einen Commit. | Nur https-Adressen auf öffentlichen Hosts. Eine Übertragung wird abgelehnt, solange der Branch Commits hat, die nicht abgerufen wurden. 64 MB pro Abruf, 120 Sekunden pro Vorgang und 300 Vorgänge pro Konto und Stunde. Erfordert die Rolle Bearbeiter. |
| Systems Modeling API in Holarch | Lesen und Committen durch andere Werkzeuge | Andere SysML-v2-Werkzeuge lesen die Elemente eines SysML-v2-Projekts als SysML-v2-JSON über REST, mit einem persönlichen Zugriffstoken, und committen Änderungen in Branches von Änderungsanträgen. | main ist schreibgeschützt; Commits gehen in Änderungsanträge, die ein Genehmiger in Holarch anwendet. Nur Branch-Köpfe; keine Tags, Merges oder gespeicherten Abfragen. |
| SysML v1 zu SysML v2 (.xmi, .uml, .xml, .mdzip) | Import | Ein SysML-1.x-Modell aus Cameo oder MagicDraw, Enterprise Architect, Rhapsody oder Papyrus wird in SysML-v2-Text umgewandelt, geprüft und als ein Rückgängig-Schritt in ein SysML-v2-Projekt oder ein neues importiert. Ein Umwandlungsbericht listet jedes Element als umgewandelt, angenähert oder ausgelassen auf, mit dem Grund, und lässt sich als CSV herunterladen. | Diagramme und ihr Layout werden nicht umgewandelt. Beziehungen zu unbenannten Elementen werden ausgelassen. |
| LML zu SysML v2 und zurück | Umgewandelte Kopie, in beide Richtungen | Ein neues Projekt in der anderen Sprache: Assets, Ports, Conduits, Input/Outputs, Anforderungen, satisfy-Links, Testfälle, Actions mit ihrem Ablauf, Zustände und Gleichungen. Risiken, Entscheidungen, Aufgaben, Dokumente, Whiteboards, Anforderungsstatus und Testergebnisse kommen mit. Ein Bericht listet auf, was umgewandelt wurde und was nicht, und lässt sich als CSV herunterladen. | Diagrammlayouts, Verlauf, Baselines und Änderungsanträge werden nicht umgewandelt. Elemente, für die eine Sprache keinen Platz hat, etwa LML-Measures und -Resources oder SysML-v2-Berechnungen und Analysis Cases, werden im Bericht aufgeführt. |
Holarch-Daten neben einem SysML-v2-Modell, etwa Anforderungsstatus, Risiken, Budgets und Ansichtslayouts, sind nicht Teil von .sysml- oder SysML-v2-JSON-Dateien. Ein Projektexport behält sie.
Tabellen
| Format | Richtung | Was es abdeckt | Bekannte Grenzen |
|---|---|---|---|
| Excel (.xlsx, .xlsm) und CSV | Import | Neue oder aktualisierte Elemente jeder Klasse, mit einer Spaltenzuordnung, die aus den Überschriften vorgeschlagen wird. Attribute, Labels, Beziehungen, Hierarchie aus einer Elternspalte oder aus den Nummern und neue, aus den Daten erstellte Attribute. Ordnen Sie vorhandene Elemente nach ID, Name oder Nummer zu, um sie zu aktualisieren. | Excel 97-2003 (.xls) und durch Semikolon getrennte CSV-Dateien werden nicht gelesen. Namen und Nummern werden auf 255 Zeichen gekürzt. |
| Excel und CSV aus der Datenbank | Export | Eine beliebige Menge von Elementen als Tabelle mit gewählten Attributen und Beziehungen, mit Hierarchie und Aufsummierungen, als Definitionen, als Beziehungsmatrix, als Änderungsverlauf oder als Kommentare. | Excel-Zellen fassen bis zu 32.000 Zeichen; längerer Text wird gekürzt. |
| Excel und CSV aus anderen Seiten | Export | RVTM, VCRM, RVM, RTM, RSM und TVM; Ergebnisse der Anforderungsqualität; TBD/TBR-Register; Schnittstellenregister; N²- und I²-Matrizen; Budgets und TPMs; Risikoregister; Trade-Studien; Tabellen der Funktionsanalyse; Baseline-Vergleiche; Chart-Daten; Zeitachsen, Ereignisprotokolle und Läufe des Simulators. | Jede Seite exportiert ihre eigenen Spalten. |
| Nachverfolgbarkeitsmatrix (.xlsx, .csv) | Import und Export | Exportieren Sie eine beliebige Beziehung als Matrix. Bearbeiten Sie die Arbeitsmappe in einer Tabellenkalkulation und importieren Sie sie zurück: Die Vorschau listet die hinzuzufügenden Links, die zu entfernenden Links und die übersprungenen Zellen auf. | Der Import fügt nur Links zwischen vorhandenen Elementen hinzu oder entfernt sie. Zellen, die das Schema nicht erlaubt, werden übersprungen und aufgelistet. |
Dokumente und Berichte
| Format | Richtung | Was es abdeckt | Bekannte Grenzen |
|---|---|---|---|
| Word (.docx) | Export | Dokumente und Gliederungen mit Word-Überschriftenformaten, Kennzeichnungen, Deckblättern und Seitenzahlen; Änderungsansichten mit Überarbeitungen zwischen Baselines; Aufschlüsselungen von Entitäten; Diagrammberichte; ICDs; Testfälle; RVTM und Nachverfolgbarkeitsmatrizen; Zusammenfassungen von Trade-Studien; Berichte zur Funktionsanalyse; das DoDAF-Architekturpaket. | Seiten sind im Format US Letter. |
| PowerPoint (.pptx) | Export | Präsentationen, eine Folie pro Seite, mit Textfeldern, Formen und Sprechernotizen. Präsentationen lassen sich auch als HTML und Word exportieren. | Keine bekannt. |
| Markdown (.md) | Export | Ein Dokument als Markdown-Überschriften und -Text. | Keine bekannt. |
| HTML | Export | Webseiten von Diagrammen, Diagrammberichten, Charts, Präsentationen und Nachverfolgbarkeitsmatrizen. | Keine bekannt. |
| Drucken und PDF | Export | Dokumente, Tabellen und Diagramme über den Druckdialog des Browsers, der PDF speichert. Whiteboards exportieren PDF direkt. | PDF-Seiten von Whiteboards sind Bilder. |
Bilder
| Format | Richtung | Was es abdeckt | Bekannte Grenzen |
|---|---|---|---|
| PNG und SVG | Export | Diagramme, Charts, Folien, Simulatorbereiche und Galeriekarten. PNG in gewählter Skalierung, mit oder ohne Hintergrund; SVG als skalierbares Vektorbild. | Keine bekannt. |
| Whiteboards: PNG, JPG, SVG, PDF | Export | Ein Board, eine Auswahl, die aktuelle Ansicht, ein Frame oder alle Boards. SVG hält Formen und Text in Vektorwerkzeugen bearbeitbar. | PDF-Seiten sind Bilder. |
| Bilder und angehängte Dateien | Import | Bilder in Rich Text, Entitätsbilder, Dateiattribute, Whiteboards und Folien. PNG-, JPEG- oder SVG-Grafiken für DoDAF-Produkte, etwa ein OV-1 mit Hotspots. | Bilder über 4.000 px auf der längsten Seite werden verkleinert. Dateien sind auf 10 MB im Plan Free, 25 MB in Individual und 100 MB in Team begrenzt, Projekte auf 100 MB im Plan Free. |
Projektdateien
| Format | Richtung | Was es abdeckt | Bekannte Grenzen |
|---|---|---|---|
| Holarch-Backup (.holarch) und Projektdatei (.json) | Import und Export | Ein ganzes Projekt zur Sicherung oder zum Umzug auf einen anderen Holarch-Server: Elemente, Beziehungen, Diagramme, Baselines, Kommentare, Verlauf und Start-Einstellungen, mit Anhängen und Bildern. Ein .holarch-Backup enthält eine Prüfsumme für jeden Teil und wird vor dem Import geprüft. Wird als neues Projekt importiert, dessen Eigentümer Sie sind. Die Formate Backup und JSON sind dokumentiert. | Immer ein neues Projekt; um in ein geöffnetes Projekt zusammenzuführen, verwenden Sie den Zusammenführungsimport unten. |
| In ein Projekt zusammenführen (.holarch, .json) | Import | Holarch-Backups und -Pakete mit ihren angehängten Dateien sowie Holarch-Projekt-, Datenbank- und Dokumentexporte, in das geöffnete Projekt zusammengeführt. Klassen, Attribute, Labels und Beziehungen werden nach Namen zugeordnet, und fehlende Schemaelemente können zuerst hinzugefügt werden. Kommentare, Verlauf und Diagrammlayouts kommen auf Wunsch mit. | Simulationsskripte aus einer Datei werden als importiert markiert, und der Simulator fragt, bevor er sie ausführt. |
| Projektpaket (.holarch) | Export | Die gewählten Elemente mit ihren Beziehungen, Diagrammen, Kommentaren und ihrem Schema sowie jede angehängte Datei, beim Import auf Beschädigung geprüft. | Enthält die gewählten Elemente; Baselines und Verlauf sind nicht enthalten. |
| Schema (.json) | Import und Export | Die Klassen, Relationen, Attribute und Labels eines Projekts. Der Import ergänzt, was dem Projekt fehlt, oder ersetzt das Schema. | Keine bekannt. |
| Baselines und Dokumentdaten (.json) | Export; Dokumentdaten auch Import | Eine Baseline mit Datum, Dokument, Genehmigungen und Schnappschuss. Die Elemente, Beziehungen und der Zustand eines Dokuments, die in ein anderes Projekt zusammengeführt werden können. | Keine bekannt. |
| DoDAF-Produkte (JSON) und DM2-PES-Teilmenge (XML) | Export | Die Architekturbeschreibung, jedes Produkt mit seinen Daten und das Wörterbuch. Das XML schreibt das Wörterbuch in Begriffen des DoDAF-Metamodells. | Das XML verwendet einen eigenen Namespace von Holarch und wird nicht gegen das DM2-PES-Schema validiert. |
| MS-Project-Zeitplan (.xml) | Export | Die Gantt-Zeilen eines Simulationslaufs als MS-Project-XML-Zeitplan. | Nur aus Simulatorläufen. |
API und MCP
Skripte lesen und ändern Projekte über die REST-API, mit einem persönlichen Zugriffstoken und einer OpenAPI-Beschreibung. KI-Werkzeuge wie Claude verbinden sich über das Model Context Protocol (MCP); ihre Änderungen kommen als Vorschläge an, die Sie prüfen, bevor sie angewendet werden. Siehe API und MCP.