Outil gratuit
Du Structurizr DSL au diagramme de modèle C4
Collez un workspace Structurizr DSL ou un export JSON de workspace et affichez les vues de votre modèle C4 en diagrammes modifiables : personnes, systèmes logiciels, conteneurs, composants et nœuds de déploiement, les relations libellées par leur description. Choisissez une vue, ou ouvrez-les toutes en diagrammes séparés.
Exemple de résultat
Comment ça marche
Collez ou déposez votre workspace
Un fichier workspace.dsl, du DSL copié depuis le playground Structurizr ou le JSON exporté par Structurizr. Les blocs model et views sont lus, les styles peuvent rester dans le texte.
Affichez chaque vue C4
Toutes les vues du workspace sont listées, du paysage des systèmes jusqu’aux composants et au déploiement. Choisissez-en une et l’aperçu la redessine avec des cartes C4, des frontières et des flèches libellées.
Ouvrez-la dans Archboard
Enregistrez la vue comme nouveau diagramme pour la réorganiser, l’annoter, la partager par lien ou l’exporter en SVG et PNG. L’inscription se fait avec un compte Google ou GitHub.
Ce qui est dessiné depuis un workspace Structurizr
La vue choisie est construite à partir de ces parties du modèle :
personLes personnes, en cartes personne C4 avec leur description. Une personne avec le tag External, ou avec location External dans un export JSON, devient une personne externe.
softwareSystemLes systèmes logiciels, en cartes système C4 avec leur description. Les systèmes avec le tag External deviennent des cartes de système externe, qui n’affichent que le nom.
containerLes conteneurs, en cartes avec leur technologie et leur description. Un conteneur avec le tag Database devient une carte de base de données, qui n’affiche que le nom. Le tag Queue, le tag External (conteneur ou component) et un bloc enterprise ont chacun leur propre type C4.
componentLes composants, en cartes avec leur technologie, à l’intérieur du conteneur auquel ils appartiennent.
->Les relations, en flèches libellées avec leur description, suivie de la technologie entre crochets. Si une vue ne montre que les parents, une relation entre leurs enfants est dessinée une seule fois entre les parents.
container bankingcomponent banking.apiLa portée d’une vue de conteneurs ou de composants, sous forme de cadre : le système logiciel dans la vue de conteneurs, le conteneur dans la vue de composants.
groupLes groupes, en cadres autour des personnes, systèmes ou conteneurs qu’ils contiennent. Un groupe vide est omis.
deploymentNodeinfrastructureNodecontainerInstanceLes vues de déploiement : nœuds de déploiement imbriqués en cadres, instances de conteneurs et de systèmes logiciels en cartes de l’élément qu’elles représentent, nœuds d’infrastructure en cartes de nœud de déploiement.
systemLandscapesystemContextdeploymentVues de paysage, de contexte système, de conteneurs, de composants et de déploiement, chacune en diagramme séparé. Un workspace sans vues reçoit un paysage, une vue de contexte par système et une vue de conteneurs par système qui en possède.
autoLayout lrinclude *include * avec le sens qu’il prend dans chaque type de vue, les listes d’identifiants de include et exclude, et le sens de autoLayout, de haut en bas s’il n’est pas précisé.
Un workspace, plusieurs vues
Un workspace contient souvent plusieurs vues du même modèle. La première vue du fichier est dessinée en premier, et un sélecteur de vue au-dessus de l’aperçu passe à n’importe quelle autre vue du même texte. Pour tout garder, Ouvrir toutes les vues crée un diagramme par vue dans votre espace de travail, en commençant par la vue sélectionnée. Avec l’offre Free, les vues qui dépassent votre limite de diagrammes ne disparaissent pas en silence : l’outil indique combien ont été ouvertes et combien restent.
Ce qu’un import Structurizr laisse de côté
- Les fichiers et scripts référencés par le workspace : !include, !docs, !adrs, !script, !plugin et workspace extends ne sont ni suivis ni exécutés. Ils sont comptés dans un avertissement, et tout ce qui est écrit dans le texte collé est tout de même dessiné.
- Les styles d’éléments et de relations, les thèmes et le branding. Formes, couleurs et icônes viennent des cartes C4, et vous pouvez les modifier une fois le diagramme ouvert dans Archboard.
- Les vues dynamic, filtered, custom et image, ainsi que les règles include ou exclude écrites sous forme d’expressions. Elles sont ignorées et comptées, et les autres vues restent listées.
- Les positions d’éléments enregistrées dans un export JSON. Chaque vue est de nouveau disposée automatiquement, car les dimensions de Structurizr ne correspondent pas aux cartes C4.
- Les sections de documentation, les registres de décisions, les properties, les perspectives et les URL. Seuls le modèle et ses vues sont lus.
Questions sur Structurizr
Quels niveaux C4 puis-je dessiner depuis Structurizr DSL ?
Tous les niveaux que Structurizr modélise : vues de contexte système et de paysage pour le niveau 1, vues de conteneurs pour le niveau 2 et vues de composants pour le niveau 3, plus les vues de déploiement. Les diagrammes de niveau code ne font pas partie d’un workspace Structurizr, il n’y a donc rien à dessiner pour eux.
Puis-je coller un export JSON de workspace au lieu du DSL ?
Oui. Le JSON que Structurizr enregistre ou exporte se lit de la même façon : les éléments et relations listés dans chaque vue sont dessinés, personnes, systèmes, conteneurs et nœuds de déploiement compris. Les positions enregistrées sont ignorées et chaque vue reçoit une nouvelle disposition automatique.
Puis-je ouvrir toutes les vues en une fois ?
Oui. Quand un workspace a deux vues ou plus, Ouvrir toutes les vues crée un diagramme séparé pour chacune, en commençant par la vue choisie. Si la limite de diagrammes de votre offre l’arrête avant la fin, les vues déjà ouvertes restent et les autres sont comptées, pour que rien ne se perde sans prévenir.
Mon workspace utilise !include. Que faire ?
Collez les fichiers inclus dans la même zone de texte, à la place de leurs lignes !include. La directive est comptée dans un avertissement au lieu d’être suivie, car l’outil ne lit que le texte que vous lui donnez.
Qu’est-ce qui est enregistré quand j’ouvre le diagramme dans Archboard ?
L’aperçu n’est pas enregistré. Quand vous choisissez Ouvrir dans Archboard, la vue affichée, avec ses cartes C4, ses frontières, ses cadres et ses flèches libellées, est enregistrée comme nouveau diagramme dans votre espace de travail. Les modifications ultérieures du DSL ou du JSON ne le mettent pas à jour.
L’outil Structurizr vers diagramme est-il gratuit ?
Oui. Coller un workspace et voir ses diagrammes ne demande aucun compte. Ouvrir une vue, ou toutes, dans Archboard demande un compte gratuit.
Ouvrez un canevas en une minute
Connectez-vous avec Google ou GitHub. Gratuit pour un siège. Passez à un forfait supérieur quand l’équipe vous rejoint.