Codeunit 20444 Qlty. Disp. Transfer
src/Apps/W1/Quality Management/app/src/Dispositions/Transfer/QltyDispTransfer.Codeunit.al190 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.Transfer;using Microsoft.Inventory.Location;using Microsoft.Inventory.Transfer;using Microsoft.QualityManagement.Dispositions;using Microsoft.QualityManagement.Document;using Microsoft.QualityManagement.Integration.Inventory;using Microsoft.QualityManagement.Utilities;/// <summary>/// The purpose of this disposition is to create a transfer document /// </summary>codeunit 20444 "Qlty. Disp. Transfer" implements "Qlty. Disposition"{ var DocumentTypeLbl: Label 'Transfer Order'; /// <summary> /// Creates a transfer order from a quality inspection and explicit disposition options. /// </summary> /// <param name="QltyInspectionHeader">The inspection that identifies the inventory to transfer.</param> /// <param name="OptionalSpecificQuantity">The specific base quantity to transfer when required by the quantity behavior.</param> /// <param name="QltyQuantityBehavior">The rule used to determine the transfer quantity.</param> /// <param name="OptionalSourceLocationFilter">An optional source location filter.</param> /// <param name="OptionalSourceBinFilter">An optional source bin filter.</param> /// <param name="DestinationLocationCode">The destination location code.</param> /// <param name="OptionalInTransitLocationCode">The optional in-transit location code.</param> /// <returns>True if a transfer line was created; otherwise, false.</returns> internal procedure PerformDisposition(QltyInspectionHeader: Record "Qlty. Inspection Header"; OptionalSpecificQuantity: Decimal; QltyQuantityBehavior: Enum "Qlty. Quantity Behavior"; OptionalSourceLocationFilter: Text; OptionalSourceBinFilter: Text; DestinationLocationCode: Code[10]; OptionalInTransitLocationCode: Code[10]) DidSomething: Boolean var TempInstructionQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; begin TempInstructionQltyDispositionBuffer."Disposition Action" := TempInstructionQltyDispositionBuffer."Disposition Action"::"Create Transfer Order"; TempInstructionQltyDispositionBuffer."Qty. To Handle (Base)" := OptionalSpecificQuantity; TempInstructionQltyDispositionBuffer."Quantity Behavior" := QltyQuantityBehavior; TempInstructionQltyDispositionBuffer."Location Filter" := CopyStr(OptionalSourceLocationFilter, 1, MaxStrLen(TempInstructionQltyDispositionBuffer."Location Filter")); TempInstructionQltyDispositionBuffer."Bin Filter" := CopyStr(OptionalSourceBinFilter, 1, MaxStrLen(TempInstructionQltyDispositionBuffer."Bin Filter")); TempInstructionQltyDispositionBuffer."New Location Code" := DestinationLocationCode; TempInstructionQltyDispositionBuffer."In-Transit Location Code" := OptionalInTransitLocationCode; exit(PerformDisposition(QltyInspectionHeader, TempInstructionQltyDispositionBuffer)); end; /// <summary> /// Creates transfer orders and outbound tracking for inspection inventory. /// </summary> /// <param name="QltyInspectionHeader">The inspection that identifies the inventory to transfer.</param> /// <param name="TempInstructionQltyDispositionBuffer">The disposition instructions containing source, destination, in-transit location, and quantity.</param> /// <returns>True if at least one transfer line was created; otherwise, false.</returns> internal procedure PerformDisposition(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempInstructionQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary) DidSomething: Boolean var Location: Record Location; TransferRoute: Record "Transfer Route"; TempQuantityToActQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; TransferHeader: Record "Transfer Header"; QltyInventoryAvailability: Codeunit "Qlty. Inventory Availability"; QltyNotificationMgmt: Codeunit "Qlty. Notification Mgmt."; IsHandled: Boolean; IsDirectTransfer: Boolean; begin OnBeforeProcessDisposition(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DidSomething, IsHandled); if IsHandled then exit; QltyInventoryAvailability.PopulateQuantityBuffer(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, TempQuantityToActQltyDispositionBuffer); if not TempQuantityToActQltyDispositionBuffer.FindSet() then begin QltyNotificationMgmt.NotifyDocumentCreationFailed(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DocumentTypeLbl); exit; end; repeat Clear(TransferHeader); Location.Get(TempQuantityToActQltyDispositionBuffer.GetFromLocationCode()); if TempQuantityToActQltyDispositionBuffer."In-Transit Location Code" = '' then if TransferRoute.Get(Location.Code, TempQuantityToActQltyDispositionBuffer."New Location Code") then TempQuantityToActQltyDispositionBuffer."In-Transit Location Code" := TransferRoute."In-Transit Code"; IsDirectTransfer := (TempQuantityToActQltyDispositionBuffer."In-Transit Location Code" = ''); CreateTransferHeader(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, IsDirectTransfer, TransferHeader); DidSomething := DidSomething or CreateTransferLineWithOutboundTracking(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, TransferHeader); if DidSomething then QltyNotificationMgmt.NotifyDocumentCreated(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DocumentTypeLbl, TransferHeader."No.", TransferHeader); until TempQuantityToActQltyDispositionBuffer.Next() = 0; OnAfterProcessDisposition(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DidSomething); if not DidSomething then QltyNotificationMgmt.NotifyDocumentCreationFailed(QltyInspectionHeader, TempInstructionQltyDispositionBuffer, DocumentTypeLbl); end; /// <summary> /// Creates a transfer header for the requested source and destination locations. /// </summary> /// <param name="QltyInspectionHeader">The inspection linked to the transfer order.</param> /// <param name="TempQuantityToActQltyDispositionBuffer">The source, destination, and in-transit location values.</param> /// <param name="DirectTransfer">Specifies whether the transfer is direct.</param> /// <param name="TransferHeader">The created transfer header.</param> local procedure CreateTransferHeader(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempQuantityToActQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; DirectTransfer: Boolean; var TransferHeader: Record "Transfer Header") begin TransferHeader.SetHideValidationDialog(true); TransferHeader.Validate("Transfer-from Code", TempQuantityToActQltyDispositionBuffer.GetFromLocationCode()); TransferHeader.Validate("Transfer-to Code", TempQuantityToActQltyDispositionBuffer."New Location Code"); if TempQuantityToActQltyDispositionBuffer."In-Transit Location Code" <> '' then TransferHeader.Validate("In-Transit Code", TempQuantityToActQltyDispositionBuffer."In-Transit Location Code"); TransferHeader."Qlty. Inspection No." := QltyInspectionHeader."No."; TransferHeader."Qlty. Re-inspection No." := QltyInspectionHeader."Re-inspection No."; TransferHeader.Insert(true); TransferHeader.Validate("Direct Transfer", DirectTransfer); end; /// <summary> /// Creates a transfer line and outbound reservation entries for inspection item tracking. /// </summary> /// <param name="QltyInspectionHeader">The inspection that identifies the item, variant, and tracking values.</param> /// <param name="TempQuantityToActQltyDispositionBuffer">The source bin and quantity to transfer.</param> /// <param name="TransferHeader">The transfer header receiving the line.</param> /// <returns>True after the transfer line is created unless changed by an event subscriber.</returns> local procedure CreateTransferLineWithOutboundTracking(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempQuantityToActQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; var TransferHeader: Record "Transfer Header") Created: Boolean var TransferLine: Record "Transfer Line"; Location: Record Location; QltyItemTrackingMgmt: Codeunit "Qlty. Item Tracking Mgmt."; begin TransferLine."Document No." := TransferHeader."No."; TransferLine."Line No." := 10000; TransferLine.Validate("Item No.", QltyInspectionHeader."Source Item No."); if QltyInspectionHeader."Source Variant Code" <> '' then TransferLine.Validate("Variant Code", QltyInspectionHeader."Source Variant Code"); if TempQuantityToActQltyDispositionBuffer."Bin Filter" <> '' then if Location.Get(TempQuantityToActQltyDispositionBuffer.GetFromLocationCode()) then if Location."Bin Mandatory" and not Location."Directed Put-away and Pick" then TransferLine.Validate("Transfer-from Bin Code", TempQuantityToActQltyDispositionBuffer.GetFromBinCode()); TransferLine.Validate(Quantity, TempQuantityToActQltyDispositionBuffer."Qty. To Handle (Base)"); TransferLine.Validate("Qty. to Ship", TempQuantityToActQltyDispositionBuffer."Qty. To Handle (Base)"); TransferLine.Insert(false); if QltyInspectionHeader.IsItemTrackingUsed() then QltyItemTrackingMgmt.CreateOutboundTransferLineReservationEntries(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, TransferLine); Created := true; OnAfterCreateTransferLineWithOutboundTracking(QltyInspectionHeader, TempQuantityToActQltyDispositionBuffer, TransferHeader, TransferLine, Created); end; /// <summary> /// Occurs before transfer order processing and can replace the default behavior. /// </summary> /// <param name="QltyInspectionHeader">The inspection being processed.</param> /// <param name="TempInstructionQltyDispositionBuffer">The disposition instructions.</param> /// <param name="DidSomething">Indicates whether a transfer line was created.</param> /// <param name="IsHandled">Set to true to skip the default transfer processing.</param> [IntegrationEvent(false, false)] local procedure OnBeforeProcessDisposition(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempInstructionQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; var DidSomething: Boolean; var IsHandled: Boolean) begin end; /// <summary> /// Occurs after transfer order processing. /// </summary> /// <param name="QltyInspectionHeader">The inspection that was processed.</param> /// <param name="TempInstructionQltyDispositionBuffer">The disposition instructions.</param> /// <param name="DidSomething">Indicates whether a transfer line was created.</param> [IntegrationEvent(false, false)] local procedure OnAfterProcessDisposition(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempInstructionQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; var DidSomething: Boolean) begin end; /// <summary> /// Provides an opportunity to modify the created transfer header and transfer line after the line and optional outbound shipment tracking has been inserted. /// </summary> /// <param name="QltyInspectionHeader">The inspection that identifies the transferred inventory.</param> /// <param name="TempQuantityToActQltyDispositionBuffer">The source, destination, and quantity used for the transfer line.</param> /// <param name="TransferHeader">The created transfer header.</param> /// <param name="TransferLine">The created transfer line.</param> /// <param name="Created">Indicates whether the transfer line should be treated as created.</param> [IntegrationEvent(false, false)] local procedure OnAfterCreateTransferLineWithOutboundTracking(var QltyInspectionHeader: Record "Qlty. Inspection Header"; var TempQuantityToActQltyDispositionBuffer: Record "Qlty. Disposition Buffer" temporary; var TransferHeader: Record "Transfer Header"; var TransferLine: Record "Transfer Line"; var Created: Boolean) begin end;}