ایجاد دیاگرام ویزیو در C#
Microsoft Visio ابزاری است که به طور گسترده برای طراحی فلوچارتها، چارتهای سازمانی، نمودارهای شبکه، جریانهای فرآیند و دیگر انواع تصاویر فنی یا تجاری که به اشکال و اتصالات دقیقی نیاز دارند، استفاده میشود. برای بسیاری از تیمها و سناریوهای خودکارسازی، طراحی دستی نمودارها عملی نیست وقتی که باید نمودارها برای بسیاری از سوابق، به صورت تقاضا ایجاد شده یا درون خطوط管گزاری گزارشها گنجانده شوند. تولید برنامهنویسی نمودار این مشکلات را با اجازه دادن به توسعهدهندگان برای تولید نمودارهای مداوم و تکراری مستقیماً از منابع داده یا منطق کسبوکار درون یک برنامه C# حل میکند. مثالی که در این مقاله نشان داده شده است، چگونگی ایجاد یک نمودار Visio به طور برنامهنویسی در C#
خودکارسازی ایجاد نمودار در بسیاری از زمینههای واقعی که نمودارها باید بهطور قابل اعتماد و مکرر تولید شوند مفید است. به عنوان مثال، ممکن است شما نمودارهای معماری را برای هر محیط استقرار تولید کنید، نقشههای شبکه را برای پانلهای نظارت ایجاد کنید، یا نمودارهای سازمانی استاندارد شدهای را از دادههای منابع انسانی بسازید. تولید برنامهنویسی تضمین میکند که قوانین چیدمان بهطور مداوم اعمال میشوند، اشکال از همان راهنماهای سبک پیروی میکنند و فایلهای خروجی بدون مداخله دستی تولید میشوند. بخشهای بعدی به بررسی دلایل، یک رویکرد مرحله به مرحله، یک کد C# کامل که میتوانید کپی و چسباندن کنید، و یک FAQ دقیق برای پوشش نگرانیهای رایج و مراحل بعدی هنگام ادغام تولید نمودار در برنامه
چرا نمودارهای ویژیو را برنامهنویسی ایجاد کنیم؟
- ایجاد تولید دیاگرام به صورت عمده یا در خواست به گونهای قابل اعتماد و تکرارپذیر باشد تا دیاگرامها به طور مداوم در سراسر بسیاری از سوابق یا اجراها تولید شوند، زمان رسم دستی را ذخیره کرده و تنوع تنظیمات انسانی را از بین ببرد.
- ادغام تولید نمودار در جریانهای خودکار مانند گزارشدهی، خطوط لوله مستندسازی یا تحویل مداوم بهگونهای که تصاویری که همیشه با دادههای زیرین بهروز باشند بدون هرگونه ویرایش دستی.
- رعایت راهنماییهای سبک شرکتی یا پروژه را بهصورت برنامهنویسی اعمال کنید تا شکلها، فونتها و رنگها در تمام نمودارها یکپارچه باشد و نیاز به ویرایش و بازنگری دستی کاهش یابد.
- نمودارهایی در فرمتهای مختلف تولید کنید و آنها را در سایر اسناد یا سیستمها جاسازی کنید تا توزیع در پلتفرمهای مختلف و مصرف آسانتر توسط ذینفعان ممکن شود.
- تولید نمودار مقیاس به صدها یا هزاران مورد در سناریوهایی مانند تولید نمودارهای فردی برای هر مشتری، هر سایت یا هر استقرار، جایی که ویرایش دستی غیرممکن خواهد بود.
در C# نمودار Visio VSDX ایجاد کنید
- پروژه خود را با افزودن کتابخانه نمودار به مراجع پروژه آماده کنید تا به کلاسهای نمودار و شکل دسترسی داشته باشید.
- یک شیء دیagrams جدید را راهاندازی کنید که به عنوان بوم برای نگهداری صفحات، مسترها، اشکال و سبکها عمل میکند.
- یک شابلون مستر اضافه کنید یا بارگذاری کنید که شامل الگوهای شکل است که میخواهید از آنها استفاده کنید، به عنوان مثال یک مستر مستطیل از یک شابلون اشکال پایه.
- ابعاد و مختصات هر شکلی که میخواهید قرار دهید را تعریف کنید تا موقعیتها و اندازهها قطعی باشند و بتوانند از دادهها یا قوانین چیدمان محاسبه شوند.
- شکلها را به نمودار اضافه کنید با ارجاع به الگوی اصلی و مقادیر موقعیت و اندازه محاسبه شده، سپس شناسه شکل بازگشتی را ثبت کنید اگر میخواهید شکل را بیشتر اصلاح کنید.
- شکل نمونه را زمانی که نیاز به تغییر ویژگیهای آن مانند مکان، متن، سبک یا نوع دارید، بازیابی کنید و تغییرات را به صورت برنامهنویسی اعمال کنید.
- نقشه نهایی را در فرمت مورد نظر ذخیره کنید، معمولاً 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# یک رویکرد عملی و قوی برای خودکارسازی مستندسازی بصری، استانداردسازی زیباییشناسی نمودارها و یکپارچهسازی خروجی نمودار در سیستمهای گزارشدهی یا مستندات سازمانی است. با دنبال کردن مراحل و مثالی که ارائه شده، میتوانید به سرعت شروع کنید و سپس رویکرد را گسترش دهید تا نمودارهای پیچیده، اتصالدهندهها و مدارک چند صفحهای را که به طور مستقیم از منابع داده هدایت میشوند، تولید کنید. صرف نظر از اینکه به نمودارهای معماری خودکار، نمودارهای سازمانی، توپولوژیهای شبکه یا جریانهای فرآیندی نیاز دارید، تولید نمودار به صورت برنامهنویسی این فرآیند را سریعتر، سازگارتر و با اشتباه کمتری میسازد که به طراحان