Codeunit 260 Document-Mailing

Base Application, System.EMail

src/Layers/W1/BaseApp/DocumentMailing.Codeunit.al867 lines, Copyright (c) Microsoft Corporation. MIT

// ------------------------------------------------------------------------------------------------// Copyright (c) Microsoft Corporation. All rights reserved.// Licensed under the MIT License. See License.txt in the project root for license information.// ------------------------------------------------------------------------------------------------namespace System.EMail;using Microsoft.CRM.Outlook;using Microsoft.Foundation.Company;using Microsoft.Foundation.Reporting;using Microsoft.Purchases.Vendor;using Microsoft.Sales.Customer;using System;#if not CLEAN27using System.IO;#endifusing System.Threading;using System.Utilities;codeunit 260 "Document-Mailing"{    TableNo = "Job Queue Entry";    trigger OnRun()    var        ReportSelections: Record "Report Selections";    begin        ReportSelections.SendEmailInBackground(Rec);    end;    var        EmailSubjectCapTxt: Label '%1 - %2 %3', Comment = '%1 = Customer Name. %2 = Document Type %3 = Invoice No.';        ReportAsPdfFileNameMsg: Label '%1 %2.pdf', Comment = '%1 = Document Type %2 = Invoice No. or Job Number';        EmailSubjectPluralCapTxt: Label '%1 - %2', Comment = '%1 = Customer Name. %2 = Document Type in plural form';        PdfFileNamePluralPurchaseTxt: Label '%1 (Purchase).pdf', Comment = '%1 = Document Type in plural form';        PdfFileNamePluralSalesTxt: Label '%1 (Sales).pdf', Comment = '%1 = Document Type in plural form';        PdfFileNamePluralTxt: Label '%1.pdf', Comment = '%1 = Document Type in plural form';        CustomerLbl: Label '<Customer>';    internal procedure EnqueueEmailFile(AttachmentInStream: Instream; AttachmentName: Text; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceTables: List of [Integer]; SourceIDs: List of [Guid]; SourceRelationTypes: List of [Integer]): Boolean    var        TempEmailItem: Record "Email Item" temporary;        HtmlBody: Codeunit "Temp Blob";    begin        TempEmailItem.SetSourceDocuments(SourceTables, SourceIDs, SourceRelationTypes);        TempEmailItem.AddAttachment(AttachmentInStream, AttachmentName);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            '',            ToEmailAddress,            PostedDocNo,            EmailDocName,            HideDialog,            ReportUsage,            true,            '',            Enum::"Email Scenario"::Default,            true            ));    end;#if not CLEAN27    [Obsolete('Use procedure EmailFile that accepts a "Temp Blob" for the html body instead.', '27.0')]    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; HtmlBodyFilePath: Text; EmailSubject: Text; ToEmailAddress: Text; HideDialog: Boolean; EmailScenario: Enum "Email Scenario"): Boolean    var        FileManagement: Codeunit "File Management";        HtmlBody: Codeunit "Temp Blob";    begin        if HtmlBodyFilePath <> '' then            FileManagement.BLOBImportFromServerFile(HtmlBody, HtmlBodyFilePath);        exit(EmailFile(AttachmentStream, AttachmentName, HtmlBody, EmailSubject, ToEmailAddress, HideDialog, EmailScenario));    end;#endif    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; var HtmlBody: Codeunit "Temp Blob"; EmailSubject: Text; ToEmailAddress: Text; HideDialog: Boolean; EmailScenario: Enum "Email Scenario"): Boolean    var        TempEmailItem: Record "Email Item" temporary;    begin        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            CopyStr(EmailSubject, 1, MaxStrLen(TempEmailItem.Subject)),            CopyStr(ToEmailAddress, 1, MaxStrLen(TempEmailItem."Send to")),            '',            '',            HideDialog,            -1,            false,            '',            EmailScenario,            false));    end;#if not CLEAN27    [Obsolete('Use procedure EmailFile that accepts a "Temp Blob" for the html body instead.', '27.0')]    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; HtmlBodyFilePath: Text[250]; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer): Boolean    var        FileManagement: Codeunit "File Management";        HtmlBody: Codeunit "Temp Blob";    begin        if HtmlBodyFilePath <> '' then            FileManagement.BLOBImportFromServerFile(HtmlBody, HtmlBodyFilePath);        exit(EmailFile(AttachmentStream, AttachmentName, HtmlBody, PostedDocNo, ToEmailAddress, EmailDocName, HideDialog, ReportUsage));    end;#endif    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; var HtmlBody: Codeunit "Temp Blob"; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer): Boolean    var        TempEmailItem: Record "Email Item" temporary;    begin        OnBeforeEmailFile(HideDialog);        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            '',            ToEmailAddress,            PostedDocNo,            EmailDocName,            HideDialog,            ReportUsage,            true,            '',            Enum::"Email Scenario"::Default,            false));    end;#if not CLEAN27    [Obsolete('Use procedure EmailFile that accepts a "Temp Blob" for the html body instead.', '27.0')]    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; HtmlBodyFilePath: Text; EmailSubject: Text; ToEmailAddress: Text; HideDialog: Boolean; EmailScenario: Enum "Email Scenario"; SourceReference: RecordRef): Boolean    var        FileManagement: Codeunit "File Management";        HtmlBody: Codeunit "Temp Blob";    begin        if HtmlBodyFilePath <> '' then            FileManagement.BLOBImportFromServerFile(HtmlBody, HtmlBodyFilePath);        exit(EmailFile(AttachmentStream, AttachmentName, HtmlBody, EmailSubject, ToEmailAddress, HideDialog, EmailScenario, SourceReference));    end;#endif    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; var HtmlBody: Codeunit "Temp Blob"; EmailSubject: Text; ToEmailAddress: Text; HideDialog: Boolean; EmailScenario: Enum "Email Scenario"; SourceReference: RecordRef): Boolean    var        TempEmailItem: Record "Email Item" temporary;    begin        repeat            TempEmailItem.AddSourceDocument(SourceReference.Number(), SourceReference.Field(SourceReference.SystemIdNo()).Value());        until SourceReference.Next() = 0;        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            CopyStr(EmailSubject, 1, MaxStrLen(TempEmailItem.Subject)),            CopyStr(ToEmailAddress, 1, MaxStrLen(TempEmailItem."Send to")),            '',            '',            HideDialog,            -1,            false,            '',            EmailScenario,            false));    end;#if not CLEAN27    [Obsolete('Use procedure EmailFile that accepts a "Temp Blob" for the html body instead.', '27.0')]    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; HtmlBodyFilePath: Text; EmailSubject: Text; ToEmailAddress: Text; HideDialog: Boolean; EmailScenario: Enum "Email Scenario"; SourceTables: List of [Integer]; SourceIDs: List of [Guid]; SourceRelationTypes: List of [Integer]): Boolean    var        FileManagement: Codeunit "File Management";        HtmlBody: Codeunit "Temp Blob";    begin        if HtmlBodyFilePath <> '' then            FileManagement.BLOBImportFromServerFile(HtmlBody, HtmlBodyFilePath);        exit(EmailFile(AttachmentStream, AttachmentName, HtmlBody, EmailSubject, ToEmailAddress, HideDialog, EmailScenario, SourceTables, SourceIDs, SourceRelationTypes));    end;#endif    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; var HtmlBody: Codeunit "Temp Blob"; EmailSubject: Text; ToEmailAddress: Text; HideDialog: Boolean; EmailScenario: Enum "Email Scenario"; SourceTables: List of [Integer]; SourceIDs: List of [Guid]; SourceRelationTypes: List of [Integer]): Boolean    var        TempEmailItem: Record "Email Item" temporary;    begin        TempEmailItem.SetSourceDocuments(SourceTables, SourceIDs, SourceRelationTypes);        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            CopyStr(EmailSubject, 1, MaxStrLen(TempEmailItem.Subject)),            CopyStr(ToEmailAddress, 1, MaxStrLen(TempEmailItem."Send to")),            '',            '',            HideDialog,            -1,            false,            '',            EmailScenario,            false));    end;#if not CLEAN27    [Obsolete('Use procedure EmailFile that accepts a "Temp Blob" for the html body instead.', '27.0')]    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; HtmlBodyFilePath: Text[250]; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceReference: RecordRef): Boolean    var        FileManagement: Codeunit "File Management";        HtmlBody: Codeunit "Temp Blob";    begin        if HtmlBodyFilePath <> '' then            FileManagement.BLOBImportFromServerFile(HtmlBody, HtmlBodyFilePath);        exit(EmailFile(AttachmentStream, AttachmentName, HtmlBody, PostedDocNo, ToEmailAddress, EmailDocName, HideDialog, ReportUsage, SourceReference));    end;#endif    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; var HtmlBody: Codeunit "Temp Blob"; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceReference: RecordRef): Boolean    var        TempEmailItem: Record "Email Item" temporary;    begin        repeat            TempEmailItem.AddSourceDocument(SourceReference.Number(), SourceReference.Field(SourceReference.SystemIdNo()).Value());        until SourceReference.Next() = 0;        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            '',            ToEmailAddress,            PostedDocNo,            EmailDocName,            HideDialog,            ReportUsage,            true,            '',            Enum::"Email Scenario"::Default,            false));    end;    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; HtmlBodyInstream: InStream; EmailSubject: Text; ToEmailAddress: Text; HideDialog: Boolean; EmailScenario: Enum "Email Scenario"; SourceTables: List of [Integer]; SourceIDs: List of [Guid]; SourceRelationTypes: List of [Integer]): Boolean    var        TempEmailItem: Record "Email Item" temporary;        HtmlBody: Codeunit "Temp Blob";        HtmlBodyOutStream: OutStream;    begin        TempEmailItem.SetSourceDocuments(SourceTables, SourceIDs, SourceRelationTypes);        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        HtmlBody.CreateOutStream(HtmlBodyOutStream, TextEncoding::UTF8);        CopyStream(HtmlBodyOutStream, HtmlBodyInstream);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            CopyStr(EmailSubject, 1, MaxStrLen(TempEmailItem.Subject)),            CopyStr(ToEmailAddress, 1, MaxStrLen(TempEmailItem."Send to")),            '',            '',            HideDialog,            -1,            false,            '',            EmailScenario,            false));    end;#if not CLEAN27    [Obsolete('Use procedure EmailFile that accepts a "Temp Blob" for the html body instead.', '27.0')]    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; HtmlBodyFilePath: Text[250]; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceTables: List of [Integer]; SourceIDs: List of [Guid]; SourceRelationTypes: List of [Integer]): Boolean    var        FileManagement: Codeunit "File Management";        HtmlBody: Codeunit "Temp Blob";    begin        if HtmlBodyFilePath <> '' then            FileManagement.BLOBImportFromServerFile(HtmlBody, HtmlBodyFilePath);        exit(EmailFile(AttachmentStream, AttachmentName, HtmlBody, PostedDocNo, ToEmailAddress, EmailDocName, HideDialog, ReportUsage, SourceTables, SourceIDs, SourceRelationTypes));    end;#endif    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; var EmailBody: Codeunit "Temp Blob"; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceTables: List of [Integer]; SourceIDs: List of [Guid]; SourceRelationTypes: List of [Integer]): Boolean    var        TempEmailItem: Record "Email Item" temporary;    begin        TempEmailItem.SetSourceDocuments(SourceTables, SourceIDs, SourceRelationTypes);        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        exit(EmailFileInternal(            TempEmailItem,            EmailBody,            '',            ToEmailAddress,            PostedDocNo,            EmailDocName,            HideDialog,            ReportUsage,            true,            '',            Enum::"Email Scenario"::Default,            false));    end;    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; var HtmlBody: Codeunit "Temp Blob"; EmailSubject: Text[250]; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceTables: List of [Integer]; SourceIDs: List of [Guid]; SourceRelationTypes: List of [Integer]): Boolean    var        TempEmailItem: Record "Email Item" temporary;    begin        TempEmailItem.SetSourceDocuments(SourceTables, SourceIDs, SourceRelationTypes);        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            '',            ToEmailAddress,            PostedDocNo,            EmailDocName,            HideDialog,            ReportUsage,            true,            '',            Enum::"Email Scenario"::Default,            false));    end;    procedure EmailFile(AttachmentStream: Instream; AttachmentName: Text; HtmlBodyInstream: Instream; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceTables: List of [Integer]; SourceIDs: List of [Guid]; SourceRelationTypes: List of [Integer]): Boolean    var        TempEmailItem: Record "Email Item" temporary;        HtmlBody: Codeunit "Temp Blob";        HtmlBodyOutStream: OutStream;    begin        TempEmailItem.SetSourceDocuments(SourceTables, SourceIDs, SourceRelationTypes);        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        HtmlBody.CreateOutStream(HtmlBodyOutStream, TextEncoding::UTF8);        CopyStream(HtmlBodyOutStream, HtmlBodyInstream);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            '',            ToEmailAddress,            PostedDocNo,            EmailDocName,            HideDialog,            ReportUsage,            true,            '',            Enum::"Email Scenario"::Default,            false));    end;#if not CLEAN27    [Obsolete('Use procedure EmailFileWithSubjectAndReportUsage that accepts a "Temp Blob" for the html body instead.', '27.0')]    procedure EmailFileWithSubjectAndReportUsage(AttachmentStream: InStream; AttachmentName: Text; HtmlBodyFilePath: Text[250]; EmailSubject: Text[250]; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer): Boolean    var        FileManagement: Codeunit "File Management";        HtmlBody: Codeunit "Temp Blob";    begin        if HtmlBodyFilePath <> '' then            FileManagement.BLOBImportFromServerFile(HtmlBody, HtmlBodyFilePath);        exit(EmailFileWithSubjectAndReportUsage(AttachmentStream, AttachmentName, HtmlBody, EmailSubject, PostedDocNo, ToEmailAddress, EmailDocName, HideDialog, ReportUsage));    end;#endif    procedure EmailFileWithSubjectAndReportUsage(AttachmentStream: InStream; AttachmentName: Text; var HtmlBody: Codeunit "Temp Blob"; EmailSubject: Text[250]; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer): Boolean    var        TempEmailItem: Record "Email Item" temporary;    begin        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            EmailSubject,            ToEmailAddress,            PostedDocNo,            EmailDocName,            HideDialog,            ReportUsage,            false,            '',            Enum::"Email Scenario"::Default,            false));    end;#if not CLEAN27    [Obsolete('Use procedure EmailFileWithSubjectAndReportUsage that accepts a "Temp Blob" for the html body instead.', '27.0')]    procedure EmailFileWithSubjectAndReportUsage(AttachmentStream: InStream; AttachmentName: Text; HtmlBodyFilePath: Text[250]; EmailSubject: Text[250]; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceReference: RecordRef): Boolean    var        FileManagement: Codeunit "File Management";        HtmlBody: Codeunit "Temp Blob";    begin        if HtmlBodyFilePath <> '' then            FileManagement.BLOBImportFromServerFile(HtmlBody, HtmlBodyFilePath);        exit(EmailFileWithSubjectAndReportUsage(AttachmentStream, AttachmentName, HtmlBody, EmailSubject, PostedDocNo, ToEmailAddress, EmailDocName, HideDialog, ReportUsage, SourceReference));    end;#endif    procedure EmailFileWithSubjectAndReportUsage(AttachmentStream: InStream; AttachmentName: Text; var HtmlBody: Codeunit "Temp Blob"; EmailSubject: Text[250]; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceReference: RecordRef): Boolean    var        TempEmailItem: Record "Email Item" temporary;    begin        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        repeat            TempEmailItem.AddSourceDocument(SourceReference.Number(), SourceReference.Field(SourceReference.SystemIdNo()).Value());        until SourceReference.Next() = 0;        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            EmailSubject,            ToEmailAddress,            PostedDocNo,            EmailDocName,            HideDialog,            ReportUsage,            false,            '',            Enum::"Email Scenario"::Default,            false));    end;#if not CLEAN27    [Obsolete('Use procedure EmailFileWithSubjectAndReportUsage that accepts a "Temp Blob" for the html body instead.', '27.0')]    procedure EmailFileWithSubjectAndReportUsage(AttachmentStream: InStream; AttachmentName: Text; HtmlBodyFilePath: Text[250]; EmailSubject: Text[250]; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceTables: List of [Integer]; SourceIDs: List of [Guid]; SourceRelationTypes: List of [Integer]): Boolean    var        FileManagement: Codeunit "File Management";        HtmlBody: Codeunit "Temp Blob";    begin        if HtmlBodyFilePath <> '' then            FileManagement.BLOBImportFromServerFile(HtmlBody, HtmlBodyFilePath);        exit(EmailFileWithSubjectAndReportUsage(AttachmentStream, AttachmentName, HtmlBody, EmailSubject, PostedDocNo, ToEmailAddress, EmailDocName, HideDialog, ReportUsage, SourceTables, SourceIDs, SourceRelationTypes));    end;#endif    procedure EmailFileWithSubjectAndReportUsage(AttachmentStream: InStream; AttachmentName: Text; var HtmlBody: Codeunit "Temp Blob"; EmailSubject: Text[250]; PostedDocNo: Code[20]; ToEmailAddress: Text[250]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; SourceTables: List of [Integer]; SourceIDs: List of [Guid]; SourceRelationTypes: List of [Integer]): Boolean    var        TempEmailItem: Record "Email Item" temporary;    begin        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        TempEmailItem.SetSourceDocuments(SourceTables, SourceIDs, SourceRelationTypes);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            EmailSubject,            ToEmailAddress,            PostedDocNo,            EmailDocName,            HideDialog,            ReportUsage,            false,            '',            Enum::"Email Scenario"::Default,            false));    end;    procedure GetToAddressFromCustomer(BillToCustomerNo: Code[20]): Text[250]    var        Customer: Record Customer;        ToAddress: Text[250];        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeGetToAddressFromCustomer(BillToCustomerNo, ToAddress, IsHandled);        if IsHandled then            exit(ToAddress);        if Customer.Get(BillToCustomerNo) then            ToAddress := Customer."E-Mail";        exit(ToAddress);    end;    procedure GetToAddressFromVendor(BuyFromVendorNo: Code[20]): Text[250]    var        Vendor: Record Vendor;        ToAddress: Text[250];        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeGetToAddressFromVendor(BuyFromVendorNo, ToAddress, IsHandled);        if IsHandled then            exit(ToAddress);        if Vendor.Get(BuyFromVendorNo) then            ToAddress := Vendor."E-Mail";        exit(ToAddress);    end;    procedure GetAttachmentFileName(var AttachmentFileName: Text[250]; PostedDocNo: Code[20]; EmailDocumentName: Text[250]; ReportUsage: Integer)    begin        OnBeforeGetAttachmentFileName(AttachmentFileName, PostedDocNo, EmailDocumentName, ReportUsage);        if AttachmentFileName = '' then            if PostedDocNo = '' then begin                if IsPurchaseReportUsage(ReportUsage) then                    AttachmentFileName := StrSubstNo(PdfFileNamePluralPurchaseTxt, EmailDocumentName)                else                    if IsSalesReportUsage(ReportUsage) then                        AttachmentFileName := StrSubstNo(PdfFileNamePluralSalesTxt, EmailDocumentName)                    else                        AttachmentFileName := StrSubstNo(PdfFileNamePluralTxt, EmailDocumentName);            end else                AttachmentFileName := StrSubstNo(ReportAsPdfFileNameMsg, EmailDocumentName, PostedDocNo);        OnAfterGetAttachmentFileName(AttachmentFileName, PostedDocNo, EmailDocumentName, ReportUsage);    end;    local procedure IsPurchaseReportUsage(ReportUsage: Integer): Boolean    var        ReportSelectionUsage: Enum "Report Selection Usage";    begin        case ReportUsage of            ReportSelectionUsage::"P.Quote".AsInteger(),            ReportSelectionUsage::"P.Blanket".AsInteger(),            ReportSelectionUsage::"P.Order".AsInteger(),            ReportSelectionUsage::"P.Invoice".AsInteger(),            ReportSelectionUsage::"P.Self Billing Invoice".AsInteger(),            ReportSelectionUsage::"P.Return".AsInteger(),            ReportSelectionUsage::"P.Cr.Memo".AsInteger(),            ReportSelectionUsage::"P.Receipt".AsInteger(),            ReportSelectionUsage::"P.Ret.Shpt.".AsInteger(),            ReportSelectionUsage::"P.Test".AsInteger(),            ReportSelectionUsage::"P.Test Prepmt.".AsInteger(),            ReportSelectionUsage::"P.Arch.Quote".AsInteger(),            ReportSelectionUsage::"P.Arch.Order".AsInteger(),            ReportSelectionUsage::"P.Arch.Return".AsInteger(),            ReportSelectionUsage::"P.Arch.Blanket".AsInteger(),            ReportSelectionUsage::"V.Remittance".AsInteger(),            ReportSelectionUsage::"P.V.Remit.".AsInteger():                exit(true);        end;        exit(false);    end;    local procedure IsSalesReportUsage(ReportUsage: Integer): Boolean    var        ReportSelectionUsage: Enum "Report Selection Usage";    begin        case ReportUsage of            ReportSelectionUsage::"S.Quote".AsInteger(),            ReportSelectionUsage::"S.Blanket".AsInteger(),            ReportSelectionUsage::"S.Order".AsInteger(),            ReportSelectionUsage::"S.Work Order".AsInteger(),            ReportSelectionUsage::"S.Order Pick Instruction".AsInteger(),            ReportSelectionUsage::"S.Invoice".AsInteger(),            ReportSelectionUsage::"S.Invoice Draft".AsInteger(),            ReportSelectionUsage::"S.Return".AsInteger(),            ReportSelectionUsage::"S.Cr.Memo".AsInteger(),            ReportSelectionUsage::"S.Shipment".AsInteger(),            ReportSelectionUsage::"S.Ret.Rcpt.".AsInteger(),            ReportSelectionUsage::"S.Test".AsInteger(),            ReportSelectionUsage::"S.Test Prepmt.".AsInteger(),            ReportSelectionUsage::"S.Arch.Quote".AsInteger(),            ReportSelectionUsage::"S.Arch.Order".AsInteger(),            ReportSelectionUsage::"S.Arch.Return".AsInteger(),            ReportSelectionUsage::"C.Statement".AsInteger(),            ReportSelectionUsage::"Pro Forma S. Invoice".AsInteger(),            ReportSelectionUsage::"S.Arch.Blanket".AsInteger():                exit(true);        end;        exit(false);    end;    procedure GetEmailBody(PostedDocNo: Code[20]; ReportUsage: Integer; CustomerNo: Code[20]): Text    var        EmailParameter: Record "Email Parameter";        Customer: Record Customer;        String: DotNet String;    begin        if Customer.Get(CustomerNo) then;        if EmailParameter.GetParameterWithReportUsage(            PostedDocNo, Enum::"Report Selection Usage".FromInteger(ReportUsage), EmailParameter."Parameter Type"::Body)        then begin            String := EmailParameter.GetParameterValue();            exit(String.Replace(CustomerLbl, Customer.Name));        end;    end;    procedure ReplaceCustomerNameWithPlaceholder(CustomerNo: Code[20]; BodyText: Text): Text    var        Customer: Record Customer;        BodyTextString: DotNet String;    begin        BodyTextString := BodyText;        if not Customer.Get(CustomerNo) then            exit(BodyText);        exit(BodyTextString.Replace(Customer.Name, CustomerLbl));    end;    procedure GetEmailSubject(PostedDocNo: Code[20]; EmailDocumentName: Text[250]; ReportUsage: Integer) Subject: Text[250]    var        EmailParameter: Record "Email Parameter";        CompanyInformation: Record "Company Information";        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeGetEmailSubject(PostedDocNo, EmailDocumentName, ReportUsage, Subject, IsHandled);        if IsHandled then            exit(Subject);        if EmailParameter.GetParameterWithReportUsage(PostedDocNo, "Report Selection Usage".FromInteger(ReportUsage), EmailParameter."Parameter Type"::Subject) then            exit(CopyStr(EmailParameter.GetParameterValue(), 1, 250));        CompanyInformation.Get();        if PostedDocNo = '' then            Subject := CopyStr(                StrSubstNo(EmailSubjectPluralCapTxt, CompanyInformation.Name, EmailDocumentName), 1, MaxStrLen(Subject))        else            Subject := CopyStr(                StrSubstNo(EmailSubjectCapTxt, CompanyInformation.Name, EmailDocumentName, PostedDocNo), 1, MaxStrLen(Subject));        OnAfterGetEmailSubject(PostedDocNo, EmailDocumentName, ReportUsage, Subject);    end;    // Email Item needs to be passed by var so the attachments are available    local procedure EmailFileInternal(var TempEmailItem: Record "Email Item" temporary; var HtmlBody: Codeunit "Temp Blob"; EmailSubject: Text[250]; ToEmailAddress: Text[250]; PostedDocNo: Code[20]; EmailDocName: Text[250]; HideDialog: Boolean; ReportUsage: Integer; IsFromPostedDoc: Boolean; SenderUserID: Code[50]; EmailScenario: Enum "Email Scenario"; Enqueue: Boolean): Boolean    var        OfficeMgt: Codeunit "Office Management";        EmailScenarioMapping: Codeunit "Email Scenario Mapping";        Attachments: Codeunit "Temp Blob List";        Attachment: Codeunit "Temp Blob";#if not CLEAN27        FileManagement: Codeunit "File Management";#endif        EmailSentSuccesfully: Boolean;        IsHandled: Boolean;        AttachmentStream: Instream;        AttachmentNames: List of [Text];#if not CLEAN27        HtmlBodyFilePath: Text[250];#endif        Name: Text[250];    begin        IsHandled := false;#if not CLEAN27        if HtmlBody.HasValue() then            HtmlBodyFilePath := FileManagement.TempBlobToServerFile(HtmlBody, 'html');        OnBeforeEmailFileInternal(TempEmailItem, HtmlBodyFilePath, EmailSubject, ToEmailAddress, PostedDocNo, EmailDocName, HideDialog, ReportUsage, IsFromPostedDoc, SenderUserID, EmailScenario, EmailSentSuccesfully, IsHandled);        if IsHandled then            exit(EmailSentSuccesfully);        if HtmlBodyFilePath <> '' then begin            Clear(HtmlBody);            FileManagement.BLOBImportFromServerFile(HtmlBody, HtmlBodyFilePath);            FileManagement.DeleteServerFile(HtmlBodyFilePath);        end;#endif        OnBeforeEmailItemPreparation(TempEmailItem, HtmlBody, EmailSubject, ToEmailAddress, PostedDocNo, EmailDocName, HideDialog, ReportUsage, IsFromPostedDoc, SenderUserID, EmailScenario, EmailSentSuccesfully, IsHandled);        if IsHandled then            exit(EmailSentSuccesfully);        TempEmailItem."Send to" := ToEmailAddress;        TempEmailItem.GetAttachments(Attachments, AttachmentNames);        // If true, that means we came from "EmailFile" call and need to get data from the document        if IsFromPostedDoc then begin            if Attachments.Count() > 0 then begin                Name := CopyStr(AttachmentNames.Get(1), 1, 250);                GetAttachmentFileName(Name, PostedDocNo, EmailDocName, ReportUsage);                if Name <> AttachmentNames.Get(1) then                    AttachmentNames.Set(1, Name);            end;            EmailSubject := GetEmailSubject(PostedDocNo, EmailDocName, ReportUsage);            if IsSalesDocumentReportUsage(ReportUsage) then                TempEmailItem.AttachIncomingDocuments(PostedDocNo);        end;        TempEmailItem.Subject := EmailSubject;        if HtmlBody.HasValue() then begin            TempEmailItem.SetBody(HtmlBody);            TempEmailItem.Validate("Message Type", TempEmailItem."Message Type"::"From Email Body Template");        end;        IsHandled := false;        OnBeforeSendEmail(TempEmailItem, IsFromPostedDoc, PostedDocNo, HideDialog, ReportUsage, EmailSentSuccesfully, IsHandled, EmailDocName, SenderUserID, EmailScenario);        if IsHandled then begin            OnAfterEmailSent(TempEmailItem, PostedDocNo, ReportUsage, EmailSentSuccesfully);            exit(EmailSentSuccesfully);        end;        if OfficeMgt.AttachAvailable() and (Attachments.Count() > 0) then begin            Attachments.Get(1, Attachment);            Attachment.CreateInStream(AttachmentStream);            OfficeMgt.AttachDocument(AttachmentStream, AttachmentNames.Get(1), TempEmailItem.GetBodyText(), TempEmailItem.Subject);        end else            if OfficeMgt.AttachAvailable() then                OfficeMgt.AttachDocument(TempEmailItem.GetBodyText(), TempEmailItem.Subject);        if not OfficeMgt.AttachAvailable() then begin            if Enum::"Report Selection Usage".Ordinals().Contains(ReportUsage) then                EmailScenario := EmailScenarioMapping.FromReportSelectionUsage(Enum::"Report Selection Usage".FromInteger(ReportUsage));            EmailSentSuccesfully := TempEmailItem.Send(HideDialog, EmailScenario, Enqueue);            if EmailSentSuccesfully then                OnAfterEmailSentSuccesfully(TempEmailItem, PostedDocNo, ReportUsage);            OnAfterEmailSent(TempEmailItem, PostedDocNo, ReportUsage, EmailSentSuccesfully);            exit(EmailSentSuccesfully);        end;    end;    local procedure IsSalesDocumentReportUsage(ReportUsage: Integer): Boolean    var        ReportSelectionUsage: Enum "Report Selection Usage";    begin        if not Enum::"Report Selection Usage".Ordinals().Contains(ReportUsage) then            exit(false);        ReportSelectionUsage := Enum::"Report Selection Usage".FromInteger(ReportUsage);        exit(ReportSelectionUsage in [            ReportSelectionUsage::"S.Quote",            ReportSelectionUsage::"S.Order",            ReportSelectionUsage::"S.Invoice",            ReportSelectionUsage::"S.Cr.Memo",            ReportSelectionUsage::"S.Blanket",            ReportSelectionUsage::"S.Return",            ReportSelectionUsage::"S.Shipment",            ReportSelectionUsage::"S.Ret.Rcpt."]);    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeSendEmail(var TempEmailItem: Record "Email Item" temporary; var IsFromPostedDoc: Boolean; var PostedDocNo: Code[20]; var HideDialog: Boolean; var ReportUsage: Integer; var EmailSentSuccesfully: Boolean; var IsHandled: Boolean; EmailDocName: Text[250]; SenderUserID: Code[50]; EmailScenario: Enum "Email Scenario")    begin    end;    procedure EmailFileFromStream(AttachmentStream: InStream; AttachmentName: Text; Body: Text; Subject: Text; MailTo: Text; HideDialog: Boolean; ReportUsage: Integer): Boolean    var        TempEmailItem: Record "Email Item" temporary;        HtmlBody: Codeunit "Temp Blob";    begin        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        TempEmailItem.Validate("Plaintext Formatted", true);        TempEmailItem.SetBodyText(Body);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            CopyStr(Subject, 1, MaxStrLen(TempEmailItem.Subject)),            CopyStr(MailTo, 1, MaxStrLen(TempEmailItem."Send to")),            '',            '',            HideDialog,            ReportUsage,            false,            '',            Enum::"Email Scenario"::Default,            false));    end;    procedure EmailHtmlFromStream(MailInStream: InStream; ToEmailAddress: Text[250]; Subject: Text; HideDialog: Boolean; ReportUsage: Integer): Boolean    var        TempEmailItem: Record "Email Item" temporary;        HtmlBody: Codeunit "Temp Blob";        BodyOutStream: OutStream;    begin        HtmlBody.CreateOutStream(BodyOutStream, TextEncoding::UTF8);        CopyStream(BodyOutStream, MailInStream);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            CopyStr(Subject, 1, MaxStrLen(TempEmailItem.Subject)),            CopyStr(ToEmailAddress, 1, MaxStrLen(TempEmailItem."Send to")),            '',            '',            HideDialog,            ReportUsage,            false,            '',            Enum::"Email Scenario"::Default,            false));    end;    procedure EmailFileAndHtmlFromStream(AttachmentStream: InStream; AttachmentName: Text; MailInStream: InStream; ToEmailAddress: Text[250]; Subject: Text; HideDialog: Boolean; ReportUsage: Integer): Boolean    begin        EmailFileAndHtmlFromStream(AttachmentStream, AttachmentName, MailInStream, ToEmailAddress, Subject, HideDialog, ReportUsage, '', false);    end;    procedure EmailFileAndHtmlFromStream(AttachmentStream: InStream; AttachmentName: Text; MailInStream: InStream; ToEmailAddress: Text[250]; Subject: Text; HideDialog: Boolean; ReportUsage: Integer; PostedDocNo: Code[20]; IsFromPostedDoc: Boolean): Boolean    var        TempEmailItem: Record "Email Item" temporary;        HtmlBody: Codeunit "Temp Blob";        BodyOutStream: OutStream;    begin        TempEmailItem.AddAttachment(AttachmentStream, AttachmentName);        HtmlBody.CreateOutStream(BodyOutStream, TextEncoding::UTF8);        CopyStream(BodyOutStream, MailInStream);        exit(EmailFileInternal(            TempEmailItem,            HtmlBody,            CopyStr(Subject, 1, MaxStrLen(TempEmailItem.Subject)),            CopyStr(ToEmailAddress, 1, MaxStrLen(TempEmailItem."Send to")),            PostedDocNo,            '',            HideDialog,            ReportUsage,            IsFromPostedDoc,            '',            Enum::"Email Scenario"::Default,            false));    end;    [IntegrationEvent(false, false)]    local procedure OnAfterEmailSentSuccesfully(var TempEmailItem: Record "Email Item" temporary; PostedDocNo: Code[20]; ReportUsage: Integer)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnAfterEmailSent(var TempEmailItem: Record "Email Item" temporary; PostedDocNo: Code[20]; ReportUsage: Integer; EmailSentSuccesfully: Boolean)    begin    end;#if not CLEAN27    [Obsolete('Use new Event OnBeforeEmailItemPreparation instead.', '27.0')]    [IntegrationEvent(false, false)]    local procedure OnBeforeEmailFileInternal(var TempEmailItem: Record "Email Item" temporary; var HtmlBodyFilePath: Text[250]; var EmailSubject: Text[250]; var ToEmailAddress: Text[250]; var PostedDocNo: Code[20]; var EmailDocName: Text[250]; var HideDialog: Boolean; var ReportUsage: Integer; var IsFromPostedDoc: Boolean; var SenderUserID: Code[50]; var EmailScenario: Enum "Email Scenario"; var EmailSentSuccessfully: Boolean; var IsHandled: Boolean)    begin    end;#endif    [IntegrationEvent(false, false)]    local procedure OnBeforeEmailItemPreparation(var TempEmailItem: Record "Email Item" temporary; var HtmlBody: Codeunit "Temp Blob"; var EmailSubject: Text[250]; var ToEmailAddress: Text[250]; var PostedDocNo: Code[20]; var EmailDocName: Text[250]; var HideDialog: Boolean; var ReportUsage: Integer; var IsFromPostedDoc: Boolean; var SenderUserID: Code[50]; var EmailScenario: Enum "Email Scenario"; var EmailSentSuccessfully: Boolean; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeEmailFile(var HideDialog: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeGetAttachmentFileName(var AttachmentFileName: Text[250]; PostedDocNo: Code[20]; EmailDocumentName: Text[250]; ReportUsage: Integer)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeGetEmailSubject(PostedDocNo: Code[20]; EmailDocumentName: Text[250]; ReportUsage: Integer; var EmailSubject: Text[250]; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeGetToAddressFromCustomer(BillToCustomerNo: Code[20]; var ToAddress: Text[250]; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeGetToAddressFromVendor(BuyFromVendorNo: Code[20]; var ToAddress: Text[250]; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnAfterGetEmailSubject(PostedDocNo: Code[20]; EmailDocumentName: Text[250]; ReportUsage: Integer; var EmailSubject: Text[250])    begin    end;    [IntegrationEvent(false, false)]    local procedure OnAfterGetAttachmentFileName(var AttachmentFileName: Text[250]; PostedDocNo: Code[20]; EmailDocumentName: Text[250]; ReportUsage: Integer)    begin    end;}