Codeunit 81 Sales-Post (Yes/No)

Base Application, Microsoft.Sales.Posting

src/Layers/W1/BaseApp/Sales/Posting/SalesPostYesNo.Codeunit.al264 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.Finance.GeneralLedger.Preview;using Microsoft.Finance.ReceivablesPayables;using Microsoft.Sales.Document;using Microsoft.Sales.Setup;using Microsoft.Utilities;/// <summary>/// Prompts the user for confirmation and posting options before posting a sales document./// </summary>codeunit 81 "Sales-Post (Yes/No)"{    EventSubscriberInstance = Manual;    TableNo = "Sales Header";    trigger OnRun()    var        SalesHeader: Record "Sales Header";    begin        OnBeforeOnRun(Rec);        if not Rec.Find() then            Error(DocumentErrorsMgt.GetNothingToPostErrorMsg());        SalesHeader.Copy(Rec);        Code(SalesHeader, false);        Rec := SalesHeader;    end;    var        DocumentErrorsMgt: Codeunit "Document Errors Mgt.";    /// <summary>    /// Posts the sales document and sends it to the customer using the configured document sending profile.    /// </summary>    /// <param name="SalesHeader">Specifies the sales header of the document to post and send.</param>    procedure PostAndSend(var SalesHeader: Record "Sales Header")    var        SalesHeaderToPost: Record "Sales Header";    begin        SalesHeaderToPost.Copy(SalesHeader);        Code(SalesHeaderToPost, true);        SalesHeader := SalesHeaderToPost;    end;    local procedure "Code"(var SalesHeader: Record "Sales Header"; PostAndSend: Boolean)    var        SalesSetup: Record "Sales & Receivables Setup";        SalesPostViaJobQueue: Codeunit "Sales Post via Job Queue";        HideDialog: Boolean;        IsHandled: Boolean;        DefaultOption: Integer;    begin        HideDialog := false;        IsHandled := false;        DefaultOption := 3;        OnBeforeConfirmSalesPost(SalesHeader, HideDialog, IsHandled, DefaultOption, PostAndSend);        if IsHandled then            exit;        if not HideDialog then            if not ConfirmPost(SalesHeader, DefaultOption) then                exit;        IsHandled := false;        OnAfterConfirmPost(SalesHeader, IsHandled);        if IsHandled then            exit;        SalesSetup.Get();        if SalesSetup."Post with Job Queue" and not PostAndSend then            SalesPostViaJobQueue.EnqueueSalesDoc(SalesHeader)        else            RunSalesPost(SalesHeader);        OnAfterPost(SalesHeader, PostAndSend);    end;    local procedure RunSalesPost(var SalesHeader: Record "Sales Header")    var        SalesPost: Codeunit "Sales-Post";        IsHandled: Boolean;        SuppressCommit: Boolean;    begin        IsHandled := false;        OnBeforeRunSalesPost(SalesHeader, IsHandled, SuppressCommit);        if IsHandled then            exit;        SalesPost.SetSuppressCommit(SuppressCommit);        SalesPost.Run(SalesHeader);    end;    local procedure ConfirmPost(var SalesHeader: Record "Sales Header"; DefaultOption: Integer) Result: Boolean    var        PostingSelectionManagement: Codeunit "Posting Selection Management";        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeConfirmPost(SalesHeader, DefaultOption, Result, IsHandled);        if IsHandled then            exit(Result);        OnConfirmPostOnBeforeSetSelection(SalesHeader);        Result := PostingSelectionManagement.ConfirmPostSalesDocument(SalesHeader, DefaultOption, false, false);        if not Result then            exit(false);        SalesHeader."Print Posted Documents" := false;        exit(true);    end;    /// <summary>    /// Previews the posting of the sales document without actually posting it, showing the expected ledger entries.    /// </summary>    /// <param name="SalesHeader">Specifies the sales header of the document to preview.</param>    procedure Preview(var SalesHeader: Record "Sales Header")    var        SalesPostYesNo: Codeunit "Sales-Post (Yes/No)";        GenJnlPostPreview: Codeunit "Gen. Jnl.-Post Preview";    begin        BindSubscription(SalesPostYesNo);        GenJnlPostPreview.Preview(SalesPostYesNo, SalesHeader);    end;    /// <summary>    /// Displays a message if previewing multiple sales documents and indicates which document is being previewed.    /// </summary>    /// <param name="SalesHeaderToPreview">Specifies the sales header records being previewed.</param>    /// <param name="DocumentNo">Specifies the document number of the current document being previewed.</param>    procedure MessageIfPostingPreviewMultipleDocuments(var SalesHeaderToPreview: Record "Sales Header"; DocumentNo: Code[20])    var        GenJnlPostPreview: Codeunit "Gen. Jnl.-Post Preview";        RecordRefToPreview: RecordRef;    begin        RecordRefToPreview.Open(Database::"Sales Header");        RecordRefToPreview.Copy(SalesHeaderToPreview);        GenJnlPostPreview.MessageIfPostingPreviewMultipleDocuments(RecordRefToPreview, DocumentNo);    end;    /// <summary>    /// Raised after the sales document has been posted.    /// </summary>    /// <param name="SalesHeader">The sales header that was posted.</param>    /// <param name="PostAndSend">Indicates whether the document was posted using Post and Send functionality.</param>    [IntegrationEvent(false, false)]    local procedure OnAfterPost(var SalesHeader: Record "Sales Header"; PostAndSend: Boolean)    begin    end;    /// <summary>    /// Raised after the user confirms posting the sales document.    /// </summary>    /// <param name="SalesHeader">The sales header being posted.</param>    /// <param name="IsHandled">Set to true to skip the default posting logic.</param>    [IntegrationEvent(false, false)]    local procedure OnAfterConfirmPost(var SalesHeader: Record "Sales Header"; var IsHandled: Boolean)    begin    end;    [EventSubscriber(ObjectType::Codeunit, Codeunit::"Gen. Jnl.-Post Preview", 'OnRunPreview', '', false, false)]    local procedure OnRunPreview(var Result: Boolean; Subscriber: Variant; RecVar: Variant)    var        SalesHeader: Record "Sales Header";        SalesPost: Codeunit "Sales-Post";        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeRunPreview(Result, RecVar, IsHandled);        if IsHandled then            exit;        SalesHeader.Copy(RecVar);        SalesHeader.Receive := SalesHeader."Document Type" = SalesHeader."Document Type"::"Return Order";        SalesHeader.Ship := SalesHeader."Document Type" in [SalesHeader."Document Type"::Order, SalesHeader."Document Type"::Invoice, SalesHeader."Document Type"::"Credit Memo"];        SalesHeader.Invoice := true;        OnRunPreviewOnAfterSetPostingFlags(SalesHeader);        SalesPost.SetPreviewMode(true);        Result := SalesPost.Run(SalesHeader);    end;    /// <summary>    /// Raised after the posting flags (Ship, Receive, Invoice) are set during posting preview.    /// </summary>    /// <param name="SalesHeader">The sales header being previewed.</param>    [IntegrationEvent(false, false)]    local procedure OnRunPreviewOnAfterSetPostingFlags(var SalesHeader: Record "Sales Header")    begin    end;    /// <summary>    /// Raised before displaying the posting confirmation dialog.    /// </summary>    /// <param name="SalesHeader">The sales header being posted.</param>    /// <param name="DefaultOption">The default posting option to select in the dialog.</param>    /// <param name="Result">Set to the result of the confirmation dialog.</param>    /// <param name="IsHandled">Set to true to skip the default confirmation dialog.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeConfirmPost(var SalesHeader: Record "Sales Header"; var DefaultOption: Integer; var Result: Boolean; var IsHandled: Boolean)    begin    end;    /// <summary>    /// Raised before confirming and posting the sales document.    /// </summary>    /// <param name="SalesHeader">The sales header being posted.</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="DefaultOption">The default posting option to select in the dialog.</param>    /// <param name="PostAndSend">Indicates whether to also send the document after posting.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeConfirmSalesPost(var SalesHeader: Record "Sales Header"; var HideDialog: Boolean; var IsHandled: Boolean; var DefaultOption: Integer; var PostAndSend: Boolean)    begin    end;    /// <summary>    /// Raised before the OnRun trigger executes.    /// </summary>    /// <param name="SalesHeader">The sales header to be posted.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeOnRun(var SalesHeader: Record "Sales Header")    begin    end;    /// <summary>    /// Raised before running the Sales-Post codeunit.    /// </summary>    /// <param name="SalesHeader">The sales header to be posted.</param>    /// <param name="IsHandled">Set to true to skip the default posting logic.</param>    /// <param name="SuppressCommit">Set to true to suppress database commits during posting.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeRunSalesPost(var SalesHeader: Record "Sales Header"; var IsHandled: Boolean; var SuppressCommit: Boolean)    begin    end;    /// <summary>    /// Raised before setting the posting selection options in the confirmation dialog.    /// </summary>    /// <param name="SalesHeader">The sales header being posted.</param>    [IntegrationEvent(false, false)]    local procedure OnConfirmPostOnBeforeSetSelection(var SalesHeader: Record "Sales Header")    begin    end;    /// <summary>    /// Raised before running the posting preview.    /// </summary>    /// <param name="Result">Returns the result of the preview operation.</param>    /// <param name="RecVar">The record to preview.</param>    /// <param name="IsHandled">Set to true to skip the default preview logic.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeRunPreview(var Result: Boolean; RecVar: Variant; var IsHandled: Boolean)    begin    end;}