Exportar

Archyl te permite exportar tus diagramas de arquitectura en múltiples formatos para usar en presentaciones, documentos y herramientas externas.

Formatos Disponibles

PNG (Imagen Raster)

Ideal para:

• Presentaciones (PowerPoint, Google Slides)
• Documentos (Word, Google Docs)
• Compartir por chat y email
• Publicaciones en redes sociales

Las exportaciones PNG mantienen calidad visual completa con resolución personalizable.

SVG (Gráficos Vectoriales)

Ideal para:

• Herramientas de diseño (Figma, Sketch, Illustrator)
• Impresión de alta resolución
• Integración web
• Edición posterior

Las exportaciones SVG son escalables a cualquier tamaño sin pérdida de calidad.

PDF (Formato de Documento)

Ideal para:

• Impresión
• Documentación formal
• Propósitos de archivo
• Exportaciones multipágina

Las exportaciones PDF incluyen todo el estilo y pueden abarcar múltiples páginas.

Cómo Exportar

Exportación de Un Solo Nivel

1. Navega al nivel C4 que quieres exportar
2. Haz clic en Exportar en la barra de herramientas
3. Selecciona tu formato (PNG, SVG, o PDF)
4. Configura las opciones
5. Haz clic en Exportar

Exportar Todos los Niveles

Para exportar los cuatro niveles C4 a la vez:

1. Haz clic en Exportar en la barra de herramientas
2. Selecciona tu formato
3. Marca Exportar todos los niveles
4. Haz clic en Exportar

Esto genera archivos separados para cada nivel:

• nombre-proyecto-contexto-sistema.png
• nombre-proyecto-contenedor.png
• nombre-proyecto-componente.png
• nombre-proyecto-codigo.png

Opciones de Exportación

Opciones de Fondo

Para documentos con temas claros, las exportaciones transparentes funcionan mejor.

Configuración de Calidad

Para exportaciones PNG:

• Estándar: Bueno para visualización en pantalla
• Alta: Mejor para presentaciones
• Impresión: Ideal para impresión física

Opciones de Viewport

• Ajustar al contenido: Exportar solo el contenido del diagrama
• Incluir padding: Agregar margen alrededor del diagrama
• Vista actual: Exportar exactamente lo que es visible en pantalla

Consejos para Mejores Resultados

Para Presentaciones

1. Exporta como PNG con alta calidad
2. Incluye fondo para diapositivas oscuras
3. Usa transparente para diapositivas claras
4. Exporta al nivel C4 apropiado para tu audiencia

Para Documentación

1. Exporta como SVG para escalabilidad
2. Usa fondo transparente
3. Considera exportar todos los niveles
4. Agrega las exportaciones a tu repositorio de documentación

Para Impresión

1. Exporta como PDF
2. Elige alta resolución
3. Incluye fondo para impacto visual
4. Revisa la vista previa antes de imprimir

Para Herramientas de Diseño

1. Exporta como SVG
2. Importa en tu herramienta de diseño
3. Los elementos permanecen editables
4. Los colores y estilos se preservan

Automatización con API

Puedes automatizar exportaciones usando la API de Archyl:

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

Esto permite:

• Integración CI/CD para documentación
• Exportaciones programadas para reportes
• Exportaciones masivas a través de proyectos

Exportación JSON (Portabilidad de Datos)

Para respaldo, migración o compartir datos de arquitectura completos, exporta tu proyecto como JSON.

Qué se Exporta

La exportación JSON incluye tu modelo C4 completo:

• Sistemas con descripciones, tecnologías, tags y posiciones
• Contenedores anidados dentro de sus sistemas padre
• Componentes anidados dentro de sus contenedores padre
• Elementos de código incluyendo métodos y propiedades
• Relaciones entre todos los elementos con descripciones y estilo
• Overlays con posiciones, dimensiones y elementos contenidos

La exportación preserva el diseño de tu diagrama, así que los proyectos importados se ven exactamente como los diseñaste.

Cómo Exportar JSON

1. Abre el proyecto que quieres exportar
2. Haz clic en Exportar en la barra de herramientas
3. Selecciona el formato JSON
4. Haz clic en Exportar
5. Guarda el archivo descargado

El archivo se llama {nombre-proyecto}-{fecha}.json y contiene JSON legible.

Exportar vía API

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

Esto devuelve los datos completos del proyecto como JSON, permitiendo respaldos automatizados e integración CI/CD.

Importar Proyectos

Puedes crear un nuevo proyecto importando desde múltiples formatos. Archyl soporta cuatro fuentes de importación:

Cómo Importar

1. Desde tu lista de proyectos, haz clic en Importar Proyecto
2. Selecciona la pestaña del formato fuente (Archyl YAML, Structurizr DSL, LikeC4 o IcePanel)
3. Sube el archivo o pega su contenido
4. Haz clic en Validar para previsualizar lo que se creará
5. Haz clic en Crear Proyecto

El proceso completo toma menos de un minuto. Todos los sistemas, contenedores, componentes, relaciones, tecnologías y tags se importan automáticamente.

Importación de Structurizr DSL

Archyl analiza los archivos workspace .dsl de Structurizr y extrae el modelo C4 completo: elementos person, softwareSystem, container, component, todas las relaciones, tecnologías y tags.

Importación de LikeC4

Archyl es la primera herramienta en importar archivos LikeC4. Los tipos de elementos personalizados, jerarquías anidadas, propiedades, tags hashtag y múltiples bloques de modelo son todos soportados.

Importación de IcePanel JSON

La exportación JSON de IcePanel es completamente soportada: tipos system, actor, app, store, component, campo external, modelConnections y resolución de tags.

Importación vía MCP (Agentes IA)

La misma capacidad de importación está disponible a través de la herramienta MCP import_dsl para agentes de codificación IA (Claude Code, Cursor, Windsurf).

Importar en Proyectos Existentes

También puedes importar en un proyecto existente. Los elementos que ya existen se actualizan; los nuevos elementos se crean.

Próximos Pasos

• Compartir e Integrar - Compartir diagramas en vivo
• Visión General de API - Automatizar exportaciones vía API
• Documentación - Incluir exportaciones en docs