Saltar al contenido

Herramienta gratuita

Structurizr DSL a diagrama de modelo C4

Pega un workspace de Structurizr DSL o una exportación JSON del workspace y ve las vistas de tu modelo C4 como diagramas editables: personas, sistemas de software, contenedores, componentes y nodos de despliegue, con las relaciones etiquetadas con su descripción. Elige una vista o ábrelas todas como diagramas separados.

Resultado de ejemplo

Diagrama de ejemplo dibujado a partir de un ejemplo de Structurizr
Prueba un ejemploBanca en línea (DSL)Seguimiento de paquetes (JSON)

Cómo funciona

  1. Pega o suelta tu workspace

    Un archivo workspace.dsl, DSL copiado del playground de Structurizr o el JSON que exporta Structurizr. Se leen los bloques model y views; los styles pueden quedarse en el texto.

  2. Ve cada vista C4

    Se listan todas las vistas del workspace, desde el paisaje de sistemas hasta los componentes y el despliegue. Elige una y la vista previa la vuelve a dibujar con tarjetas C4, límites y flechas etiquetadas.

  3. Ábrela en Archboard

    Guarda la vista como un diagrama nuevo para reorganizarla, anotarla, compartir un enlace o exportarla en SVG y PNG. Para registrarte basta una cuenta de Google o GitHub.

Qué se dibuja de un workspace de Structurizr

La vista elegida se construye con estas partes del modelo:

  • person

    Las personas, como tarjetas de persona C4 con su descripción. Una persona con el tag External, o con location External en una exportación JSON, pasa a ser una persona externa.

  • softwareSystem

    Los sistemas de software, como tarjetas de sistema C4 con su descripción. Los sistemas con el tag External pasan a ser tarjetas de sistema externo, que muestran solo el nombre.

  • container

    Los contenedores, como tarjetas con su tecnología y su descripción. Un contenedor con el tag Database pasa a ser una tarjeta de base de datos, que muestra solo el nombre. El tag Queue, el tag External (contenedor o component) y un bloque enterprise tienen cada uno su propio tipo C4.

  • component

    Los componentes, como tarjetas con su tecnología, dentro del contenedor al que pertenecen.

  • ->

    Las relaciones, como flechas etiquetadas con su descripción y, después, la tecnología entre corchetes. Si una vista muestra solo a los padres, una relación entre sus hijos se dibuja una sola vez entre los padres.

  • container bankingcomponent banking.api

    El alcance de una vista de contenedores o de componentes, como marco: el sistema de software en la vista de contenedores, el contenedor en la vista de componentes.

  • group

    Los grupos, como marcos alrededor de las personas, sistemas o contenedores que contienen. Un grupo vacío se omite.

  • deploymentNodeinfrastructureNodecontainerInstance

    Vistas de despliegue con nodos de despliegue anidados como marcos, instancias de contenedores y de sistemas de software como las tarjetas que representan, y nodos de infraestructura como tarjetas de nodo de despliegue.

  • systemLandscapesystemContextdeployment

    Vistas de paisaje, de contexto de sistema, de contenedores, de componentes y de despliegue, cada una como un diagrama aparte. Un workspace sin vistas recibe un paisaje, una vista de contexto por sistema y una de contenedores por cada sistema que los tenga.

  • autoLayout lrinclude *

    include * con el significado que tiene en cada tipo de vista, listas de identificadores en include y exclude, y la dirección de autoLayout, de arriba abajo si no se indica.

Un workspace, muchas vistas

Un workspace suele tener varias vistas del mismo modelo. La primera vista del archivo se dibuja primero, y un selector de vistas sobre la vista previa cambia a cualquier otra vista del mismo texto. Para conservarlas todas, Abrir todas las vistas crea un diagrama por vista en tu espacio de trabajo, empezando por la vista seleccionada. En el plan Free, las vistas que no caben en tu límite de diagramas no se pierden sin aviso: la herramienta indica cuántas se abrieron y cuántas quedan.

Lo que una importación de Structurizr deja fuera

  • Archivos y scripts a los que apunta el workspace: !include, !docs, !adrs, !script, !plugin y workspace extends no se siguen ni se ejecutan. Se cuentan en un aviso, y todo lo escrito en el texto pegado se dibuja igualmente.
  • Estilos de elementos y relaciones, temas y branding. Las formas, los colores y los iconos vienen de las tarjetas C4, y puedes cambiarlos cuando el diagrama esté abierto en Archboard.
  • Vistas dynamic, filtered, custom e image, y reglas include o exclude escritas como expresiones. Se omiten y se cuentan, y el resto de vistas sigue en la lista.
  • Las posiciones de los elementos guardadas en una exportación JSON. Cada vista se coloca de nuevo de forma automática, porque los tamaños de Structurizr no coinciden con las tarjetas C4.
  • Secciones de documentación, registros de decisiones, properties, perspectives y URL. Solo se leen el modelo y sus vistas.

Preguntas sobre Structurizr

¿Qué niveles de C4 puedo dibujar desde Structurizr DSL?

Todos los que modela Structurizr: vistas de contexto de sistema y de paisaje para el nivel 1, vistas de contenedores para el nivel 2 y vistas de componentes para el nivel 3, además de las vistas de despliegue. Los diagramas de nivel de código no forman parte de un workspace de Structurizr, así que no hay nada que dibujar para ellos.

¿Puedo pegar una exportación JSON del workspace en lugar del DSL?

Sí. El JSON que Structurizr guarda o exporta se lee igual: se dibujan los elementos y relaciones listados en cada vista, incluidas personas, sistemas, contenedores y nodos de despliegue. Las posiciones guardadas se ignoran y cada vista recibe una nueva disposición automática.

¿Puedo abrir todas las vistas a la vez?

Sí. Cuando un workspace tiene dos o más vistas, Abrir todas las vistas crea un diagrama distinto para cada una, empezando por la que elegiste. Si el límite de diagramas de tu plan lo detiene antes, las vistas ya abiertas se quedan y el resto se cuenta, para que nada se pierda sin aviso.

Mi workspace usa !include. ¿Qué hago?

Pega los archivos incluidos en el mismo cuadro de texto, en lugar de sus líneas !include. La directiva se cuenta en un aviso en vez de seguirse, porque la herramienta solo lee el texto que le das.

¿Qué se guarda al abrir el diagrama en Archboard?

La vista previa no se guarda. Al elegir Abrir en Archboard, la vista que ves, con sus tarjetas C4, límites, marcos y flechas etiquetadas, se guarda como un diagrama nuevo en tu espacio de trabajo. Los cambios posteriores en el DSL o el JSON no lo actualizan.

¿La herramienta de Structurizr a diagrama es gratuita?

Sí. Pegar un workspace y ver sus diagramas no requiere cuenta. Abrir una vista, o todas, en Archboard requiere una cuenta gratuita.

Abre un lienzo en un minuto

Inicia sesión con Google o GitHub. Gratis para un asiento. Mejora el plan cuando se una el equipo.