Page 8887 Email Accounts

System Application, System.Email

src/System Application/App/Email/src/Account/EmailAccounts.Page.al598 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 System.Email;using System.Telemetry;/// <summary>/// Lists all of the registered email accounts/// </summary>page 8887 "Email Accounts"{    PageType = List;    Caption = 'Email Accounts';    ApplicationArea = All;    UsageCategory = Administration;    SourceTable = "Email Account";    SourceTableTemporary = true;    AdditionalSearchTerms = 'SMTP,Office 365,Exchange,Outlook';    PromotedActionCategories = 'New,Process,Report,Navigate';    InsertAllowed = false;    ModifyAllowed = false;    DeleteAllowed = false;    Editable = false;    ShowFilter = false;    LinksAllowed = false;    RefreshOnActivate = true;    layout    {        area(Content)        {            repeater(Accounts)            {                FreezeColumn = NameField;#pragma warning disable AW0009                field(LogoField; Rec.LogoBlob)#pragma warning restore AW0009                {                    ApplicationArea = All;                    ShowCaption = false;                    Caption = ' ';                    ToolTip = 'Specifies the logo for the type of email account.';                    Width = 1;                }                field(NameField; Rec.Name)                {                    ApplicationArea = All;                    ToolTip = 'Specifies the name of the account.';                    Visible = not IsLookupMode;                    trigger OnDrillDown()                    begin                        ShowAccountInformation();                    end;                }                field(EmailAddress; Rec."Email Address")                {                    ApplicationArea = All;                    ToolTip = 'Specifies the address of the email account.';                    Visible = not IsLookupMode;                    trigger OnDrillDown()                    begin                        ShowAccountInformation();                    end;                }                field(NameFieldLookup; Rec.Name)                {                    ApplicationArea = All;                    ToolTip = 'Specifies the name of the account.';                    Visible = IsLookupMode;                }                field(EmailAddressLookup; Rec."Email Address")                {                    ApplicationArea = All;                    ToolTip = 'Specifies the address of the email account.';                    Visible = IsLookupMode;                }                field(DefaultField; DefaultTxt)                {                    ApplicationArea = All;                    Caption = 'Default';                    ToolTip = 'Specifies whether the email account will be used for all scenarios for which an account is not specified. You must have a default email account, even if you have only one account.';                    Visible = not IsLookupMode;                }                field(EmailConnector; Rec.Connector)                {                    ApplicationArea = All;                    ToolTip = 'Specifies the type of email extension that the account is added to.';                    Visible = false;                }                field(EmailRateLimit; RateLimit)                {                    ApplicationArea = All;                    Caption = 'Email Rate Limit';                    ToolTip = 'Specifies the rate limit per minute for the email account.';                    Visible = true;                    trigger OnDrillDown()                    begin                        EmailRateLimitImpl.UpdateRateLimit(Rec);                    end;                }                field(EmailConcurrencyLimit; ConcurrencyLimit)                {                    ApplicationArea = All;                    Caption = 'Email Concurrency Limit';                    ToolTip = 'Specifies the maximum number of emails that can be sent simultaneously from this account.';                    Visible = true;                    trigger OnDrillDown()                    begin                        EmailRateLimitImpl.UpdateRateLimit(Rec);                    end;                }                field(EmailMaxRetryLimit; MaxRetryLimit)                {                    ApplicationArea = All;                    Caption = 'Email Max. Attempt Limit';                    ToolTip = 'Specifies the maximum number of attempts for sending an email from this account.';                    Visible = true;                    trigger OnDrillDown()                    begin                        EmailRateLimitImpl.UpdateRateLimit(Rec);                    end;                }            }        }        area(FactBoxes)        {            part(Scenarios; "Email Scenarios FactBox")            {                Caption = 'Email Scenarios';                SubPageLink = "Account Id" = field("Account Id"), Connector = field(Connector), Scenario = filter(<> 0); // Do not show Default scenario                ApplicationArea = All;            }        }    }    actions    {        area(Creation)        {            action(View)            {                ApplicationArea = All;                Image = View;                ToolTip = 'View settings for the email account.';                ShortcutKey = return;                Visible = false;                trigger OnAction()                begin                    ShowAccountInformation();                end;            }            action(AddAccount)            {                ApplicationArea = All;                Promoted = true;                PromotedOnly = true;                PromotedCategory = New;                Image = Add;                Caption = 'Add an email account';                ToolTip = 'Add an email account.';                Visible = ((not IsLookupMode) or ShowCreateAccount) and CanUserManageEmailSetup;                trigger OnAction()                begin                    Page.RunModal(Page::"Email Account Wizard");                    UpdateEmailAccounts();                end;            }        }        area(Processing)        {            action(SendEmail)            {                ApplicationArea = All;                Promoted = true;                PromotedOnly = true;                PromotedCategory = Process;                Image = PostMail;                Caption = 'Compose Email';                ToolTip = 'Compose a new email message.';                Visible = not IsLookupMode;                Enabled = HasEmailAccount;                trigger OnAction()                var                    Email: Codeunit Email;                    EmailMessage: Codeunit "Email Message";                begin                    EmailMessage.Create('', '', '', true);                    Email.OpenInEditor(EmailMessage, Rec);                end;            }            action(SendTestMail)            {                ApplicationArea = All;                Promoted = true;                PromotedOnly = true;                PromotedCategory = Process;                Image = MailSetup;                Caption = 'Send Test Email';                ToolTip = 'Send a test email to verify your email settings.';                RunObject = codeunit "Email Test Mail";                RunPageOnRec = true;                Visible = not IsLookupMode;                Enabled = HasEmailAccount;            }            action(MakeDefault)            {                ApplicationArea = All;                Image = Default;                Caption = 'Set as default';                ToolTip = 'Mark the selected email account as the default account. This account will be used for all scenarios for which an account is not specified.';                Visible = (not IsLookupMode) and CanUserManageEmailSetup;                Promoted = true;                PromotedOnly = true;                PromotedCategory = Process;                PromotedIsBig = true;                Scope = Repeater;                Enabled = not IsDefault;                trigger OnAction()                begin                    EmailAccountImpl.MakeDefault(Rec);                    UpdateAccounts := true;                    CurrPage.Update(false);                end;            }            action(SetUpRateLimit)            {                ApplicationArea = All;                Promoted = true;                PromotedOnly = true;                PromotedCategory = Process;                Image = Setup;                Caption = 'Set email rate limit';                ToolTip = 'Sets a limit on how many emails can be sent from the account per minute.';                Visible = (not IsLookupMode) and CanUserManageEmailSetup;                Enabled = HasEmailAccount;                trigger OnAction()                begin                    EmailRateLimitImpl.UpdateRateLimit(Rec);                end;            }            action(Delete)            {                ApplicationArea = All;                Promoted = true;                PromotedOnly = true;                PromotedCategory = Process;                Image = Delete;                Caption = 'Delete email account';                ToolTip = 'Delete the email account.';                Visible = (not IsLookupMode) and CanUserManageEmailSetup;                Scope = Repeater;                trigger OnAction()                begin                    CurrPage.SetSelectionFilter(Rec);                    EmailAccountImpl.OnAfterSetSelectionFilter(Rec);                    EmailAccountImpl.DeleteAccounts(Rec);                    UpdateEmailAccounts();                end;            }        }        area(Navigation)        {            action(Outbox)            {                ApplicationArea = All;                Promoted = true;                PromotedOnly = true;                PromotedCategory = Category4;                Image = CreateJobSalesInvoice;                Caption = 'Email Outbox';                ToolTip = 'View emails for the selected account that are either waiting to be sent, or could not be sent because something went wrong.';                Visible = not IsLookupMode;                trigger OnAction()                var                    EmailOutbox: Page "Email Outbox";                begin                    EmailOutbox.SetEmailAccountId(Rec."Account Id");                    EmailOutbox.Run();                end;            }            action(SentEmails)            {                ApplicationArea = All;                Promoted = true;                PromotedOnly = true;                PromotedCategory = Category4;                Image = Archive;                Caption = 'Sent Emails';                ToolTip = 'View the list of emails that you have sent from the selected email account.';                Visible = not IsLookupMode;                trigger OnAction()                var                    SentEmails: Page "Sent Emails";                begin                    SentEmails.SetEmailAccountId(Rec."Account Id");                    SentEmails.Run();                end;            }            action(EmailScenarioSetup)            {                ApplicationArea = All;                Promoted = true;                PromotedOnly = true;                PromotedCategory = Category4;                Image = Answers;                Caption = 'Email Scenarios';                ToolTip = 'Assign scenarios to the email accounts.';                Visible = not IsLookupMode;                trigger OnAction()                var                    EmailScenarioSetup: Page "Email Scenario Setup";                begin                    EmailScenarioSetup.SetEmailAccountId(Rec."Account Id", Rec.Connector);                    EmailScenarioSetup.Run();                end;            }            action(EmailScenarioAttachments)            {                ApplicationArea = All;                Promoted = true;                PromotedOnly = true;                PromotedCategory = Category4;                Image = Documents;                Caption = 'Email Scenario Attachments';                ToolTip = 'Assign attachments to email scenarios.';                Visible = not IsLookupMode;                RunObject = page "Email Scenario Attach Setup";            }        }    }    trigger OnOpenPage()    var        FeatureTelemetry: Codeunit "Feature Telemetry";    begin        FeatureTelemetry.LogUptake('0000CTA', 'Emailing', Enum::"Feature Uptake Status"::Discovered);        CanUserManageEmailSetup := EmailAccountImpl.IsUserEmailAdmin();        Rec.SetCurrentKey("Account Id", Connector);        UpdateEmailAccounts();    end;    trigger OnAfterGetRecord()    begin        // Updating the accounts is done via OnAfterGetRecord in the cases when an account was changed from the corresponding connector's page        if UpdateAccounts then begin            UpdateAccounts := false;            UpdateEmailAccounts();        end;        RateLimit := EmailRateLimitImpl.GetRateLimit(Rec."Account Id", Rec.Connector, Rec."Email Address");        ConcurrencyLimit := EmailRateLimitImpl.GetConcurrencyLimit(Rec."Account Id", Rec.Connector, Rec."Email Address");        MaxRetryLimit := EmailRateLimitImpl.GetMaxRetryLimit(Rec."Account Id", Rec.Connector, Rec."Email Address");        DefaultTxt := '';        IsDefault := TempDefaultEmailAccount."Account Id" = Rec."Account Id";        if IsDefault then            DefaultTxt := '✓';    end;    local procedure UpdateEmailAccounts()    var        EmailAccount: Codeunit "Email Account";        EmailScenario: Codeunit "Email Scenario";        IsSelected: Boolean;        SelectedAccountId: Guid;    begin        // We need this code block to maintain the same selected record.        SelectedAccountId := Rec."Account Id";        IsSelected := not IsNullGuid(SelectedAccountId);        EmailAccount.GetAllAccounts(true, Rec); // Refresh the email accounts#if not CLEAN28#pragma warning disable AL0432        if V2V3Filter then            FilterToConnectorv2v3Accounts(Rec);        if V3Filter then            FilterToConnectorv3Accounts(Rec);#pragma warning restore AL0432#endif        if V4Filter then            FilterToConnectorv4Accounts(Rec);        EmailScenario.GetDefaultEmailAccount(TempDefaultEmailAccount); // Refresh the default email account        if IsSelected then begin            Rec."Account Id" := SelectedAccountId;            if Rec.Find() then;        end else            if Rec.FindFirst() then;        HasEmailAccount := not Rec.IsEmpty();        CurrPage.Update(false);    end;#if not CLEAN28    [Obsolete('Replaced by FilterToConnectorv4Accounts which only returns v4 accounts.', '28.0')]    local procedure FilterToConnectorv3Accounts(var EmailAccounts: Record "Email Account")    var        IConnector: Interface "Email Connector";    begin        if EmailAccounts.IsEmpty() then            exit;        if EmailAccounts.FindSet() then            repeat                IConnector := EmailAccounts.Connector;                if not (IConnector is "Email Connector v3") then                    EmailAccounts.Delete();            until EmailAccounts.Next() = 0;    end;#endif    local procedure FilterToConnectorv4Accounts(var EmailAccounts: Record "Email Account")    var        IConnector: Interface "Email Connector";    begin        if EmailAccounts.FindSet() then            repeat                IConnector := EmailAccounts.Connector;                if not (IConnector is "Email Connector v4") then                    EmailAccounts.Delete();            until EmailAccounts.Next() = 0;    end;#if not CLEAN28    [Obsolete('Replaced by FilterToConnectorv4Accounts which only returns v4 accounts.', '28.0')]    local procedure FilterToConnectorv2v3Accounts(var EmailAccounts: Record "Email Account")    var        IConnector: Interface "Email Connector";    begin        if EmailAccounts.IsEmpty() then            exit;        repeat            IConnector := EmailAccounts.Connector;#if not CLEAN26#pragma warning disable AL0432            if not (IConnector is "Email Connector v2") and not (IConnector is "Email Connector v3") and not (IConnector is "Email Connector v4") then#pragma warning restore AL0432#else            if not (IConnector is "Email Connector v3") then#endif                EmailAccounts.Delete();        until EmailAccounts.Next() = 0;    end;#endif    local procedure ShowAccountInformation()    var        Connector: Interface "Email Connector";    begin        UpdateAccounts := true;        if not EmailAccountImpl.IsValidConnector(Rec.Connector) then            Error(EmailConnectorHasBeenUninstalledMsg);        Connector := Rec.Connector;        Connector.ShowAccountInformation(Rec."Account Id");    end;    /// <summary>    /// Gets the selected email account.    /// </summary>    /// <param name="EmailAccount">The selected email account</param>    procedure GetAccount(var EmailAccount: Record "Email Account")    begin        EmailAccount := Rec;    end;    /// <summary>    /// Sets an email account to be selected.    /// </summary>    /// <param name="EmailAccount">The email account to be initially selected on the page</param>    procedure SetAccount(var EmailAccount: Record "Email Account")    begin        Rec := EmailAccount;    end;    /// <summary>    /// Enables the lookup mode on the page.    /// </summary>    procedure EnableLookupMode()    begin        IsLookupMode := true;        CurrPage.LookupMode(true);    end;    /// <summary>    /// Sets whether the action to create a new email account is shown.    /// </summary>    /// <param name="Show">True to show the create account action, false to hide it</param>    procedure SetShowCreateAccount(Show: Boolean)    begin        ShowCreateAccount := Show;    end;    /// <summary>    /// Filters the email accounts to only show accounts that are using the Email Connector v2 or v3.    /// </summary>    /// <param name="Filter">True to filter the email accounts, false to show all email accounts</param>#if not CLEAN26    [Obsolete('Replaced by FilterConnectorV3Accounts. In addition, this function now returns both v2 and v3 accounts.', '26.0')]    procedure FilterConnectorV2Accounts(UseFilter: Boolean)    begin        V2V3Filter := UseFilter;    end;#endif    /// <summary>    /// Filters the email accounts to only show accounts that are using the Email Connector v2 or v3.    /// </summary>    /// <param name="UseFilter">True to filter the email accounts, false to show all email accounts</param>    procedure FilterConnectorV3Accounts(UseFilter: Boolean)    begin        V2V3Filter := UseFilter;    end;    /// <summary>    /// Filters the email accounts to only show accounts using the Email Connector v3.    /// </summary>    /// <param name="Version3">Show accounts using the Email Connector v3</param>    procedure FilterConnectorV3AccountsOnly(Version3: Boolean)    begin        V3Filter := Version3;    end;    /// <summary>    /// Filters the email accounts to only show accounts using the Email Connector v4.    /// </summary>    /// <param name="UseFilter"></param>    procedure FilterConnectorV4Accounts(UseFilter: Boolean)    begin        V4Filter := UseFilter;    end;    var        TempDefaultEmailAccount: Record "Email Account";        EmailAccountImpl: Codeunit "Email Account Impl.";        EmailRateLimitImpl: Codeunit "Email Rate Limit Impl.";        IsDefault: Boolean;        RateLimit: Integer;        ConcurrencyLimit: Integer;        MaxRetryLimit: Integer;        CanUserManageEmailSetup: Boolean;        DefaultTxt: Text;        UpdateAccounts: Boolean;        IsLookupMode: Boolean;        ShowCreateAccount: Boolean;        HasEmailAccount: Boolean;        V2V3Filter, V3Filter : Boolean;        V4Filter: Boolean;        EmailConnectorHasBeenUninstalledMsg: Label 'The selected email extension has been uninstalled. To view information about the email account, you must reinstall the extension.';}