Aspose.Diagram for Java é uma API Java rica em recursos para manipular diagramas do Visio programaticamente sem exigir o Microsoft Visio. A API suporta o trabalho com formatos populares do Visio, incluindo VSD, VSDX, VDX, VSDM, VSSM e VSSX. Recentemente, aproveitamos os recursos do Aspose.Diagram para Java e possibilitamos a implementação de recursos de automação do MS Visio em aplicativos Node.js. Esses recursos permitem que você crie, manipule, converta e processe diagramas do MS Visio em seu aplicativo Node.js.

Aspose.Diagram for Node.js via Java fornece um conjunto completo de recursos para automatizar a criação ou manipulação de diagramas do Visio. Você pode criar, ler, exportar, imprimir e proteger os diagramas com bastante facilidade em poucas linhas de código. Neste artigo, abordarei como criar diagramas do Visio do zero em um aplicativo Node.js. O restante do artigo está dividido nas seguintes seções.

API do Visio Node.js - Instalação

Use o comando a seguir para instalar o pacote Aspose.Diagram em seu aplicativo Node.js.

npm install aspose.diagram --save

Criar diagrama do MS Visio em Node.js

Começarei criando um diagrama vazio do Visio (VSDX) do zero. A seguir estão as etapas para realizar esta operação.

O exemplo de código a seguir mostra como criar um diagrama do Visio (VSDX) em um aplicativo Node.js.

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

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

Adicionar mestre ao diagrama do Visio no Node.js

Os estênceis do Visio contêm a coleção de formas mestras que são usadas para adicionar/copiar formas nos diagramas do Visio. Você adiciona um mestre ao diagrama do Visio usando o arquivo de estêncil VSS. A seguir estão as etapas para adicionar um mestre usando Aspose.Diagram.

  • Crie um novo diagrama do Visio usando a classe Diagram.
  • Adicione mestre ao diagrama usando o caminho do arquivo de estêncil e o nome/ID do mestre.
  • Adicione forma ao diagrama usando o nome do mestre.
  • Salve o diagrama usando o método Diagram.save().

O exemplo de código a seguir mostra como adicionar um mestre a um diagrama do Visio no Node.js.

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

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

// Carregar estêncil em um fluxo
templateFileName = "NetApp-FAS-series.vss";

// Adicionar mestre com caminho de arquivo de estêncil e id mestre
masterName = "FAS80xx rear empty";
diagram.addMaster(templateFileName, 2);

// Ou adicione mestre com caminho de arquivo de estêncil e nome mestre
diagram.addMaster(templateFileName, masterName);

// Ou adicione o mestre ao diagrama do diagrama de origem
src = new aspose.diagram.Diagram(templateFileName);
diagram.addMaster(src, masterName);

// Adicione forma com PinX e PinY definidos.
diagram.addShape(2.0, 2.0, masterName, 0);
diagram.addShape(6.0, 6.0, masterName, 0);

// Adicione forma com PinX,PinY,Width e Height definidos.
diagram.addShape(7.0, 3.0, 1.5, 1.5, masterName, 0);

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

Inserir páginas em um diagrama do Visio no Node.js

Antes de criar as formas, você precisa ter pelo menos uma página no diagrama do Visio. Cada página no diagrama do Visio tem um nome e uma ID que são usados para identificar exclusivamente essa página. A seguir estão as etapas para adicionar uma página no diagrama do Visio.

O exemplo de código a seguir mostra como inserir páginas em um diagrama do Visio no Node.js.

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

var diagram = new aspose.diagram.Diagram();
// calcula o id máximo da página
 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();
}
        
// Inicializar um novo objeto de página
newPage = new aspose.diagram.Page();
// Nome do conjunto
newPage.setName("new page");
// Definir ID da página
newPage.setID(max + 1);

// Ou tente o construtor Page
// Página novaPágina = nova Página(MaxPageId + 1);

// Adicionar uma nova página em branco
diagram.getPages().add(newPage);
diagram.save("output.vsdx", aspose.diagram.SaveFileFormat.VSDX);

Criar uma forma em um diagrama do Visio no Node.js

Depois de criar a página no diagrama, você pode adicionar uma forma a ela. A seguir estão as etapas para criar e inserir uma forma no diagrama.

  • Crie um objeto da classe Diagram.
  • Adicione mestre ao diagrama usando o caminho do arquivo de estêncil.
  • Adicione uma forma de retângulo usando o método Diagram.addShape().
  • Defina as propriedades da forma, como ID, texto, posição, cor de preenchimento, etc.
  • Salve o diagrama usando o método Diagram.save().

O exemplo de código a seguir mostra como adicionar uma forma ao diagrama do Visio no Node.js.

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

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

// Obter página por nome
page = diagram.getPages()[.getPage("Page-2")];

// Adicionar mestre com caminho de arquivo de estêncil e id mestre
masterName = "Rectangle";
// Adicionar mestre com caminho de arquivo de estêncil e nome mestre
diagram.addMaster("Basic Shapes.vss", masterName);
            
// A indexação da página começa em 0
PageIndex = 2;
width = 2, height = 2, pinX = 4.25, pinY = 4.5;
// Adicionar uma nova forma de retângulo
rectangleId = diagram.addShape(pinX, pinY, width, height, masterName, PageIndex);
            
// Definir propriedades da forma 
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);

Adicionar uma forma de texto a um diagrama do Visio no Node.js

Aspose.Diagram também permite adicionar texto aos diagramas do Visio. Nesse caso, o texto é adicionado como uma forma. A seguir estão as etapas para adicionar texto a um diagrama do Visio.

  • Crie um novo diagrama do Visio usando a classe Diagram.
  • Adicione forma de texto ao diagrama usando o método Diagram.getPages().getPage(0).addText().
  • Salve o diagrama usando o método Diagram.save().

O exemplo de código a seguir mostra como adicionar forma de texto ao diagrama do Visio no Node.js.

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

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

// Definir parâmetros
PinX = 1, PinY = 1, Width = 1, Height = 1;
text = "Test text";

// Adicionar texto a uma página do Visio
diagram.getPages().getPage(0).addText(PinX, PinY, Width, Height, text);

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

Os hiperlinks nos diagramas do Visio podem ser usados para navegar de uma página para outra ou para vincular um arquivo ou uma página da Web ao desenho. A seguir estão as etapas para adicionar um hiperlink a um diagrama do Visio.

  • Crie um novo diagrama do Visio.
  • Selecione a página desejada no diagrama.
  • Selecione a Forma desejada na página selecionada.
  • Crie um novo hiperlink usando a classe Hyperlink e defina suas propriedades.
  • Adicione o hiperlink à forma usando o método Shape.getHyperlinks().add().
  • Salve o diagrama.

O exemplo de código a seguir mostra como adicionar um hiperlink a um diagrama do Visio no Node.js.

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

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

page = diagram.getPages().getPage(0);
// Obter forma por ID
shape = page.getShapes().getShape(2);

// Inicializar objeto de hiperlink
hyperlink = new aspose.diagram.Hyperlink();
// Definir valor de endereço
hyperlink.getAddress().setValue("http://www.google.com/");
// Definir valor do subendereço
hyperlink.getSubAddress().setValue("Sub address here");
// Definir valor da descrição
hyperlink.getDescription().setValue("Description here");
// Nome do conjunto
hyperlink.setName("MyHyperLink");

// Adicionar hiperlink à forma
shape.getHyperlinks().add(hyperlink); 

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

Conclusão

Neste artigo, você aprendeu como criar diagramas/desenhos do Visio do zero em aplicativos Node.js. O tutorial passo a passo e os exemplos de código mostraram como adicionar mestre, páginas, formas, texto e hiperlinks no diagrama do Visio com algumas linhas de código. Você pode explorar mais sobre a API do Visio para Node.js usando a documentação.

Artigos relacionados