Codeunit 20443 Qlty. Disp. Change Tracking

Quality Management, Microsoft.QualityManagement.Dispositions.ItemTracking

src/Apps/W1/Quality Management/app/src/Dispositions/ItemTracking/QltyDispChangeTracking.Codeunit.al238 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.ItemTracking;using Microsoft.Inventory.Journal;using Microsoft.Inventory.Location;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;using Microsoft.Warehouse.Journal;using Microsoft.Warehouse.Tracking;/// <summary>/// The purpose of this reaction is to change lot, change serial, change package, change expiration date./// </summary>codeunit 20443 "Qlty. Disp. Change Tracking" implements "Qlty. Disposition"{    var        WarehouseJournalLineDescriptionTemplateLbl: Label 'Inspection [%1] changed item tracking', Comment = '%1 = Quality Inspection';        DescriptionTxt: Label 'Inspection [%1] changed item tracking', Comment = '%1 = Quality Inspection';        NoJournalBatchErr: Label 'Cannot open the Reclassification Journal Batch. Check the Move/Reclassify batches on the Quality Management Setup page.';        MissingBatchErr: Label 'There is missing setup on the Quality Management Setup Card defining the Reclassification Journal Batch or Warehouse Reclassification Batch';        NoItemTrackingChangesErr: Label 'No changes to item tracking information were provided.';        DocumentTypeLbl: Label 'item tracking change';    /// <summary>    /// Performs the change item tracking disposition.    /// </summary>    /// <param name="QltyInspectionHeader">The inspection that identifies the inventory and current tracking values.</param>    /// <param name="TempInstructionQltyDispositionBuffer">The disposition instructions containing the new tracking values and posting behavior.</param>    /// <returns>True if item tracking was changed; otherwise, false.</returns>    internal procedure PerformDisposition(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempInstructionQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary) Changed: Boolean    var        QltyManagementSetup: Record "Qlty. Management Setup";        Location: Record Location;        ItemJournalLine: Record "Item Journal Line";        ItemReservationEntry: Record "Reservation Entry";        WarehouseJournalLine: Record "Warehouse Journal Line";        WhseItemTrackingLine: Record "Whse. Item Tracking Line";        TempQuantityToActQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary;        QltyInventoryAvailability: Codeunit "Qlty. Inventory Availability";        QltyNotificationMgmt: Codeunit "Qlty. Notification Mgmt.";        QltyItemJournalManagement: Codeunit "Qlty. Item Journal Management";        IsHandled: Boolean;        LoopSuccess: Boolean;        LineCreated: Boolean;        DocumentOrBatch: Text;    begin        TempInstructionQltyDispositionBuffer."Disposition Action" := TempInstructionQltyDispositionBuffer."Disposition Action"::"Change Item Tracking";        OnBeforeProcessDisposition(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, Changed, IsHandled);        if IsHandled then            exit;        if ((TempInstructionQltyDispositionBuffer."New Lot No." = '') and (TempInstructionQltyDispositionBuffer."New Serial No." = '') and (TempInstructionQltyDispositionBuffer."New Package No." = '') and           (TempInstructionQltyDispositionBuffer."New Expiration Date" = 0D))        then            Error(NoItemTrackingChangesErr);        QltyManagementSetup.Get();        QltyInventoryAvailability.PopulateQuantityBuffer(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, TempQuantityToActQltyDispositionBuffer);        if not TempQuantityToActQltyDispositionBuffer.FindSet() then            QltyNotificationMgmt.NotifyDocumentCreationFailed(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DocumentTypeLbl);        repeat            Clear(Location);            LoopSuccess := false;            if TempQuantityToActQltyDispositionBuffer."Location Filter" <> '' then                Location.Get(TempQuantityToActQltyDispositionBuffer.GetFromLocationCode());            if Location."Directed Put-away and Pick" then begin                if QltyManagementSetup."Whse. Reclass. Batch Name" = '' then                    Error(MissingBatchErr);                DocumentOrBatch := QltyManagementSetup."Whse. Reclass. Batch Name";                Clear(WarehouseJournalLine);                CreateTrackingWarehouseReclassLine(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, QltyManagementSetup."Whse. Reclass. Batch Name", WarehouseJournalLine, WhseItemTrackingLine);                LineCreated := WarehouseJournalLine."Line No." <> 0;                if TempInstructionQltyDispositionBuffer."Entry Behavior" = TempInstructionQltyDispositionBuffer."Entry Behavior"::"Prepare only" then                    Changed := LineCreated;                if LineCreated and (TempInstructionQltyDispositionBuffer."Entry Behavior" = TempInstructionQltyDispositionBuffer."Entry Behavior"::Post) then                    Changed := QltyItemJournalManagement.PostWarehouseJournal(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, WarehouseJournalLine);                LoopSuccess := true;            end else begin                if QltyManagementSetup."Item Reclass. Batch Name" = '' then                    Error(MissingBatchErr);                DocumentOrBatch := QltyManagementSetup."Item Reclass. Batch Name";                Clear(ItemJournalLine);                CreateTrackingItemReclassLine(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, QltyManagementSetup."Item Reclass. Batch Name", ItemJournalLine, ItemReservationEntry);                LineCreated := ItemJournalLine."Line No." <> 0;                if TempInstructionQltyDispositionBuffer."Entry Behavior" = TempInstructionQltyDispositionBuffer."Entry Behavior"::"Prepare only" then                    Changed := LineCreated;                if LineCreated and (TempInstructionQltyDispositionBuffer."Entry Behavior" = TempInstructionQltyDispositionBuffer."Entry Behavior"::Post) then                    Changed := QltyItemJournalManagement.PostItemJournal(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, ItemJournalLine);                LoopSuccess := true;            end;            if LoopSuccess then                if Location."Directed Put-away and Pick" then                    QltyNotificationMgmt.NotifyItemTrackingChanged(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, LineCreated, Changed, TempQuantityToActQltyDispositionBuffer."Qty. To Handle (Base)", DocumentOrBatch, WhseItemTrackingLine."Expiration Date")                else                    QltyNotificationMgmt.NotifyItemTrackingChanged(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, LineCreated, Changed, TempQuantityToActQltyDispositionBuffer."Qty. To Handle (Base)", DocumentOrBatch, ItemReservationEntry."Expiration Date")        until TempQuantityToActQltyDispositionBuffer.Next() = 0;        OnAfterProcessDisposition(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, Changed);        if not Changed then            QltyNotificationMgmt.NotifyDocumentCreationFailed(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DocumentTypeLbl);    end;    /// <summary>    /// Creates an item reclassification journal line with the requested tracking changes.    /// </summary>    /// <param name="QltyInspectionHeader">The inspection that identifies the item and current tracking values.</param>    /// <param name="TempQuantityToActQltyDispositionBuffer">The quantity, source filters, and new tracking values.</param>    /// <param name="ReclassBatchName">The item reclassification journal batch name.</param>    /// <param name="ItemJournalLine">The created item journal line.</param>    /// <param name="ReservationEntry">The reservation entry created for the new tracking values.</param>    local procedure CreateTrackingItemReclassLine(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempQuantityToActQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; ReclassBatchName: Code[10]; var ItemJournalLine: Record "Item Journal Line"; var ReservationEntry: Record "Reservation Entry")    var        QltyManagementSetup: Record "Qlty. Management Setup";        ItemJournalBatch: Record "Item Journal Batch";        QltyItemJournalManagement: Codeunit "Qlty. Item Journal Management";        JournalTemplate: Code[10];        IsHandled: Boolean;    begin        Clear(ItemJournalLine);        QltyManagementSetup.Get();        JournalTemplate := QltyManagementSetup.GetItemReclassJournalTemplate();        ItemJournalBatch.SetAutoCalcFields("Template Type");        if not ItemJournalBatch.Get(JournalTemplate, ReclassBatchName) then            Error(NoJournalBatchErr);        OnBeforeInsertCreateTrackingItemReclassLine(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, ReclassBatchName, ItemJournalLine, IsHandled);        if IsHandled then            exit;        if TempQuantityToActQltyDispositionBuffer."New Location Code" = '' then            TempQuantityToActQltyDispositionBuffer."New Location Code" := TempQuantityToActQltyDispositionBuffer.GetFromLocationCode();        if TempQuantityToActQltyDispositionBuffer."New Bin Code" = '' then            TempQuantityToActQltyDispositionBuffer."New Bin Code" := TempQuantityToActQltyDispositionBuffer.GetFromBinCode();        QltyItemJournalManagement.CreateItemJournalLine(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, ItemJournalBatch, ItemJournalLine, ReservationEntry);        ItemJournalLine.Description := CopyStr(StrSubstNo(DescriptionTxt, QltyInspectionHeader.GetFriendlyIdentifier()), 1, MaxStrLen(ItemJournalLine.Description));        ItemJournalLine.Modify();        OnAfterCreateTrackingItemReclassLine(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, ReclassBatchName, ItemJournalLine, ReservationEntry);    end;    /// <summary>    /// Creates a warehouse reclassification journal line with the requested tracking changes.    /// </summary>    /// <param name="QltyInspectionHeader">The inspection that identifies the item and current tracking values.</param>    /// <param name="TempQuantityToActQltyDispositionBuffer">The quantity, source filters, and new tracking values.</param>    /// <param name="ReclassBatchName">The warehouse reclassification journal batch name.</param>    /// <param name="WhseWarehouseJournalLine">The created warehouse journal line.</param>    /// <param name="WhseItemTrackingLine">The created warehouse item tracking line.</param>    local procedure CreateTrackingWarehouseReclassLine(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempQuantityToActQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; ReclassBatchName: Code[10]; var WhseWarehouseJournalLine: Record "Warehouse Journal Line"; var WhseItemTrackingLine: Record "Whse. Item Tracking Line")    var        QltyManagementSetup: Record "Qlty. Management Setup";        ChangeTrackingWarehouseJournalBatch: Record "Warehouse Journal Batch";        QltyItemJournalManagement: Codeunit "Qlty. Item Journal Management";        JournalTemplate: Code[10];    begin        JournalTemplate := QltyManagementSetup.GetWarehouseReclassificationJournalTemplate();        if not ChangeTrackingWarehouseJournalBatch.Get(JournalTemplate, ReclassBatchName, TempQuantityToActQltyDispositionBuffer.GetFromLocationCode()) then            Error(NoJournalBatchErr);        TempQuantityToActQltyDispositionBuffer."New Location Code" := TempQuantityToActQltyDispositionBuffer.GetFromLocationCode();        TempQuantityToActQltyDispositionBuffer."New Bin Code" := TempQuantityToActQltyDispositionBuffer.GetFromBinCode();        QltyItemJournalManagement.CreateWarehouseJournalLine(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, ChangeTrackingWarehouseJournalBatch, WhseWarehouseJournalLine, WhseItemTrackingLine);        WhseWarehouseJournalLine.Description := CopyStr(StrSubstNo(WarehouseJournalLineDescriptionTemplateLbl, QltyInspectionHeader.GetFriendlyIdentifier()), 1, MaxStrLen(WhseWarehouseJournalLine.Description));        WhseWarehouseJournalLine.Modify();    end;    /// <summary>    /// Occurs before change tracking 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 item tracking was changed.</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 change tracking 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 item tracking was changed.</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>    /// Provides an opportunity to adjust the item reclassification line created to change item tracking information before it is inserted.    /// </summary>    /// <param name="QltyInspectionHeader">The inspection that identifies the item and current tracking values.</param>    /// <param name="TempQuantityToActQltyDispositionBuffer">The quantity, source filters, and new tracking values.</param>    /// <param name="ReclassBatchName">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)]    procedure OnBeforeInsertCreateTrackingItemReclassLine(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempQuantityToActQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; var ReclassBatchName: Code[10]; var ItemJournalLine: Record "Item Journal Line"; var IsHandled: Boolean)    begin    end;    /// <summary>    /// Occurs after an item reclassification line and reservation entry are created for the tracking change.    /// </summary>    /// <param name="QltyInspectionHeader">The inspection that identifies the item and current tracking values.</param>    /// <param name="TempQuantityToActQltyDispositionBuffer">The quantity, source filters, and new tracking values.</param>    /// <param name="ReclassBatchName">The item reclassification journal batch name.</param>    /// <param name="ItemJournalLine">The created item journal line.</param>    /// <param name="ReservationEntry">The reservation entry created for the new tracking values.</param>    [IntegrationEvent(false, false)]    procedure OnAfterCreateTrackingItemReclassLine(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempQuantityToActQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; var ReclassBatchName: Code[10]; var ItemJournalLine: Record "Item Journal Line"; var ReservationEntry: Record "Reservation Entry")    begin    end;}