Aspose.Diagram for Java — це багатофункціональний Java API для програмного керування діаграмами Visio без використання Microsoft Visio. API підтримує роботу з популярними форматами Visio, включаючи VSD, VSDX, VDX, VSDM, VSSM і VSSX. Нещодавно ми використали можливості Aspose.Diagram for Java і зробили можливим впровадження функцій автоматизації MS Visio у програми Node.js. Ці функції дозволяють створювати, маніпулювати, перетворювати та обробляти діаграми MS Visio у вашому додатку Node.js.

Aspose.Diagram for Node.js через Java надає повний набір функцій для автоматизації створення та обробки діаграм Visio. Ви можете легко створювати, читати, експортувати, друкувати та захищати діаграми за допомогою кількох рядків коду. У цій статті я розповім, як створити діаграми Visio з нуля в програмі Node.js. Решта статті поділено на наступні розділи.

Node.js Visio API - встановлення

Використовуйте наступну команду, щоб установити пакет Aspose.Diagram у вашій програмі Node.js.

npm install aspose.diagram --save

Створіть діаграму MS Visio у Node.js

Я почну зі створення порожньої діаграми Visio (VSDX) з нуля. Нижче наведено кроки для виконання цієї операції.

  • Створіть об’єкт класу Diagram.
  • Збережіть діаграму як файл за допомогою методу Diagram.save().

У наведеному нижче прикладі коду показано, як створити діаграму Visio (VSDX) у програмі Node.js.

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

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

Додайте майстер до діаграми Visio у Node.js

Трафарети Visio містять колекцію основних фігур, які використовуються для додавання/копіювання фігур у діаграмах Visio. Ви додаєте майстер до діаграми Visio за допомогою файлу трафарету VSS. Нижче наведено кроки, щоб додати майстер за допомогою Aspose.Diagram.

  • Створіть нову діаграму Visio за допомогою класу Diagram.
  • Додайте майстер до діаграми, використовуючи шлях до файлу трафарету та ім’я/ідентифікатор майстра.
  • Додайте форму до діаграми, використовуючи ім’я майстра.
  • Збережіть діаграму за допомогою методу Diagram.save().

У наведеному нижче прикладі коду показано, як додати майстер до діаграми Visio у Node.js.

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

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

// Завантажте трафарет у потік
templateFileName = "NetApp-FAS-series.vss";

// Додайте шаблон із шляхом до файлу трафарету та ідентифікатором шаблону
masterName = "FAS80xx rear empty";
diagram.addMaster(templateFileName, 2);

// Або додайте майстер із шляхом до файлу трафарету та назвою шаблону
diagram.addMaster(templateFileName, masterName);

// Або додайте майстер до діаграми з вихідної діаграми
src = new aspose.diagram.Diagram(templateFileName);
diagram.addMaster(src, masterName);

// Додайте форму з визначеними PinX і PinY.
diagram.addShape(2.0, 2.0, masterName, 0);
diagram.addShape(6.0, 6.0, masterName, 0);

// Додайте форму з визначеними значеннями PinX, PinY, Width і Height.
diagram.addShape(7.0, 3.0, 1.5, 1.5, masterName, 0);

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

Вставте сторінки в діаграму Visio у Node.js

Перш ніж створювати фігури, потрібно мати принаймні одну сторінку на схемі Visio. Кожна сторінка на діаграмі Visio має назву та ідентифікатор, які використовуються для унікальної ідентифікації цієї сторінки. Нижче наведено кроки, щоб додати сторінку до діаграми Visio.

  • Створіть екземпляр класу Diagram.
  • Обчисліть максимальний ідентифікатор сторінки.
  • Створіть нову сторінку за допомогою класу Page.
  • Встановіть назву та ідентифікатор сторінки за допомогою методів Page.setName() і Page.setID() відповідно.
  • Додайте сторінку до діаграми за допомогою методу Diagram.getPages().add().
  • Збережіть діаграму Visio за допомогою методу Diagram.save().

У наведеному нижче прикладі коду показано, як вставити сторінки в діаграму Visio у Node.js.

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

var diagram = new aspose.diagram.Diagram();
// він обчислює максимальний ідентифікатор сторінки
 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();
}
        
// Ініціалізація нового об'єкта сторінки
newPage = new aspose.diagram.Page();
// Встановити назву
newPage.setName("new page");
// Встановити ідентифікатор сторінки
newPage.setID(max + 1);

// Або спробуйте конструктор сторінок
// Page newPage = нова сторінка (MaxPageId + 1);

// Додайте нову порожню сторінку
diagram.getPages().add(newPage);
diagram.save("output.vsdx", aspose.diagram.SaveFileFormat.VSDX);

Створіть фігуру на діаграмі Visio у Node.js

Створивши сторінку на схемі, ви можете додати до неї форму. Нижче наведено кроки, щоб створити та вставити фігуру в діаграму.

  • Створіть об’єкт класу Diagram.
  • Додайте шаблон до діаграми за допомогою шляху до файлу трафарету.
  • Додайте форму прямокутника за допомогою методу Diagram.addShape().
  • Установіть такі властивості фігури, як ідентифікатор, текст, положення, колір заливки тощо.
  • Збережіть діаграму за допомогою методу Diagram.save().

У наведеному нижче прикладі коду показано, як додати фігуру до діаграми Visio у Node.js.

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

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

// Отримати сторінку за назвою
page = diagram.getPages()[.getPage("Page-2")];

// Додайте шаблон із шляхом до файлу трафарету та ідентифікатором шаблону
masterName = "Rectangle";
// Додайте майстер із шляхом до файлу трафарету та назвою шаблону
diagram.addMaster("Basic Shapes.vss", masterName);
            
// Індексація сторінки починається з 0
PageIndex = 2;
width = 2, height = 2, pinX = 4.25, pinY = 4.5;
// Додайте нову форму прямокутника
rectangleId = diagram.addShape(pinX, pinY, width, height, masterName, PageIndex);
            
// Встановити властивості фігури 
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);

Додайте текстову форму до діаграми Visio у Node.js

Aspose.Diagram також дозволяє додавати текст до діаграм Visio. У цьому випадку текст додається як фігура. Нижче наведено кроки, щоб додати текст до діаграми Visio.

  • Створіть нову діаграму Visio за допомогою класу Diagram.
  • Додайте текстову форму до діаграми за допомогою методу Diagram.getPages().getPage(0).addText().
  • Збережіть діаграму за допомогою методу Diagram.save().

У наведеному нижче прикладі коду показано, як додати текстову форму до діаграми Visio у Node.js.

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

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

// Встановити параметри
PinX = 1, PinY = 1, Width = 1, Height = 1;
text = "Test text";

// Додайте текст на сторінку Visio
diagram.getPages().getPage(0).addText(PinX, PinY, Width, Height, text);

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

Гіперпосилання в діаграмах Visio можна використовувати для переходу від однієї сторінки до іншої або для зв’язування файлу чи веб-сторінки з малюнком. Нижче наведено кроки, щоб додати гіперпосилання до діаграми Visio.

  • Створіть нову діаграму Visio.
  • Виберіть потрібну сторінку на схемі.
  • Виберіть потрібну Форму на вибраній сторінці.
  • Створіть нове гіперпосилання за допомогою класу Hyperlink і встановіть його властивості.
  • Додайте гіперпосилання до фігури за допомогою методу Shape.getHyperlinks().add().
  • Збережіть схему.

У наведеному нижче прикладі коду показано, як додати гіперпосилання до діаграми Visio у Node.js.

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

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

page = diagram.getPages().getPage(0);
// Отримати форму за ID
shape = page.getShapes().getShape(2);

// Ініціалізація об'єкта гіперпосилання
hyperlink = new aspose.diagram.Hyperlink();
// Встановити значення адреси
hyperlink.getAddress().setValue("http://www.google.com/");
// Встановіть значення додаткової адреси
hyperlink.getSubAddress().setValue("Sub address here");
// Встановити значення опису
hyperlink.getDescription().setValue("Description here");
// Встановити назву
hyperlink.setName("MyHyperLink");

// Додайте гіперпосилання до форми
shape.getHyperlinks().add(hyperlink); 

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

Висновок

У цій статті ви дізналися, як створювати діаграми/малюнки Visio з нуля в програмах Node.js. У покроковому посібнику та зразках коду показано, як додати шаблон, сторінки, фігури, текст і гіперпосилання до діаграми Visio за допомогою кількох рядків коду. Ви можете дізнатися більше про Visio API для Node.js за допомогою документації.

Пов’язані статті