Codeunit 5321 Exchange Web Services Server
src/Layers/W1/BaseApp/System/Exchange/ExchangeWebServicesServer.Codeunit.al375 lines, Copyright (c) Microsoft Corporation. MIT
namespace System.Integration;#if not CLEAN28using Microsoft.CRM.Outlook;#endifusing System;using System.Azure.Identity;codeunit 5321 "Exchange Web Services Server"{ trigger OnRun() begin end; var Service: DotNet ExchangeServiceWrapper; ProdEndpointTxt: Label 'https://outlook.office365.com/EWS/Exchange.asmx', Locked = true; CategoryTxt: Label 'AL EWS Server', Locked = true;#if not CLEAN28 ExpiredTokenErr: Label 'Trying to reconnect. Please close and reopen the add-in. Error from the service: %1', Comment = '%1 = the error message from the service.'; ExpiredTokenTxt: Label 'Expired token.', Locked = true;#endif InvalidCredentialsTxt: Label 'Invalid credentials.', Locked = true; InitializedTxt: Label 'Service has been initialized.', Locked = true; NotInitializedTxt: Label 'Service has not been initialized.', Locked = true; ServiceLastErrorTxt: Label 'Service last error: %1.', Locked = true; local procedure InitializeForVersion(AutodiscoveryEmail: Text[250]; var ServiceUri: Text; Credentials: DotNet ExchangeCredentials; Rediscover: Boolean; ExchangeVersion: DotNet ExchangeVersion; Impersonation: Boolean) Result: Boolean var ServiceFactory: DotNet ServiceWrapperFactory; begin if IsNull(Service) then Service := ServiceFactory.CreateServiceWrapperForVersion(ExchangeVersion); if (ServiceUri = '') and not Rediscover then ServiceUri := GetEndpoint(); Service.ExchangeServiceUrl := ServiceUri; if not IsNull(Credentials) then begin Service.SetNetworkCredential(Credentials); if Impersonation then SetImpersonatedIdentity(AutodiscoveryEmail); end; if (Service.ExchangeServiceUrl = '') or Rediscover then begin Result := Service.AutodiscoverServiceUrl(AutodiscoveryEmail); ServiceUri := Service.ExchangeServiceUrl; end else Result := true; if Result then Session.LogMessage('0000D8V', InitializedTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', CategoryTxt) else begin Session.LogMessage('0000D8W', NotInitializedTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', CategoryTxt); LogLastError(); end; end; [Scope('OnPrem')] procedure Initialize(AutodiscoveryEmail: Text[250]; ServiceUri: Text; Credentials: DotNet ExchangeCredentials; Rediscover: Boolean) Result: Boolean var ExchangeVersion: DotNet ExchangeVersion; begin Result := InitializeForVersion(AutodiscoveryEmail, ServiceUri, Credentials, Rediscover, ExchangeVersion.Exchange2013, false); end; [Scope('OnPrem')] procedure InitializeAndValidate(AutodiscoveryEmail: Text[250]; var ServiceUri: Text; Credentials: DotNet ExchangeCredentials) Result: Boolean var ExchangeVersion: DotNet ExchangeVersion; begin if ServiceUri = '' then ServiceUri := GetEndpoint(); if InitializeForVersion(AutodiscoveryEmail, ServiceUri, Credentials, false, ExchangeVersion.Exchange2013, false) then begin Result := ValidCredentials(); // If the email address was not found in the exchange server (404 error) then attempt to discover the exchange service endpoint. if not Result and (StrPos(GetLastErrorText, '404') > 0) then if InitializeForVersion(AutodiscoveryEmail, ServiceUri, Credentials, true, ExchangeVersion.Exchange2013, false) and ValidCredentials() then begin Result := true; ServiceUri := Service.ExchangeServiceUrl; end; end; end; [Scope('OnPrem')] procedure Initialize2010(AutodiscoveryEmail: Text[250]; ServiceUri: Text; Credentials: DotNet ExchangeCredentials; Rediscover: Boolean) Result: Boolean var ExchangeVersion: DotNet ExchangeVersion; begin Result := InitializeForVersion(AutodiscoveryEmail, ServiceUri, Credentials, Rediscover, ExchangeVersion.Exchange2010, false); end; [Scope('OnPrem')] procedure Initialize2010WithUserImpersonation(AutodiscoveryEmail: Text[250]; ServiceUri: Text; Credentials: DotNet ExchangeCredentials; Rediscover: Boolean) Result: Boolean var ExchangeVersion: DotNet ExchangeVersion; begin Result := InitializeForVersion(AutodiscoveryEmail, ServiceUri, Credentials, Rediscover, ExchangeVersion.Exchange2010, true); end; [Scope('OnPrem')] procedure InitializeWithCertificate(ApplicationID: Guid; Thumbprint: Text[40]; AuthenticationEndpoint: Text[250]; ExchangeEndpoint: Text[250]; ResourceUri: Text[250]) var ServiceFactory: DotNet ServiceWrapperFactory; begin Service := ServiceFactory.CreateServiceWrapperWithCertificate(ApplicationID, Thumbprint, AuthenticationEndpoint, ResourceUri); Service.ExchangeServiceUrl := ExchangeEndpoint; end; [Scope('OnPrem')] procedure InitializeWithOAuthToken(Token: SecretText; ExchangeEndpoint: Text) var AzureADMgt: Codeunit "Azure AD Mgt."; begin if ExchangeEndpoint = '' then ExchangeEndpoint := GetEndpoint(); AzureADMgt.CreateExchangeServiceWrapperWithToken(Token, Service); Service.ExchangeServiceUrl := ExchangeEndpoint; end; [TryFunction] [Scope('OnPrem')] procedure ValidCredentials() var AzureADAuthFlow: Codeunit "Azure AD Auth Flow"; begin if AzureADAuthFlow.CanHandle() then if not Service.ValidateCredentials() then begin Session.LogMessage('0000D8X', InvalidCredentialsTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', CategoryTxt); LogLastError(); Error(''); end; end; [Scope('OnPrem')] procedure SetImpersonatedIdentity(Email: Text[250]) begin Service.SetImpersonatedIdentity(Email); end; [Scope('OnPrem')] procedure InstallApp(ManifestPath: InStream) begin Service.InstallApp(ManifestPath); end; [Scope('OnPrem')] procedure CreateAppointment(var Appointment: DotNet IAppointment) begin Appointment := Service.CreateAppointment(); end; [TryFunction] [Scope('OnPrem')] procedure SendEmailMessageWithAttachment(Subject: Text; RecipientAddress: Text; BodyHTML: Text; AttachmentPath: Text; SenderAddress: Text) begin OnBeforeSendEmailMessageWithAttachment(Subject, RecipientAddress, BodyHTML, SenderAddress); Service.SendMessageAndSaveToSentItems(Subject, RecipientAddress, BodyHTML, AttachmentPath, SenderAddress, ''); end; [Scope('OnPrem')] procedure SaveEmailToInbox(EmailMessage: Text) begin Service.SaveEmlMessageToInbox(EmailMessage); end; [Scope('OnPrem')] procedure SaveHTMLEmailToInbox(EmailSubject: Text; EmailBodyHTML: Text; SenderAddress: Text; SenderName: Text; RecipientAddress: Text) begin OnBeforeSaveHTMLEmailToInbox(EmailSubject, EmailBodyHTML, SenderAddress, SenderName, RecipientAddress); Service.SaveHtmlMessageToInbox(EmailSubject, EmailBodyHTML, SenderAddress, SenderName, RecipientAddress); end; [Scope('OnPrem')] procedure GetEmailFolder(FolderId: Text; var Folder: DotNet IEmailFolder): Boolean begin Folder := Service.GetEmailFolder(FolderId); exit(not IsNull(Folder)); end; [Scope('OnPrem')] procedure IdenticalMailExists(SampleMessage: DotNet IEmailMessage; TargetFolder: DotNet IEmailFolder; var TargetMessage: DotNet IEmailMessage): Boolean var FindResults: DotNet IFindEmailsResults; Enumerator: DotNet IEnumerator; FolderOffset: Integer; begin TargetFolder.UseSampleEmailAsFilter(SampleMessage); FolderOffset := 0; repeat FindResults := TargetFolder.FindEmailMessages(50, FolderOffset); if FindResults.TotalCount > 0 then begin Enumerator := FindResults.GetEnumerator(); while Enumerator.MoveNext() do begin TargetMessage := Enumerator.Current; if SampleMessage.Subject = TargetMessage.Subject then if SampleMessage.Body = TargetMessage.Body then if CompareEmailAttachments(SampleMessage, TargetMessage) then exit(true); end; FolderOffset := FindResults.NextPageOffset; end; until not FindResults.MoreAvailable; exit(false); end; [Scope('OnPrem')] procedure CompareEmailAttachments(LeftMsg: DotNet IEmailMessage; RightMsg: DotNet IEmailMessage): Boolean var LeftEnum: DotNet IEnumerator; RightEnum: DotNet IEnumerator; LeftAttrib: DotNet IAttachment; RightAttrib: DotNet IAttachment; LeftFlag: Boolean; RightFlag: Boolean; begin LeftEnum := LeftMsg.Attachments.GetEnumerator(); RightEnum := RightMsg.Attachments.GetEnumerator(); LeftFlag := LeftEnum.MoveNext(); RightFlag := RightEnum.MoveNext(); while LeftFlag and RightFlag do begin LeftAttrib := LeftEnum.Current; RightAttrib := RightEnum.Current; if (LeftAttrib.ContentId <> RightAttrib.ContentId) or (LeftAttrib.ContentType <> RightAttrib.ContentType) then exit(false); LeftFlag := LeftEnum.MoveNext(); RightFlag := RightEnum.MoveNext(); end; exit(LeftFlag = RightFlag); end;#if not CLEAN28 [Obsolete('Please use Microsoft Graph API instead e.g `Email - Outlook REST API`', '28.0')] [TryFunction] local procedure TryGetEmailWithAttachments(var EmailMessage: DotNet IEmailMessage; ItemID: Text[250]) begin EmailMessage := Service.GetEmailWithAttachments(ItemID); end; [Obsolete('Please use Microsoft Graph API instead e.g `Email - Outlook REST API`', '28.0')] [Scope('OnPrem')] procedure GetEmailAndAttachments(ItemID: Text[250]; var TempExchangeObject: Record "Exchange Object" temporary; "Action": Option InitiateSendToOCR,InitiateSendToIncomingDocuments,InitiateSendToWorkFlow,IntiateSendToAttachments; RecRef: RecordRef) var EmailMessage: DotNet IEmailMessage; Attachments: DotNet IEnumerable; Attachment: DotNet IAttachment; begin if TryGetEmailWithAttachments(EmailMessage, ItemID) then begin if not IsNull(EmailMessage) then begin TempExchangeObject.Init(); TempExchangeObject.Validate("Item ID", EmailMessage.Id); TempExchangeObject.Validate(Type, TempExchangeObject.Type::Email); TempExchangeObject.Validate(Name, EmailMessage.Subject); TempExchangeObject.Validate(Owner, UserSecurityId()); TempExchangeObject.SetBody(EmailMessage.TextBody); TempExchangeObject.SetContent(EmailMessage.Content); TempExchangeObject.SetViewLink(EmailMessage.LinkUrl); if not TempExchangeObject.Insert(true) then TempExchangeObject.Modify(true); Attachments := EmailMessage.Attachments; foreach Attachment in Attachments do begin TempExchangeObject.Init(); TempExchangeObject.Validate(Type, TempExchangeObject.Type::Attachment); TempExchangeObject.Validate("Item ID", Attachment.Id); TempExchangeObject.Validate(Name, Attachment.Name); TempExchangeObject.Validate("Parent ID", EmailMessage.Id); TempExchangeObject.Validate("Content Type", Attachment.ContentType); TempExchangeObject.Validate(InitiatedAction, Action); TempExchangeObject.Validate(IsInline, Attachment.IsInline); TempExchangeObject.Validate(RecId, RecRef.RecordId()); TempExchangeObject.SetContent(Attachment.Content); if not TempExchangeObject.Insert(true) then TempExchangeObject.Modify(true); end; end else begin Session.LogMessage('0000D8Y', ExpiredTokenTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', CategoryTxt); Error(ExpiredTokenErr, Service.LastError); end; end else begin Session.LogMessage('0000D8Z', ExpiredTokenTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', CategoryTxt); Error(ExpiredTokenErr, Service.LastError); end; end; [Obsolete('Please use Microsoft Graph API instead e.g `Email - Outlook REST API`', '28.0')] [Scope('OnPrem')] procedure GetEmailBody(ItemID: Text[250]) EmailBody: Text var EmailMessage: DotNet IEmailMessage; begin if TryGetEmailWithAttachments(EmailMessage, ItemID) and not IsNull(EmailMessage) then EmailBody := EmailMessage.TextBody else begin Session.LogMessage('0000D90', ExpiredTokenTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', CategoryTxt); Error(ExpiredTokenErr, Service.LastError); end; end; [Obsolete('Please use Microsoft Graph API instead e.g `Email - Outlook REST API`', '28.0')] [TryFunction] local procedure TryEmailHasAttachments(var HasAttachments: Boolean; ItemID: Text[250]) begin HasAttachments := Service.AttachmentsExists(ItemID); end; [Obsolete('Please use Microsoft Graph API instead e.g `Email - Outlook REST API`', '28.0')] [Scope('OnPrem')] procedure EmailHasAttachments(ItemID: Text[250]): Boolean var HasAttachments: Boolean; begin if not TryEmailHasAttachments(HasAttachments, ItemID) then exit(false); exit(HasAttachments) end;#endif procedure GetEndpoint() Endpoint: Text begin Endpoint := ProdEndpoint(); end; procedure ProdEndpoint() ProdEndpointText: Text begin ProdEndpointText := ProdEndpointTxt; OnAfterGetProdEndpoint(ProdEndpointText); end; procedure IsDefaultProdEndpoint(Endpoint: Text): Boolean begin exit(Endpoint = ProdEndpointTxt); end; [Scope('OnPrem')] procedure GetCurrentUserTimeZone(): Text begin exit(Service.GetExchangeUserTimeZone()); end; local procedure LogLastError() var LastError: Text; begin LastError := Service.LastError(); if LastError <> '' then Session.LogMessage('0000F63', StrSubstNo(ServiceLastErrorTxt, LastError), Verbosity::Warning, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', CategoryTxt); end; [IntegrationEvent(false, false)] local procedure OnBeforeSaveHTMLEmailToInbox(var EmailSubject: Text; var EmailBodyHTML: Text; var SenderAddress: Text; var SenderName: Text; var RecipientAddress: Text) begin end; [IntegrationEvent(false, false)] local procedure OnBeforeSendEmailMessageWithAttachment(var Subject: Text; var RecipientAddress: Text; var BodyHTML: Text; var SenderAddress: Text) begin end; [IntegrationEvent(false, false)] local procedure OnAfterGetProdEndpoint(var ProdEndPointText: Text) begin end;}