Esportazione

Archyl ti permette di esportare i tuoi diagrammi architetturali in diversi formati per l'uso in presentazioni, documenti e strumenti esterni.

Formati Disponibili

PNG (Immagine Raster)

Ideale per:

• Presentazioni (PowerPoint, Google Slides)
• Documenti (Word, Google Docs)
• Condivisione via chat ed email
• Post sui social media

Le esportazioni PNG mantengono la piena qualità visiva con risoluzione personalizzabile.

SVG (Grafica Vettoriale)

Ideale per:

• Strumenti di design (Figma, Sketch, Illustrator)
• Stampa ad alta risoluzione
• Incorporamento web
• Ulteriore modifica

Le esportazioni SVG sono scalabili a qualsiasi dimensione senza perdita di qualità.

PDF (Formato Documento)

Ideale per:

• Stampa
• Documentazione formale
• Scopi d'archivio
• Esportazioni multi-pagina

Le esportazioni PDF includono tutto lo stile e possono estendersi su più pagine.

Come Esportare

Esportazione Singolo Livello

1. Naviga al livello C4 che vuoi esportare
2. Clicca su Esporta nella barra degli strumenti
3. Seleziona il formato (PNG, SVG o PDF)
4. Configura le opzioni
5. Clicca su Esporta

Esporta Tutti i Livelli

Per esportare tutti e quattro i livelli C4 in una volta:

1. Clicca su Esporta nella barra degli strumenti
2. Seleziona il formato
3. Seleziona Esporta tutti i livelli
4. Clicca su Esporta

Questo genera file separati per ogni livello:

• nome-progetto-contesto-sistema.png
• nome-progetto-container.png
• nome-progetto-componente.png
• nome-progetto-codice.png

Opzioni di Esportazione

Opzioni Sfondo

Per documenti con temi chiari, le esportazioni trasparenti funzionano meglio.

Impostazioni di Qualità

Per le esportazioni PNG:

• Standard: Buona per la visualizzazione a schermo
• Alta: Migliore per le presentazioni
• Stampa: Ideale per la stampa fisica

Opzioni Viewport

• Adatta al contenuto: Esporta solo il contenuto del diagramma
• Includi margine: Aggiungi margine intorno al diagramma
• Vista corrente: Esporta esattamente ciò che è visibile sullo schermo

Suggerimenti per i Migliori Risultati

Per le Presentazioni

1. Esporta come PNG con alta qualità
2. Includi lo sfondo per slide scure
3. Usa trasparente per slide chiare
4. Esporta al livello C4 appropriato per il tuo pubblico

Per la Documentazione

1. Esporta come SVG per la scalabilità
2. Usa sfondo trasparente
3. Considera di esportare tutti i livelli
4. Aggiungi le esportazioni al tuo repository di documentazione

Per la Stampa

1. Esporta come PDF
2. Scegli alta risoluzione
3. Includi lo sfondo per impatto visivo
4. Verifica l'anteprima di stampa prima di stampare

Per Strumenti di Design

1. Esporta come SVG
2. Importa nel tuo strumento di design
3. Gli elementi rimangono modificabili
4. Colori e stili sono preservati

Automazione con API

Puoi automatizzare le esportazioni usando l'API di Archyl:

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

Questo abilita:

• Integrazione CI/CD per la documentazione
• Esportazioni programmate per reportistica
• Esportazioni in blocco tra progetti

Esportazione JSON (Portabilità dei Dati)

Per backup, migrazione o condivisione di dati architetturali completi, esporta il tuo progetto come JSON.

Cosa Viene Esportato

L'esportazione JSON include il tuo modello C4 completo:

• Sistemi con descrizioni, tecnologie, tag e posizioni
• Container annidati nei sistemi padre
• Componenti annidati nei container padre
• Elementi di codice inclusi metodi e proprietà
• Relazioni tra tutti gli elementi con descrizioni e stile
• Overlay con posizioni, dimensioni ed elementi contenuti

L'esportazione preserva il layout del diagramma, quindi i progetti importati appaiono esattamente come li hai progettati.

Come Esportare in JSON

1. Apri il progetto che vuoi esportare
2. Clicca su Esporta nella barra degli strumenti
3. Seleziona il formato JSON
4. Clicca su Esporta
5. Salva il file scaricato

Il file è denominato {nome-progetto}-{data}.json e contiene JSON leggibile.

Esportazione via API

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

Restituisce i dati completi del progetto come JSON, abilitando backup automatizzati e integrazione CI/CD.

Importazione Progetti

Puoi creare un nuovo progetto importando da più formati. Archyl supporta quattro fonti di importazione:

Come Importare

1. Dalla lista progetti, clicca su Importa Progetto
2. Seleziona la scheda del formato sorgente (Archyl YAML, Structurizr DSL, LikeC4 o IcePanel)
3. Carica il file o incolla il suo contenuto
4. Clicca su Valida per visualizzare l'anteprima di ciò che verrà creato
5. Clicca su Crea Progetto

L'intero processo richiede meno di un minuto. Tutti i sistemi, container, componenti, relazioni, tecnologie e tag vengono importati automaticamente.

Importazione Structurizr DSL

Archyl analizza i file workspace .dsl di Structurizr ed estrae il modello C4 completo: elementi person, softwareSystem, container, component, tutte le relazioni, tecnologie e tag.

Importazione LikeC4

Archyl è il primo strumento a importare file LikeC4. I tipi di elementi personalizzati, le gerarchie annidate, le proprietà, i tag hashtag e i blocchi di modello multipli sono tutti supportati.

Importazione IcePanel JSON

L'esportazione JSON di IcePanel è completamente supportata: tipi system, actor, app, store, component, campo external, modelConnections e risoluzione dei tag.

Importazione via MCP (Agenti IA)

La stessa capacità di importazione è disponibile tramite lo strumento MCP import_dsl per gli agenti di codifica IA (Claude Code, Cursor, Windsurf).

Importazione in Progetti Esistenti

Puoi anche importare in un progetto esistente. Gli elementi già esistenti vengono aggiornati; i nuovi elementi vengono creati.

Prossimi Passi

• Condivisione e Incorporamento - Condividere diagrammi live
• Panoramica API - Automatizzare le esportazioni via API
• Documentazione - Includere le esportazioni nei docs