Aspose.Diagram for Java est une API Java riche en fonctionnalités permettant de manipuler des diagrammes Visio par programmation sans nécessiter Microsoft Visio. L’API prend en charge l’utilisation des formats Visio courants, notamment VSD, VSDX, VDX, VSDM, VSSM et VSSX. Récemment, nous avons exploité les capacités d’Aspose.Diagram for Java et rendu possible l’implémentation des fonctionnalités d’automatisation MS Visio dans les applications Node.js. Ces fonctionnalités vous permettent de créer, manipuler, convertir et traiter des diagrammes MS Visio dans votre application Node.js.

Aspose.Diagram for Node.js via Java fournit un ensemble complet de fonctionnalités pour automatiser la création ou la manipulation de diagrammes Visio. Vous pouvez créer, lire, exporter, imprimer et protéger les diagrammes assez facilement en quelques lignes de code. Dans cet article, j’expliquerai comment créer des diagrammes Visio à partir de zéro dans une application Node.js. Le reste de l’article est divisé dans les sections suivantes.

API Node.js Visio - Installation

Utilisez la commande suivante pour installer le package Aspose.Diagram dans votre application Node.js.

npm install aspose.diagram --save

Créer un diagramme MS Visio dans Node.js

Je vais commencer par créer un diagramme Visio vide (VSDX) à partir de zéro. Voici les étapes pour effectuer cette opération.

  • Créez un objet de la classe Diagram.
  • Enregistrez le diagramme sous forme de fichier à l’aide de la méthode Diagram.save().

L’exemple de code suivant montre comment créer un diagramme Visio (VSDX) dans une application Node.js.

var aspose = aspose || {};
aspose.diagram = require("aspose.diagram");

var diagram = new aspose.diagram.Diagram();
diagram.save("output.vsdx", aspose.diagram.SaveFileFormat.VSDX);

Ajouter un maître au diagramme Visio dans Node.js

Les gabarits Visio contiennent la collection de formes principales utilisées pour ajouter/copier des formes dans les diagrammes Visio. Vous ajoutez une forme de base au diagramme Visio à l’aide du fichier de gabarit VSS. Voici les étapes pour ajouter un maître à l’aide de Aspose.Diagram.

  • Créez un nouveau diagramme Visio à l’aide de la classe Diagram.
  • Ajoutez le maître au diagramme en utilisant le chemin du fichier stencil et le nom/ID du maître.
  • Ajoutez une forme au diagramme en utilisant le nom du maître.
  • Enregistrez le diagramme à l’aide de la méthode Diagram.save().

L’exemple de code suivant montre comment ajouter un maître à un diagramme Visio dans Node.js.

var aspose = aspose || {};
aspose.diagram = require("aspose.diagram");

var diagram = new aspose.diagram.Diagram();

// Charger le gabarit dans un flux
templateFileName = "NetApp-FAS-series.vss";

// Ajouter un maître avec le chemin du fichier de gabarit et l'ID du maître
masterName = "FAS80xx rear empty";
diagram.addMaster(templateFileName, 2);

// Ou ajoutez un maître avec le chemin du fichier de gabarit et le nom du maître
diagram.addMaster(templateFileName, masterName);

// Ou ajouter un maître au diagramme à partir du diagramme source
src = new aspose.diagram.Diagram(templateFileName);
diagram.addMaster(src, masterName);

// Ajoutez une forme avec PinX et PinY définis.
diagram.addShape(2.0, 2.0, masterName, 0);
diagram.addShape(6.0, 6.0, masterName, 0);

// Ajoutez une forme avec PinX, PinY, largeur et hauteur définis.
diagram.addShape(7.0, 3.0, 1.5, 1.5, masterName, 0);

diagram.save("output.vsdx", aspose.diagram.SaveFileFormat.VSDX);

Insérer des pages dans un diagramme Visio dans Node.js

Avant de créer les formes, vous devez avoir au moins une page dans le diagramme Visio. Chaque page du diagramme Visio a un nom et un identifiant qui sont utilisés pour identifier de manière unique cette page. Voici les étapes pour ajouter une page dans le diagramme Visio.

  • Créez une instance de la classe Diagram.
  • Calculez l’ID de page maximum.
  • Créez une nouvelle page en utilisant la classe Page.
  • Définissez le nom et l’ID de la page à l’aide des méthodes Page.setName() et Page.setID() respectivement.
  • Ajoutez une page au diagramme à l’aide de la méthode Diagram.getPages().add().
  • Enregistrez le diagramme Visio à l’aide de la méthode Diagram.save().

L’exemple de code suivant montre comment insérer des pages dans un diagramme Visio dans Node.js.

var aspose = aspose || {};
aspose.diagram = require("aspose.diagram");

var diagram = new aspose.diagram.Diagram();
// il calcule l'identifiant maximum de la page
 max = 0;
if (diagram.getPages().getCount() != 0)
    max = diagram.getPages().get(0).getID();

for ( i = 1; i < diagram.getPages().getCount(); i++)
{
    if (max < diagram.getPages().get(i).getID())
        max = diagram.getPages().get(i).getID();
}
        
// Initialiser un nouvel objet de page
newPage = new aspose.diagram.Page();
// Définir le nom
newPage.setName("new page");
// Définir l'identifiant de la page
newPage.setID(max + 1);

// Ou essayez le constructeur de page
// Page nouvellePage = nouvelle Page(MaxPageId + 1);

// Ajouter une nouvelle page vierge
diagram.getPages().add(newPage);
diagram.save("output.vsdx", aspose.diagram.SaveFileFormat.VSDX);

Créer une forme dans un diagramme Visio dans Node.js

Une fois que vous avez créé la page dans le diagramme, vous pouvez y ajouter une forme. Voici les étapes pour créer et insérer une forme dans le diagramme.

  • Créez un objet de la classe Diagram.
  • Ajoutez master au diagramme en utilisant le chemin du fichier stencil.
  • Ajoutez une forme de rectangle à l’aide de la méthode Diagram.addShape().
  • Définissez les propriétés de la forme telles que l’ID, le texte, la position, la couleur de remplissage, etc.
  • Enregistrez le diagramme à l’aide de la méthode Diagram.save().

L’exemple de code suivant montre comment ajouter une forme au diagramme Visio dans Node.js.

var aspose = aspose || {};
aspose.diagram = require("aspose.diagram");

var diagram = new aspose.diagram.Diagram("output.vsdx");

// Obtenir la page par nom
page = diagram.getPages()[.getPage("Page-2")];

// Ajouter un maître avec le chemin du fichier de gabarit et l'ID du maître
masterName = "Rectangle";
// Ajouter un maître avec le chemin du fichier de gabarit et le nom du maître
diagram.addMaster("Basic Shapes.vss", masterName);
            
// L'indexation des pages commence à partir de 0
PageIndex = 2;
width = 2, height = 2, pinX = 4.25, pinY = 4.5;
// Ajouter une nouvelle forme de rectangle
rectangleId = diagram.addShape(pinX, pinY, width, height, masterName, PageIndex);
            
// Définir les propriétés de la forme 
rectangle = page.getShapes().getShape(rectangleId);
rectangle.getXForm().getPinX().setValue(5);
rectangle.getXForm().getPinY().setValue(5);
rectangle.setType(TypeValue.SHAPE);
rectangle.getText().getValue().add(new Txt("Aspose Diagram"));
rectangle.setTextStyle(diagram.getStyleSheets().get(3));
rectangle.getLine().getLineColor().setValue("#ff0000");
rectangle.getLine().getLineWeight().setValue(0.03);
rectangle.getLine().getRounding().setValue(0.1);
rectangle.getFill().getFillBkgnd().setValue("#ff00ff");
rectangle.getFill().getFillForegnd().setValue("#ebf8df");

diagram.save("output.vsdx", aspose.diagram.SaveFileFormat.VSDX);

Ajouter une forme de texte à un diagramme Visio dans Node.js

Aspose.Diagram vous permet également d’ajouter du texte aux diagrammes Visio. Dans ce cas, le texte est ajouté sous forme de forme. Voici les étapes pour ajouter du texte à un diagramme Visio.

  • Créez un nouveau diagramme Visio à l’aide de la classe Diagram.
  • Ajoutez une forme de texte au diagramme à l’aide de la méthode Diagram.getPages().getPage(0).addText().
  • Enregistrez le diagramme à l’aide de la méthode Diagram.save().

L’exemple de code suivant montre comment ajouter une forme de texte au diagramme Visio dans Node.js.

var aspose = aspose || {};
aspose.diagram = require("aspose.diagram");

var diagram = new aspose.diagram.Diagram();

// Définir les paramètres
PinX = 1, PinY = 1, Width = 1, Height = 1;
text = "Test text";

// Ajouter du texte à une page Visio
diagram.getPages().getPage(0).addText(PinX, PinY, Width, Height, text);

diagram.save("output.vsdx", aspose.diagram.SaveFileFormat.VSDX);

Les liens hypertexte dans les diagrammes Visio peuvent être utilisés pour naviguer d’une page à l’autre ou pour lier un fichier ou une page Web au dessin. Voici les étapes pour ajouter un lien hypertexte à un diagramme Visio.

  • Créez un nouveau diagramme Visio.
  • Sélectionnez la page souhaitée dans le diagramme.
  • Sélectionnez la Forme souhaitée dans la page sélectionnée.
  • Créez un nouveau lien hypertexte à l’aide de la classe Hyperlink et définissez ses propriétés.
  • Ajoutez le lien hypertexte à la forme à l’aide de la méthode Shape.getHyperlinks().add().
  • Enregistrez le diagramme.

L’exemple de code suivant montre comment ajouter un lien hypertexte à un diagramme Visio dans Node.js.

var aspose = aspose || {};
aspose.diagram = require("aspose.diagram");

var diagram = new aspose.diagram.Diagram();

page = diagram.getPages().getPage(0);
// Obtenir la forme par ID
shape = page.getShapes().getShape(2);

// Initialiser l'objet lien hypertexte
hyperlink = new aspose.diagram.Hyperlink();
// Définir la valeur de l'adresse
hyperlink.getAddress().setValue("http://www.google.com/");
// Définir la valeur de la sous-adresse
hyperlink.getSubAddress().setValue("Sub address here");
// Définir la valeur de la description
hyperlink.getDescription().setValue("Description here");
// Définir le nom
hyperlink.setName("MyHyperLink");

// Ajouter un lien hypertexte à la forme
shape.getHyperlinks().add(hyperlink); 

diagram.save("output.vsdx", aspose.diagram.SaveFileFormat.VSDX);

Conclusion

Dans cet article, vous avez appris à créer des diagrammes/dessins Visio à partir de zéro dans les applications Node.js. Le didacticiel pas à pas et les exemples de code ont montré comment ajouter un masque, des pages, des formes, du texte et des liens hypertexte dans le diagramme Visio avec quelques lignes de code. Vous pouvez en savoir plus sur l’API Visio pour Node.js à l’aide de la documentation.

Articles Liés