Codeunit 309 No. Series - Batch Impl.

Business Foundation, Microsoft.Foundation.NoSeries

src/Business Foundation/App/NoSeries/src/Batch/NoSeriesBatchImpl.Codeunit.al233 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.Foundation.NoSeries;codeunit 309 "No. Series - Batch Impl."{    Access = Internal;    InherentEntitlements = X;    InherentPermissions = X;    Permissions = tabledata "No. Series Line" = rm;    var        TempGlobalNoSeriesLine: Record "No. Series Line" temporary;        SimulationMode: Boolean;        CannotSaveNonExistingNoSeriesErr: Label 'Cannot save No. Series Line that does not exist: %1, %2', Comment = '%1 = No. Series Code, %2 = Line No.';        CannotSaveWhileSimulatingNumbersErr: Label 'No. Series state cannot be saved while simulating numbers.';        NoSeriesBatchTxt: Label 'No. Series - Batch', Locked = true;        SimulationModeStartedTxt: Label 'No. Series simulation mode started.', Locked = true;        SavingSingleNoSeriesStateTxt: Label 'Saving single No. Series state.', Locked = true;    procedure SetInitialState(TempNoSeriesLine: Record "No. Series Line" temporary)    begin        if IsSameNoSeriesLine(TempNoSeriesLine) then begin            TempGlobalNoSeriesLine := TempNoSeriesLine;            exit;        end;        if TempGlobalNoSeriesLine.Get(TempNoSeriesLine."Series Code", TempNoSeriesLine."Line No.") then            exit;        CopyNoSeriesLinesToTemp(TempNoSeriesLine."Series Code");        if not TempGlobalNoSeriesLine.Get(TempNoSeriesLine."Series Code", TempNoSeriesLine."Line No.") then begin            TempGlobalNoSeriesLine := TempNoSeriesLine;            TempGlobalNoSeriesLine.Insert();        end;    end;    local procedure IsSameNoSeriesLine(TempNoSeriesLine: Record "No. Series Line" temporary): Boolean    begin        exit((TempGlobalNoSeriesLine."Series Code" = TempNoSeriesLine."Series Code") and             (TempGlobalNoSeriesLine."Line No." = TempNoSeriesLine."Line No."));    end;    procedure PeekNextNo(NoSeriesCode: Code[20]): Code[20]    begin        exit(PeekNextNo(NoSeriesCode, WorkDate()));    end;    procedure PeekNextNo(NoSeriesCode: Code[20]; UsageDate: Date): Code[20]    var        TempNoSeriesLine: Record "No. Series Line" temporary;    begin        GetNoSeriesLine(TempNoSeriesLine, NoSeriesCode, UsageDate);        exit(PeekNextNo(TempNoSeriesLine, UsageDate));    end;    procedure PeekNextNo(TempNoSeriesLine: Record "No. Series Line" temporary; UsageDate: Date): Code[20]    var        NoSeries: Codeunit "No. Series";    begin        SyncGlobalLineWithProvidedLine(TempNoSeriesLine, UsageDate);        exit(NoSeries.PeekNextNo(TempGlobalNoSeriesLine, UsageDate));    end;    procedure GetNextNo(NoSeriesCode: Code[20]; UsageDate: Date; HideErrorsAndWarnings: Boolean): Code[20]    var        TempNoSeriesLine: Record "No. Series Line" temporary;    begin        GetNoSeriesLine(TempNoSeriesLine, NoSeriesCode, UsageDate, HideErrorsAndWarnings);        exit(GetNextNo(TempNoSeriesLine, UsageDate, HideErrorsAndWarnings));    end;    procedure GetNextNo(var TempNoSeriesLine: Record "No. Series Line" temporary; UsageDate: Date; HideErrorsAndWarnings: Boolean): Code[20]    var        NoSeries: Codeunit "No. Series";        NextNo: Code[20];    begin        SyncGlobalLineWithProvidedLine(TempNoSeriesLine, UsageDate);        NextNo := NoSeries.GetNextNo(TempGlobalNoSeriesLine, UsageDate, HideErrorsAndWarnings);        TempNoSeriesLine := TempGlobalNoSeriesLine;        exit(NextNo);    end;    procedure SimulateGetNextNo(NoSeriesCode: Code[20]; UsageDate: Date; PrevDocumentNo: Code[20]): Code[20]    var        TempNoSeriesLine: Record "No. Series Line" temporary;        NoSeries: Codeunit "No. Series";        NoSeriesStatelessImpl: Codeunit "No. Series - Stateless Impl.";    begin        if NoSeriesCode = '' then            exit(IncStr(PrevDocumentNo));        SetSimulationMode();        GetNoSeriesLine(TempNoSeriesLine, NoSeriesCode, UsageDate);        if NoSeries.MayProduceGaps(TempNoSeriesLine) then            TempNoSeriesLine.Implementation := TempNoSeriesLine.Implementation::Normal;        TempNoSeriesLine."Last No. Used" := PrevDocumentNo;        if not NoSeriesStatelessImpl.EnsureLastNoUsedIsWithinValidRange(TempNoSeriesLine, true) then            exit(IncStr(PrevDocumentNo));        TempNoSeriesLine.Modify(false);        exit(GetNextNo(TempNoSeriesLine, UsageDate, false));    end;    procedure GetLastNoUsed(NoSeriesCode: Code[20]): Code[20]    var        TempNoSeriesLine: Record "No. Series Line" temporary;        NoSeries: Codeunit "No. Series";    begin        if not GetNoSeriesLine(TempNoSeriesLine, NoSeriesCode, WorkDate(), true) then            exit('');        exit(NoSeries.GetLastNoUsed(TempGlobalNoSeriesLine));    end;    procedure GetLastNoUsed(TempNoSeriesLine: Record "No. Series Line" temporary): Code[20]    var        NoSeries: Codeunit "No. Series";    begin        SyncGlobalLineWithProvidedLine(TempNoSeriesLine, TempNoSeriesLine."Starting Date");        exit(NoSeries.GetLastNoUsed(TempGlobalNoSeriesLine));    end;    procedure SetSimulationMode()    begin        if SimulationMode then            exit;        Session.LogMessage('0000MI2', SimulationModeStartedTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', NoSeriesBatchTxt);        SimulationMode := true;    end;    procedure SaveState(TempNoSeriesLine: Record "No. Series Line" temporary)    begin        if SimulationMode then            Error(CannotSaveWhileSimulatingNumbersErr);        if not TempGlobalNoSeriesLine.Get(TempNoSeriesLine."Series Code", TempNoSeriesLine."Line No.") then            Error(CannotSaveNonExistingNoSeriesErr, TempNoSeriesLine."Series Code", TempNoSeriesLine."Line No.");        Session.LogMessage('0000MI3', SavingSingleNoSeriesStateTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', NoSeriesBatchTxt);        UpdateNoSeriesLine(TempGlobalNoSeriesLine);    end;    procedure SaveState();    begin        if SimulationMode then            Error(CannotSaveWhileSimulatingNumbersErr);        TempGlobalNoSeriesLine.Reset();        if TempGlobalNoSeriesLine.FindSet() then            repeat                UpdateNoSeriesLine(TempGlobalNoSeriesLine);            until TempGlobalNoSeriesLine.Next() = 0;    end;    [InherentPermissions(PermissionObjectType::TableData, Database::"No. Series Line", 'm')]    local procedure UpdateNoSeriesLine(var TempNoSeriesLine: Record "No. Series Line" temporary)    var        NoSeriesLine: Record "No. Series Line";    begin        NoSeriesLine.Get(TempNoSeriesLine."Series Code", TempNoSeriesLine."Line No.");        NoSeriesLine.TransferFields(TempNoSeriesLine);        NoSeriesLine.Modify(true);        TempNoSeriesLine := NoSeriesLine;        TempNoSeriesLine.Modify();    end;    procedure GetNoSeriesLine(var NoSeriesLine: Record "No. Series Line" temporary; NoSeriesCode: Code[20]; UsageDate: Date)    begin        GetNoSeriesLine(NoSeriesLine, NoSeriesCode, UsageDate, false);    end;    procedure GetNoSeriesLine(var NoSeriesLine: Record "No. Series Line" temporary; NoSeriesCode: Code[20]; UsageDate: Date; HideErrorsAndWarnings: Boolean) LineFound: Boolean    var        NoSeries: Codeunit "No. Series";    begin        LineFound := true; // Assume success        if not NoSeries.GetNoSeriesLine(TempGlobalNoSeriesLine, NoSeriesCode, UsageDate, true) then begin            CopyNoSeriesLinesToTemp(NoSeriesCode);            if not NoSeries.GetNoSeriesLine(TempGlobalNoSeriesLine, NoSeriesCode, UsageDate, HideErrorsAndWarnings) then begin                LineFound := false;                ClearGlobalLine();            end;        end;        NoSeriesLine.Copy(TempGlobalNoSeriesLine, true);        exit(LineFound);    end;    local procedure CopyNoSeriesLinesToTemp(NoSeriesCode: Code[20])    var        NoSeriesLine: Record "No. Series Line";    begin        if not IsNoSeriesCopied(NoSeriesCode) then begin            NoSeriesLine.SetRange("Series Code", NoSeriesCode);            NoSeriesLine.SetRange(Open, true);            if NoSeriesLine.FindSet() then                repeat                    TempGlobalNoSeriesLine := NoSeriesLine;                    TempGlobalNoSeriesLine.Insert();                until NoSeriesLine.Next() = 0;        end;        ClearGlobalLine();    end;    local procedure IsNoSeriesCopied(NoSeriesCode: Code[20]): Boolean    begin        TempGlobalNoSeriesLine.Reset();        TempGlobalNoSeriesLine.SetRange("Series Code", NoSeriesCode);        exit(not TempGlobalNoSeriesLine.IsEmpty());    end;    local procedure ClearGlobalLine()    var        TempBlankNoSeriesLine: Record "No. Series Line" temporary;    begin        TempGlobalNoSeriesLine := TempBlankNoSeriesLine; // Init + primary key    end;    local procedure SyncGlobalLineWithProvidedLine(var TempNoSeriesLine: Record "No. Series Line" temporary; UsageDate: Date)    var        NoSeries: Codeunit "No. Series";    begin        TempGlobalNoSeriesLine := TempNoSeriesLine;        if not NoSeries.GetNoSeriesLine(TempGlobalNoSeriesLine, TempNoSeriesLine."Series Code", UsageDate, true) then begin            ClearGlobalLine();            SetInitialState(TempNoSeriesLine);        end;    end;}