Copy page

365 business PDF

Pdf - Stationery

Codeunit 5523673 bdev.Pdf - Stationery applies a stationery - a PDF document that is laid under the pages of another PDF - to a document of your own. It is what the app itself uses when a report selection carries a stationery configuration, so a document you process this way looks exactly like one the app processed.

There are two ways to state which stationery to apply:

• a stationery document, passed as a Temp Blob. It is laid under every page.
• a stationery configuration, a bdev.Pdf Stationery Config. record. The configuration states a PDF file per page position - first page, following pages, second last page, last page, or all pages - and whether it applies to the print intent at hand.

Code
    pdfStationery: Codeunit "bdev.Pdf - Stationery";

ApplyStationeryToDocument(Codeunit, Codeunit)

Applies a stationery document to every page of a PDF document.

Code
    procedure ApplyStationeryToDocument(var document: Codeunit "Temp Blob"; stationery: Codeunit "Temp Blob")

Example

Code
    procedure ApplyStationery(var document: Codeunit "Temp Blob")
    var
        mySetup: Record "My Setup";
        pdfStationery: Codeunit "bdev.Pdf - Stationery";
        stationery: Codeunit "Temp Blob";
    begin
        mySetup.Get();

        stationery.FromRecord(mySetup, mySetup.FieldNo("Stationery Document"));

        pdfStationery.ApplyStationeryToDocument(document, stationery);
    end;

ApplyStationeryToDocument(Codeunit, Record)

Applies the page settings of a stationery configuration to a PDF document, with the print intent Print.

Code
    procedure ApplyStationeryToDocument(var document: Codeunit "Temp Blob"; pdfStationeryConfig: Record "bdev.Pdf Stationery Config.")

Example

Code
    procedure ApplyStationery(var document: Codeunit "Temp Blob"; stationeryConfigCode: Code[20])
    var
        pdfStationeryConfig: Record "bdev.Pdf Stationery Config.";
        pdfStationery: Codeunit "bdev.Pdf - Stationery";
    begin
        if (not pdfStationeryConfig.Get(stationeryConfigCode)) then
            exit;

        pdfStationery.ApplyStationeryToDocument(document, pdfStationeryConfig);
    end;

Letting the user pick the configuration works the same way as anywhere else:

Code
    procedure SelectAndApplyStationery(var document: Codeunit "Temp Blob")
    var
        pdfStationeryConfig: Record "bdev.Pdf Stationery Config.";
        pdfStationery: Codeunit "bdev.Pdf - Stationery";
        pdfStationeryConfigList: Page "bdev.Pdf Stat. Config. List";
    begin
        pdfStationeryConfigList.LookupMode(true);
        if (pdfStationeryConfigList.RunModal() <> Action::LookupOK) then
            exit;
        pdfStationeryConfigList.GetRecord(pdfStationeryConfig);

        pdfStationery.ApplyStationeryToDocument(document, pdfStationeryConfig);
    end;

ApplyStationeryToDocument(Codeunit, Record, Code)

Applies the page settings of a stationery configuration in a given language, with the print intent Print.

Code
    procedure ApplyStationeryToDocument(var document: Codeunit "Temp Blob"; pdfStationeryConfig: Record "bdev.Pdf Stationery Config."; languageCode: Code[10])

The language decides which PDF file the configuration resolves to. A PDF file marked as All Languages is used regardless of the language code, and so is the default file when no translation exists for the language - see Pdf - File.

ApplyStationeryToDocument(Codeunit, Record, Enum)

Applies the page settings of a stationery configuration for a given print intent.

Code
    procedure ApplyStationeryToDocument(var document: Codeunit "Temp Blob"; pdfStationeryConfig: Record "bdev.Pdf Stationery Config."; documentPrintIntent: Enum "bdev.Pdf Document Print Intent")

ApplyStationeryToDocument(Codeunit, Record, Enum, Code)

The full overload: a stationery configuration, a print intent and a language.

Code
    procedure ApplyStationeryToDocument(var document: Codeunit "Temp Blob"; pdfStationeryConfig: Record "bdev.Pdf Stationery Config."; documentPrintIntent: Enum "bdev.Pdf Document Print Intent"; languageCode: Code[10])

The print intent decides whether anything happens

A stationery configuration carries a Perform on ... switch per print intent. When the switch of the intent you pass is off, the method returns without applying anything and without an error - the same behavior the app shows when a user previews a document whose stationery is configured for printing only.

The overload that takes a stationery document rather than a configuration has no such switch and always applies the stationery.

See also

• 365 business PDF - Overview
• Pdf - File
• Pdf - Concatenate
• Documentation - Stationery