Export

Archyl ermöglicht es Ihnen, Ihre Architekturdiagramme in mehreren Formaten zu exportieren, um sie in Präsentationen, Dokumenten und externen Tools zu verwenden.

Verfügbare Formate

PNG (Rasterbild)

Am besten für:

• Präsentationen (PowerPoint, Google Slides)
• Dokumente (Word, Google Docs)
• Chat- und E-Mail-Sharing
• Social-Media-Posts

PNG-Exporte behalten volle visuelle Qualität mit anpassbarer Auflösung.

SVG (Vektorgrafik)

Am besten für:

• Design-Tools (Figma, Sketch, Illustrator)
• Hochauflösender Druck
• Web-Einbettung
• Weitere Bearbeitung

SVG-Exporte sind auf jede Größe skalierbar ohne Qualitätsverlust.

PDF (Dokumentformat)

Am besten für:

• Drucken
• Formale Dokumentation
• Archivierungszwecke
• Mehrseitige Exporte

PDF-Exporte enthalten alle Formatierungen und können mehrere Seiten umfassen.

So exportieren Sie

Einzelebenen-Export

1. Navigieren Sie zur C4-Ebene, die Sie exportieren möchten
2. Klicken Sie auf Export in der Toolbar
3. Wählen Sie Ihr Format (PNG, SVG, oder PDF)
4. Konfigurieren Sie die Optionen
5. Klicken Sie auf Exportieren

Alle Ebenen exportieren

Um alle vier C4-Ebenen auf einmal zu exportieren:

1. Klicken Sie auf Export in der Toolbar
2. Wählen Sie Ihr Format
3. Aktivieren Sie Alle Ebenen exportieren
4. Klicken Sie auf Exportieren

Dies generiert separate Dateien für jede Ebene:

• projektname-systemkontext.png
• projektname-container.png
• projektname-komponente.png
• projektname-code.png

Export-Optionen

Hintergrund-Optionen

Für Dokumente mit hellen Themes funktionieren transparente Exporte am besten.

Qualitätseinstellungen

Für PNG-Exporte:

• Standard: Gut für Bildschirmansicht
• Hoch: Besser für Präsentationen
• Druck: Am besten für physischen Druck

Viewport-Optionen

• An Inhalt anpassen: Nur den Diagramminhalt exportieren
• Padding einschließen: Rand um das Diagramm hinzufügen
• Aktuelle Ansicht: Genau das exportieren, was auf dem Bildschirm sichtbar ist

Tipps für beste Ergebnisse

Für Präsentationen

1. Als PNG mit hoher Qualität exportieren
2. Hintergrund für dunkle Folien einschließen
3. Transparent für helle Folien verwenden
4. Auf der passenden C4-Ebene für Ihr Publikum exportieren

Für Dokumentation

1. Als SVG für Skalierbarkeit exportieren
2. Transparenten Hintergrund verwenden
3. Export aller Ebenen in Betracht ziehen
4. Exporte zu Ihrem Dokumentations-Repository hinzufügen

Für Druck

1. Als PDF exportieren
2. Hohe Auflösung wählen
3. Hintergrund für visuelle Wirkung einschließen
4. Druckvorschau vor dem Drucken prüfen

Für Design-Tools

1. Als SVG exportieren
2. In Ihr Design-Tool importieren
3. Elemente bleiben bearbeitbar
4. Farben und Stile werden beibehalten

Automatisierung mit API

Sie können Exporte mit der Archyl-API automatisieren:

curl -X GET \
  -H "X-API-Key: ihr-api-schluessel" \
  "https://api.archyl.com/api/v1/projects/{projectId}/export?format=png&level=system-context"

Dies ermöglicht:

• CI/CD-Integration für Dokumentation
• Geplante Exporte für Berichte
• Massenexporte über Projekte hinweg

JSON-Export (Datenportabilität)

Für Backup, Migration oder das Teilen vollständiger Architekturdaten exportieren Sie Ihr Projekt als JSON.

Was exportiert wird

Der JSON-Export enthält Ihr vollständiges C4-Modell:

• Systeme mit Beschreibungen, Technologien, Tags und Positionen
• Container verschachtelt in ihren Elternsystemen
• Komponenten verschachtelt in ihren Elterncontainern
• Code-Elemente einschließlich Methoden und Eigenschaften
• Beziehungen zwischen allen Elementen mit Beschreibungen und Styling
• Overlays mit Positionen, Dimensionen und enthaltenen Elementen

Der Export bewahrt Ihr Diagramm-Layout, sodass importierte Projekte genau so aussehen, wie Sie sie gestaltet haben.

So exportieren Sie JSON

1. Öffnen Sie das Projekt, das Sie exportieren möchten
2. Klicken Sie auf Export in der Toolbar
3. Wählen Sie das JSON-Format
4. Klicken Sie auf Exportieren
5. Speichern Sie die heruntergeladene Datei

Die Datei heißt {projektname}-{datum}.json und enthält lesbares JSON.

Export via API

curl -X GET \
  -H "X-API-Key: ihr-api-schluessel" \
  "https://api.archyl.com/api/v1/projects/{projectId}/export"

Dies gibt die vollständigen Projektdaten als JSON zurück und ermöglicht automatisierte Backups und CI/CD-Integration.

Projekte importieren

Sie können ein neues Projekt erstellen, indem Sie aus mehreren Formaten importieren. Archyl unterstützt vier Importquellen:

So importieren Sie

1. Klicken Sie in Ihrer Projektliste auf Projekt importieren
2. Wählen Sie den Quellformat-Tab (Archyl YAML, Structurizr DSL, LikeC4 oder IcePanel)
3. Laden Sie die Datei hoch oder fügen Sie den Inhalt ein
4. Klicken Sie auf Validieren, um eine Vorschau des Ergebnisses zu sehen
5. Klicken Sie auf Projekt erstellen

Der gesamte Vorgang dauert weniger als eine Minute. Alle Systeme, Container, Komponenten, Beziehungen, Technologien und Tags werden automatisch importiert.

Structurizr DSL-Import

Archyl analysiert Structurizrs .dsl-Workspace-Dateien und extrahiert das vollständige C4-Modell: Person-, SoftwareSystem-, Container- und Component-Elemente, alle Beziehungen, Technologien und Tags.

LikeC4-Import

Archyl ist das erste Tool, das LikeC4-Dateien importiert. Benutzerdefinierte Element-Typen, verschachtelte Hierarchien, Eigenschaften, Hashtag-Tags und mehrere Modellblöcke werden vollständig unterstützt.

IcePanel JSON-Import

IcePanels JSON-Export wird vollständig unterstützt: System-, Actor-, App-, Store- und Component-Typen, das External-Feld, modelConnections und Tag-Auflösung.

Import via MCP (KI-Agenten)

Dieselbe Import-Funktionalität ist über das MCP-Tool import_dsl für KI-Coding-Agenten (Claude Code, Cursor, Windsurf) verfügbar.

Import in bestehende Projekte

Sie können auch in ein bestehendes Projekt importieren. Bereits vorhandene Elemente werden aktualisiert; neue Elemente werden erstellt.

Nächste Schritte

• Teilen & Einbetten - Live-Diagramme teilen
• API-Übersicht - Exporte via API automatisieren
• Dokumentation - Exporte in Docs einbinden