Aspose.Diagram for Java عبارة عن واجهة برمجة تطبيقات Java غنية بالميزات لمعالجة مخططات Visio برمجيًا دون الحاجة إلى Microsoft Visio. تدعم واجهة برمجة التطبيقات (API) العمل مع تنسيقات Visio الشائعة بما في ذلك VSD و VSDX و VDX و VSDM و VSSM و VSSX. لقد استفدنا مؤخرًا من إمكانات Aspose.Diagram لجافا وجعلنا من الممكن تنفيذ ميزات أتمتة 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) من البداية. فيما يلي خطوات إجراء هذه العملية.

يُظهر نموذج التعليمات البرمجية التالي كيفية إنشاء رسم تخطيطي لـ 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.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.

  • قم بإنشاء مثيل لفئة مخطط.
  • حساب معرف الصفحة الأقصى.
  • قم بإنشاء صفحة جديدة باستخدام فئة الصفحة.
  • قم بتعيين اسم ومعرف الصفحة باستخدام أسلوب 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);

// أو جرب مُنشئ الصفحة
// صفحة newPage = صفحة جديدة (MaxPageId + 1) ؛

// أضف صفحة فارغة جديدة
diagram.getPages().add(newPage);
diagram.save("output.vsdx", aspose.diagram.SaveFileFormat.VSDX);

قم بإنشاء شكل في رسم تخطيطي Visio في Node.js

بمجرد إنشاء الصفحة في الرسم التخطيطي ، يمكنك إضافة شكل إليها. فيما يلي خطوات إنشاء وإدراج شكل في الرسم التخطيطي.

  • قم بإنشاء كائن من رسم بياني فئة.
  • أضف رئيسي إلى الرسم التخطيطي باستخدام مسار ملف الاستنسل.
  • أضف شكل مستطيل باستخدام طريقة 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.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.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 = 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 باستخدام الوثائق.

مقالات ذات صلة)