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

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

Azure Functionsとは
実装する内容
アプリケーションを作成
NuGetパッケージの追加
DioDocs for Excelを使うコードを追加
DioDocs for PDFを使う関数を追加
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で直接ローカルへ出力する、といった内容です。

アプリケーションを作成

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

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

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

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

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

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

NuGetパッケージの追加

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

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,
        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["A1"].Value = Message;

        byte[] output;
        using (var ms = new MemoryStream())
        {
            workbook.Save(ms, SaveFileFormat.Xlsx);
            output = ms.ToArray();
        }

        return new FileContentResult(output, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
        {
            FileDownloadName = "Result.xlsx"
        };
    }
}

DioDocs for PDFを使う関数を追加

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

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

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,
        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));

        byte[] output;

        using (var ms = new MemoryStream())
        {
            doc.Save(ms, false);
            output = ms.ToArray();
        }

        return new FileContentResult(output, "application/pdf")
        {
            FileDownloadName = "Result.pdf"
        };
    }
}

デバッグ実行で確認

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

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