Codeunit 6840 Release Spend Request
src/Layers/W1/BaseApp/Finance/SpendRequest/ReleaseSpendRequest.Codeunit.al185 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.Finance.SpendRequest;using System.Utilities;codeunit 6840 "Release Spend Request"{ TableNo = "Spend Request"; Permissions = tabledata "Spend Request" = rm; trigger OnRun() begin Release(Rec); end; var HasExpensesErr: Label 'A %1 with posted expenses cannot be reopened.', Comment = '%1 = document type description, e.g. spend request or Travel Request'; ClosedRequestErr: Label 'A closed %1 cannot be reopened.', Comment = '%1 = document type description, e.g. spend request or Travel Request'; CloseSpendRequestQst: Label 'Do you want to close %1 %2?', Comment = '%1 = document type description, %2 = document no.'; /// <summary> /// Sets the status of the spend request to Released. /// </summary> /// <param name="SpendRequest">The spend request to release.</param> procedure Release(var SpendRequest: Record "Spend Request") var IsHandled: Boolean; begin IsHandled := false; OnBeforeRelease(SpendRequest, IsHandled); if IsHandled then exit; if SpendRequest.Status = SpendRequest.Status::Released then exit; SpendRequest.Status := SpendRequest.Status::Released; SpendRequest.Modify(); OnAfterRelease(SpendRequest); end; /// <summary> /// Sets the status of the spend request back to Open so it can be edited again. /// </summary> /// <param name="SpendRequest">The spend request to reopen.</param> procedure Reopen(var SpendRequest: Record "Spend Request") var IsHandled: Boolean; begin IsHandled := false; OnBeforeReopen(SpendRequest, IsHandled); if IsHandled then exit; if SpendRequest.Status = SpendRequest.Status::Open then exit; if SpendRequest.Status = SpendRequest.Status::Closed then Error(ClosedRequestErr, SpendRequest.GetDocumentTypeDescription()); SpendRequest.CalcFields("Total Spent Amount (LCY)"); if SpendRequest."Total Spent Amount (LCY)" <> 0 then Error(HasExpensesErr, SpendRequest.GetDocumentTypeDescription()); SpendRequest.Status := SpendRequest.Status::Open; SpendRequest.Modify(); OnAfterReopen(SpendRequest); end; /// <summary> /// Sets the status of the spend request to Closed so it cannot be used anymore. /// </summary> /// <param name="SpendRequest">The spend request to close.</param> procedure Close(var SpendRequest: Record "Spend Request") var ConfirmManagement: Codeunit "Confirm Management"; IsHandled: Boolean; begin IsHandled := false; OnBeforeClose(SpendRequest, IsHandled); if IsHandled then exit; if SpendRequest.Status = SpendRequest.Status::Closed then exit; if not ConfirmManagement.GetResponseOrDefault(StrSubstNo(CloseSpendRequestQst, SpendRequest.GetDocumentTypeDescription(), SpendRequest."No."), true) then exit; SpendRequest.Status := SpendRequest.Status::Closed; SpendRequest.Modify(); OnAfterClose(SpendRequest); end; /// <summary> /// Performs a manual release of the spend request triggered from the UI. /// </summary> /// <param name="SpendRequest">The spend request to release.</param> procedure PerformManualRelease(var SpendRequest: Record "Spend Request") begin Codeunit.Run(Codeunit::"Release Spend Request", SpendRequest); end; /// <summary> /// Performs a manual reopen of the spend request triggered from the UI. /// </summary> /// <param name="SpendRequest">The spend request to reopen.</param> procedure PerformManualReopen(var SpendRequest: Record "Spend Request") begin Reopen(SpendRequest); end; /// <summary> /// Performs a manual close of the spend request triggered from the UI. /// </summary> /// <param name="SpendRequest">The spend request to close.</param> procedure PerformManualClose(var SpendRequest: Record "Spend Request") begin Close(SpendRequest); end; /// <summary> /// Integration event raised before releasing the spend request. /// </summary> /// <param name="SpendRequest">The spend request being released.</param> /// <param name="IsHandled">Set to true to skip the standard release logic.</param> [IntegrationEvent(false, false)] local procedure OnBeforeRelease(var SpendRequest: Record "Spend Request"; var IsHandled: Boolean) begin end; /// <summary> /// Integration event raised after releasing the spend request. /// </summary> /// <param name="SpendRequest">The spend request that was released.</param> [IntegrationEvent(false, false)] local procedure OnAfterRelease(var SpendRequest: Record "Spend Request") begin end; /// <summary> /// Integration event raised before reopening the spend request. /// </summary> /// <param name="SpendRequest">The spend request being reopened.</param> /// <param name="IsHandled">Set to true to skip the standard reopen logic.</param> [IntegrationEvent(false, false)] local procedure OnBeforeReopen(var SpendRequest: Record "Spend Request"; var IsHandled: Boolean) begin end; /// <summary> /// Integration event raised after reopening the spend request. /// </summary> /// <param name="SpendRequest">The spend request that was reopened.</param> [IntegrationEvent(false, false)] local procedure OnAfterReopen(var SpendRequest: Record "Spend Request") begin end; /// <summary> /// Integration event raised before closing the spend request. /// </summary> /// <param name="SpendRequest">The spend request being closed.</param> /// <param name="IsHandled">Set to true to skip the standard close logic.</param> [IntegrationEvent(false, false)] local procedure OnBeforeClose(var SpendRequest: Record "Spend Request"; var IsHandled: Boolean) begin end; /// <summary> /// Integration event raised after closing the spend request. /// </summary> /// <param name="SpendRequest">The spend request that was closed.</param> [IntegrationEvent(false, false)] local procedure OnAfterClose(var SpendRequest: Record "Spend Request") begin end;}