Codeunit 20452 Qlty. Disp. Move Item Reclass.

Quality Management, Microsoft.QualityManagement.Dispositions.Move

src/Apps/W1/Quality Management/app/src/Dispositions/Move/QltyDispMoveItemReclass.Codeunit.al180 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.QualityManagement.Dispositions.Move;using Microsoft.Inventory.Journal;using Microsoft.Inventory.Tracking;using Microsoft.QualityManagement.Dispositions;using Microsoft.QualityManagement.Document;using Microsoft.QualityManagement.Integration.Inventory;using Microsoft.QualityManagement.Setup;using Microsoft.QualityManagement.Utilities;codeunit 20452 "Qlty. Disp. Move Item Reclass." implements "Qlty. Disposition"{    var        ItemJournalLineDescriptionTemplateLbl: Label 'Inspection [%3] changed bin from [%1] to [%2]', Comment = '%1 = From Bin code; %2 = To Bin code; %3 = the inspection';        MissingBinMoveBatchErr: Label 'There is missing setup on the Quality Management Setup Card defining the movement batches.';        OpenSetupActionLbl: Label 'Open Quality Management Setup';        DocumentTypeLbl: Label 'Item Reclassification';    /// <summary>    /// Creates and optionally posts item reclassification lines to move inspection inventory.    /// </summary>    /// <param name="QltyInspectionHeader">The inspection that identifies the inventory to move.</param>    /// <param name="TempInstructionQltyDispositionBuffer">The disposition instructions containing source, destination, quantity, and posting behavior.</param>    /// <returns>True if a reclassification line was created or posted; otherwise, false.</returns>    internal procedure PerformDisposition(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempInstructionQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary) DidSomething: Boolean    var        QltyManagementSetup: Record "Qlty. Management Setup";        TempQuantityToActQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary;        ItemJournalLine: Record "Item Journal Line";        QltyInventoryAvailability: Codeunit "Qlty. Inventory Availability";        QltyNotificationMgmt: Codeunit "Qlty. Notification Mgmt.";        QltyItemJournalManagement: Codeunit "Qlty. Item Journal Management";        CreatedLineNo: Integer;        IsHandled: Boolean;    begin        TempInstructionQltyDispositionBuffer."Disposition Action" := TempInstructionQltyDispositionBuffer."Disposition Action"::"Move with Item Reclassification";        OnBeforeProcessDisposition(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DidSomething, IsHandled);        if IsHandled then            exit;        QltyManagementSetup.Get();        if QltyManagementSetup."Item Reclass. Batch Name" = '' then            ThrowMissingSetupError();        QltyInventoryAvailability.PopulateQuantityBuffer(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, TempQuantityToActQltyDispositionBuffer);        if not TempQuantityToActQltyDispositionBuffer.FindSet() then begin            QltyNotificationMgmt.NotifyDocumentCreationFailed(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DocumentTypeLbl);            exit;        end;        repeat            Clear(CreatedLineNo);            CreateItemReclassificationLine(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, QltyManagementSetup."Item Reclass. Batch Name", CreatedLineNo);            if CreatedLineNo <> 0 then begin                DidSomething := true;                if TempInstructionQltyDispositionBuffer."Entry Behavior" = TempInstructionQltyDispositionBuffer."Entry Behavior"::Post then begin                    ItemJournalLine.SetRange("Journal Template Name", QltyManagementSetup.GetItemReclassJournalTemplate());                    ItemJournalLine.SetRange("Journal Batch Name", QltyManagementSetup."Item Reclass. Batch Name");                    ItemJournalLine.SetRange("Line No.", CreatedLineNo);                    DidSomething := QltyItemJournalManagement.PostItemJournal(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, ItemJournalLine);                    if DidSomething then                        QltyNotificationMgmt.NotifyMovementOccurred(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, QltyManagementSetup."Item Reclass. Batch Name")                    else begin                        TempInstructionQltyDispositionBuffer."Entry Behavior" := TempInstructionQltyDispositionBuffer."Entry Behavior"::"Prepare only";                        QltyNotificationMgmt.NotifyMovementOccurred(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, QltyManagementSetup."Item Reclass. Batch Name");                        TempInstructionQltyDispositionBuffer."Entry Behavior" := TempInstructionQltyDispositionBuffer."Entry Behavior"::Post;                    end;                end else                    QltyNotificationMgmt.NotifyMovementOccurred(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, QltyManagementSetup."Item Reclass. Batch Name");            end;        until TempQuantityToActQltyDispositionBuffer.Next() = 0;        if not DidSomething and (TempInstructionQltyDispositionBuffer."Entry Behavior" <> TempInstructionQltyDispositionBuffer."Entry Behavior"::Post) then            QltyNotificationMgmt.NotifyDocumentCreationFailed(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DocumentTypeLbl);        OnAfterProcessDisposition(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DidSomething);    end;    /// <summary>    /// Creates an item reclassification journal line for the requested movement.    /// </summary>    /// <param name="QltyInspectionHeader">The inspection that identifies the item and tracking values.</param>    /// <param name="TempInstructionQltyDispositionBuffer">The movement source, destination, and quantity.</param>    /// <param name="BatchName">The item reclassification journal batch name.</param>    /// <param name="CreatedLineNo">The line number of the created journal line.</param>    local procedure CreateItemReclassificationLine(QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempInstructionQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; BatchName: Code[10]; var CreatedLineNo: Integer)    var        ItemJournalLine: Record "Item Journal Line";        ReservationEntry: Record "Reservation Entry";        ItemJournalBatch: Record "Item Journal Batch";        QltyManagementSetup: Record "Qlty. Management Setup";        QltyItemJournalManagement: Codeunit "Qlty. Item Journal Management";        IsHandled: Boolean;    begin        QltyManagementSetup.Get();        OnBeforeCreateItemReclassificationLine(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, BatchName, ItemJournalLine, IsHandled);        if IsHandled then            exit;        ItemJournalBatch.SetAutoCalcFields("Template Type");        ItemJournalBatch.Get(QltyManagementSetup.GetItemReclassJournalTemplate(), BatchName);        QltyItemJournalManagement.CreateItemJournalLine(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, ItemJournalBatch, ItemJournalLine, ReservationEntry);        ItemJournalLine.Description := CopyStr(StrSubstNo(ItemJournalLineDescriptionTemplateLbl, TempInstructionQltyDispositionBuffer.GetFromBinCode(), TempInstructionQltyDispositionBuffer."New Bin Code", QltyInspectionHeader.GetFriendlyIdentifier()), 1, MaxStrLen(ItemJournalLine.Description));        ItemJournalLine.Modify(false);        CreatedLineNo := ItemJournalLine."Line No.";    end;    /// <summary>    /// This allows extensions to override or replace the item reclassification event.    /// </summary>    /// <param name="QltyInspectionHeader">The inspection that identifies the inventory to move.</param>    /// <param name="TempInstructionQltyDispositionBuffer">The movement source, destination, and quantity.</param>    /// <param name="BatchName">The item reclassification journal batch name.</param>    /// <param name="ItemJournalLine">The item journal line being prepared.</param>    /// <param name="IsHandled">Set to true to skip the default line creation.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeCreateItemReclassificationLine(QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempInstructionQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; var BatchName: Code[10]; var ItemJournalLine: Record "Item Journal Line"; var IsHandled: Boolean)    begin    end;    /// <summary>    /// Occurs before the disposition has taken place, allowing the opportunity to extend or replace the functionality.    /// </summary>    /// <param name="QltyInspectionHeader">The inspection being processed.</param>    /// <param name="TempInstructionQltyDispositionBuffer">The disposition instructions.</param>    /// <param name="Changed">Indicates whether a reclassification line was created or posted.</param>    /// <param name="IsHandled">Set to true to skip the default processing.</param>    [IntegrationEvent(false, false)]    local procedure OnBeforeProcessDisposition(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempInstructionQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; var Changed: Boolean; var IsHandled: Boolean)    begin    end;    /// <summary>    /// Occurs after the disposition has taken place.    /// </summary>    /// <param name="QltyInspectionHeader">The inspection that was processed.</param>    /// <param name="TempInstructionQltyDispositionBuffer">The disposition instructions.</param>    /// <param name="Changed">Indicates whether a reclassification line was created or posted.</param>    [IntegrationEvent(false, false)]    local procedure OnAfterProcessDisposition(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempInstructionQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; var Changed: Boolean)    begin    end;    /// <summary>    /// Raises an actionable error when the item reclassification batch is not configured.    /// </summary>    local procedure ThrowMissingSetupError()    var        ErrorInfo: ErrorInfo;    begin        ErrorInfo.Message := MissingBinMoveBatchErr;        ErrorInfo.PageNo := Page::"Qlty. Management Setup";        ErrorInfo.AddAction(OpenSetupActionLbl, Codeunit::"Qlty. Disp. Move Item Reclass.", 'OpenQualityManagementSetup');        Error(ErrorInfo);    end;    /// <summary>    /// Opens Quality Management Setup from the missing-setup error action.    /// </summary>    /// <param name="ErrorInfo">The error context supplied to the action callback.</param>    procedure OpenQualityManagementSetup(ErrorInfo: ErrorInfo)    var        QltyManagementSetup: Record "Qlty. Management Setup";    begin        if not QltyManagementSetup.Get() then            QltyManagementSetup.Insert(true);        Page.Run(Page::"Qlty. Management Setup", QltyManagementSetup);    end;}