Codeunit 5930 ServAllocationManagement
src/Layers/W1/BaseApp/Service/Document/ServAllocationManagement.Codeunit.al374 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.Service.Document;using Microsoft.Projects.Resources.Resource;using Microsoft.Service.Maintenance;using Microsoft.Service.Resources;using Microsoft.Service.Setup;using System.Utilities;codeunit 5930 ServAllocationManagement{ Permissions = TableData "Service Order Allocation" = rimd; trigger OnRun() begin end; var#pragma warning disable AA0074#pragma warning disable AA0470 Text000: Label 'You cannot allocate a resource to the service order %1 because it is %2.'; Text001: Label '%1 with the field %2 selected cannot be found.'; Text002: Label 'Do you want to allocate the %1 %2 to all nonactive Service Order Allocations on the Service Item Lines with the %3 other than %4?'; Text003: Label 'There are no %1 lines to split the corresponding %2.'; Text004: Label 'You cannot change the resource allocation for service item line %1 because the %2 is %3.';#pragma warning restore AA0470#pragma warning restore AA0074 procedure AllocateDate(DocumentType: Integer; DocumentNo: Code[20]; EntryNo: Integer; ResNo: Code[20]; ResGrNo: Code[20]; CurrentDate: Date; Quantity: Decimal) var ServHeader: Record "Service Header"; ServOrderAlloc: Record "Service Order Allocation"; IsHandled: Boolean; begin IsHandled := false; OnBeforeAllocateDate(DocumentType, DocumentNo, EntryNo, ResNo, ResGrNo, CurrentDate, Quantity, IsHandled); if not IsHandled then begin ServHeader.Get(DocumentType, DocumentNo); if ServHeader.Status = ServHeader.Status::Finished then Error( Text000, ServHeader."No.", ServHeader.Status); if ServOrderAlloc.Get(EntryNo) then begin CheckServiceItemLineFinished(ServHeader, ServOrderAlloc."Service Item Line No."); ServOrderAlloc."Allocation Date" := CurrentDate; ServOrderAlloc.Validate("Resource No.", ResNo); if ResGrNo <> '' then ServOrderAlloc.Validate("Resource Group No.", ResGrNo); ServOrderAlloc.Validate("Allocated Hours", Quantity); ServOrderAlloc.Modify(true); end; end; OnAfterAllocateDate(ServOrderAlloc, ServHeader); end; procedure CancelAllocation(var ServOrderAlloc: Record "Service Order Allocation") var ServHeader: Record "Service Header"; ServItemLine: Record "Service Item Line"; RepairStatus: Record "Repair Status"; RepairStatus2: Record "Repair Status"; AddReasonCodeCancelation: Page "Cancelled Allocation Reasons"; ReasonCode: Code[10]; RepairStatusCode: Code[10]; IsHandled: Boolean; begin IsHandled := false; OnBeforeCancelAllocation(ServOrderAlloc, IsHandled); if not IsHandled then begin if ServOrderAlloc."Entry No." = 0 then exit; ServHeader.Get(ServOrderAlloc."Document Type", ServOrderAlloc."Document No."); CheckServiceItemLineFinished(ServHeader, ServOrderAlloc."Service Item Line No."); Clear(AddReasonCodeCancelation); AddReasonCodeCancelation.SetRecord(ServOrderAlloc); AddReasonCodeCancelation.SetTableView(ServOrderAlloc); if AddReasonCodeCancelation.RunModal() = ACTION::Yes then begin ReasonCode := AddReasonCodeCancelation.ReturnReasonCode(); ServOrderAlloc.Validate(Status, ServOrderAlloc.Status::"Reallocation Needed"); ServOrderAlloc."Reason Code" := ReasonCode; ServOrderAlloc.Modify(true); if ServItemLine.Get( ServOrderAlloc."Document Type", ServOrderAlloc."Document No.", ServOrderAlloc."Service Item Line No.") then begin ServItemLine.Validate(Priority, AddReasonCodeCancelation.ReturnPriority()); RepairStatusCode := ServItemLine."Repair Status Code"; RepairStatus.Get(RepairStatusCode); if RepairStatus.Initial then begin Clear(RepairStatus2); RepairStatus2.SetRange(Referred, true); if RepairStatus2.FindFirst() then RepairStatusCode := RepairStatus2.Code else Error( Text001, RepairStatus.TableCaption(), RepairStatus.FieldCaption(Referred)); end else if RepairStatus."In Process" then begin Clear(RepairStatus2); RepairStatus2.SetRange("Partly Serviced", true); if RepairStatus2.FindFirst() then RepairStatusCode := RepairStatus2.Code else Error( Text001, RepairStatus.TableCaption(), RepairStatus.FieldCaption("Partly Serviced")); end; ServItemLine."Repair Status Code" := RepairStatusCode; ServItemLine.Modify(true); end else begin ServHeader.Get(ServOrderAlloc."Document Type", ServOrderAlloc."Document No."); ServHeader.Validate(Priority, AddReasonCodeCancelation.ReturnPriority()); ServHeader.Modify(true); end; end; end; OnAfterCancelAllocation(ServOrderAlloc, ServHeader); end; procedure CreateAllocationEntry(DocumentType: Integer; DocumentNo: Code[20]; ServItemLineNo: Integer; ServItemNo: Code[20]; ServSerialNo: Code[50]) var ServHeader: Record "Service Header"; ServOrderAlloc: Record "Service Order Allocation"; NewServOrderAlloc: Record "Service Order Allocation"; IsHandled: Boolean; begin IsHandled := false; OnBeforeCreateAllocationEntry(DocumentType, DocumentNo, ServItemLineNo, ServItemNo, ServSerialNo, IsHandled); if IsHandled then exit; ServHeader.Get(DocumentType, DocumentNo); if ServHeader.Status <> ServHeader.Status::Finished then begin CheckServiceItemLineFinished(ServHeader, ServOrderAlloc."Service Item Line No."); ServOrderAlloc.Reset(); ServOrderAlloc.SetCurrentKey(Status, "Document Type", "Document No.", "Service Item Line No."); ServOrderAlloc.SetFilter(Status, '<>%1', ServOrderAlloc.Status::Canceled); ServOrderAlloc.SetRange("Document Type", DocumentType); ServOrderAlloc.SetRange("Document No.", DocumentNo); ServOrderAlloc.SetRange("Service Item Line No.", ServItemLineNo); if not ServOrderAlloc.FindFirst() then begin NewServOrderAlloc.Init(); NewServOrderAlloc."Document Type" := "Service Document Type".FromInteger(DocumentType); NewServOrderAlloc."Document No." := DocumentNo; NewServOrderAlloc."Service Item Line No." := ServItemLineNo; NewServOrderAlloc."Service Item No." := ServItemNo; NewServOrderAlloc."Service Item Serial No." := ServSerialNo; NewServOrderAlloc.Insert(true); end; end; end; procedure SplitAllocation(var SplitServOrderAlloc: Record "Service Order Allocation") var ServOrderAlloc: Record "Service Order Allocation"; TempServiceOrderAllocation: Record "Service Order Allocation" temporary; ServItemLine: Record "Service Item Line"; Res: Record Resource; RepairStatus: Record "Repair Status"; ConfirmManagement: Codeunit "Confirm Management"; NoOfRecords: Integer; SplitAllocHours: Decimal; begin SplitServOrderAlloc.TestField(Status, SplitServOrderAlloc.Status::Active); if not ConfirmManagement.GetResponseOrDefault( StrSubstNo( Text002, Res.TableCaption(), SplitServOrderAlloc."Resource No.", RepairStatus.TableCaption(), RepairStatus.FieldCaption(Finished)), true) then exit; ServOrderAlloc.Reset(); ServOrderAlloc.SetCurrentKey("Document Type", "Document No.", Status); ServOrderAlloc.SetRange("Document Type", SplitServOrderAlloc."Document Type"); ServOrderAlloc.SetRange("Document No.", SplitServOrderAlloc."Document No."); ServOrderAlloc.SetFilter(Status, '%1|%2', ServOrderAlloc.Status::Nonactive, ServOrderAlloc.Status::"Reallocation Needed"); ServOrderAlloc.SetHideDialog(true); if not ServOrderAlloc.Find('-') then Error(Text003, ServOrderAlloc.TableCaption(), SplitServOrderAlloc.FieldCaption(SplitServOrderAlloc."Allocated Hours")); TempServiceOrderAllocation.DeleteAll(); repeat ServItemLine.Get( ServOrderAlloc."Document Type", ServOrderAlloc."Document No.", ServOrderAlloc."Service Item Line No."); if RepairStatus.Get(ServItemLine."Repair Status Code") then if not RepairStatus.Finished then begin TempServiceOrderAllocation := ServOrderAlloc; TempServiceOrderAllocation.Insert(); end; until ServOrderAlloc.Next() = 0; NoOfRecords := TempServiceOrderAllocation.Count + 1; if NoOfRecords <> 1 then begin SplitAllocHours := Round(SplitServOrderAlloc."Allocated Hours" / NoOfRecords, 0.1); TempServiceOrderAllocation.Find('-'); repeat ServOrderAlloc.Get(TempServiceOrderAllocation."Entry No."); if ServOrderAlloc."Entry No." <> SplitServOrderAlloc."Entry No." then begin ServOrderAlloc.Validate("Allocation Date", SplitServOrderAlloc."Allocation Date"); ServOrderAlloc.Validate("Resource No.", SplitServOrderAlloc."Resource No."); ServOrderAlloc.Validate("Resource Group No.", SplitServOrderAlloc."Resource Group No."); ServOrderAlloc.Validate("Allocated Hours", SplitAllocHours); OnSplitAllocationOnBeforeServOrderAllocModify(ServOrderAlloc, SplitServOrderAlloc); ServOrderAlloc.Modify(true); end; SplitServOrderAlloc.Validate(SplitServOrderAlloc."Allocated Hours", SplitAllocHours); SplitServOrderAlloc.Modify(true); until TempServiceOrderAllocation.Next() = 0; end else Error(Text003, ServOrderAlloc.TableCaption(), SplitServOrderAlloc.FieldCaption(SplitServOrderAlloc."Allocated Hours")); end; procedure ResourceQualified(ResourceNo: Code[20]; Type: Enum "Resource Skill Type"; No: Code[20]): Boolean var ServMgtSetup: Record "Service Mgt. Setup"; ResourceSkill: Record "Resource Skill"; ResourceSkill2: Record "Resource Skill"; begin ServMgtSetup.Get(); if ServMgtSetup."Resource Skills Option" = ServMgtSetup."Resource Skills Option"::"Not Used" then exit(false); if ResourceNo = '' then exit(false); ResourceSkill.SetRange(Type, Type); ResourceSkill.SetRange("No.", No); if ResourceSkill.Find('-') then repeat if not ResourceSkill2.Get( Type::Resource, ResourceNo, ResourceSkill."Skill Code") then exit(false); until ResourceSkill.Next() = 0; exit(true); end; procedure QualifiedForServiceItemLine(var ServiceItemLine: Record "Service Item Line"; ResourceNo: Code[20]): Boolean var ResourceSkill: Record "Resource Skill"; begin case true of ServiceItemLine."Service Item No." <> '': if not ResourceQualified( ResourceNo, ResourceSkill.Type::"Service Item", ServiceItemLine."Service Item No.") then exit(false); ServiceItemLine."Item No." <> '': if not ResourceQualified( ResourceNo, ResourceSkill.Type::Item, ServiceItemLine."Item No.") then exit(false); ServiceItemLine."Service Item Group Code" <> '': if not ResourceQualified( ResourceNo, ResourceSkill.Type::"Service Item Group", ServiceItemLine."Service Item Group Code") then exit(false); end; exit(true); end; procedure CheckServiceItemLineFinished(var ServHeader: Record "Service Header"; ServiceItemLineNo: Integer) var ServiceItemLine: Record "Service Item Line"; RepairStatus: Record "Repair Status"; begin if ServiceItemLine.Get(ServHeader."Document Type", ServHeader."No.", ServiceItemLineNo) then if ServiceItemLine."Repair Status Code" <> '' then begin RepairStatus.Get(ServiceItemLine."Repair Status Code"); if RepairStatus.Finished then Error(Text004, ServiceItemLine."Line No.", ServiceItemLine.FieldCaption("Repair Status Code"), ServiceItemLine."Repair Status Code"); end; end; procedure SetServOrderAllocStatus(var ServHeader: Record "Service Header") var ServOrderAlloc: Record "Service Order Allocation"; ServOrderAlloc2: Record "Service Order Allocation"; begin ServOrderAlloc.Reset(); ServOrderAlloc.SetCurrentKey("Document Type", "Document No."); ServOrderAlloc.SetRange("Document Type", ServHeader."Document Type"); ServOrderAlloc.SetRange("Document No.", ServHeader."No."); if ServOrderAlloc.Find('-') then repeat ServOrderAlloc2 := ServOrderAlloc; ServOrderAlloc2.Posted := true; if ServOrderAlloc2.Status = ServOrderAlloc2.Status::Active then ServOrderAlloc2.Status := ServOrderAlloc2.Status::Finished; OnSetServOrderAllocStatusOnBeforeServOrderAlloc2Modify(ServOrderAlloc, ServOrderAlloc2, ServHeader); ServOrderAlloc2.Modify(); until ServOrderAlloc.Next() = 0; end; procedure SetServLineAllocStatus(var ServLine: Record "Service Line") var ServOrderAlloc: Record "Service Order Allocation"; ServOrderAlloc2: Record "Service Order Allocation"; begin if (ServLine."Service Item Line No." = 0) or (ServLine."Qty. to Ship" = 0) then exit; ServOrderAlloc.Reset(); ServOrderAlloc.SetCurrentKey("Document Type", "Document No."); ServOrderAlloc.SetRange("Document Type", ServLine."Document Type"); ServOrderAlloc.SetRange("Document No.", ServLine."Document No."); ServOrderAlloc.SetRange("Service Item Line No.", ServLine."Service Item Line No."); if ServOrderAlloc.Find('-') then repeat ServOrderAlloc2 := ServOrderAlloc; ServOrderAlloc2.Posted := true; ServOrderAlloc2.Modify(); until ServOrderAlloc.Next() = 0; end; [IntegrationEvent(false, false)] local procedure OnAfterAllocateDate(var ServOrderAllocation: Record "Service Order Allocation"; var ServHeader: Record "Service Header") begin end; [IntegrationEvent(false, false)] local procedure OnAfterCancelAllocation(var ServOrderAllocation: Record "Service Order Allocation"; var ServHeader: Record "Service Header") begin end; [IntegrationEvent(false, false)] local procedure OnBeforeAllocateDate(DocumentType: Integer; DocumentNo: Code[20]; EntryNo: Integer; ResNo: Code[20]; ResGrNo: Code[20]; CurrentDate: Date; Quantity: Decimal; var IsHandled: Boolean) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeCancelAllocation(var ServOrderAllocation: Record "Service Order Allocation"; var IsHandled: Boolean); begin end; [IntegrationEvent(false, false)] local procedure OnBeforeCreateAllocationEntry(DocumentType: Integer; DocumentNo: Code[20]; ServItemLineNo: Integer; ServItemNo: Code[20]; ServSerialNo: Code[50]; var IsHandled: Boolean); begin end; [IntegrationEvent(false, false)] local procedure OnSplitAllocationOnBeforeServOrderAllocModify(var ServiceOrderAllocation: Record "Service Order Allocation"; var SplitServiceOrderAllocation: Record "Service Order Allocation") begin end; [IntegrationEvent(false, false)] local procedure OnSetServOrderAllocStatusOnBeforeServOrderAlloc2Modify(var ServiceOrderAllocation: Record "Service Order Allocation"; var ServiceOrderAllocation2: Record "Service Order Allocation"; var ServiceHeader: Record "Service Header") begin end;}