Codeunit 89 Sales-Post + Email

Base Application, Microsoft.Sales.Posting

src/Layers/W1/BaseApp/Sales/Posting/SalesPostEmail.Codeunit.al170 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 Microsoft.Sales.Posting;using Microsoft.Sales.Document;using Microsoft.Sales.History;using System.Utilities;/// <summary>/// Posts a sales document and sends the posted document to the customer via email./// </summary>codeunit 89 "Sales-Post + Email"{    TableNo = "Sales Header";    trigger OnRun()    begin        SalesHeader.Copy(Rec);        Code();        Rec := SalesHeader;    end;    var        SalesHeader: Record "Sales Header";        SalesInvHeader: Record "Sales Invoice Header";        SalesCrMemoHeader: Record "Sales Cr.Memo Header";        HideMailDialog: Boolean;#pragma warning disable AA0470        PostAndSaveInvoiceQst: Label 'Do you want to post and save the %1?';        NotSupportedDocumentTypeSavingErr: Label 'The %1 is not posted because saving document of type %1 is not supported.';#pragma warning restore AA0470    local procedure "Code"()    var        HideDialog: Boolean;        IsHandled: Boolean;    begin        HideDialog := false;        IsHandled := false;        OnBeforePostAndEMail(SalesHeader, HideDialog, IsHandled, HideMailDialog);        if IsHandled then            exit;        if not HideDialog then            case SalesHeader."Document Type" of                SalesHeader."Document Type"::Invoice,                  SalesHeader."Document Type"::"Credit Memo":                    if not ConfirmPostAndDistribute(SalesHeader) then                        exit;                else                    ErrorPostAndDistribute(SalesHeader);            end;        OnAfterConfirmPost(SalesHeader);        CODEUNIT.Run(CODEUNIT::"Sales-Post", SalesHeader);        OnAfterPostAndBeforeSend(SalesHeader);        Commit();        SendDocumentReport(SalesHeader);        OnAfterPostAndSend(SalesHeader);    end;    local procedure SendDocumentReport(var SalesHeader: Record "Sales Header")    begin        case SalesHeader."Document Type" of            SalesHeader."Document Type"::Invoice:                begin                    OnSendDocumentReportOnBeforeSendInvoice(SalesInvHeader);                    if SalesHeader."Last Posting No." = '' then                        SalesInvHeader."No." := SalesHeader."No."                    else                        SalesInvHeader."No." := SalesHeader."Last Posting No.";                    SalesInvHeader.Find();                    SalesInvHeader.SetRecFilter();                    SalesInvHeader.EmailRecords(not HideMailDialog);                end;            SalesHeader."Document Type"::"Credit Memo":                begin                    if SalesHeader."Last Posting No." = '' then                        SalesCrMemoHeader."No." := SalesHeader."No."                    else                        SalesCrMemoHeader."No." := SalesHeader."Last Posting No.";                    SalesCrMemoHeader.Find();                    SalesCrMemoHeader.SetRecFilter();                    SalesCrMemoHeader.EmailRecords(not HideMailDialog);                end        end    end;    /// <summary>    /// Initializes the codeunit with settings that control whether the email dialog is displayed.    /// </summary>    /// <param name="NewHideMailDialog">Specifies whether to hide the email dialog when sending the posted document.</param>    procedure InitializeFrom(NewHideMailDialog: Boolean)    begin        HideMailDialog := NewHideMailDialog;    end;    local procedure ConfirmPostAndDistribute(var SalesHeader: Record "Sales Header"): Boolean    var        ConfirmManagement: Codeunit "Confirm Management";    begin        exit(          ConfirmManagement.GetResponseOrDefault(            StrSubstNo(PostAndSaveInvoiceQst, SalesHeader."Document Type"), true));    end;    local procedure ErrorPostAndDistribute(var SalesHeader: Record "Sales Header")    var        NotSupportedDocumentType: Text;    begin        NotSupportedDocumentType := NotSupportedDocumentTypeSavingErr;        Error(NotSupportedDocumentType, SalesHeader."Document Type");    end;    /// <summary>    /// Raised after the user confirms posting the sales document.    /// </summary>    /// <param name="SalesHeader">The sales header that was confirmed for posting.</param>    [IntegrationEvent(false, false)]    local procedure OnAfterConfirmPost(SalesHeader: Record "Sales Header")    begin    end;    /// <summary>    /// Raised after the document has been posted and the email has been sent.    /// </summary>    /// <param name="SalesHeader">The sales header that was posted and sent.</param>    [IntegrationEvent(false, false)]    local procedure OnAfterPostAndSend(var SalesHeader: Record "Sales Header")    begin    end;    /// <summary>    /// Raised after the document has been posted but before the email is sent.    /// </summary>    /// <param name="SalesHeader">The sales header that was posted.</param>    [IntegrationEvent(false, false)]    local procedure OnAfterPostAndBeforeSend(var SalesHeader: Record "Sales Header")    begin    end;    /// <summary>    /// Raised before posting and emailing the sales document.    /// </summary>    /// <param name="SalesHeader">The sales header to be posted and emailed.</param>    /// <param name="HideDialog">Set to true to hide the confirmation dialog.</param>    /// <param name="IsHandled">Set to true to skip the default posting logic.</param>    /// <param name="HideMailDialog">Set to true to hide the email dialog.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforePostAndEMail(var SalesHeader: Record "Sales Header"; var HideDialog: Boolean; var IsHandled: Boolean; var HideMailDialog: Boolean)    begin    end;    /// <summary>    /// Raised before sending the posted invoice via email.    /// </summary>    /// <param name="SalesInvoiceHeader">The posted sales invoice header to be emailed.</param>    [IntegrationEvent(false, false)]    local procedure OnSendDocumentReportOnBeforeSendInvoice(var SalesInvoiceHeader: Record "Sales Invoice Header")    begin    end;}