Visual Paradigm est heureux d’annoncer une amélioration importante de Visual Paradigm OpenDocs: les utilisateurs peuvent désormais créer et insérer des diagrammes modifiables directement dans les pages de documents grâce à l’intégration avec Visual Paradigm VPasCode.
Cette nouvelle fonctionnalité relie la documentation et la création de diagrammes dans un flux de travail optimisé. Au lieu de créer un diagramme dans une application distincte, de l’exporter en tant qu’image et de placer manuellement cette image dans un document, les utilisateurs peuvent désormais créer un diagramme avec le diagramme en tant que code, l’insérer dans OpenDocs et le rouvrir pour modification à tout moment en cas de besoin de changement.
Le résultat est un outil de gestion des connaissances plus flexible pour les équipes logicielles, les rédacteurs techniques, les architectes, les analystes d’affaires, les chefs de produit et toute personne ayant besoin d’expliquer visuellement des idées complexes.
Ouvrez Visual Paradigm OpenDocs et commencez dès aujourd’hui à créer de la documentation avec des diagrammes modifiables.
Quoi de neuf dans Visual Paradigm OpenDocs ?
OpenDocs permet désormais aux utilisateurs d’insérer des diagrammes dans une page grâce à l’intégration VPasCode. Le diagramme est ajouté à la position du curseur de texte et peut être modifié à nouveau après son insertion.
Cela signifie que les diagrammes ne sont plus limités à des images statiques ajoutées après l’achèvement du processus d’écriture. Ils peuvent devenir des parties actives et modifiables d’un document qui soutiennent l’explication, la collaboration, la planification, l’analyse et le partage des connaissances.
Que vous prépariez une spécification des exigences logicielles, créiez un wiki de projet interne, documentiez une architecture système, publiez un guide de processus ou construisez une base de connaissances produit, vous pouvez désormais combiner du contenu écrit et des modèles visuels dans le même document.
Pourquoi cette amélioration est importante
Les documents sont souvent plus utiles lorsqu’ils combinent des explications claires avec des diagrammes. Les descriptions écrites fournissent un contexte et des détails, tandis que les diagrammes aident les lecteurs à comprendre les relations, les séquences, les dépendances, les structures et les flux de travail d’un coup d’œil.
Cependant, la création et la maintenance de diagrammes dans la documentation peuvent être inconfortables. Un flux de travail courant consiste à utiliser un outil pour créer le diagramme, à exporter le résultat sous forme de fichier PNG ou SVG, à télécharger l’image dans un document, et à répéter le processus à chaque fois que le diagramme change. Cela peut créer un travail inutile et entraîner des visuels obsolètes, des fichiers dupliqués ou une confusion quant à la version la plus récente.
L’intégration entre OpenDocs et VPasCode réduit cette friction en rapprochant la création de diagrammes du flux de travail de documentation. Les utilisateurs peuvent créer un diagramme là où il est nécessaire, l’insérer dans la page, puis revenir à l’éditeur de diagrammes plus tard pour des révisions.
Gardez les explications visuelles à proximité du contenu pertinent
Un diagramme est le plus efficace lorsqu’il apparaît à côté de l’explication qu’il soutient. Grâce à la nouvelle fonctionnalité d’OpenDocs, les utilisateurs peuvent placer un organigramme sous une description de processus, ajouter un diagramme de séquence à côté d’une explication d’API, ou inclure un diagramme d’architecture système dans une spécification technique.
Cela rend les documents plus faciles à lire et aide les utilisateurs à comprendre la relation entre les informations écrites et les informations visuelles sans avoir à basculer entre plusieurs applications.
Réduisez le travail manuel d’exportation et de téléchargement
VPasCode crée des diagrammes à partir de langages de diagrammes basés sur du texte et les rend visuellement dans le navigateur. Grâce à l’intégration OpenDocs, les utilisateurs peuvent insérer le résultat directement dans une page au lieu de télécharger manuellement une image et de la télécharger dans un document.
Réduire ces étapes répétitives peut aider les équipes à gagner du temps et à maintenir un processus de documentation plus propre, en particulier lorsque les diagrammes sont mis à jour fréquemment pendant le développement ou la planification de projet.
Rendre les diagrammes modifiables après l’insertion
Les exigences changent. Les systèmes évoluent. Les processus d’affaires sont révisés. Un diagramme qui décrit avec précision un projet aujourd’hui peut devoir être mis à jour demain.
Comme les diagrammes insérés via VPasCode restent modifiables, les utilisateurs peuvent rouvrir l’éditeur de diagrammes depuis OpenDocs, modifier le code du diagramme, enregistrer les modifications et actualiser le diagramme dans le document. Cela facilite l’affinement du contenu visuel à mesure que les idées et les projets évoluent.
Prendre en charge plus d’un style de diagramme
Différents projets nécessitent différents types de communication visuelle. Un architecte logiciel peut avoir besoin d’un modèle C4 ou d’un diagramme de déploiement. Un analyste d’affaires peut avoir besoin d’un organigramme de processus ou d’une carte de parcours utilisateur. Un chef de projet peut avoir besoin d’un diagramme de Gantt ou d’une feuille de route. Un rédacteur technique peut avoir besoin d’une carte mentale, d’un diagramme de séquence ou d’un diagramme de relation d’entités.
VPasCode prend en charge une large gamme de formats de diagrammes et de technologies de visualisation, notamment PlantUML, Mermaid, Graphviz, D2, Markmap et ECharts. Il prend également en charge les données structurées et d’autres formats basés sur du code qui peuvent être utilisés pour créer des représentations visuelles.
Qu’est-ce que Visual Paradigm VPasCode ?
Visual Paradigm VPasCodeest une plateforme en ligne de diagrammes en tant que code qui permet aux utilisateurs de créer des diagrammes en rédigeant des descriptions textuelles. Elle combine un éditeur de code avec un aperçu visuel en temps réel, permettant aux utilisateurs de voir le diagramme au fur et à mesure qu’ils écrivent ou modifient le code.
Au lieu de dessiner manuellement chaque forme et connecteur, les utilisateurs décrivent la structure d’un diagramme en utilisant une syntaxe prise en charge. VPasCode rend ensuite le résultat sous forme de diagramme visuel.
Cette approche est particulièrement utile pour les développeurs, les architectes logiciels, les équipes techniques et d’autres utilisateurs qui souhaitent un moyen rapide et répétable de créer des diagrammes. Elle est également utile pour les équipes qui préfèrent des diagrammes qui peuvent être examinés et affinés sous forme de texte.
VPasCode inclut des exemples pour différents types et formats de diagrammes, ce qui facilite le démarrage pour les nouveaux utilisateurs. Les utilisateurs peuvent égalementutiliser l’IA pour générer du code de diagrammeà partir d’une description en langage naturel.
Formats de diagrammes et de visualisations pris en charge
Grâce à VPasCode, les utilisateurs d’OpenDocs peuvent créer et insérer de nombreux types différents de diagrammes et de visualisations. Les formats pris en charge incluent :
- PlantUML: Diagrammes de classes, diagrammes de séquence, diagrammes de cas d’utilisation, diagrammes d’activité, diagrammes de composants, diagrammes de déploiement, diagrammes d’états, diagrammes ER, diagrammes ArchiMate, modèles C4, cartes mentales, diagrammes de Gantt, et plus encore.
- Mermaid: Diagrammes de flux, diagrammes de classes, diagrammes de séquence, diagrammes de relations d’entités, diagrammes d’états, cartes mentales, diagrammes C4, diagrammes de Gantt, chronologies, cartes de parcours utilisateur, graphiques Git, diagrammes Kanban, et plus encore.
- Graphviz: Graphiques, diagrammes de réseau, diagrammes hiérarchiques, organigrammes et visualisations de relations.
- D2: Diagrammes déclaratifs modernes pour l’architecture, les systèmes, les flux de travail et les relations.
- Markmap : Cartes mentales interactives générées à partir de contenu au style Markdown.
- ECharts: Graphiques et visualisations basés sur les données.
- Formats de données et de schémas: JSON, YAML, XML, CSV, TOML, DBML et SQL.
Cette gamme de technologies prises en charge fait d’OpenDocs une plateforme de documentation plus performante pour les équipes qui doivent créer à la fois des visuels commerciaux traditionnels et des diagrammes techniques.
Création de diagrammes assistée par l’IA
Les utilisateurs n’ont pas besoin de mémoriser chaque syntaxe de diagramme avant de commencer. VPasCode inclut une génération de diagrammes assistée par l’IA qui peut aider à transformer une demande en langage naturel en code de diagramme.
Par exemple, un utilisateur pourrait demander :
Créez un diagramme de séquence montrant un client se connectant via une application web, un service d’authentification et une base de données.
VPasCode peut utiliser la demande pour générer du code de diagramme que les utilisateurs peuvent examiner, ajuster et insérer dans OpenDocs. Les utilisateurs peuvent ensuite affiner le code manuellement ou demander à l’IA de modifier le diagramme selon une nouvelle exigence.
L’assistance par l’IA peut être utile lorsque :
- Vous savez ce que vous voulez communiquer, mais vous ne connaissez pas la syntaxe requise.
- Vous souhaitez créer rapidement un diagramme initial.
- Vous devez ajouter ou supprimer des étapes, des composants, des relations ou des branches.
- Vous souhaitez simplifier un diagramme complexe.
- Vous avez besoin d’aide pour corriger les erreurs de code de diagramme.
- Vous souhaitez traduire les libellés des diagrammes pour une équipe internationale.
Les diagrammes générés par l’IA restent modifiables, ce qui signifie que les utilisateurs peuvent considérer le résultat généré comme un point de départ et l’ajuster pour qu’il corresponde aux exigences de leur projet.
Comment insérer un diagramme modifiable dans une page OpenDocs
Suivez ces étapes pour créer et insérer un diagramme dans une page de document :
- Ouvrez Visual Paradigm OpenDocs.
- Créez une nouvelle page ou ouvrez une page existante.
- Cliquez sur Modifier dans le coin supérieur droit de la page.
- Placez le curseur de texte à l’endroit où vous souhaitez que le diagramme apparaisse.
- Cliquez sur le + bouton de la barre d’outils pour ouvrir la Créer un artefact fenêtre.
- Sélectionnez VPasCode depuis le menu à gauche.
- Cliquez sur VPasCode à droite pour ouvrir l’éditeur de diagrammes.
- Écrivez ou collez le code du diagramme dans l’éditeur à gauche.
- Vérifiez l’aperçu en temps réel et apportez les modifications nécessaires.
- Cliquez sur Enregistrer dans le coin supérieur droit de l’éditeur VPasCode.
- Cliquez sur Fermer pour revenir à la page OpenDocs.
- Le diagramme sera inséré à la position du curseur de texte.
Une fois le diagramme inséré, les utilisateurs peuvent continuer à écrire autour de lui, tout comme avec le reste du contenu du document.
Comment rééditer un diagramme
Les diagrammes insérés dans OpenDocs peuvent être modifiés à tout moment si des mises à jour sont nécessaires.
- Ouvrez la page OpenDocs contenant le diagramme.
- Cliquez sur l’icône de crayon dans le coin supérieur droit du diagramme.
- Apportez des modifications dans l’éditeur VPasCode.
- Utilisez l’aperçu en direct pour vérifier le résultat.
- Cliquez sur Enregistrer.
- Cliquez sur Fermer pour revenir à OpenDocs.
Le diagramme mis à jour se mettra à jour dans le document, permettant aux utilisateurs de conserver leur contenu visuel sans supprimer le diagramme original ou recommencer à zéro.
Cas d’utilisation pratiques
Documentation de l’architecture logicielle
Les architectes logiciels peuvent utiliser les syntaxes PlantUML, Mermaid, D2 ou C4 pour décrire les composants du système, les services, les dépôts de données et les dépendances externes. Le diagramme d’architecture résultant peut être intégré directement dans un document de conception du système ou un registre de décision d’architecture.
À mesure que l’architecture évolue, le diagramme peut être modifié dans VPasCode et mis à jour dans OpenDocs. Cela permet de maintenir la documentation technique alignée sur la conception en cours de discussion.
Documentation des API et de l’intégration
Les diagrammes de séquence sont utiles pour montrer comment les clients, les services, les bases de données et les systèmes tiers interagissent. Les équipes peuvent inclure un diagramme de séquence à côté des descriptions d’API, des détails d’authentification, des flux de requêtes et des règles de gestion des erreurs.
Par exemple, un rédacteur technique pourrait documenter un processus de paiement en ligne avec une explication écrite, des exemples d’API et un diagramme de séquence Mermaid ou PlantUML sur la même page OpenDocs.
Documentation des bases de données et des modèles de données
Les équipes de bases de données peuvent utiliser des diagrammes de relation d’entités pour expliquer les tables, les champs, les clés et les relations. Un modèle de données visuel peut rendre la documentation des bases de données plus facile à comprendre pour les développeurs, les analystes, les testeurs et les autres parties prenantes.
Lorsqu’une nouvelle table ou relation est ajoutée, le diagramme peut être modifié et réinséré via le même flux de travail VPasCode.
Guides de processus métier et de flux de travail
Les analystes métier et les équipes opérationnelles peuvent utiliser des organigrammes, des diagrammes d’activité, des cartes de parcours utilisateur et des diagrammes de processus pour expliquer comment le travail circule au sein d’une organisation.
Intégrer ces visuels dans un guide opérationnel ou une procédure opérationnelle standard peut aider les lecteurs à comprendre les responsabilités, les points de décision, les chemins alternatifs et les étapes d’approbation.
Exigences produit et planification des fonctionnalités
Les chefs de produit peuvent inclure des parcours utilisateurs, des flux de processus, des diagrammes d’état, des cartes mentales et des relations de fonctionnalités dans les documents d’exigences produit. Ces actifs visuels peuvent aider les équipes produit, design, ingénierie et assurance qualité à développer une compréhension commune de la fonctionnalité.
Wikis de projet et bases de connaissances
Un outil de gestion des connaissances est le plus précieux lorsqu’il rassemble les informations dont les personnes ont besoin pour comprendre et accomplir leur travail. L’ajout de diagrammes modifiables à une base de connaissances OpenDocs peut rendre les wikis de projet, les supports d’intégration, les guides internes et les manuels système plus complets.
Au lieu de conserver les diagrammes dans des dossiers séparés ou des outils de conception déconnectés, les équipes peuvent les placer à côté des explications, décisions, procédures et documents de référence associés.
Cartes mentales et organisation des concepts
Markmap et d’autres formats de cartographie mentale peuvent aider les équipes à organiser les exigences, les sujets de recherche, les structures de projet, les résultats de réunions et les hiérarchies de connaissances. Ces cartes peuvent être insérées dans une page OpenDocs pour fournir un aperçu visuel avant que des informations plus détaillées ne soient présentées.
Avantages pour différents types d’utilisateurs
- Développeurs :Créer des diagrammes avec des formats textuels familiers et garder les explications techniques à proximité des visuels du système.
- Architectes logiciels :Construire des diagrammes d’architecture, UML, C4, de déploiement et de composants qui peuvent être révisés à mesure que les systèmes évoluent.
- Rédacteurs techniques :Combiner procédures, spécifications, exemples et diagrammes modifiables dans un seul espace de travail de documentation.
- Analystes métier :Expliquer les processus métier, les exigences, les décisions et les parcours utilisateurs à l’aide de modèles visuels clairs.
- Chefs de produit :Ajouter des flux de travail, des feuilles de route, des relations de fonctionnalités et des flux utilisateurs à la documentation produit.
- Équipes de projet :Créez une documentation partagée qui communique à la fois les détails et la vision d’ensemble.
- Éducateurs et formateurs :Utilisez des diagrammes pour rendre le contenu technique ou procédural plus facile à comprendre.
De documents statiques à une documentation vivante
Une documentation efficace doit refléter l’état actuel d’un projet, d’un produit, d’un processus ou d’un système. Lorsque le contenu visuel est stocké uniquement sous forme d’image statique, sa mise à jour peut facilement être repoussée. Avec le temps, l’image peut ne plus représenter la réalité.
L’intégration entre OpenDocs et VPasCode soutient une approche plus maintenable. Les diagrammes peuvent être créés à partir de code lisible, examinés via un aperçu visuel, insérés dans le document pertinent, et modifiés à nouveau lorsque les informations sous-jacentes changent.
Cela crée une base pratique pour une documentation vivante. Le diagramme reste un actif de travail utile plutôt qu’une capture d’écran ponctuelle.
Un écosystème Visual Paradigm plus connecté
Visual Paradigm connecte différents produits et fonctionnalités pour aider les utilisateurs à passer plus efficacement des idées aux modèles, diagrammes, documentation et connaissances partagées.
VPasCode offre l’expérience du diagramme en tant que code. OpenDocs offre l’expérience de la gestion de documents et de connaissances. Ensemble, ils aident les équipes à créer du contenu visuel et à le placer directement dans le contexte où il est nécessaire.
Cette connexion peut réduire le changement d’outils, simplifier le flux de travail de documentation et aider les équipes à mieux utiliser les diagrammes tout au long du cycle de vie du projet.
Commencez avec OpenDocs et VPasCode
Grâce à cette amélioration, Visual Paradigm OpenDocs devient un environnement plus polyvalent pour créer une documentation structurée, visuelle et collaborative. Les utilisateurs peuvent créer des diagrammes avec PlantUML, Mermaid, Graphviz, D2, Markmap, ECharts et d’autres formats pris en charge, les insérer dans des pages et les modifier à nouveau chaque fois que les exigences changent.
Si vous recherchez un générateur de diagrammes en ligne, une plateforme de diagrammes en tant que code, un outil de documentation technique ou un outil de gestion des connaissances doté de capacités de modélisation visuelle intégrées, ce nouveau flux de travail offre un moyen pratique de réunir diagrammes et documents.
Lancez Visual Paradigm OpenDocs et commencez à créer une documentation plus riche et plus utile avec des diagrammes modifiables propulsés par VPasCode.
Questions fréquentes
Quelle est la nouvelle amélioration d’OpenDocs ?
OpenDocs permet désormais aux utilisateurs de créer et d’insérer des diagrammes modifiables dans les pages de documents grâce à son intégration avec Visual Paradigm VPasCode.
Puis-je modifier un diagramme après l’avoir inséré dans OpenDocs ?
Oui. Cliquez sur l’icône crayon du diagramme inséré pour le rouvrir dans l’éditeur VPasCode. Après avoir modifié le code du diagramme, cliquez sur Enregistrer et Fermer pour actualiser le diagramme dans la page OpenDocs.
Quels formats de diagrammes sont pris en charge ?
VPasCode prend en charge les formats et technologies suivants : PlantUML, Mermaid, Graphviz, D2, Markmap, ECharts, JSON, YAML, XML, CSV, TOML, DBML et SQL. Les types de diagrammes pris en charge incluent les organigrammes, les diagrammes de séquence, les diagrammes de classes, les diagrammes d’états, les diagrammes ER, les diagrammes C4, les cartes mentales, les diagrammes d’architecture, les diagrammes de Gantt, et plus encore.
Dois-je connaître le code de diagramme pour utiliser cette fonctionnalité ?
Non. Vous pouvez charger un exemple depuis l’éditeur VPasCode ou la Galerie d’exemples. Vous pouvez également utiliser la fonctionnalité Créer avec l’IA pour décrire le diagramme souhaité en langage naturel et laisser l’IA générer un script de diagramme initial.
Où puis-je accéder à OpenDocs ?
Vous pouvez accéder à Visual Paradigm OpenDocs à l’adresse https://ai-toolbox.visual-paradigm.com/app/opendocs/.
Où puis-je en savoir plus sur VPasCode ?
Visitez le Page des fonctionnalités de VPasCode pour en savoir plus sur la plateforme de diagrammes en tant que code, les formats pris en charge, le rendu en temps réel, l’assistance par IA et les fonctionnalités connexes.