Codeunit 545 Send Reminder

Base Application, Microsoft.Sales.Reminder

src/Layers/W1/BaseApp/Sales/Reminder/SendReminder.Codeunit.al134 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.Sales.Reminder;using Microsoft.Foundation.Reporting;using System.EMail;codeunit 545 "Send Reminder"{    Permissions = tabledata "Issued Reminder Header" = rmid,                  tabledata "Email Outbox" = rmid;    [EventSubscriber(ObjectType::Codeunit, Codeunit::"Document-Mailing", 'OnAfterEmailSent', '', false, false)]    local procedure HandleEmailSent(var TempEmailItem: Record "Email Item" temporary; PostedDocNo: Code[20]; ReportUsage: Integer; EmailSentSuccesfully: Boolean)    var        DummyReportSelections: Record "Report Selections";        IssuedReminderHeader: Record "Issued Reminder Header";    begin        if not EmailSentSuccesfully then            exit;        if ReportUsage <> DummyReportSelections.Usage::Reminder.AsInteger() then            exit;        if not IssuedReminderHeader.Get(PostedDocNo) then            exit;        UpdateSentEmailFields(IssuedReminderHeader);    end;    [EventSubscriber(ObjectType::Table, Database::"Issued Reminder Header", 'OnBeforeModifyEvent', '', false, false)]    local procedure ClearEmailFields(var Rec: Record "Issued Reminder Header"; var xRec: Record "Issued Reminder Header"; RunTrigger: Boolean)    begin        if Rec.IsTemporary() then            exit;        if not xRec.Find() then            exit;        if Rec."Reminder Level" <> xRec."Reminder Level" then            Rec.ClearSentEmailFieldsOnLevelUpdate(Rec);    end;    /// <summary>    /// Prompts the user to select how the reminder was sent and updates the sent email fields accordingly.    /// </summary>    /// <param name="IssuedReminderHeader">Specifies the issued reminder header to update.</param>    procedure UpdateReminderSentFromUI(var IssuedReminderHeader: Record "Issued Reminder Header")    var        SelectedOption: Integer;    begin        SelectedOption := StrMenu(ReminderSentByEmailTxt, 1, MarkAsSentQst);        if SelectedOption = 0 then            exit;        if SelectedOption = 1 then            UpdateSentEmailFields(IssuedReminderHeader)        else            UpdateSentForCurrentLevelWithoutEmail(IssuedReminderHeader);    end;    /// <summary>    /// Updates the email tracking fields on the issued reminder header after successful email delivery.    /// </summary>    /// <param name="IssuedReminderHeader">Specifies the issued reminder header to update.</param>    procedure UpdateSentEmailFields(var IssuedReminderHeader: Record "Issued Reminder Header")    begin        IssuedReminderHeader."Sent For Current Level" := true;        IssuedReminderHeader."Last Email Sent Date Time" := CurrentDateTime();        IssuedReminderHeader."Total Email Sent Count" += 1;        if IssuedReminderHeader."Email Sent Level" <> IssuedReminderHeader."Reminder Level" then begin            IssuedReminderHeader."Last Level Email Sent Count" := 1;            IssuedReminderHeader."Email Sent Level" := IssuedReminderHeader."Reminder Level";        end else            IssuedReminderHeader."Last Level Email Sent Count" += 1;        IssuedReminderHeader.Modify();    end;    /// <summary>    /// Marks the reminder as sent for the current level without recording email delivery details.    /// </summary>    /// <param name="IssuedReminderHeader">Specifies the issued reminder header to update.</param>    procedure UpdateSentForCurrentLevelWithoutEmail(var IssuedReminderHeader: Record "Issued Reminder Header")    begin        if IssuedReminderHeader."Reminder Level" <> IssuedReminderHeader."Email Sent Level" then            IssuedReminderHeader.ClearSentEmailFieldsOnLevelUpdate(IssuedReminderHeader);        IssuedReminderHeader."Sent For Current Level" := true;        IssuedReminderHeader.Modify();    end;    /// <summary>    /// Stores the failed email outbox message ID on the issued reminder header for later retry.    /// </summary>    /// <param name="MessageID">Specifies the email outbox entry number of the failed message.</param>    /// <param name="IssuedReminderNo">Specifies the issued reminder number to update.</param>    procedure SetFailedOutboxMessageID(MessageID: BigInteger; IssuedReminderNo: Code[20])    var        IssuedReminderHeader: Record "Issued Reminder Header";    begin        if not IssuedReminderHeader.Get(IssuedReminderNo) then            exit;        IssuedReminderHeader."Failed Email Outbox Entry No." := MessageID;        IssuedReminderHeader.Modify();    end;    /// <summary>    /// Deletes the failed email outbox message linked to the issued reminder if it exists.    /// </summary>    /// <param name="IssuedReminderNo">Specifies the issued reminder number whose failed outbox message should be deleted.</param>    procedure DeleteFailedOutboxMessageIfExists(IssuedReminderNo: Code[20])    var        IssuedReminderHeader: Record "Issued Reminder Header";        EmailOutbox: Record "Email Outbox";    begin        if not IssuedReminderHeader.Get(IssuedReminderNo) then            exit;        if EmailOutbox.Get(IssuedReminderHeader."Failed Email Outbox Entry No.") then            EmailOutbox.Delete();        Clear(IssuedReminderHeader."Failed Email Outbox Entry No.");        IssuedReminderHeader.Modify();    end;    var        ReminderSentByEmailTxt: Label 'Yes,No';        MarkAsSentQst: Label 'Was reminder sent by email?';}