Aspose.Diagram for Java یک API جاوا با ویژگی های غنی برای دستکاری نمودارهای Visio به صورت برنامه نویسی بدون نیاز به Microsoft Visio است. API از کار با فرمت های محبوب Visio از جمله VSD، VSDX، VDX، VSDM، VSSM و VSSX پشتیبانی می کند. اخیراً از قابلیت‌های Aspose.Diagram برای جاوا استفاده کرده‌ایم و امکان پیاده‌سازی ویژگی‌های اتوماسیون MS Visio را در برنامه‌های Node.js فراهم کرده‌ایم. این ویژگی ها به شما امکان می دهد نمودارهای MS Visio را در برنامه Node.js خود ایجاد، دستکاری، تبدیل و پردازش کنید.

Aspose.Diagram برای Node.js از طریق جاوا مجموعه کاملی از ویژگی ها را برای ایجاد خودکار یا دستکاری نمودارهای Visio فراهم می کند. می توانید نمودارها را به راحتی در چند خط کد ایجاد کنید، بخوانید، صادر کنید، چاپ کنید و از آنها محافظت کنید. در این مقاله، نحوه ایجاد نمودارهای Visio را از ابتدا در یک برنامه Node.js توضیح خواهم داد. بقیه مقاله به بخش های زیر تقسیم می شود.

Node.js Visio API - نصب

از دستور زیر برای نصب بسته Aspose.Diagram در برنامه Node.js خود استفاده کنید.

npm install aspose.diagram --save

MS Visio Diagram را در 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);

Master را به Visio Diagram در Node.js اضافه کنید

استنسیل های Visio شامل مجموعه ای از اشکال اصلی است که برای افزودن/کپی اشکال در نمودارهای Visio استفاده می شود. شما با استفاده از فایل استنسیل VSS یک Master به نمودار Visio اضافه می کنید. در زیر مراحل اضافه کردن یک Master با استفاده از Aspose.Diagram آمده است.

  • با استفاده از کلاس Diagram یک نمودار Visio جدید ایجاد کنید.
  • با استفاده از مسیر فایل استنسیل و نام/ID استاد اصلی را به نمودار اضافه کنید.
  • با استفاده از نام استاد، شکل را به نمودار اضافه کنید.
  • نمودار را با استفاده از روش Diagram.save() ذخیره کنید.

نمونه کد زیر نحوه اضافه کردن یک Master به نمودار 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، عرض و ارتفاع تعریف شده اضافه کنید.
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() یک شکل مستطیل اضافه کنید.
  • ویژگی های شکل مانند ID، متن، موقعیت، رنگ پر و غیره را تنظیم کنید.
  • نمودار را با استفاده از روش 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 آمده است.

  • با استفاده از کلاس Diagram یک نمودار Visio جدید ایجاد کنید.
  • با استفاده از روش 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 ایجاد کنید.
  • صفحه مورد نظر را از نمودار انتخاب کنید.
  • Shape مورد نظر را از صفحه انتخاب شده انتخاب کنید.
  • یک هایپرلینک جدید با استفاده از کلاس 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);
// با شناسه شکل بگیرید
shape = page.getShapes().getShape(2);

// شی Hyperlink را راه اندازی کنید
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 بیشتر کاوش کنید.

مقالات مرتبط)