تحويل VSSX إلى SVG في C#

غالبًا ما يتم استخدام Microsoft Visio في إعدادات العمل لتنظيم وتصور وتوصيل تدفقات العمل المعقدة، مثل المخططات التنظيمية ونماذج قواعد البيانات ومخططات سير العمل. قدمت Microsoft تنسيق VSSX عندما أصدرت Visio 2013. VSSX هو تنسيق يعتمد على Zip والذي حل محل تنسيق VSS الثنائي ويمكن استخدامه بواسطة Visio 2013 وما فوق. لذلك، من أجل فتح ملفات VSSX وتحريرها وحفظها، نستخدم Microsoft Visio. ولكنه متاح فقط على نظام Windows الأساسي ولا تمتلك Microsoft إصدار سطح مكتب من Visio لنظام macOS أو Linux الأساسي. لذا من منظور قابلية النقل، قد نفكر في تحويل ملفات VSSX إلى تنسيق SVG الذي يتمتع بفوائد مثل قابلية التوسع، وسهولة تحسين محركات البحث، والقدرة على التحرير، واستقلال الدقة على أي نظام أساسي. علاوة على ذلك، فإن SVG مرن ومعيار W3C وخفيف الوزن وقابل للطباعة وقابل للفهرسة وقابل للضغط بسهولة.

في هذه المقالة، سنناقش المواضيع التالية بمزيد من التفصيل

واجهة برمجة تطبيقات معالجة ملفات Visio
تحويل VSSX إلى SVG في C#
تحويل VSSX إلى SVG باستخدام الأمر cURL

واجهة برمجة تطبيقات معالجة ملفات Visio

Aspose.Diagram Cloud عبارة عن واجهة برمجة تطبيقات REST توفر الإمكانيات لإنشاء وتحرير وعرض مخططات Visio بتنسيقات شائعة أخرى. كما أن التطبيق المستند إلى Aspose.Diagram Cloud لا يتطلب أي برنامج تابع لجهة خارجية لمعالجة مخططات/مخططات التدفق الخاصة بـ Microsoft Visio ويعتمد على محركه الخاص. وبالتالي، بمساعدة هذا الحل سهل الاستخدام، يمكنك إجراء عمليات معقدة على ملفات Visio باستخدام عدد أقل من أسطر التعليمات البرمجية. يوفر هذا التصميم سهولة التركيز على متطلبات العمل ونسيان تعقيدات التنفيذ الداخلي.

الآن، من أجل تسهيل الأمر على عملائنا، قمنا بإنشاء مجموعات تطوير برمجيات خاصة بلغات البرمجة حتى يتمكنوا من الاستفادة من عمليات معالجة ملفات Visio داخل بيئة التطوير المتكاملة المفضلة لديهم. لإجراء تحويل ملفات Visio إلى تنسيق SVG في تطبيق .NET، يرجى محاولة استخدام مجموعة تطوير برمجيات Aspose.Diagram Cloud لـ .NET.

تثبيت

الخطوة الأولى في استخدام Cloud SDK هي تثبيته. يمكن تنزيله من NuGet أو GitHub. يرجى تنفيذ الأمر التالي في المحطة الطرفية لتثبيت SDK عبر NuGet:

nuget install Aspose.Diagram-Cloud

أو قم بتنفيذ الأمر التالي في NuGet Package Manager:

 PM> Install-Package Aspose.Diagram-Cloud

مدير الحزم NuGet — الصورة 1:- تثبيت الحزمة باستخدام NuGet Package Manager.

تثبيت Visual Studio

يمكن أيضًا إضافة Cloud SDK مباشرةً داخل حل Visual Studio:

افتح مستكشف الحلول.
قم بتوسيع المشروع ثم انقر بزر الماوس الأيمن فوق مجلد الحزم ضمن الحل الخاص بك.
حدد خيار إدارة حزم NuGet…
انقر فوق علامة التبويب “استعراض” وابحث عن “Aspose.Diagram-Cloud”.
انقر فوق الحزمة Aspose.Diagram-Cloud، وحدد الإصدار المناسب في علامة التبويب اليمنى وانقر فوق الزر “إضافة الحزمة”.

حزمة Aspose.Diagram-Cloud — الصورة 2:- Aspose.Diagram-Cloud في Visual Studio 2022.

اشتراك سحابي

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

لذا، استخدم حساب GitHub أو Google الخاص بك للتسجيل ببساطة أو انقر فوق الزر إنشاء حساب جديد وقم بتوفير المعلومات المطلوبة. الآن قم بتسجيل الدخول إلى لوحة المعلومات باستخدام بيانات الاعتماد وقم بتوسيع قسم التطبيقات من لوحة المعلومات وانتقل لأسفل نحو قسم بيانات اعتماد العميل لرؤية تفاصيل معرف العميل والسر الخاص بالعميل.

الصورة 3:- بيانات اعتماد العميل في لوحة معلومات Aspose.Cloud.

تعتبر عملية التحويل سريعة وموثوقة في نفس الوقت، وتوفر نتائج عالية الدقة بغض النظر عن تنسيق الملف الناتج.

الخطوة الأولى هي إنشاء مثيل لفئة DiagramApi أثناء تمرير تفاصيل ClientID وClientSecret كحجج
ثانيًا، اقرأ محتوى VSSX المدخل في مثيل FileStream
ثالثًا، قم بإنشاء كائن من فئة StorageApi عن طريق تمرير نفس تفاصيل ClientID وClient Secret كحجج
الخطوة التالية هي تحميل ملف VSSX إلى التخزين السحابي باستخدام طريقة UploadFile(…) من StorageApi
الآن قم باستدعاء طريقة DownloadFileWithFormat(..) من DiagramApi لبدء عملية تحويل الملف
أخيرًا، احفظ الملف الناتج على محرك الأقراص المحلي باستخدام كائن File.Create

// احصل على معرف العميل من https://dashboard.aspose.cloud/
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";

// إنشاء كائن DiagramApi
DiagramApi diagramApi = new DiagramApi("client_credentials", clientID, clientSecret);

// أدخل اسم ملف VSSX
String inputFile = "MVPSession1SimpleTimeline.vssx";
// اسم ملف SVG الناتج
String resultant = "Conveted.svg";

try
{   
    // قراءة ملف VSSX المدخل من محرك الأقراص المحلي
    using (var inputStream = new FileStream("C:\\Users\\Downloads\\" + inputFile, FileMode.Open))
    {
        // إنشاء مثيل لفئة التخزين
        StorageApi storageApi = new StorageApi("client_credentials", clientID, clientSecret);
        // تحميل ملف VXXS المدخل إلى التخزين السحابي
        storageApi.UploadFile(inputFile, inputStream);
    
        // بدء عملية تحويل الملف
        var response = diagramApi.DownloadFileWithFormat(inputFile, format: "SVG", null);
        if (response != null)
        {
            Console.WriteLine("Successfully converted VSD to SVG !");
        }

        // طريقة مخصصة لحفظ الملف الناتج على محرك النظام المحلي
        saveToDisk(response, "C:\\Users\\Downloads\\" + resultant);
    }
}
catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}

static void saveToDisk(Stream responseStream, String resultantFile)
{
    var fileStream = File.Create(resultantFile);
    responseStream.Seek(0, SeekOrigin.Begin);
    responseStream.CopyTo(fileStream);
    fileStream.Close();
}

يمكن تنزيل ملفات VSSX وSVG المدخلة المستخدمة في المثال أعلاه من MVPSession1SimpleTimeline.vssx وconverted.svg.

تحويل VSSX إلى SVG باستخدام الأمر cURL

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

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=4ccf1790-accc-41e9-8d18-a78dbb2ed1aa&client_secret=caac6e3d4a4724b2feb53f4e460eade3" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

بمجرد إنشاء رمز وصول JWT، يرجى تحميل الملف إلى التخزين السحابي باستخدام أمر cURL التالي.

curl -X PUT "https://api.aspose.cloud/v3.0/diagram/storage/file/MVPSession1SimpleTimeline.vssx" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: multipart/form-data" \
-d {"File":{}}

الآن بعد أن تم تحميل الملف على التخزين السحابي، يرجى تنفيذ الأمر التالي لإجراء التحويل وحفظ الإخراج في الموقع المحدد.

curl -X GET "https://api.aspose.cloud/v3.0/diagram/MVPSession1SimpleTimeline.vssx?format=SVG" \
-H  "accept: multipart/form-data" \
-H  "authorization: Bearer <JWT Token>" \
-o Converted.svg

خاتمة

في هذه المقالة، ناقشنا إمكانيات Aspose.Diagram Cloud لتحويل تنسيق الملف VSSX إلى SVG. ناقشنا الخطوات اللازمة لإجراء التحويل باستخدام كود C# .NET بالإضافة إلى استخدام الأمر cURL. تم تطوير حزم SDK الخاصة بنا بموجب ترخيص MIT ويمكن تنزيل الكود المصدر الكامل الخاص بها من GitHub. علاوة على ذلك، في حالة مواجهة أي مشكلة أثناء استخدام واجهة برمجة التطبيقات، فلا تتردد في الاتصال عبر منتدى الدعم المجاني.

VSSX إلى SVG - تحويل VSSX إلى SVG في C#

واجهة برمجة تطبيقات معالجة ملفات Visio

تثبيت

تثبيت Visual Studio

اشتراك سحابي