Convertir Documentos con la función de Microsoft Azure

Este artículo proporciona instrucciones detalladas paso a paso para convertir documentos PDF en Microsoft Azure utilizando Aspose.PDF for .NET y la función de Azure.

Requisitos Previos

Visual Studio 2022 Community Edition con desarrollo de Azure instalado o Visual Studio Code.
Cuenta de Azure: Necesita una suscripción de Azure, cree una cuenta gratuita antes de comenzar.
SDK de .NET 6.
Aspose.PDF for .NET.

Crear Recursos de Azure

Crear Cuenta de Almacenamiento

Vaya al Portal de Azure (https://portal.azure.com).
Haga clic en “Crear un recurso”.
Busque “Cuenta de almacenamiento”.
Haga clic en “Crear”.
Complete los detalles:
- Suscripción: Elija su suscripción.
- Grupo de recursos: Cree uno nuevo o seleccione uno existente.
- Nombre de la cuenta de almacenamiento: Ingrese un nombre único.
- Región: Elija la región más cercana.
- Rendimiento: Estándar.
- Redundancia: LRS (almacenamiento redundante localmente).
Haga clic en “Revisar + crear”.
Haga clic en “Crear”.

Crear Contenedor

Abra su cuenta de almacenamiento.
Vaya a “Contenedores” bajo “Almacenamiento de datos”.
Haga clic en “+ Contenedor”.
Nómbralo “pdfdocs”.
Establezca el nivel de acceso público en “Privado”.
Haga clic en “Crear”.

Crear Proyecto

Crear Proyecto en Visual Studio

Abra Visual Studio 2022.
Haga clic en “Crear un nuevo proyecto”.
Seleccione “Funciones de Azure”.
Nombre su proyecto “PdfConverterAzure”.
Elija “.NET 6.0” o posterior y “disparador HTTP”.
Haga clic en “Crear”.

Crear Proyecto en Visual Studio Code

Instalar Requisitos Previos

Extensiones de Visual Code:

code --install-extension ms-dotnettools.csharp
code --install-extension ms-azuretools.vscode-azurefunctions
code --install-extension ms-vscode.azure-account

Instalar Azure Functions Core Tools:

npm install -g azure-functions-core-tools@4 --unsafe-perm true

Instalar Azure CLI:

Windows: Descargue desde el sitio web de Microsoft.
macOS: brew install azure-cli.
Linux: curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash.

Configurar Proyecto

Abra el proyecto en Visual Studio Code:

code .

Agregue paquetes NuGet creando/actualizando PdfConverterApp.csproj:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="4.1.1" />
    <PackageReference Include="Aspose.PDF" Version="24.10.0" />
    <PackageReference Include="Azure.Storage.Blobs" Version="12.14.1" />
    <PackageReference Include="Microsoft.Azure.WebJobs.Extensions.Storage" Version="5.0.1" />
  </ItemGroup>
</Project>

Instalar Paquetes NuGet Requeridos

En Visual Studio, abra la Consola del Administrador de Paquetes y ejecute:

Install-Package Aspose.PDF
Install-Package Azure.Storage.Blobs
Install-Package Microsoft.Azure.WebJobs.Extensions.Storage

En Visual Studio Code, ejecute:

dotnet restore

Configurar Conexión de Almacenamiento de Azure

Obtenga las Claves de Acceso para la cuenta de almacenamiento en Claves de acceso en el Portal de Azure. Estas claves se utilizarán para autenticar su aplicación.

Abra local.settings.json:

{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "YOUR_STORAGE_CONNECTION_STRING",
        "FUNCTIONS_WORKER_RUNTIME": "dotnet",
        "ContainerName": "pdfdocs"
    }
}

Reemplace YOUR_STORAGE_CONNECTION_STRING con su cadena de conexión de almacenamiento real del Portal de Azure.

Configurar Licencia de Aspose

En Visual Studio:

Copie su archivo de licencia de Aspose.PDF al proyecto.
Haga clic derecho en el archivo de licencia y seleccione “Propiedades”.
Establezca “Copiar en el directorio de salida” en “Copiar siempre”.
Agregue el código de inicialización de la licencia en el Program.cs:

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

Crear código

Cree un nuevo archivo PdfConverter.cs:

using Azure.Storage.Blobs;
using System;
using System.IO;
using System.Threading.Tasks;

public class PdfConverter
{
    private readonly BlobContainerClient _containerClient;

    public PdfConverter(string connectionString, string containerName)
    {
        _containerClient = new BlobContainerClient(connectionString, containerName);
    }

    public async Task<string> ConvertToFormat(string sourceBlobName, string targetFormat)
    {
        // Download source PDF
        var sourceBlob = _containerClient.GetBlobClient(sourceBlobName);
        using var sourceStream = new MemoryStream();
        await sourceBlob.DownloadToAsync(sourceStream);
        sourceStream.Position = 0;

        // Open PDF document
        var document = new Aspose.Pdf.Document(sourceStream);

        // Create output stream
        using var outputStream = new MemoryStream();
        string targetBlobName = Path.GetFileNameWithoutExtension(sourceBlobName);

        // Convert based on format
        switch (targetFormat.ToLower())
        {
            case "docx":
                targetBlobName += ".docx";
                document.Save(outputStream, Aspose.Pdf.SaveFormat.DocX);
                break;

            case "html":
                targetBlobName += ".html";
                document.Save(outputStream, Aspose.Pdf.SaveFormat.Html);
                break;

            case "xlsx":
                targetBlobName += ".xlsx";
                document.Save(outputStream, Aspose.Pdf.SaveFormat.Excel);
                break;

            case "pptx":
                targetBlobName += ".pptx";
                document.Save(outputStream, Aspose.Pdf.SaveFormat.Pptx);
                break;

            case "jpeg":
            case "jpg":
                targetBlobName += ".jpg";
                foreach (var page in document.Pages)
                {
                    var jpegDevice = new Aspose.Pdf.Devices.JpegDevice(new Aspose.Pdf.Devices.Resolution(300));
                    jpegDevice.Process(page, outputStream);
                }
                break;

            default:
                throw new ArgumentException($"Unsupported format: {targetFormat}");
        }

        // Upload converted file
        outputStream.Position = 0;
        var targetBlob = _containerClient.GetBlobClient(targetBlobName);
        await targetBlob.UploadAsync(outputStream, true);

        return targetBlob.Uri.ToString();
    }
}

Cree un nuevo archivo ConvertPdfFunction.cs:

using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Logging;
using System.Threading.Tasks;
using System;
using System.IO;
using Newtonsoft.Json;
using Microsoft.AspNetCore.Mvc;

public static class ConvertPdfFunction
{
    [FunctionName("ConvertPdf")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "post"), Route = "convert"] HttpRequest req,
        ILogger log)
    {
        try
        {
            // Read request body
            string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
            dynamic data = JsonConvert.DeserializeObject(requestBody);

            string sourceBlob = data?.sourceBlob;
            string targetFormat = data?.targetFormat;

            if (string.IsNullOrEmpty(sourceBlob) || string.IsNullOrEmpty(targetFormat))
            {
                return new BadRequestObjectResult("Please provide sourceBlob and targetFormat");
            }

            // Get configuration
            string connectionString = Environment.GetEnvironmentVariable("AzureWebJobsStorage");
            string containerName = Environment.GetEnvironmentVariable("ContainerName");

            // Convert PDF
            var converter = new PdfConverter(connectionString, containerName);
            string resultUrl = await converter.ConvertToFormat(sourceBlob, targetFormat);

            return new OkObjectResult(new { url = resultUrl });
        }
        catch (Exception ex)
        {
            log.LogError(ex, "Error converting PDF");
            return new StatusCodeResult(500);
        }
    }
}

// Startup.cs
[assembly: FunctionsStartup(typeof(PdfConverterAzure.Functions.Startup))]
namespace PdfConverterAzure.Functions
{
    public class Startup : FunctionsStartup
    {
        public override void Configure(IFunctionsHostBuilder builder)
        {
            // Read configuration
            var config = builder.GetContext().Configuration;

            // Register services
            builder.Services.AddLogging();

            // Register Azure Storage
            builder.Services.AddSingleton(x => 
                new BlobServiceClient(config["AzureWebJobsStorage"]));

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

Probar Localmente

En Visual Studio:

Inicie el emulador de almacenamiento de Azure.
Ejecute el proyecto en Visual Studio.
Use Postman o curl para probar:

curl -X POST http://localhost:7071/api/convert \
-H "Content-Type: application/json" \
-d '{"sourceBlob": "sample.pdf", "targetFormat": "docx"}'

En Visual Studio Code:

Inicie la aplicación de función:

func start

Cargue un PDF para probar:

az storage blob upload \
    --account-name $AccountName \
    --container-name pdfdocs \
    --name sample.pdf \
    --file /path/to/your/sample.pdf

Use Postman o curl para probar:

curl -X POST http://localhost:7071/api/convert \
-H "Content-Type: application/json" \
-d '{"sourceBlob": "sample.pdf", "targetFormat": "docx"}'

Desplegar en Azure

En Visual Studio:

Haga clic derecho en el proyecto en Visual Studio.
Seleccione “Publicar”.
Elija “Aplicación de Función de Azure”.
Seleccione su suscripción.
Cree una nueva o seleccione una Aplicación de Función existente.
Haga clic en “Publicar”.

En Visual Studio Code:

Presione F1 o Ctrl+Shift+P.
Seleccione “Funciones de Azure: Desplegar en Aplicación de Función”.
Elija su suscripción.
Seleccione la aplicación de función creada anteriormente.
Haga clic en “Desplegar”.

Configurar Aplicación de Función de Azure

Vaya al Portal de Azure.
Abra su Aplicación de Función.
Vaya a “Configuración”.
Agregue configuraciones de aplicación:
- Clave: “ContainerName”.
- Valor: “pdfdocs”.
Guarde los cambios.

Probar el Servicio Desplegado

Use Postman o curl para probar:

curl -X POST "https://your-function.azurewebsites.net/api/convert" \
     -H "x-functions-key: your-function-key" \
     -H "Content-Type: application/json" \
     -d '{"sourceBlob": "sample.pdf", "targetFormat": "docx"}'

Formatos Soportados

La lista de formatos soportados se puede encontrar aquí.

Solución de Problemas

Opciones de Configuración Importantes

Agregar autenticación:

[FunctionName("ConvertPdf")]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Function, "post", Route = "convert")] HttpRequest req,
    ClaimsPrincipal principal,
    ILogger log)
{
    // Check authentication
    if (!principal.Identity.IsAuthenticated)
    {
        return new UnauthorizedResult();
    }
    // ...
}

Para archivos grandes, considere:
- Aumentar el tiempo de espera de la función.
- Usar un plan de consumo con más memoria.
- Implementar carga/descarga en fragmentos.
- Agregar seguimiento de progreso.

Convertir Documentos con Microsoft Azure App Service