Codeunit 170 Standard Codes Mgt.
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;}