Pacem.Extensions.OfficeWord.Pdf 0.8.11

Office Word Extensions

About

Pacem.Extensions.OfficeWord.Pdf provides a lightweight set of utilities that ease the conversion of .docx documents into PDFs.

This library depends on Pacem.Extensions.OfficeWord. Please, check its documentation first.

The following paragraphs exemplify the library utilization.

Getting started

Inject the IOfficeWordPdfConverter singleton service into the DI container.

Currently, there's no other [than the dependency injection] way to reach the instance of the processor service.

Like this:

// Program.cs
// You can inject your own instance of `IOfficeWordPdfConverter`
services.AddPacemOfficeWordProcessor()
	.WithPdfConverter<MyConverterType>();

Or you can lean on the - actually sole - implementation of IOfficeWordPdfConverter, which relies on Microsoft Graph API.

You need an account bound to an Office 365 subscription, and an Azure Application relevant to that user with access to the Microsoft Graph API.

// Program.cs
// You can inject your own instance of `IOfficeWordPdfConverter`
services.AddPacemOfficeWordProcessor()
	.WithMicrosoftGraphPdfConverter(options => {
		options.TenantId = "00000000-0000-0000-0000-000000000000", // your tenant id
		options.ClientId = "00000000-0000-0000-0000-000000000000", // your application id
		options.ClientSecret = "Sneaky~Password", // your application secret
		options.UserId = "00000000-0000-0000-0000-000000000000", // the user id licensed w Office 365
	});

Then use it in your services, like this:

namespace Pacem.OpenXml.OfficeWord;

public class MyController : ControllerBase
{
    private readonly IOfficeWordProcessor _word;
    private readonly IOfficeWordPdfConverter _pdf;

    public MyController(IOfficeWordProcessor word, IOfficeWordPdfConverter pdf)
    {
        _word = word;
		_pdf = pdf;
    }

    // [...]
}

Usage

For a comprehensive list of usage example, please refer to Pacem.Extensions.OfficeWord documentation.

Here's a simple find and replace code sample.
The important part is the conversion function, which is the last instruction in the code sample.

string root = AppContext.BaseDirectory;
string source = Path.Combine(root, "file1.docx");
string target = Path.Combine(root, "file1-replaced.pdf");
await _word.Open(source)
    .Find("[_my_placeholder_]")
    .ReplaceWith("Hello, World!")
    .FlushPdfAsync(_pdf, target);