Azure FunctionsとDioDocsでExcelやPDFファイルを出力する（2）

前回に引き続き、本記事でもAzure Functionsで「DioDocs（ディオドック）」を使用したC#（ .NET Core 3.1）のクラスライブラリをベースにした関数を作成し、ExcelやPDFファイルを出力する方法について紹介します。

Azure Functionsとは
実装する内容
アプリケーションを作成
NuGetパッケージの追加
Azure Blob Storageを使うコードを追加
DioDocs for Excelを使うコードを追加
DioDocs for PDFを使う関数を追加
Azure Blob Storageを使うコードを追加
DioDocs for PDFを使うコードを追加
デバッグ実行で確認
Azureへデプロイ
デプロイしたアプリケーションを確認
さいごに

Azure Functionsとは

Azure FunctionsはMicrosoft Azureで提供されている、各種イベントをトリガーに処理を実行するサーバーレスなアプリケーションを作成できるクラウドサービスです。

今回はVisual Studio 2019でAzure Functionsアプリケーションを作成し、Azureへデプロイして確認してみます。

実装する内容

実装する内容は今回も非常にシンプルです。Azure FunctionsアプリケーションでHTTPトリガーを使用する関数を作成します。関数の実行時にDioDocsを使用してExcelとPDFファイルを作成し、クエリパラメータで受け取った文字列を追加します。前回は作成したExcelとPDFファイルをFileContentResultで直接ローカルへ出力していましたが、今回は作成したExcelとPDFファイルをAzure Blob Storageへ出力します。

アプリケーションを作成

以下のドキュメントを参考にAzure Functionsアプリケーションを作成していきます。

クイックスタート:Visual Studio を使用して Azure で初めての関数を作成する

Visual Studio 2019でプロジェクトテンプレート「Azure Functions」を選択して［次へ］をクリックします。

プロジェクト名DioDocsFileIOFunctionAppを入力して［作成］をクリックします。

Azure Functionsで作成する関数のテンプレートを選択します。Http Triggerを選択して［作成］をクリックします。

DioDocsFileIOFunctionAppプロジェクトが作成されます。

NuGetパッケージの追加

Visual Studioの「NuGet パッケージマネージャー」からDioDocsのパッケージGrapeCity.DioDocs.Excel.ja、GrapeCity.DioDocs.Pdf.jaをインストールします。

また、作成したExcelとPDFファイルをAzure Blob Storageへ出力するために、出力バインドでAzure Blob Storageを使用するので、必要なパッケージMicrosoft.Azure.WebJobs.Extensions.Storageをインストールします。

Azure Blob Storageを使うコードを追加

Azure Blob Storageの出力バインドを設定するコードを追加してFunction1を以下のように更新します。

public static class Function1
{
    [FunctionName("Function1")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req,
        [Blob("output/result.xlsx", FileAccess.Write)] Stream outputfile,
        ILogger log)
    {
        log.LogInformation("C# HTTP trigger function processed a request.");

        string name = req.Query["name"];

        string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
        dynamic data = JsonConvert.DeserializeObject(requestBody);
        name = name ?? data?.name;

        string responseMessage = string.IsNullOrEmpty(name)
            ? "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response."
            : $"Hello, {name}. This HTTP triggered function executed successfully.";

        return new OkObjectResult(responseMessage);
    }
}

追加した6行目のコードですが、出力バインドの属性コンストラクタ[Blob("output/result.xlsx", FileAccess.Write)]では、出力先となるAzure Blob Storageのコンテナとファイル名output/result.xlsxと、Azure Blob Storageへの書き込みアクセスFileAccess.Writeを設定しています。

DioDocs for Excelを使うコードを追加

DioDocsでExcelファイルを作成するコードを追加してFunction1を以下のように更新します。

public static class Function1
{
    [FunctionName("Function1")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req,
        [Blob("output/result.xlsx", FileAccess.Write)] Stream outputfile,
        ILogger log)
    {
        log.LogInformation("C# HTTP trigger function processed a request.");

        string name = req.Query["name"];

        string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
        dynamic data = JsonConvert.DeserializeObject(requestBody);
        name = name ?? data?.name;

        string Message = string.IsNullOrEmpty(name)
            ? "Hello, World!!"
            : $"Hello, {name}!!";

        Workbook workbook = new Workbook();

        workbook.Worksheets[0].Range["B2"].Value = Message;

        workbook.Save(outputfile);

        return new OkObjectResult("Finished.");
    }
}

DioDocs for PDFを使う関数を追加

ソリューションエクスプローラーからDioDocsFileIOFunctionAppプロジェクトを右クリックして［追加］－［新しい Azure 関数］を選択して、DioDocsでPDFファイルを作成する関数Function2を追加します。

関数のテンプレートを選択します。Http Triggerを選択して［追加］をクリックします。

Azure Blob Storageを使うコードを追加

Azure Blob Storageの出力バインドを設定するコードを追加してFunction2を以下のように更新します。

public static class Function2
{
    [FunctionName("Function2")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req,
        [Blob("output/result.pdf", FileAccess.Write)] Stream outputfile,
        ILogger log)
    {
        log.LogInformation("C# HTTP trigger function processed a request.");

        string name = req.Query["name"];

        string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
        dynamic data = JsonConvert.DeserializeObject(requestBody);
        name = name ?? data?.name;

        string responseMessage = string.IsNullOrEmpty(name)
            ? "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response."
            : $"Hello, {name}. This HTTP triggered function executed successfully.";

        return new OkObjectResult(responseMessage);
    }
}

先程と同じように、追加した6行目のコードでは出力バインドの属性コンストラクタ[Blob("output/result.pdf", FileAccess.Write)]では、出力先となるAzure Blob Storageのコンテナとファイル名output/result.pdfと、Azure Blob Storageへの書き込みアクセスFileAccess.Writeを設定しています。

DioDocs for PDFを使うコードを追加

DioDocsでPDFファイルを作成するコードを追加してFunction2を以下のように更新します。

public static class Function2
{
    [FunctionName("Function2")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req,
        [Blob("output/result.pdf", FileAccess.Write)] Stream outputfile,
        ILogger log)
    {
        log.LogInformation("C# HTTP trigger function processed a request.");

        string name = req.Query["name"];

        string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
        dynamic data = JsonConvert.DeserializeObject(requestBody);
        name = name ?? data?.name;

        string Message = string.IsNullOrEmpty(name)
            ? "Hello, World!!"
            : $"Hello, {name}!!";

        GcPdfDocument doc = new GcPdfDocument();
        GcPdfGraphics g = doc.NewPage().Graphics;

        g.DrawString(Message,
            new TextFormat() { Font = StandardFonts.Helvetica, FontSize = 12 },
            new PointF(72, 72));

        doc.Save(outputfile, false);

        return new OkObjectResult("Finished.");
    }
}

デバッグ実行で確認

今回はAzure Functionアプリケーションの関数で作成するExcelとPDFファイルの出力先として、関数の出力バインドで設定しているAzure Blob Storageを使用しています。ローカルでの確認にはAzure Storage Emulatorを使用します。Visual StudioでCloud Explorerを表示して［Blob Containers］を右クリックして表示されるメニューから［BLOB コンテナーの作成］を選択します。

outputというコンテナを作成します。

作成したAzure Functionsアプリケーションをローカルでデバッグ実行して確認します。Visual Studioからデバッグ実行すると以下のコンソールが表示されます。

アプリケーションに含まれる関数のURLはhttp://localhost:7071/api/Function1、http://localhost:7071/api/Function2となっています。このURLにクエリパラメータと文字列?name=DioDocsを追加して、それぞれの関数をブラウザで実行します。