VSSX به SVG

Microsoft Visio اغلب در تنظیمات کسب و کار برای سازماندهی، تجسم و برقراری ارتباط جریان های کاری پیچیده، مانند نمودارهای سازمانی، مدل های پایگاه داده، نمودارهای فلوچارت های تجاری استفاده می شود. مایکروسافت فرمت VSSX را هنگام انتشار Visio 2013 معرفی کرد. VSSX یک فرمت مبتنی بر Zip است که جایگزین فرمت VSS مبتنی بر باینری شده است و می تواند توسط Visio 2013 و بالاتر از آن استفاده شود. بنابراین، برای باز کردن، ویرایش و ذخیره فایل‌های VSSX، از Microsoft Visio استفاده می‌کنیم. اما، فقط بر روی پلتفرم ویندوز موجود است و مایکروسافت نسخه دسکتاپ Visio را برای پلتفرم macOS یا Linux ندارد. بنابراین از منظر قابلیت حمل، ممکن است تبدیل فایل‌های VSSX به فرمت SVG را در نظر بگیریم که دارای مزایایی مانند مقیاس‌پذیری، سئو دوستانه بودن، توانایی ویرایش و استقلال وضوح در هر پلتفرمی است. علاوه بر این، SVG انعطاف پذیر، استاندارد W3C، سبک وزن، قابل چاپ، نمایه سازی و به راحتی قابل فشرده سازی است.

در این مقاله قصد داریم در مورد موضوعات زیر با جزئیات بیشتری صحبت کنیم

API پردازش فایل Visio

Aspose.Diagram Cloud یک API REST است که توانایی ایجاد، ویرایش و رندر نمودارهای Visio را به سایر فرمت‌های محبوب ارائه می‌کند. همچنین، یک برنامه مبتنی بر Aspose.Diagram Cloud به هیچ نرم افزار شخص ثالثی برای پردازش نمودارها/نمودارهای مایکروسافت Visio نیاز ندارد و به موتور خود متکی است. بنابراین، با کمک این راه حل آسان برای استفاده، می توانید عملیات پیچیده ای را روی فایل های Visio با خطوط کد کمتر انجام دهید. این طراحی به راحتی می‌تواند بر الزامات تجاری متمرکز بماند و پیچیدگی‌های اجرایی داخلی را فراموش کند.

اکنون به منظور تسهیل بیشتر مشتریان خود، SDK های مخصوص زبان برنامه نویسی را ایجاد کرده ایم تا آنها بتوانند از پردازش فایل Visio در IDE مورد علاقه خود بهره ببرند. برای انجام تبدیل فایل Visio به فرمت SVG در برنامه NET، لطفاً از Aspose.Diagram Cloud SDK برای NET استفاده کنید.

نصب و راه اندازی

اولین قدم در استفاده از Cloud SDK نصب آن است. می توان آن را از NuGet یا GitHub بارگیری کرد. لطفاً برای نصب SDK از طریق NuGet دستور زیر را در ترمینال اجرا کنید:

nuget install Aspose.Diagram-Cloud

یا دستور زیر را در NuGet Package Manager اجرا کنید:

 PM> Install-Package Aspose.Diagram-Cloud
NuGet Package Manager

تصویر 1: - نصب بسته با استفاده از NuGet Package Manager.

نصب ویژوال استودیو

Cloud SDK همچنین می تواند مستقیماً در راه حل ویژوال استودیو اضافه شود:

  1. Solution Explorer را باز کنید.
  2. پروژه را گسترش دهید و روی پوشه Packages در راه حل خود کلیک راست کنید.
  3. گزینه Manage NuGet Packages… را انتخاب کنید
  4. روی تب Browse کلیک کنید و “Aspose.Diagram-Cloud” را جستجو کنید.
  5. روی بسته Aspose.Diagram-Cloud کلیک کنید، نسخه مناسب را در برگه سمت راست انتخاب کنید و روی دکمه Add Package کلیک کنید.
Aspose.Diagram-Cloud Package

تصویر 2: - Aspose.Diagram-Cloud در ویژوال استودیو 2022.

اشتراک ابری

پس از نصب، مرحله بعدی ایجاد یک حساب اشتراک رایگان با مراجعه به Aspose.Cloud dashboard است. در طول اشتراک، هیچ کارت اعتباری یا سایر جزئیات پرداخت مورد نیاز نیست. علاوه بر این، تحت یک حساب اشتراک رایگان، می توانید تا 150 درخواست پردازش سند رایگان را انجام دهید.

بنابراین از حساب GitHub یا Google خود برای ثبت نام به سادگی استفاده کنید یا روی دکمه ایجاد یک حساب جدید کلیک کنید و اطلاعات مورد نیاز را ارائه دهید. اکنون با استفاده از اعتبارنامه وارد داشبورد شوید و بخش Applications را از داشبورد گسترش دهید و به سمت پایین به سمت قسمت Client Credentials حرکت کنید تا Client ID و Client Secret را ببینید.

اعتبار مشتری

تصویر 3: - اعتبار مشتری در داشبورد Aspose.Cloud.

VSSX به SVG در C#

فرآیند تبدیل سریع و در عین حال قابل اعتماد است و بدون در نظر گرفتن فرمت فایل حاصل، نتایجی با وفاداری بالا ارائه می دهد.

  • اولین قدم این است که یک نمونه از کلاس DiagramApi ایجاد کنید در حالی که اطلاعات ClientID و ClientSecret را به عنوان آرگومان ارسال می کنید.
  • در مرحله دوم، محتوای VSSX ورودی را در نمونه FileStream بخوانید
  • سوم، یک شی از کلاس StorageApi با ارسال همان ClientID و جزئیات Client Secret به عنوان آرگومان ایجاد کنید.
  • مرحله بعدی آپلود فایل VSSX در فضای ذخیره سازی ابری با استفاده از روش UploadFile(…) StorageApi است.
  • اکنون متد DownloadFileWithFormat(..) DiagramApi را فراخوانی کنید تا عملیات تبدیل فایل آغاز شود.
  • در نهایت، فایل حاصل را در درایو محلی با استفاده از شی File.Create ذخیره کنید
// ClientID را از 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))
    {
        // یک نمونه کلاس Storage ایجاد کنید
        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

تصویر 4: - پیش نمایش تبدیل VSSX به SVG.

با استفاده از دستور cURL VSSX را به SVG تبدیل کنید

از آنجایی که Cloud API ما مبتنی بر معماری REST است، بنابراین می توان با استفاده از دستورات cURL نیز به آن دسترسی داشت. اما همانطور که قبلا ذکر شد، API ها فقط برای افراد مجاز قابل دسترسی هستند، بنابراین بر اساس Client ID و جزئیات Client Secret، ما نیاز به ایجاد توکن دسترسی 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 دانلود کرد. علاوه بر این، در صورتی که در هنگام استفاده از API با مشکلی مواجه شدید، لطفاً از طریق [فروم پشتیبانی رایگان15 تماس بگیرید.

مقالات مرتبط

همچنین توصیه می کنیم برای کسب اطلاعات بیشتر به لینک های زیر مراجعه کنید