{"title":"Codeunit 9520 Mail Management, changes","url":"https://jonas-paprotka.de/ref/codeunit/9520-mail-management/changes/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":9520,"name":"Mail Management","app":"Base Application","versions":"17-29","url":"https://jonas-paprotka.de/ref/codeunit/9520-mail-management/","json":"https://jonas-paprotka.de/ref/codeunit/9520-mail-management.json"},"aspect":"changes","total":39,"rows":[{"version":27,"kind":"event","change":"marked","name":"OnBeforeSendMailOnWinClient","member":{"name":"OnBeforeSendMailOnWinClient","sig":"(var Record Email Item)","named":"(var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"This event is never raised.","tag":"27.0"}}},{"version":27,"kind":"event","change":"marked","name":"OnAfterDeleteTempAttachments","member":{"name":"OnAfterDeleteTempAttachments","sig":"(var Record Email Item)","named":"(var EmailItem: Record \"Email Item\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"This event is never raised.","tag":"27.0"}}},{"version":24,"kind":"procedure","change":"gone","name":"GetLastGraphError","member":{"name":"GetLastGraphError","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Microsoft Invoicing has been discontinued.","tag":"21.0"}}},{"version":24,"kind":"procedure","change":"gone","name":"IsGraphEnabled","member":{"name":"IsGraphEnabled","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Microsoft Invoicing has been discontinued.","tag":"21.0"}}},{"version":24,"kind":"procedure","change":"gone","name":"Send","member":{"name":"Send","sig":"(Record Email Item)","named":"(ParmEmailItem: Record \"Email Item\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the overload containing Email Scenario","tag":"17.0"}}},{"version":24,"kind":"procedure","change":"gone","name":"SendMailOrDownload","member":{"name":"SendMailOrDownload","sig":"(Record Email Item, Boolean)","named":"(TempEmailItem: Record \"Email Item\" temporary; HideMailDialog: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the overload containing Email Scenario","tag":"17.0"}}},{"version":24,"kind":"event","change":"added","name":"OnSendViaEmailModuleOnBeforeOpenInEditorModally","member":{"name":"OnSendViaEmailModuleOnBeforeOpenInEditorModally","sig":"(Enum Email Scenario, var Record Email Account, var Codeunit Email Message, var Boolean)","named":"(EmailScenario: Enum \"Email Scenario\"; var TempEmailAccount: Record \"Email Account\" temporary; var Message: Codeunit \"Email Message\"; var HideMailDialog: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":23,"kind":"procedure","change":"added","name":"Send","member":{"name":"Send","sig":"(var Record Email Item, Enum Email Scenario, Boolean)","named":"(var ParmEmailItem: Record \"Email Item\"; EmailScenario: Enum \"Email Scenario\"; Enqueue: Boolean)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":23,"kind":"procedure","change":"added","name":"SendMailOrDownload","member":{"name":"SendMailOrDownload","sig":"(var Record Email Item, Boolean, Enum Email Scenario, Boolean)","named":"(var TempEmailItem: Record \"Email Item\" temporary; HideMailDialog: Boolean; EmailScenario: Enum \"Email Scenario\"; Enqueue: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":23,"kind":"event","change":"gone","name":"OnBeforeRunMailDialog","member":{"name":"OnBeforeRunMailDialog","sig":"(var Record Email Item, Boolean, Boolean, var Boolean, var Boolean, var Boolean, var Boolean)","named":"(var TempEmailItem: Record \"Email Item\"; OutlookSupported: Boolean; SMTPSupported: Boolean; var ReturnValue: Boolean; var IsHandled: Boolean; var DoEdit: Boolean; var Cancelled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"Email dialog has been removed, event no longer relevant.","tag":"20.0"}}},{"version":23,"kind":"event","change":"gone","name":"OnAfterGetAttachmentName","member":{"name":"OnAfterGetAttachmentName","sig":"(List, Integer, var Text[250])","named":"(AttachmentNames: List of [Text]; Index: Integer; var AttachmentName: Text[250])","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":23,"kind":"event","change":"added","name":"OnAfterGetAttachmentName","member":{"name":"OnAfterGetAttachmentName","sig":"(List, Integer, var Text[250], var Record Email Item)","named":"(AttachmentNames: List of [Text]; Index: Integer; var AttachmentName: Text[250]; var TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":23,"kind":"event","change":"added","name":"OnBeforeSendViaEmailModule","member":{"name":"OnBeforeSendViaEmailModule","sig":"(var Record Email Item, Enum Email Scenario, var Record Email Account, Boolean, var Boolean, var Boolean)","named":"(var TempEmailItem: Record \"Email Item\" temporary; EmailScenario: Enum \"Email Scenario\"; var TempEmailAccount: Record \"Email Account\" temporary; HideMailDialog: Boolean; var IsHandled: Boolean; var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":23,"kind":"event","change":"added","name":"OnAfterDownloadPDFAttachment","member":{"name":"OnAfterDownloadPDFAttachment","sig":"()","named":"()","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":21,"kind":"procedure","change":"marked","name":"GetLastGraphError","member":{"name":"GetLastGraphError","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Microsoft Invoicing has been discontinued.","tag":"21.0"}}},{"version":21,"kind":"procedure","change":"marked","name":"IsGraphEnabled","member":{"name":"IsGraphEnabled","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Microsoft Invoicing has been discontinued.","tag":"21.0"}}},{"version":21,"kind":"event","change":"added","name":"OnAfterIsBackground","member":{"name":"OnAfterIsBackground","sig":"(var Boolean)","named":"(var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":21,"kind":"event","change":"added","name":"OnAfterGetAttachmentName","member":{"name":"OnAfterGetAttachmentName","sig":"(List, Integer, var Text[250])","named":"(AttachmentNames: List of [Text]; Index: Integer; var AttachmentName: Text[250])","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":20,"kind":"procedure","change":"gone","name":"SetHideSMTPError","member":{"name":"SetHideSMTPError","sig":"(Boolean)","named":"(NewHideSMTPError: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the SetHideEmailSendingError function","tag":"17.0"}}},{"version":20,"kind":"procedure","change":"gone","name":"IsSMTPEnabled","member":{"name":"IsSMTPEnabled","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Replaced with the IsAnyAccountRegistered in \"Email Account\" codeunit from \"System Application\".","tag":"17.0"}}},{"version":20,"kind":"procedure","change":"gone","name":"GetSenderEmailAddress","member":{"name":"GetSenderEmailAddress","sig":"()","named":"()","returns":"Text[250]","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Sender will be chosen based on the scenario parameter to the Send function when using the email feature is enabled. To control which account will be used, use the overload containing Email Scenario.","tag":"17.0"}}},{"version":20,"kind":"procedure","change":"gone","name":"GetSMTPCredentials","member":{"name":"GetSMTPCredentials","sig":"(var Record SMTP Mail Setup)","named":"(var SMTPMailSetup: Record \"SMTP Mail Setup\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Not needed once email feature is enabled.","tag":"17.0"}}},{"version":20,"kind":"event","change":"gone","name":"OnAfterSentViaSMTP","member":{"name":"OnAfterSentViaSMTP","sig":"(var Record Email Item, var Codeunit SMTP Mail, var Boolean, Boolean)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\"; var MailSent: Boolean; HideSMTPError: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"}}},{"version":20,"kind":"event","change":"marked","name":"OnBeforeRunMailDialog","member":{"name":"OnBeforeRunMailDialog","sig":"(var Record Email Item, Boolean, Boolean, var Boolean, var Boolean, var Boolean, var Boolean)","named":"(var TempEmailItem: Record \"Email Item\"; OutlookSupported: Boolean; SMTPSupported: Boolean; var ReturnValue: Boolean; var IsHandled: Boolean; var DoEdit: Boolean; var Cancelled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"Email dialog has been removed, event no longer relevant.","tag":"20.0"}}},{"version":20,"kind":"event","change":"gone","name":"OnBeforeSentViaSMTP","member":{"name":"OnBeforeSentViaSMTP","sig":"(var Record Email Item, var Codeunit SMTP Mail)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"}}},{"version":20,"kind":"event","change":"gone","name":"OnSendViaSMTPOnBeforeSMTPMailAddAttachment","member":{"name":"OnSendViaSMTPOnBeforeSMTPMailAddAttachment","sig":"(var Record Email Item, var Codeunit SMTP Mail)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"}}},{"version":19,"kind":"procedure","change":"added","name":"AddSendTo","member":{"name":"AddSendTo","sig":"(Text)","named":"(EmailAddresses: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":19,"kind":"event","change":"marked","name":"OnAfterSentViaSMTP","member":{"name":"OnAfterSentViaSMTP","sig":"(var Record Email Item, var Codeunit SMTP Mail, var Boolean, Boolean)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\"; var MailSent: Boolean; HideSMTPError: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"}}},{"version":19,"kind":"event","change":"marked","name":"OnBeforeSentViaSMTP","member":{"name":"OnBeforeSentViaSMTP","sig":"(var Record Email Item, var Codeunit SMTP Mail)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"}}},{"version":19,"kind":"event","change":"marked","name":"OnSendViaSMTPOnBeforeSMTPMailAddAttachment","member":{"name":"OnSendViaSMTPOnBeforeSMTPMailAddAttachment","sig":"(var Record Email Item, var Codeunit SMTP Mail)","named":"(var TempEmailItem: Record \"Email Item\" temporary; var SMTPMail: Codeunit \"SMTP Mail\")","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"SMTP Mail codeunit has been obsolete","tag":"19.3"}}},{"version":19,"kind":"event","change":"added","name":"OnSetIsHandlingGetEmailBodyCustomer","member":{"name":"OnSetIsHandlingGetEmailBodyCustomer","sig":"(var Boolean)","named":"(var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":19,"kind":"event","change":"added","name":"OnSetIsHandlingGetEmailBodyVendor","member":{"name":"OnSetIsHandlingGetEmailBodyVendor","sig":"(var Boolean)","named":"(var Result: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":18,"kind":"procedure","change":"added","name":"AddSource","member":{"name":"AddSource","sig":"(Integer, Guid)","named":"(TableId: Integer; SystemId: Guid)","returns":"","kind":"procedure","access":"public","obsolete":null}},{"version":18,"kind":"event","change":"gone","name":"OnBeforeCheckValidEmailAddress","member":{"name":"OnBeforeCheckValidEmailAddress","sig":"(Text, var Boolean)","named":"(Recipients: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"Replaced by event OnBeforeCheckValidEmailAddresses","tag":"15.3"}}},{"version":18,"kind":"event","change":"gone","name":"OnSendMailOrDownloadOnBeforeMailManagementIsSent","member":{"name":"OnSendMailOrDownloadOnBeforeMailManagementIsSent","sig":"(var Codeunit Mail Management)","named":"(var MailManagement: Codeunit \"Mail Management\")","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":18,"kind":"event","change":"added","name":"OnBeforeIsEnabled","member":{"name":"OnBeforeIsEnabled","sig":"(Boolean, var Boolean, var Boolean)","named":"(OutlookSupported: Boolean; var Result: Boolean; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":18,"kind":"event","change":"added","name":"OnQualifyFromAddressOnAfterGetEmailAccount","member":{"name":"OnQualifyFromAddressOnAfterGetEmailAccount","sig":"(var Record Email Item, Enum Email Scenario, var Record Email Account)","named":"(var TempEmailItem: Record \"Email Item\" temporary; EmailScenario: Enum \"Email Scenario\"; var TempEmailAccount: Record \"Email Account\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":18,"kind":"event","change":"added","name":"OnSendMailOrDownloadOnBeforeMailManagementIsSent","member":{"name":"OnSendMailOrDownloadOnBeforeMailManagementIsSent","sig":"(var Codeunit Mail Management, Record Email Item)","named":"(var MailManagement: Codeunit \"Mail Management\"; TempEmailItem: Record \"Email Item\" temporary)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":18,"kind":"event","change":"added","name":"OnSendViaEmailModuleOnAfterEmailSend","member":{"name":"OnSendViaEmailModuleOnAfterEmailSend","sig":"(var Codeunit Email Message, var Record Email Item, var Boolean, var Boolean, var Boolean)","named":"(var Message: Codeunit \"Email Message\"; var TempEmailItem: Record \"Email Item\" temporary; var MailSent: Boolean; var Cancelled: Boolean; var HideEmailSendingError: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}}]}