Interface Email Connector v4

// ------------------------------------------------------------------------------------------------
// 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;

/// <summary>
/// An e-mail connector interface enhances the "Email Connector" with reading, replying to e-mails and marking emails as read.
/// </summary>
interface "Email Connector v4" extends "Email Connector"
{
    /// <summary>
    /// Reply to an e-mail using the provided account.
    /// </summary>
    /// <param name="EmailMessage">The email message that is to be sent out.</param>
    /// <param name="AccountId">The email account ID which is used to send out the email.</param>
    procedure Reply(var EmailMessage: Codeunit "Email Message"; AccountId: Guid);

    /// <summary>
    /// Read e-mails from the provided account.
    /// </summary>
    /// <param name="AccountId">The email account ID which is used to send out the email.</param>
    /// <param name="EmailInbox">The email inbox record that will store the emails.</param>
    /// <param name="Filters">Filters to be used when retrieving emails.</param>
    procedure RetrieveEmails(AccountId: Guid; var EmailInbox: Record "Email Inbox"; var Filters: Record "Email Retrieval Filters" temporary);

    /// <summary>
    /// Mark an e-mail as read in the provided account.
    /// </summary>
    /// <param name="AccountId">The email account ID.</param>
    /// <param name="ExternalId">The external ID of the email.</param>
    procedure MarkAsRead(AccountId: Guid; ExternalId: Text);

    /// <summary>
    /// Get email folders from the provided account.
    /// </summary>
    /// <param name="AccountId">The email account ID.</param>
    /// <param name="EmailFolders">The email folders retrieved.</param>
    procedure GetEmailFolders(AccountId: Guid; var EmailFolders: Record "Email Folders" temporary);
}