إنشاء مخطط فيزيو في C#

Microsoft Visio هو أداة مستخدمة على نطاق واسع لتصميم مخططات الانسياب، والمخططات التنظيمية، ومخططات الشبكات، وتدفقات العمليات، وأنواع أخرى من المرئيات التقنية أو التجارية التي تحتاج إلى أشكال وروابط دقيقة. بالنسبة للعديد من الفرق والسيناريوهات الآلية، فإن رسم المخططات يدويًا ليس عمليًا عندما يتعين إنشاء المخططات للعديد من السجلات، أو إنشاؤها عند الطلب، أو تضمينها داخل خطوط تقارير. يحل إنشاء المخططات برمجيًا هذه المشكلات من خلال السماح للمطورين بإنتاج مخططات متسقة وقابلة للتكرار مباشرة من مصادر البيانات أو منطق الأعمال داخل تطبيق C#. المثال الموضح في هذه المقالة يوضح كيفية إنشاء مخطط Visio برمجيًا في C#، وإضافة شكل مستطيل من قالب رئيسي، وضبط موقعه وحجمه،

أتمتة إنشاء المخططات مفيدة في العديد من السياقات الواقعية حيث يحتاج إلى إنتاج المخططات بشكل موثوق ومتكرر. على سبيل المثال، يمكنك إنشاء مخططات معمارية لكل بيئة نشر، إنشاء خرائط شبكية لوحات المراقبة، أو بناء مخططات تنظيمية موحدة من بيانات الموارد البشرية. يضمن التوليد البرنامجي أن يتم تطبيق قواعد التخطيط بشكل متسق، وأن تتبع الأشكال نفس إرشادات التنسيق، وأن يتم إنتاج ملفات الإخراج دون تدخل يدوي. الأقسام التالية توضح المبررات، نهج خطوة بخطوة، مقتطف كامل من كود C# يمكنك نسخه ولصقه، وأسئلة شائعة مفصلة لتغطية المخاوف الشائعة والخطوات التالية عند دمج توليد المخططات في تطبيقاتك.

لماذا إنشاء مخططات فيزيو برمجياً؟

  • اجعل إنشاء المخططات بالجملة أو عند الطلب موثوقًا وقابلًا للتكرار حتى يتم إنتاج المخططات بشكل متسق عبر العديد من السجلات أو التشغيلات، مما يوفر وقت الرسم اليدوي ويقضي على تباين التخطيط البشري.
  • قم بتكامل إنشاء المخططات في سير العمل المؤتمت مثل التقارير ، وخطوط وثائق البيانات ، أو التسليم المستمر بحيث تظل الرسوم البيانية محدثة دائمًا بالبيانات الأساسية دون أي تعديل يدوي.
  • تطبيق إرشادات نمط الشركات أو المشاريع برمجيًا لضمان تناسق الأشكال والخطوط والألوان عبر جميع المخططات وتقليل الحاجة إلى التدقيق اليدوي وإعادة العمل.
  • إنتاج مخططات بصيغ متعددة ودمجها في مستندات أو أنظمة أخرى، مما يتيح توزيعًا عبر الأنظمة الأساسية ويسهل استهلاكها من قبل المعنيين.
  • إنتاج مخططات المقاييس لمئات أو آلاف العناصر في سيناريوهات مثل إنتاج مخططات فردية لكل عميل، أو لكل موقع، أو لكل نشر، حيث سيكون من غير الممكن التحرير يدويًا.

إنشاء رسم تخطيطي VSDX باستخدام Visio بلغة C#

  1. قم بإعداد مشروعك عن طريق إضافة مكتبة المخططات إلى مراجع المشروع حتى تتمكن من الوصول إلى فئات المخططات والأشكال.
  2. قم بتهيئة كائن مخطط جديد يعمل كلوحة لاستضافة الصفحات، والماستر، والأشكال، والأنماط.
  3. أضف أو حمّل نموذجًا رئيسيًا يحتوي على قوالب الأشكال التي تريد استخدامها، على سبيل المثال نموذج مستطيل من نموذج الأشكال الأساسية.
  4. حدد الأبعاد والإحداثيات لكل شكل تريد وضعه حتى تكون المواقع والأحجام محددة ويمكن حسابها من البيانات أو قواعد التخطيط.
  5. أضف الأشكال إلى المخطط من خلال الرجوع إلى القالب الرئيسي وقيم الموضع والحجم المحسوبة، ثم قم بالتقاط معرّف الشكل المرجع في حال رغبتك في تعديل الشكل بشكل أكبر.
  6. استرجع مثيل الشكل عندما تحتاج إلى تغيير خصائصه مثل الموقع والنص والأسلوب أو النوع، وقم بتطبيق التغييرات برمجيًا.
  7. احفظ المخطط النهائي بالتنسيق المطلوب، عادةً ما يكون VSDX للتوافق مع Visio، أو صدّر إلى صور أو تنسيقات أخرى مدعومة للإدراج في المستندات.
// Create a new instance of a diagram
Aspose.Diagram.Diagram diagram = new Aspose.Diagram.Diagram();

// Define the name of the master (template) to be used for creating shapes
string masterName = "Rectangle";
diagram.AddMaster("Basic Shapes.vss", masterName);

// Define the dimensions and position for the new shape
double width = 2, height = 2, pinX = 4.25, pinY = 4.5;

// Add a new rectangle shape to the diagram using the specified master
long rectangleId = diagram.AddShape(pinX, pinY, width, height, masterName, 0);

// Retrieve the shape by its ID for modification
Aspose.Diagram.Shape rectangle = diagram.Pages[0].Shapes.GetShape(rectangleId);

// Set the position of the shape by modifying its PinX and PinY properties
rectangle.XForm.PinX.Value = 5;
rectangle.XForm.PinY.Value = 5;

// Set the type of the shape to indicate it is a standard shape
rectangle.Type = Aspose.Diagram.TypeValue.Shape;

// Add text to the shape
rectangle.Text.Value.Add(new Aspose.Diagram.Txt("Aspose Diagram"));

// Apply a predefined text style to the shape's text
rectangle.TextStyle = diagram.StyleSheets[3];

// Save the modified diagram to a file
diagram.Save("Visio_out.vsdx", Aspose.Diagram.SaveFileFormat.Vsdx);

توضح هذه القطعة تدفقًا كاملاً من إنشاء مثيل مخطط جديد إلى حفظ النتيجة كملف VSDX. يقوم الكود أولاً بتسجيل شكل رئيسي من ملف القالب، ثم يضيف مستطيلًا باستخدام إحداثيات وأحجام محددة. بعد إضافة الشكل، يسترجع الكود المثيل لضبط موقعه ونوعه، وإدراج محتوى نصي، وتطبيق نمط موجود من مجموعة أوراق أنماط المخطط. أخيرًا، يتم حفظ المخطط على القرص. يمكنك تعديل هذه القطعة لإضافة أشكال متعددة، وإنشاء موصلات بين الأشكال، وتوليد صفحات متعددة، أو تطبيق تنسيق ديناميكي استنادًا إلى البيانات.

استنتاج

إن إنشاء مخططات Visio برمجياً في C# هو نهج عملي وقوي لأتمتة الوثائق المرئية، وتوحيد جمالية المخططات، ودمج ناتج المخططات في نظم التقارير أو الوثائق في المؤسسات. من خلال اتباع الخطوات والمثال المقدم، يمكنك البدء بسرعة، ثم توسيع النهج لإنشاء مخططات معقدة، وموصلات، ووثائق متعددة الصفحات مدفوعة مباشرة من مصادر البيانات. سواء كنت بحاجة إلى مخططات معمارية آلية، أو مخططات تنظيمية، أوTopology الشبكات، أو تدفقات العمليات، فإن إنشاء المخططات برمجياً يجعل العملية أسرع، وأكثر اتساقاً، وأقل عرضة للأخطاء، مما يتيح للمصممين والمهندسين تركيز الجهد على اتخاذ قرارات أعلى مستوى بدلاً من المهام المتكررة في الرسم.

انظر أيضا