Codeunit 170 Standard Codes Mgt.

Base Application, Microsoft.Utilities

src/Layers/W1/BaseApp/Utilities/StandardCodesMgt.Codeunit.al467 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.Utilities;using Microsoft.Purchases.Document;using Microsoft.Sales.Document;using System.Environment.Configuration;codeunit 170 "Standard Codes Mgt."{    trigger OnRun()    begin    end;    var        SkipRecurringLines: Boolean;        GetRecurringLinesTxt: Label 'Get Recurring Lines.';        GetSalesRecurringLinesQst: Label 'Recurring sales lines exist for customer %1. Do you want to insert them on this document?', Comment = '%1 - customer number';        GetPurchRecurringLinesQst: Label 'Recurring purchase lines exist for vendor %1. Do you want to insert them on this document?', Comment = '%1 - vendor number';    procedure CheckCreatePurchRecurringLines(var PurchHeader: Record "Purchase Header"): Boolean    var        StandardVendorPurchaseCode: Record "Standard Vendor Purchase Code";    begin        if not CanCreatePurchRecurringLines(PurchHeader) then            exit;        if not TryFindFirstStandardPurchCodeToAdd(PurchHeader, StandardVendorPurchaseCode) then            exit;        if (StandardVendorPurchaseCode.Count = 1) and           StandardVendorPurchaseCode.IsInsertRecurringLinesOnDocumentAutomatic(PurchHeader)        then            StandardVendorPurchaseCode.ApplyStdCodesToPurchaseLines(PurchHeader, StandardVendorPurchaseCode)        else            ShowGetPurchRecurringLinesNotification(PurchHeader);    end;    procedure CheckCreateSalesRecurringLines(SalesHeader: Record "Sales Header")    var        StandardCustomerSalesCode: Record "Standard Customer Sales Code";    begin        if not CanCreateSalesRecurringLines(SalesHeader) then            exit;        if not TryFindFirstStandardSalesCodeToAdd(SalesHeader, StandardCustomerSalesCode) then            exit;        if (StandardCustomerSalesCode.Count = 1) and           StandardCustomerSalesCode.IsInsertRecurringLinesOnDocumentAutomatic(SalesHeader)        then            StandardCustomerSalesCode.ApplyStdCodesToSalesLines(SalesHeader, StandardCustomerSalesCode)        else            ShowGetSalesRecurringLinesNotification(SalesHeader);    end;    local procedure TryFindFirstStandardPurchCodeToAdd(PurchHeader: Record "Purchase Header"; var StandardVendorPurchaseCode: Record "Standard Vendor Purchase Code"): Boolean;    begin        StandardVendorPurchaseCode.SetFilterByAutomaticAndAlwaysAskCodes(PurchHeader);        exit(StandardVendorPurchaseCode.FindFirst());    end;    local procedure TryFindFirstStandardSalesCodeToAdd(SalesHeader: Record "Sales Header"; var StandardCustomerSalesCode: Record "Standard Customer Sales Code"): Boolean;    begin        StandardCustomerSalesCode.SetFilterByAutomaticAndAlwaysAskCodes(SalesHeader);        exit(StandardCustomerSalesCode.FindFirst());    end;    procedure SetSkipRecurringLines(SkipRecurringLinesNew: Boolean)    begin        SkipRecurringLines := SkipRecurringLinesNew;    end;    procedure CanCreatePurchRecurringLines(var PurchHeader: Record "Purchase Header") Result: Boolean    var        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeCanCreatePurchRecurringLines(PurchHeader, Result, IsHandled);        if IsHandled then            exit(Result);        if SkipRecurringLines then            exit(false);        if PurchHeader.IsTemporary then            exit(false);        if PurchHeader."No." = '' then            exit(false);        if PurchHeader."Buy-from Vendor No." = '' then            exit(false);        if not IsPurchDocumentEmpty(PurchHeader) then            exit(false);        if PurchHeader."Document Type" in           [PurchHeader."Document Type"::"Blanket Order", PurchHeader."Document Type"::"Return Order"]        then            exit(false);        if (PurchHeader."Document Type" = PurchHeader."Document Type"::Order) and (PurchHeader."Quote No." <> '') then            exit(false);        exit(true);    end;    local procedure CanCreateSalesRecurringLines(SalesHeader: Record "Sales Header") Result: Boolean;    var        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeCanCreateSalesRecurringLines(SalesHeader, Result, IsHandled);        if IsHandled then            exit(Result);        if SkipRecurringLines then            exit(false);        if SalesHeader.IsTemporary then            exit(false);        if SalesHeader."No." = '' then            exit(false);        if SalesHeader."Sell-to Customer No." = '' then            exit(false);        if SalesHeader."Document Type" in           [SalesHeader."Document Type"::"Blanket Order", SalesHeader."Document Type"::"Return Order"]        then            exit(false);        if not IsSalesDocumentEmpty(SalesHeader) then            exit(false);        if (SalesHeader."Document Type" = SalesHeader."Document Type"::Order) and (SalesHeader."Quote No." <> '') then            exit(false);        exit(true);    end;    procedure GetSalesRecurringLines(SalesHeader: Record "Sales Header")    var        StandardCustomerSalesCode: Record "Standard Customer Sales Code";    begin        OnBeforeGetSalesRecurringLines(SalesHeader);        StandardCustomerSalesCode.SetFilterByAutomaticAndAlwaysAskCodes(SalesHeader);        StandardCustomerSalesCode.FindFirst();        if (StandardCustomerSalesCode.Count = 1) and           StandardCustomerSalesCode.IsInsertRecurringLinesOnDocumentAutomatic(SalesHeader)        then            StandardCustomerSalesCode.ApplyStdCodesToSalesLines(SalesHeader, StandardCustomerSalesCode)        else            StandardCustomerSalesCode.InsertSalesLines(SalesHeader);    end;    procedure GetPurchRecurringLines(PurchHeader: Record "Purchase Header")    var        StandardVendorPurchaseCode: Record "Standard Vendor Purchase Code";    begin        OnBeforeGetPurchRecurringLines(PurchHeader);        StandardVendorPurchaseCode.SetFilterByAutomaticAndAlwaysAskCodes(PurchHeader);        StandardVendorPurchaseCode.FindFirst();        if (StandardVendorPurchaseCode.Count = 1) and           StandardVendorPurchaseCode.IsInsertRecurringLinesOnDocumentAutomatic(PurchHeader)        then            StandardVendorPurchaseCode.ApplyStdCodesToPurchaseLines(PurchHeader, StandardVendorPurchaseCode)        else            StandardVendorPurchaseCode.InsertPurchLines(PurchHeader);    end;    local procedure IsSalesDocumentEmpty(SalesHeader: Record "Sales Header"): Boolean    var        SalesLine: Record "Sales Line";    begin        SalesLine.SetRange("Document Type", SalesHeader."Document Type");        SalesLine.SetRange("Document No.", SalesHeader."No.");        exit(SalesLine.IsEmpty);    end;    local procedure IsPurchDocumentEmpty(PurchaseHeader: Record "Purchase Header"): Boolean    var        PurchaseLine: Record "Purchase Line";    begin        PurchaseLine.SetRange("Document Type", PurchaseHeader."Document Type");        PurchaseLine.SetRange("Document No.", PurchaseHeader."No.");        exit(PurchaseLine.IsEmpty);    end;    procedure CheckShowSalesRecurringLinesNotification(var SalesHeader: Record "Sales Header")    begin        if CanGetSalesRecurringLines(SalesHeader) then            ShowGetSalesRecurringLinesNotification(SalesHeader);    end;    procedure CheckShowPurchRecurringLinesNotification(var PurchaseHeader: Record "Purchase Header")    begin        if CanGetPurchRecurringLines(PurchaseHeader) then            ShowGetPurchRecurringLinesNotification(PurchaseHeader);    end;    procedure ShowGetSalesRecurringLinesNotification(SalesHeader: Record "Sales Header")    var        NotificationLifecycleMgt: Codeunit "Notification Lifecycle Mgt.";        StandardCodesExistNotification: Notification;        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeShowGetSalesRecurringLinesNotification(SalesHeader, IsHandled);        if IsHandled then            exit;        StandardCodesExistNotification.Id := GetSalesRecurringLinesNotificationId();        StandardCodesExistNotification.Message := StrSubstNo(GetSalesRecurringLinesQst, SalesHeader."Sell-to Customer No.");        StandardCodesExistNotification.AddAction(          GetRecurringLinesTxt, CODEUNIT::"Standard Codes Mgt.", 'GetSalesRecurringLinesFromNotification');        StandardCodesExistNotification.Scope := NOTIFICATIONSCOPE::LocalScope;        StandardCodesExistNotification.SetData(SalesHeader.FieldName("Document Type"), Format(SalesHeader."Document Type"));        StandardCodesExistNotification.SetData(SalesHeader.FieldName("No."), SalesHeader."No.");        NotificationLifecycleMgt.SendNotificationWithAdditionalContext(          StandardCodesExistNotification, SalesHeader.RecordId, GetSalesRecurringLinesNotificationId());    end;    procedure ShowGetPurchRecurringLinesNotification(PurchHeader: Record "Purchase Header")    var        NotificationLifecycleMgt: Codeunit "Notification Lifecycle Mgt.";        StandardCodesExistNotification: Notification;        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeShowGetPurchRecurringLinesNotification(PurchHeader, IsHandled);        if IsHandled then            exit;        StandardCodesExistNotification.Id := GetPurchRecurringLinesNotificationId();        StandardCodesExistNotification.Message := StrSubstNo(GetPurchRecurringLinesQst, PurchHeader."Buy-from Vendor No.");        StandardCodesExistNotification.AddAction(          GetRecurringLinesTxt, CODEUNIT::"Standard Codes Mgt.", 'GetPurchRecurringLinesFromNotification');        StandardCodesExistNotification.Scope := NOTIFICATIONSCOPE::LocalScope;        StandardCodesExistNotification.SetData(PurchHeader.FieldName("Document Type"), Format(PurchHeader."Document Type"));        StandardCodesExistNotification.SetData(PurchHeader.FieldName("No."), PurchHeader."No.");        NotificationLifecycleMgt.SendNotificationWithAdditionalContext(          StandardCodesExistNotification, PurchHeader.RecordId, GetPurchRecurringLinesNotificationId());    end;    procedure GetSalesRecurringLinesNotificationId(): Guid    begin        exit('5FBC61D4-9344-4BA4-A977-5C0E3A8E3BB9');    end;    procedure GetPurchRecurringLinesNotificationId(): Guid    begin        exit('4C35449A-FA4C-4BA2-9982-3F9D08529052');    end;    procedure GetSalesRecurringLinesFromNotification(Notification: Notification)    var        SalesHeader: Record "Sales Header";    begin        if not (Notification.HasData(SalesHeader.FieldName("Document Type")) and                Notification.HasData(SalesHeader.FieldName("No.")))        then            exit;        Evaluate(SalesHeader."Document Type", Notification.GetData(SalesHeader.FieldName("Document Type")));        SalesHeader.Get(          SalesHeader."Document Type",          Notification.GetData(SalesHeader.FieldName("No.")));        GetSalesRecurringLines(SalesHeader);    end;    procedure GetPurchRecurringLinesFromNotification(Notification: Notification)    var        PurchHeader: Record "Purchase Header";    begin        if not (Notification.HasData(PurchHeader.FieldName("Document Type")) and                Notification.HasData(PurchHeader.FieldName("No.")))        then            exit;        Evaluate(PurchHeader."Document Type", Notification.GetData(PurchHeader.FieldName("Document Type")));        PurchHeader.Get(          PurchHeader."Document Type",          Notification.GetData(PurchHeader.FieldName("No.")));        GetPurchRecurringLines(PurchHeader);    end;    procedure CanGetSalesRecurringLines(var SalesHeader: Record "Sales Header"): Boolean    var        StandardCustomerSalesCode: Record "Standard Customer Sales Code";    begin        if not CanCreateSalesRecurringLines(SalesHeader) then            exit;        StandardCustomerSalesCode.SetFilterByAutomaticAndAlwaysAskCodes(SalesHeader);        exit(not StandardCustomerSalesCode.IsEmpty);    end;    procedure CanGetPurchRecurringLines(var PurchHeader: Record "Purchase Header"): Boolean    var        StandardVendorPurchaseCode: Record "Standard Vendor Purchase Code";        IsHandled: Boolean;        ReturnValue: Boolean;    begin        IsHandled := false;        OnBeforeCanGetPurchRecurringLines(PurchHeader, ReturnValue, IsHandled);        if IsHandled then            exit(ReturnValue);        if PurchHeader.IsTemporary then            exit(false);        if PurchHeader."Buy-from Vendor No." = '' then            exit(false);        if not IsPurchDocumentEmpty(PurchHeader) then            exit(false);        if PurchHeader."Document Type" in           [PurchHeader."Document Type"::"Blanket Order", PurchHeader."Document Type"::"Return Order"]        then            exit(false);        StandardVendorPurchaseCode.SetFilterByAutomaticAndAlwaysAskCodes(PurchHeader);        exit(not StandardVendorPurchaseCode.IsEmpty);    end;    [EventSubscriber(ObjectType::Page, Page::"Sales Quote", 'OnAfterValidateEvent', 'Sell-to Customer Name', false, false)]    local procedure OnAfterValidateSalesQuoteSellToCustomerName(var Rec: Record "Sales Header"; var xRec: Record "Sales Header")    begin        CheckCreateSalesRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Sales Quote", 'OnAfterValidateEvent', 'Sell-to Customer No.', false, false)]    local procedure OnAfterValidateSalesQuoteSellToCustomerNo(var Rec: Record "Sales Header"; var xRec: Record "Sales Header")    begin        CheckCreateSalesRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Sales Order", 'OnAfterValidateEvent', 'Sell-to Customer Name', false, false)]    local procedure OnAfterValidateSalesOrderSellToCustomerName(var Rec: Record "Sales Header"; var xRec: Record "Sales Header")    begin        CheckCreateSalesRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Sales Order", 'OnAfterValidateEvent', 'Sell-to Customer No.', false, false)]    local procedure OnAfterValidateSalesOrderSellToCustomerNo(var Rec: Record "Sales Header"; var xRec: Record "Sales Header")    begin        CheckCreateSalesRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Sales Invoice", 'OnAfterValidateEvent', 'Sell-to Customer Name', false, false)]    local procedure OnAfterValidateSalesInvoiceSellToCustomerName(var Rec: Record "Sales Header"; var xRec: Record "Sales Header")    begin        CheckCreateSalesRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Sales Invoice", 'OnAfterValidateEvent', 'Sell-to Customer No.', false, false)]    local procedure OnAfterValidateSalesInvoiceSellToCustomerNo(var Rec: Record "Sales Header"; var xRec: Record "Sales Header")    begin        CheckCreateSalesRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Sales Credit Memo", 'OnAfterValidateEvent', 'Sell-to Customer Name', false, false)]    local procedure OnAfterValidateSalesCreditMemoSellToCustomerName(var Rec: Record "Sales Header"; var xRec: Record "Sales Header")    begin        CheckCreateSalesRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Sales Credit Memo", 'OnAfterValidateEvent', 'Sell-to Customer No.', false, false)]    local procedure OnAfterValidateSalesCreditMemoSellToCustomerNo(var Rec: Record "Sales Header"; var xRec: Record "Sales Header")    begin        CheckCreateSalesRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Purchase Quote", 'OnAfterValidateEvent', 'Buy-from Vendor Name', false, false)]    local procedure OnAfterValidatePurchaseQuoteSellToVendorName(var Rec: Record "Purchase Header"; var xRec: Record "Purchase Header")    begin        CheckCreatePurchRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Purchase Quote", 'OnAfterValidateEvent', 'Buy-from Vendor No.', false, false)]    local procedure OnAfterValidatePurchaseQuoteSellToVendorNo(var Rec: Record "Purchase Header"; var xRec: Record "Purchase Header")    begin        CheckCreatePurchRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Purchase Invoice", 'OnAfterValidateEvent', 'Buy-from Vendor Name', false, false)]    local procedure OnAfterValidatePurchaseInvoiceSellToVendorName(var Rec: Record "Purchase Header"; var xRec: Record "Purchase Header")    begin        CheckCreatePurchRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Purchase Invoice", 'OnAfterValidateEvent', 'Buy-from Vendor No.', false, false)]    local procedure OnAfterValidatePurchaseInvoiceSellToVendorNo(var Rec: Record "Purchase Header"; var xRec: Record "Purchase Header")    begin        CheckCreatePurchRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Purchase Order", 'OnAfterValidateEvent', 'Buy-from Vendor Name', false, false)]    local procedure OnAfterValidatePurchaseOrderSellToVendorName(var Rec: Record "Purchase Header"; var xRec: Record "Purchase Header")    begin        CheckCreatePurchRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Purchase Order", 'OnAfterValidateEvent', 'Buy-from Vendor No.', false, false)]    local procedure OnAfterValidatePurchaseOrderSellToVendorNo(var Rec: Record "Purchase Header"; var xRec: Record "Purchase Header")    begin        CheckCreatePurchRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Purchase Credit Memo", 'OnAfterValidateEvent', 'Buy-from Vendor Name', false, false)]    local procedure OnAfterValidatePurchaseCreditMemoSellToVendorName(var Rec: Record "Purchase Header"; var xRec: Record "Purchase Header")    begin        CheckCreatePurchRecurringLines(Rec);    end;    [EventSubscriber(ObjectType::Page, Page::"Purchase Credit Memo", 'OnAfterValidateEvent', 'Buy-from Vendor No.', false, false)]    local procedure OnAfterValidatePurchaseCreditMemoSellToVendorNo(var Rec: Record "Purchase Header"; var xRec: Record "Purchase Header")    begin        CheckCreatePurchRecurringLines(Rec);    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeGetPurchRecurringLines(var PurchaseHeader: Record "Purchase Header")    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeCanCreatePurchRecurringLines(var PurchaseHeader: Record "Purchase Header"; var Result: Boolean; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeCanCreateSalesRecurringLines(var SalesHeader: Record "Sales Header"; var Result: Boolean; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeGetSalesRecurringLines(var SalesHeader: Record "Sales Header")    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeShowGetSalesRecurringLinesNotification(var SalesHeader: Record "Sales Header"; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeShowGetPurchRecurringLinesNotification(var PurchaseHeader: Record "Purchase Header"; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeCanGetPurchRecurringLines(var PurchaseHeader: Record "Purchase Header"; var ReturnValue: Boolean; var IsHandled: Boolean)    begin    end;}