Architecture as Code - Archyl Docs

Définissez et synchronisez votre architecture C4 avec archyl.yaml — versionné, intégré au CI/CD et entièrement déclaratif

Export

Archyl vous permet d'exporter vos diagrammes d'architecture dans plusieurs formats pour une utilisation dans des présentations, documents et outils externes.

Formats Disponibles

PNG (Image Raster)

Idéal pour :

  • Présentations (PowerPoint, Google Slides)
  • Documents (Word, Google Docs)
  • Partage par chat et email
  • Publications sur les réseaux sociaux

Les exports PNG maintiennent une qualité visuelle complète avec une résolution personnalisable.

SVG (Graphiques Vectoriels)

Idéal pour :

  • Outils de design (Figma, Sketch, Illustrator)
  • Impression haute résolution
  • Intégration web
  • Édition ultérieure

Les exports SVG sont redimensionnables à n'importe quelle taille sans perte de qualité.

PDF (Format Document)

Idéal pour :

  • Impression
  • Documentation formelle
  • Archivage
  • Exports multi-pages

Les exports PDF incluent tout le style et peuvent s'étendre sur plusieurs pages.

Comment Exporter

Export d'un Seul Niveau

  1. Naviguez vers le niveau C4 que vous voulez exporter
  2. Cliquez sur Export dans la barre d'outils
  3. Sélectionnez votre format (PNG, SVG, ou PDF)
  4. Configurez les options
  5. Cliquez sur Exporter

Exporter Tous les Niveaux

Pour exporter les quatre niveaux C4 en une fois :

  1. Cliquez sur Export dans la barre d'outils
  2. Sélectionnez votre format
  3. Cochez Exporter tous les niveaux
  4. Cliquez sur Exporter

Cela génère des fichiers séparés pour chaque niveau :

  • nom-projet-contexte-systeme.png
  • nom-projet-conteneur.png
  • nom-projet-composant.png
  • nom-projet-code.png

Options d'Export

Options d'Arrière-plan

Option Description
Inclure l'arrière-plan Exporter avec l'arrière-plan sombre du canevas
Transparent Exporter sans arrière-plan (s'adapte à tout document)

Pour les documents avec thèmes clairs, les exports transparents fonctionnent mieux.

Paramètres de Qualité

Pour les exports PNG :

  • Standard : Bon pour la visualisation à l'écran
  • Haute : Meilleur pour les présentations
  • Impression : Idéal pour l'impression physique

Options de Viewport

  • Ajuster au contenu : Exporter uniquement le contenu du diagramme
  • Inclure le padding : Ajouter une marge autour du diagramme
  • Vue actuelle : Exporter exactement ce qui est visible à l'écran

Conseils pour les Meilleurs Résultats

Pour les Présentations

  1. Exportez en PNG avec haute qualité
  2. Incluez l'arrière-plan pour les slides sombres
  3. Utilisez transparent pour les slides clairs
  4. Exportez au niveau C4 approprié pour votre audience

Pour la Documentation

  1. Exportez en SVG pour l'évolutivité
  2. Utilisez l'arrière-plan transparent
  3. Envisagez d'exporter tous les niveaux
  4. Ajoutez les exports à votre dépôt de documentation

Pour l'Impression

  1. Exportez en PDF
  2. Choisissez haute résolution
  3. Incluez l'arrière-plan pour l'impact visuel
  4. Vérifiez l'aperçu avant impression

Pour les Outils de Design

  1. Exportez en SVG
  2. Importez dans votre outil de design
  3. Les éléments restent modifiables
  4. Les couleurs et styles sont préservés

Automatisation avec l'API

Vous pouvez automatiser les exports en utilisant l'API Archyl :

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

Cela permet :

  • Intégration CI/CD pour la documentation
  • Exports planifiés pour les rapports
  • Exports en masse à travers les projets

Export JSON (Portabilité des Données)

Pour la sauvegarde, la migration ou le partage de données d'architecture complètes, exportez votre projet en JSON.

Ce qui est Exporté

L'export JSON inclut votre modèle C4 complet :

  • Systèmes avec descriptions, technologies, tags et positions
  • Conteneurs imbriqués dans leurs systèmes parents
  • Composants imbriqués dans leurs conteneurs parents
  • Éléments de code incluant méthodes et propriétés
  • Relations entre tous les éléments avec descriptions et style
  • Overlays avec positions, dimensions et éléments contenus

L'export préserve la disposition de votre diagramme, donc les projets importés ressemblent exactement à ce que vous avez conçu.

Comment Exporter en JSON

  1. Ouvrez le projet que vous voulez exporter
  2. Cliquez sur Export dans la barre d'outils
  3. Sélectionnez le format JSON
  4. Cliquez sur Exporter
  5. Enregistrez le fichier téléchargé

Le fichier est nommé {nom-projet}-{date}.json et contient du JSON lisible.

Export via API

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

Cela retourne les données complètes du projet en JSON, permettant des sauvegardes automatisées et l'intégration CI/CD.

Importer des Projets

Vous pouvez créer un nouveau projet en important depuis plusieurs formats. Archyl prend en charge quatre sources d'import :

Format Type de fichier Outil source
Archyl YAML .yaml / .yml Format natif d'Archyl
Structurizr DSL .dsl Structurizr
LikeC4 .c4 / .likec4 LikeC4
IcePanel JSON .json IcePanel

Comment Importer

  1. Depuis votre liste de projets, cliquez sur Importer un Projet
  2. Sélectionnez l'onglet du format source (Archyl YAML, Structurizr DSL, LikeC4 ou IcePanel)
  3. Uploadez le fichier ou collez son contenu
  4. Cliquez sur Valider pour prévisualiser ce qui sera créé
  5. Cliquez sur Créer le Projet

L'ensemble du processus prend moins d'une minute. Tous les systèmes, conteneurs, composants, relations, technologies et tags sont importés automatiquement.

Import Structurizr DSL

Archyl analyse les fichiers workspace .dsl de Structurizr et extrait le modèle C4 complet : éléments person, softwareSystem, container, component, toutes les relations, technologies et tags.

Import LikeC4

Archyl est le premier outil à importer des fichiers LikeC4. Les types d'éléments personnalisés, les hiérarchies imbriquées, les propriétés, les tags hashtag et les blocs de modèle multiples sont tous pris en charge.

Import IcePanel JSON

L'export JSON d'IcePanel est entièrement pris en charge : types system, actor, app, store, component, champ external, modelConnections et résolution des tags.

Import via MCP (Agents IA)

La même capacité d'import est disponible via l'outil MCP import_dsl pour les agents de codage IA (Claude Code, Cursor, Windsurf).

Import dans des Projets Existants

Vous pouvez également importer dans un projet existant. Les éléments qui existent déjà sont mis à jour ; les nouveaux éléments sont créés.

Prochaines Étapes