Codeunit 79 Sales-Post and Send

Base Application, Microsoft.Sales.Posting

src/Layers/W1/BaseApp/Sales/Posting/SalesPostandSend.Codeunit.al252 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.CRM.Outlook;using Microsoft.Finance.ReceivablesPayables;using Microsoft.Foundation.Reporting;using Microsoft.Sales.Customer;using Microsoft.Sales.Document;using Microsoft.Utilities;/// <summary>/// Posts a sales document and sends it to the customer using the configured document sending profile./// </summary>codeunit 79 "Sales-Post and Send"{    TableNo = "Sales Header";    trigger OnRun()    begin        if not Rec.Find() then            Error(DocumentErrorsMgt.GetNothingToPostErrorMsg());        SalesHeader.Copy(Rec);        Code();        Rec := SalesHeader;    end;    var        SalesHeader: Record "Sales Header";        DocumentErrorsMgt: Codeunit "Document Errors Mgt.";        NotSupportedDocumentTypeErr: Label 'Document type %1 is not supported.', Comment = '%1=Document Type';    local procedure "Code"()    var        TempDocumentSendingProfile: Record "Document Sending Profile" temporary;        SalesPost: Codeunit "Sales-Post";        SalesPostYesNo: Codeunit "Sales-Post (Yes/No)";        PostingSelectionManagement: Codeunit "Posting Selection Management";        HideDialog: Boolean;        IsHandled: Boolean;    begin        HideDialog := false;        OnBeforePostAndSend(SalesHeader, HideDialog, TempDocumentSendingProfile);        if not HideDialog then            case SalesHeader."Document Type" of                SalesHeader."Document Type"::Invoice,                  SalesHeader."Document Type"::"Credit Memo",                  SalesHeader."Document Type"::Order:                    if not ConfirmPostAndSend(SalesHeader, TempDocumentSendingProfile) then                        exit;                else                    Error(NotSupportedDocumentTypeErr, SalesHeader."Document Type");            end;        OnCodeOnAfterConfirmPostAndSend(SalesHeader);        TempDocumentSendingProfile.CheckElectronicSendingEnabled();        ValidateElectronicFormats(TempDocumentSendingProfile);        IsHandled := false;        OnCodeOnBeforePostSalesHeader(SalesHeader, TempDocumentSendingProfile, HideDialog, IsHandled);        if not IsHandled then            if SalesHeader."Document Type" = SalesHeader."Document Type"::Order then begin                SalesHeader.Ship := false;                SalesHeader.Invoice := false;                SalesPostYesNo.PostAndSend(SalesHeader);                if not (SalesHeader.Ship or SalesHeader.Invoice) then                    exit;            end else begin                if SalesHeader."Document Type" in [SalesHeader."Document Type"::Invoice, SalesHeader."Document Type"::"Credit Memo"] then                    PostingSelectionManagement.CheckUserCanInvoiceSales();                CODEUNIT.Run(CODEUNIT::"Sales-Post", SalesHeader);            end;        OnAfterPostAndBeforeSend(SalesHeader);        Commit();        SalesPost.SendPostedDocumentRecord(SalesHeader, TempDocumentSendingProfile);        OnAfterPostAndSend(SalesHeader);    end;    local procedure ConfirmPostAndSend(SalesHeader: Record "Sales Header"; var TempDocumentSendingProfile: Record "Document Sending Profile" temporary) Result: Boolean    var        Customer: Record Customer;        DocumentSendingProfile: Record "Document Sending Profile";        OfficeMgt: Codeunit "Office Management";        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeConfirmPostAndSend(SalesHeader, TempDocumentSendingProfile, Result, IsHandled);        if IsHandled then            exit(Result);        Customer.Get(SalesHeader."Bill-to Customer No.");        if OfficeMgt.IsAvailable() then            DocumentSendingProfile.GetOfficeAddinDefault(TempDocumentSendingProfile, OfficeMgt.AttachAvailable())        else begin            IsHandled := false;            OnConfirmPostAndSendOnBeforeGetDocumentSendingProfile(SalesHeader, Customer, DocumentSendingProfile, IsHandled);            if not IsHandled then                if not DocumentSendingProfile.Get(Customer."Document Sending Profile") then                    DocumentSendingProfile.GetDefault(DocumentSendingProfile);            Commit();            TempDocumentSendingProfile.Copy(DocumentSendingProfile);            TempDocumentSendingProfile.SetDocumentUsage(SalesHeader);            TempDocumentSendingProfile.Insert();            IsHandled := false;            OnBeforeConfirmAndSend(SalesHeader, TempDocumentSendingProfile, Result, IsHandled);            if IsHandled then                exit(Result);            if PAGE.RunModal(PAGE::"Post and Send Confirmation", TempDocumentSendingProfile) <> ACTION::Yes then                exit(false);        end;        exit(true);    end;    local procedure ValidateElectronicFormats(DocumentSendingProfile: Record "Document Sending Profile")    var        ElectronicDocumentFormat: Record "Electronic Document Format";        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeValidateElectronicFormats(SalesHeader, DocumentSendingProfile, IsHandled);        if IsHandled then            exit;        if (DocumentSendingProfile."E-Mail" <> DocumentSendingProfile."E-Mail"::No) and           (DocumentSendingProfile."E-Mail Attachment" <> DocumentSendingProfile."E-Mail Attachment"::PDF)        then begin            ElectronicDocumentFormat.ValidateElectronicFormat(DocumentSendingProfile."E-Mail Format");            ElectronicDocumentFormat.ValidateElectronicSalesDocument(SalesHeader, DocumentSendingProfile."E-Mail Format");        end;        if (DocumentSendingProfile.Disk <> DocumentSendingProfile.Disk::No) and           (DocumentSendingProfile.Disk <> DocumentSendingProfile.Disk::PDF)        then begin            ElectronicDocumentFormat.ValidateElectronicFormat(DocumentSendingProfile."Disk Format");            ElectronicDocumentFormat.ValidateElectronicSalesDocument(SalesHeader, DocumentSendingProfile."Disk Format");        end;        if DocumentSendingProfile."Electronic Document" <> DocumentSendingProfile."Electronic Document"::No then begin            ElectronicDocumentFormat.ValidateElectronicFormat(DocumentSendingProfile."Electronic Format");            ElectronicDocumentFormat.ValidateElectronicSalesDocument(SalesHeader, DocumentSendingProfile."Electronic Format");        end;    end;    /// <summary>    /// Raised after the document has been posted but before it is sent to the customer.    /// </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 after the document has been posted and sent to the customer.    /// </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 before displaying the send confirmation dialog.    /// </summary>    /// <param name="SalesHeader">The sales header to be posted and sent.</param>    /// <param name="TempDocumentSendingProfile">The document sending profile to use.</param>    /// <param name="Result">Returns the result of the confirmation.</param>    /// <param name="IsHandled">Set to true to skip the default confirmation dialog.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeConfirmAndSend(SalesHeader: Record "Sales Header"; var TempDocumentSendingProfile: Record "Document Sending Profile" temporary; var Result: Boolean; var IsHandled: Boolean)    begin    end;    /// <summary>    /// Raised before confirming the post and send operation.    /// </summary>    /// <param name="SalesHeader">The sales header to be posted and sent.</param>    /// <param name="TempDocumentSendingProfile">The document sending profile to use.</param>    /// <param name="Result">Returns the result of the confirmation.</param>    /// <param name="IsHandled">Set to true to skip the default confirmation logic.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeConfirmPostAndSend(SalesHeader: Record "Sales Header"; var TempDocumentSendingProfile: Record "Document Sending Profile" temporary; var Result: Boolean; var IsHandled: Boolean)    begin    end;    /// <summary>    /// Raised before validating electronic document formats.    /// </summary>    /// <param name="SalesHeader">The sales header being posted.</param>    /// <param name="DocumentSendingProfile">The document sending profile containing format settings.</param>    /// <param name="IsHandled">Set to true to skip the default validation logic.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeValidateElectronicFormats(SalesHeader: Record "Sales Header"; DocumentSendingProfile: Record "Document Sending Profile"; var IsHandled: Boolean)    begin    end;    /// <summary>    /// Raised before posting and sending the sales document.    /// </summary>    /// <param name="SalesHeader">The sales header to be posted and sent.</param>    /// <param name="HideDialog">Set to true to hide the confirmation dialog.</param>    /// <param name="TempDocumentSendingProfile">The document sending profile to use.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforePostAndSend(var SalesHeader: Record "Sales Header"; var HideDialog: Boolean; var TempDocumentSendingProfile: Record "Document Sending Profile" temporary)    begin    end;    /// <summary>    /// Raised after the user confirms the post and send operation.    /// </summary>    /// <param name="SalesHeader">The sales header being posted.</param>    [IntegrationEvent(false, false)]    local procedure OnCodeOnAfterConfirmPostAndSend(var SalesHeader: Record "Sales Header")    begin    end;    /// <summary>    /// Raised before posting the sales header in the post and send process.    /// </summary>    /// <param name="SalesHeader">The sales header to be posted.</param>    /// <param name="TempDocumentSendingProfile">The document sending profile to use.</param>    /// <param name="HideDialog">Indicates whether dialogs are hidden.</param>    /// <param name="IsHandled">Set to true to skip the default posting logic.</param>    [IntegrationEvent(false, false)]    local procedure OnCodeOnBeforePostSalesHeader(var SalesHeader: Record "Sales Header"; var TempDocumentSendingProfile: Record "Document Sending Profile" temporary; HideDialog: Boolean; var IsHandled: Boolean)    begin    end;    /// <summary>    /// Raised before retrieving the document sending profile for the customer.    /// </summary>    /// <param name="SalesHeader">The sales header being processed.</param>    /// <param name="Customer">The customer for whom to get the sending profile.</param>    /// <param name="DocumentSendingProfile">The document sending profile to use.</param>    /// <param name="IsHandled">Set to true to skip the default profile retrieval logic.</param>    [IntegrationEvent(false, false)]    local procedure OnConfirmPostAndSendOnBeforeGetDocumentSendingProfile(SalesHeader: Record "Sales Header"; Customer: Record Customer; var DocumentSendingProfile: Record "Document Sending Profile"; var IsHandled: Boolean)    begin    end;}