تحويل المستندات باستخدام خدمة تطبيقات Microsoft Azure

تقدم هذه المقالة تعليمات مفصلة خطوة بخطوة لتحويل مستندات PDF في Microsoft Azure باستخدام Aspose.PDF for .NET وخدمة تطبيقات Azure.

المتطلبات الأساسية

Visual Studio 2022 Community Edition مع تثبيت تطوير Azure أو Visual Studio Code.
حساب Azure: تحتاج إلى اشتراك Azure، أنشئ حسابًا مجانيًا قبل البدء.
.NET 6 SDK.
Aspose.PDF for .NET.

إنشاء موارد Azure

إنشاء خدمة تطبيقات

انتقل إلى بوابة Azure (https://portal.azure.com).
أنشئ مجموعة موارد جديدة.
أنشئ خدمة تطبيقات جديدة:
- اختر وقت تشغيل .NET 6 (LTS).
- اختر مستوى التسعير المناسب.
أنشئ مورد Application Insights للتسجيل.

إنشاء مشروع

إنشاء مشروع في Visual Studio

افتح Visual Studio 2022.
انقر على “إنشاء مشروع جديد”.
اختر “ASP.NET Core Web API”.
سمِّ مشروعك “PdfConversionService”.
اختر “.NET 6.0” أو أحدث.
انقر على “إنشاء”.

إنشاء مشروع في Visual Studio Code

تثبيت المتطلبات الأساسية

ملحقات Visual Code:

code --install-extension ms-dotnettools.csharp
code --install-extension ms-azuretools.vscode-azureappservice

تثبيت Azure CLI:

Windows: قم بالتنزيل من موقع Microsoft.
macOS: brew install azure-cli.
Linux: curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash.

تكوين المشروع

افتح المشروع في Visual Studio Code:

code .

أضف حزم NuGet عن طريق إنشاء/تحديث PdfConverterApp.csproj:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Aspose.PDF" Version="24.10.0" />
    <PackageReference Include="Microsoft.ApplicationInsights.AspNetCore" Version="2.22.0" />
    <PackageReference Include="Microsoft.Extensions.Logging.AzureAppServices" Version="8.0.10" />
  </ItemGroup>
</Project>

أضف التكوين:

// .vscode/launch.json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Core Launch (web)",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/bin/Debug/net6.0/PdfConversionService.dll",
            "args": [],
            "cwd": "${workspaceFolder}",
            "stopAtEntry": false,
            "env": {
                "ASPNETCORE_ENVIRONMENT": "Development"
            }
        }
    ]
}

أنشئ هيكل المشروع:

mkdir Controllers
touch Controllers/PdfController.cs

تثبيت حزم NuGet المطلوبة

في Visual Studio، افتح وحدة تحكم إدارة الحزم وقم بتشغيل:

Install-Package Aspose.PDF
Install-Package Microsoft.ApplicationInsights.AspNetCore
Install-Package Microsoft.Extensions.Logging.AzureAppServices

في Visual Studio Code، قم بتشغيل:

dotnet restore

تكوين ترخيص Aspose

في Visual Studio:

انسخ ملف ترخيص Aspose.PDF إلى المشروع.
انقر بزر الماوس الأيمن على ملف الترخيص، واختر “خصائص”.
اضبط “نسخ إلى دليل الإخراج” على “نسخ دائمًا”.
أضف كود تهيئة الترخيص في Program.cs:

var license = new Aspose.Pdf.License();
license.SetLicense("Aspose.PDF.lic");

إنشاء الكود

في Visual Studio:

انقر بزر الماوس الأيمن على مجلد Controllers.
أضف → عنصر جديد → وحدة تحكم API - فارغة.
سمِّ ملفك “PdfController.cs”.

// PdfController.cs
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
    private readonly ILogger<PdfController> _logger;

    public PdfController(ILogger<PdfController> logger)
    {
        _logger = logger;
    }

    [HttpPost("convert")]
    public async Task<IActionResult> ConvertPdf(
        IFormFile file,
        [FromQuery] string outputFormat = "docx")
    {
        try
        {
            if (file == null || file.Length == 0)
            {
                return BadRequest("No file uploaded");
            }

            // Validate input file is PDF
            if (!file.ContentType.Equals("application/pdf", StringComparison.OrdinalIgnoreCase))
            {
                return BadRequest("File must be a PDF");
            }

            using var inputStream = file.OpenReadStream();
            using var document = new Aspose.Pdf.Document(inputStream);
            using var outputStream = new MemoryStream();

            switch (outputFormat.ToLower())
            {
                case "docx":
                    document.Save(outputStream, Aspose.Pdf.SaveFormat.DocX);
                    return File(outputStream.ToArray(),
                        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                        "converted.docx");

                case "html":
                    document.Save(outputStream, Aspose.Pdf.SaveFormat.Html);
                    return File(outputStream.ToArray(),
                        "text/html",
                        "converted.html");

                case "jpg":
                case "jpeg":
                    var jpegDevice = new Aspose.Pdf.Devices.JpegDevice();
                    jpegDevice.Process(document.Pages[1], outputStream);
                    return File(outputStream.ToArray(),
                        "image/jpeg",
                        "converted.jpg");

                case "png":
                    var pngDevice = new Aspose.Pdf.Devices.PngDevice();
                    pngDevice.Process(document.Pages[1], outputStream);
                    return File(outputStream.ToArray(),
                        "image/png",
                        "converted.png");

                default:
                    return BadRequest("Unsupported output format");
            }
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "Error converting PDF");
            return StatusCode(500, "Internal server error");
        }
    }
}

// Program.cs
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

// Add logging
builder.Services.AddApplicationInsightsTelemetry();
builder.Services.AddLogging(logging =>
{
    logging.AddConsole();
    logging.AddDebug();
    logging.AddAzureWebAppDiagnostics();
});

var app = builder.Build();

// Initialize license
var license = new Aspose.Pdf.License();
license.SetLicense("Aspose.PDF.lic");

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();
app.Run();

تكوين إعدادات التطبيق

افتح appsettings.json.
أضف التكوين:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ApplicationInsights": {
    "ConnectionString": "Your-Connection-String"
  }
}

استبدل Your-Connection-StringG بسلسلة الاتصال الفعلية الخاصة بك من بوابة Azure.

اختبار محليًا

في Visual Studio:

اضغط على F5 لتشغيل التطبيق.
ستفتح واجهة Swagger.
اختبر نقطة النهاية /api/pdf/convert:
- انقر على “جربها”.
- قم بتحميل ملف PDF.
- اختر تنسيق الإخراج.
- نفذ وتحقق من التحويل.

في Visual Studio Code:

dotnet run

curl -X POST "https://localhost:5001/api/pdf/convert?outputFormat=docx" \
     -F "file=@sample.pdf" \
     -o converted.docx

نشر إلى Azure

في Visual Studio:

انقر بزر الماوس الأيمن على المشروع.
اختر “نشر”.
اختر “Azure” كهدف.
اختر “خدمة تطبيقات Azure (Windows)”.
اختر اشتراكك وخدمة التطبيقات.
انقر على “نشر”.

في Visual Studio Code:

dotnet publish -c Release

az webapp deployment source config-zip \
    --resource-group $resourceGroup \
    --name $appName \
    --src bin/Release/net6.0/publish.zip

az webapp deploy \
    --resource-group $resourceGroup \
    --name $appName \
    --src-path "Aspose.PDF.lic" \
    --target-path "site/wwwroot/Aspose.PDF.lic"

تكوين خدمة تطبيقات Azure

انتقل إلى بوابة Azure.
افتح خدمة التطبيقات الخاصة بك.

قم بتكوين الإعدادات:

App Settings:
- WEBSITE_RUN_FROM_PACKAGE=1
- ASPNETCORE_ENVIRONMENT=Production

اختبار الخدمة المنشورة

استخدم Postman أو curl للاختبار:

curl -X POST "https://your-app.azurewebsites.net/api/pdf/convert?outputFormat=docx" \
     -F "file=@sample.pdf" \
     -o converted.docx

التنسيقات المدعومة

يمكن العثور على قائمة بالتنسيقات المدعومة هنا.

استكشاف الأخطاء وإصلاحها

خيارات التكوين المهمة

حدود حجم الملف أضف إلى web.config:

<configuration>
  <system.webServer>
    <security>
      <requestFiltering>
        <requestLimits maxAllowedContentLength="104857600" />
      </requestFiltering>
    </security>
  </system.webServer>
</configuration>

CORS (إذا لزم الأمر) في Program.cs:

builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowSpecificOrigin",
        builder => builder
            .WithOrigins("https://your-frontend-domain.com")
            .AllowAnyMethod()
            .AllowAnyHeader());
});

المصادقة (إذا لزم الأمر)

builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options => {
        // Configure JWT options
    });

تحويل المستندات باستخدام وظيفة Microsoft Azure