Codeunit 5323 Exchange Add-in Setup

Base Application, System.Integration

src/Layers/W1/BaseApp/System/Exchange/ExchangeAddinSetup.Codeunit.al258 lines, Copyright (c) Microsoft Corporation. MIT

#if not CLEAN29namespace System.Integration;using Microsoft.CRm.BusinessRelation;using Microsoft.CRM.Contact;using Microsoft.CRM.Outlook;using Microsoft.Foundation.Company;using Microsoft.Utilities;using System;using System.Azure.Identity;using System.Environment;using System.Security.AccessControl;using System.Security.User;codeunit 5323 "Exchange Add-in Setup"{    ObsoleteReason = 'Exchange is depracated. Please deploy add-in manually.';    ObsoleteState = Pending;    ObsoleteTag = '29.0';    trigger OnRun()    begin    end;    var        ExchangeWebServicesServer: Codeunit "Exchange Web Services Server";        AddinManifestManagement: Codeunit "Add-in Manifest Management";        Initialized: Boolean;        InvalidCredentialsErr: Label 'The provided email address and password are not valid Office 365 or Exchange credentials.';        NoMailboxErr: Label 'An Office 365 or Exchange mailbox could not be found for this account.';        AutodiscoverMsg: Label 'Searching for your mailbox.';        WelcomeSubjectTxt: Label 'Welcome to %1 in Outlook', Comment = '%1 - Application name';        WelcomeEmailFromNameTxt: Label '%1 Admin', Comment = '%1 - Application Name';        SalesEmailAddrTxt: Label 'admin@contoso.com', Locked = true;        ExchangeTelemetryCategoryTxt: Label 'AL Exchange', Locked = true;        TryInitializeWithEmailTxt: Label 'Trying to initialize the service with email.', Locked = true;        TryInitializeWithCredentialsTxt: Label 'Trying to initialize the service with credentials.', Locked = true;        InitializedWithOAuthTokenTxt: Label 'The service is initialized with OAuth token.', Locked = true;        InitializedWithCertificateTxt: Label 'The service is initialized with certificate.', Locked = true;        InitializedWithCredentialsTxt: Label 'The service is initialized with credentials.', Locked = true;        NotInitializedWithCredentialsTxt: Label 'The service is not initialized with credentials.', Locked = true;        TryAutodiscoverEndpointTxt: Label 'Try to autodiscover endpoint.', Locked = true;        ImpersonateUserTxt: Label 'Impersonate user.', Locked = true;        DeployAddInTxt: Label 'Deploy add-in.', Locked = true;        DeploySampleEmailsTxt: Label 'Deploy sample emails.', Locked = true;        SampleEmailsDeployedTxt: Label 'sample emails are deployed.', Locked = true;        ValidCredentialsTxt: Label 'The provided email address and password are valid Office 365 or Exchange credentials.', Locked = true;        InvalidCredentialsTxt: Label 'The provided email address and password are not valid Office 365 or Exchange credentials.', Locked = true;        NoMailboxTxt: Label 'An Office 365 or Exchange mailbox could not be found for this account.', Locked = true;        ToSpecifiedEmailTxt: Label 'Recipient email is the specified email.', Locked = true;        ToUserEmailTxt: Label 'Recipient email is the user email.', Locked = true;        FromContactEmailTxt: Label 'Sender email is the contact email.', Locked = true;        FromSalesEmailTxt: Label 'Sender email is the sales email.', Locked = true;        DemoCompanyEmailTxt: Label 'trey.research@contoso.com', Locked = true;    [TryFunction]    local procedure Initialize(AuthenticationEmail: Text[80])    var        ExchangeServiceSetup: Record "Exchange Service Setup";        AzureADMgt: Codeunit "Azure AD Mgt.";        AccessToken: SecretText;    begin        Session.LogMessage('0000BX8', TryInitializeWithEmailTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);        AccessToken := AzureADMgt.GetAccessTokenAsSecretText(AzureADMgt.GetO365Resource(), AzureADMgt.GetO365ResourceName(), false);        if not AccessToken.IsEmpty() then begin            ExchangeWebServicesServer.InitializeWithOAuthToken(AccessToken, ExchangeWebServicesServer.GetEndpoint());            if ValidateCredentials() then begin                Session.LogMessage('0000BX9', InitializedWithOAuthTokenTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);                exit;            end;        end;        ExchangeServiceSetup.Get();        ExchangeWebServicesServer.InitializeWithCertificate(ExchangeServiceSetup."Azure AD App. ID", ExchangeServiceSetup."Azure AD App. Cert. Thumbprint",              ExchangeServiceSetup."Azure AD Auth. Endpoint", ExchangeServiceSetup."Exchange Service Endpoint", ExchangeServiceSetup."Exchange Resource Uri");        ExchangeWebServicesServer.SetImpersonatedIdentity(AuthenticationEmail);        Initialized := true;        Session.LogMessage('0000BYR', InitializedWithCertificateTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);    end;    [TryFunction]    [Scope('OnPrem')]    procedure InitializeServiceWithCredentials(Email: Text[80]; Password: Text)    var        WebCredentials: DotNet WebCredentials;        ProgressWindow: Dialog;        ErrorText: Text;    begin        Session.LogMessage('0000BXA', TryInitializeWithCredentialsTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);        WebCredentials := WebCredentials.WebCredentials(Email, Password);        ProgressWindow.Open('#1');        ProgressWindow.Update(1, AutodiscoverMsg);        // Production O365 endpoint        Initialized := ExchangeWebServicesServer.Initialize(Email, ExchangeWebServicesServer.GetEndpoint(), WebCredentials, false) and          ValidateCredentials();        ErrorText := GetLastErrorText;        // Autodiscover endpoint (can be slow)        if not Initialized then begin            Session.LogMessage('0000BXB', TryAutodiscoverEndpointTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);            Initialized := ExchangeWebServicesServer.Initialize(Email, '', WebCredentials, true) and ValidateCredentials();            ErrorText := GetLastErrorText;        end;        ProgressWindow.Close();        if not Initialized then begin            Session.LogMessage('0000BXC', NotInitializedWithCredentialsTxt, Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);            Error(ErrorText);        end;        Session.LogMessage('0000BXD', InitializedWithCredentialsTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);    end;    [Scope('OnPrem')]    procedure CredentialsRequired(AuthenticationEmail: Text[80]) Required: Boolean    begin        Required := not Initialize(AuthenticationEmail);    end;    [Scope('OnPrem')]    procedure ImpersonateUser(Email: Text[80])    begin        Session.LogMessage('0000BXI', ImpersonateUserTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);        if not Initialized then            Initialize(Email);        ExchangeWebServicesServer.SetImpersonatedIdentity(Email);    end;    procedure SampleEmailsAvailable(): Boolean    var        CompanyInformationMgt: Codeunit "Company Information Mgt.";        EnvironmentInfo: Codeunit "Environment Information";    begin        exit(CompanyInformationMgt.IsDemoCompany() and EnvironmentInfo.IsSaaS());    end;    [Scope('OnPrem')]    procedure DeployAddin(OfficeAddin: Record "Office Add-in")    var        UserPreference: Record "User Preference";        InstructionMgt: Codeunit "Instruction Mgt.";        Stream: DotNet MemoryStream;        Encoding: DotNet UTF8Encoding;        ManifestText: Text;    begin        Session.LogMessage('0000BXJ', DeployAddInTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);        AddinManifestManagement.GenerateManifest(OfficeAddin, ManifestText);        Encoding := Encoding.UTF8Encoding();        Stream := Stream.MemoryStream(Encoding.GetBytes(ManifestText));        ExchangeWebServicesServer.InstallApp(Stream);        UserPreference.SetRange("Instruction Code", InstructionMgt.OfficeUpdateNotificationCode());        UserPreference.SetRange("User ID", UserId);        UserPreference.DeleteAll();    end;    [Scope('OnPrem')]    procedure DeployAddins(var OfficeAddin: Record "Office Add-in")    begin        if OfficeAddin.GetAddins() then            repeat                DeployAddin(OfficeAddin);            until OfficeAddin.Next() = 0;    end;    [TryFunction]    [Scope('OnPrem')]    procedure TryDeployAddins(var OfficeAddin: Record "Office Add-in")    begin        DeployAddins(OfficeAddin);    end;    [Scope('OnPrem')]    procedure DeploySampleEmails(EmailAddress: Text)    var        User: Record User;        OfficeAddinSampleEmails: Codeunit "Office Add-In Sample Emails";        RecipientEmail: Text;        FromEmail: Text;        HTMlBody: Text;    begin        Session.LogMessage('0000BXK', DeploySampleEmailsTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);        if EmailAddress <> '' then begin            Session.LogMessage('0000BXL', ToSpecifiedEmailTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);            RecipientEmail := EmailAddress        end else begin            User.SetRange("User Name", UserId);            if User.FindFirst() then begin                Session.LogMessage('0000BXM', ToUserEmailTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);                RecipientEmail := User."Authentication Email";            end;        end;        FromEmail := GetFromEmail();        if FromEmail <> '' then            Session.LogMessage('0000BXN', FromContactEmailTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt)        else begin            // Fallback to SalesEmailAddrTxt            FromEmail := SalesEmailAddrTxt;            Session.LogMessage('0000BYS', FromSalesEmailTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);        end;        HTMlBody := OfficeAddinSampleEmails.GetHTMLSampleMsg();        ExchangeWebServicesServer.SaveHTMLEmailToInbox(StrSubstNo(WelcomeSubjectTxt, PRODUCTNAME.Marketing()), HTMlBody,          FromEmail, StrSubstNo(WelcomeEmailFromNameTxt, PRODUCTNAME.Full()), RecipientEmail);        Session.LogMessage('0000BXO', SampleEmailsDeployedTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);    end;    [TryFunction]    local procedure ValidateCredentials()    begin        if not ExchangeWebServicesServer.ValidCredentials() then begin            if StrPos(GetLastErrorText, '401') > 0 then begin                Session.LogMessage('0000BXP', InvalidCredentialsTxt, Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);                Error(InvalidCredentialsErr);            end;            Session.LogMessage('0000BXQ', NoMailboxTxt, Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);            Error(NoMailboxErr);        end;        Session.LogMessage('0000BXR', ValidCredentialsTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', ExchangeTelemetryCategoryTxt);    end;    local procedure GetFromEmail(): Text    var        ContactBusinessRelation: Record "Contact Business Relation";        Contact: Record Contact;        FirstContactEmail: Text;    begin        ContactBusinessRelation.SetRange("Link to Table", ContactBusinessRelation."Link to Table"::Customer);        if ContactBusinessRelation.FindSet() then            repeat                if Contact.Get(ContactBusinessRelation."Contact No.") then begin                    if (FirstContactEmail = '') and (Contact."E-Mail" <> '') then                        FirstContactEmail := Contact."E-Mail";                    if Contact."E-Mail" = DemoCompanyEmailTxt then                        exit(Contact."E-Mail");                end;            until ContactBusinessRelation.Next() = 0;        if FirstContactEmail <> '' then            exit(FirstContactEmail);    end;}#endif