Azure에서 .NET 사용하여 IronWord 실행하는 방법

IronWord 설치 중

먼저 공식 NuGet 저장소에서 IronWord NuGet 패키지를 설치하세요.

Install-Package IronWord

Azure 호스팅 시 고려 사항

Azure의 Docker에 배포

Azure Functions를 사용한 서버리스

Azure Functions 예제: 요청에 따라 Word 문서 생성

다음은 HTTP 요청에 대한 응답으로 Word 문서를 생성하고 반환하는 Azure Function의 실제 예입니다.

using System.Net;
using System.Net.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Extensions.Logging;
using System.Net.Http.Headers;
using IronWord;
using IronWord.Models;
using System.IO;
using System.Threading.Tasks;

public static class WordFunction
{
    [FunctionName("GenerateWordDoc")]
    public static HttpResponseMessage Run(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
        ILogger log)
    {
        log.LogInformation("Processing request to generate Word document...");

        // Set your IronWord license key
        IronWord.License.LicenseKey = "YOUR-LICENSE-KEY";

        // Create and populate Word document
        var doc = new WordDocument();
        Paragraph para1 = new Paragraph(new TextContent("This Word document was generated by IronWord in an Azure Function."));
        Paragraph para2 = new Paragraph(new TextContent($"Timestamp: {System.DateTime.UtcNow}"));
        doc.AddParagraph(para1);
        doc.AddParagraph(para2);

        // Save to temporary file
        string tempPath = Path.GetTempFileName().Replace(".tmp", ".docx");
        doc.SaveAs(tempPath);

        // Read the file bytes
        byte[] fileBytes = File.ReadAllBytes(tempPath);

        // Optionally delete the temp file
        File.Delete(tempPath);

        // Build the response with the document as an attachment
        var response = new HttpResponseMessage(HttpStatusCode.OK)
        {
            Content = new ByteArrayContent(fileBytes)
        };
        response.Content.Headers.ContentDisposition = new ContentDispositionHeaderValue("attachment")
        {
            FileName = $"IronWord_{System.DateTime.UtcNow:yyyyMMdd_HHmmss}.docx"
        };
        response.Content.Headers.ContentType = new MediaTypeHeaderValue(
            "application/vnd.openxmlformats-officedocument.wordprocessingml.document");

        return response;
    }
}

using System.Net;
using System.Net.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Extensions.Logging;
using System.Net.Http.Headers;
using IronWord;
using IronWord.Models;
using System.IO;
using System.Threading.Tasks;

public static class WordFunction
{
    [FunctionName("GenerateWordDoc")]
    public static HttpResponseMessage Run(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
        ILogger log)
    {
        log.LogInformation("Processing request to generate Word document...");

        // Set your IronWord license key
        IronWord.License.LicenseKey = "YOUR-LICENSE-KEY";

        // Create and populate Word document
        var doc = new WordDocument();
        Paragraph para1 = new Paragraph(new TextContent("This Word document was generated by IronWord in an Azure Function."));
        Paragraph para2 = new Paragraph(new TextContent($"Timestamp: {System.DateTime.UtcNow}"));
        doc.AddParagraph(para1);
        doc.AddParagraph(para2);

        // Save to temporary file
        string tempPath = Path.GetTempFileName().Replace(".tmp", ".docx");
        doc.SaveAs(tempPath);

        // Read the file bytes
        byte[] fileBytes = File.ReadAllBytes(tempPath);

        // Optionally delete the temp file
        File.Delete(tempPath);

        // Build the response with the document as an attachment
        var response = new HttpResponseMessage(HttpStatusCode.OK)
        {
            Content = new ByteArrayContent(fileBytes)
        };
        response.Content.Headers.ContentDisposition = new ContentDispositionHeaderValue("attachment")
        {
            FileName = $"IronWord_{System.DateTime.UtcNow:yyyyMMdd_HHmmss}.docx"
        };
        response.Content.Headers.ContentType = new MediaTypeHeaderValue(
            "application/vnd.openxmlformats-officedocument.wordprocessingml.document");

        return response;
    }
}

코드 설명:

1. "GenerateWordDoc"이라는 이름의 Azure Function을 정의합니다.
2. 이 함수는 HTTP GET 또는 POST 요청에 의해 실행되며 처리를 시작할 때 메시지를 로그에 기록합니다.
3. IronWord 의 라이선스 키는 IronWord 설정하여 지정합니다("YOUR-LICENSE-KEY"를 실제 라이선스 키로 바꾸십시오).
4. IronWord의 API를 사용하여 새 Word 문서가 생성됩니다.
5. 문서에 두 개의 단락이 추가됩니다. 하나는 고정된 텍스트이고 다른 하나는 현재 UTC 타임스탬프를 보여줍니다.
6. 문서는 doc.SaveAs(tempPath)를 사용하여 서버의 임시 .docx 파일로 저장됩니다.
7. 저장된 파일은 File.ReadAllBytes를 사용하여 바이트 배열로 읽어들여 다운로드를 위한 준비를 합니다.
8. 시스템을 깨끗하게 유지하기 위해 임시 파일은 읽은 직후 즉시 삭제됩니다.
9. 문서의 바이트 콘텐츠를 다운로드 가능한 첨부 파일로 포함하는 HttpResponseMessage가 생성됩니다.
10. Content-Disposition 헤더는 현재 날짜와 시간을 사용하여 다운로드 파일 이름을 설정합니다.
11. Content-Type 헤더는 Word 파일 형식을 나타내기 위해 "application/vnd.openxmlformats-officedocument.wordprocessingml.document"로 설정됩니다.