Microsoft Azure Appサービスを使用したドキュメントの変換

この記事では、Microsoft Azureを使用してPDFドキュメントを変換するための詳細な手順を提供します。Aspose.PDF for .NETとAzure Appサービスを使用します。

前提条件

Azure開発がインストールされたVisual Studio 2022 Community EditionまたはVisual Studio Code。
Azureアカウント: Azureサブスクリプションが必要です。開始する前に無料アカウントを作成してください。
.NET 6 SDK。
Aspose.PDF for .NET。

Azureリソースの作成

Appサービスの作成

Azureポータルに移動します (https://portal.azure.com)。
新しいリソースグループを作成します。
新しいAppサービスを作成します:
- .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 .

PdfConverterApp.csprojを作成/更新してNuGetパッケージを追加します:

<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 UIが開きます。
/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 App Service (Windows)」を選択します。
サブスクリプションとAppサービスを選択します。
「発行」をクリックします。

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 Appサービスの構成

Azureポータルに移動します。
Appサービスを開きます。

設定を構成します:

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 Functionを使用したドキュメントの変換