Codeunit 1410 Doc. Exch. Service Mgt.

Base Application, Microsoft.EServices.EDocument

src/Layers/W1/BaseApp/eServices/EDocument/DocExchServiceMgt.Codeunit.al1,748 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 Microsoft.EServices.EDocument;using Microsoft.Purchases.Document;using Microsoft.Sales.History;using Microsoft.Utilities;using System;using System.Azure.KeyVault;using System.Environment;using System.Integration;using System.IO;using System.Security.Authentication;using System.Telemetry;using System.Utilities;using System.Xml;codeunit 1410 "Doc. Exch. Service Mgt."{    Permissions = TableData "Sales Invoice Header" = rm,                  TableData "Sales Cr.Memo Header" = rm;    trigger OnRun()    begin    end;    var        TempBlobResponse: Codeunit "Temp Blob";        TempBlobTrace: Codeunit "Temp Blob";        Trace: Codeunit Trace;        HttpWebRequestMgt: Codeunit "Http Web Request Mgt.";        DocExchLinks: Codeunit "Doc. Exch. Links";        XMLDOMMgt: Codeunit "XML DOM Management";        EnvironmentInfo: Codeunit "Environment Information";        GLBResponseInStream: InStream;        GLBHttpStatusCode: DotNet HttpStatusCode;        GLBResponseHeaders: DotNet NameValueCollection;        GLBLastUsedGUID: Text;        GLBTraceLogEnabled: Boolean;        NotConfiguredQst: Label 'The connection to the document exchange service is not configured. Do you want to open the %1 page to set it up?', Comment = '%1 - page caption';        NotConfiguredErr: Label 'You must configure the connection to the document exchange service on the %1 page.', Comment = '%1 - page caption';        ConnectionSuccessMsg: Label 'The connection test was successful. The settings are valid.';        DocSendSuccessMsg: Label 'The document was successfully sent to the document exchange service for processing.', Comment = '%1 is the actual document no.';        DocUploadSuccessMsg: Label 'The document was successfully uploaded to the document exchange service for processing.', Comment = '%1 is the actual document no.';        DocDispatchSuccessMsg: Label 'The document was successfully sent for dispatching.', Comment = '%1 is the actual document no.';        DocDispatchFailedMsg: Label 'The document was not successfully dispatched. ', Comment = '%1 is the actual document no.';        DocStatusOKMsg: Label 'The current status of the electronic document is %1.', Comment = '%1 is the returned value.';        NotSetUpTxt: Label 'The document exchange service is not set up.';        NotEnabledTxt: Label 'The document exchange service is not enabled.';        RenewTokenTxt: Label 'Renew token';        CheckConnectionTxt: Label 'Check connection.';        SendDocTxt: Label 'Send document.';        DispatchDocTxt: Label 'Dispatch document.';        GetDocStatusTxt: Label 'Check document status.';        GetDocsTxt: Label 'Get received documents.';        LoggingConstTxt: Label 'Document exchange service.';        GetDocErrorTxt: Label 'Check document dispatch errors.';        MarkBusinessProcessedTxt: Label 'Mark as Business Processed.';        DocIdImportedTxt: Label 'The document ID %1 is imported into incoming documents.', Comment = '%1 is the actual doc id.';        FileInvalidTxt: Label 'The document ID %1 is not a valid XML format. ', Comment = '%1 is the actual doc id';        UnSupportedTableTypeErr: Label 'The %1 table is not supported.', Comment = '%1 is the table.';        InvalidHeaderResponseMsg: Label 'The document exchange service did not return a document identifier.';        CannotResendErr: Label 'You cannot send this electronic document because it is already delivered or in progress.';        MalformedGuidErr: Label 'The document exchange service did not return a valid document identifier.';        DocExchServiceDocumentSuccessfullySentTxt: Label 'The user successfully sent a document via the exchange service.', Locked = true;        DocExchServiceDocumentSuccessfullyReceivedTxt: Label 'The user successfully received a document via the exchange service.', Locked = true;        TelemetryCategoryTok: Label 'AL Document Exchange Service', Locked = true;        MethodGetTxt: Label 'GET', Locked = true;        MethodPostTxt: Label 'POST', Locked = true;        MethodPutTxt: Label 'PUT', Locked = true;        TextXmlTxt: Label 'text/xml', Locked = true;        ApplicationJsonTxt: Label 'application/json', Locked = true;        ApplicationFormTxt: Label 'application/x-www-form-urlencoded', Locked = true;        EncodingUtf8Txt: Label 'utf-8', Locked = true;        AcceptEncodingHeaderNameTxt: Label 'Accept-Encoding', Locked = true;        AuthorizationHeaderNameTxt: Label 'Authorization', Locked = true;        AuthorizationHeaderValueTxt: Label 'Bearer %1', Locked = true;        AuthorizationCodeRequestUrlTxt: Label '%1?client_id=%2&redirect_uri=%3&response_type=code&scope=%4&state=%5', Locked = true;        AuthorizationCodeRequestBodyTxt: label 'grant_type=authorization_code&client_id=%1&client_secret=%2&code=%3&redirect_uri=%4', Locked = true;        RefreshTokenRequestBodyTxt: Label 'grant_type=refresh_token&client_id=%1&client_secret=%2&refresh_token=%3&scope=%4', Locked = true;        ClientIdAKVSecretNameProdTxt: Label 'DocExchClientIdProd', Locked = true;        ClientSecretAKVSecretNameProdTxt: Label 'DocExchClientSecretProd', Locked = true;        ClientIdAKVSecretNameSandboxTxt: Label 'DocExchClientIdTest', Locked = true;        ClientSecretAKVSecretNameSandboxTxt: Label 'DocExchClientSecretTest', Locked = true;        AuthCodeScopeTxt: Label 'openid offline', Locked = true;        AccessTokenParamNameTxt: Label 'access_token', Locked = true;        RefreshTokenParamNameTxt: Label 'refresh_token', Locked = true;        IdTokenParamNameTxt: Label 'id_token', Locked = true;        TokenTypeParamNameTxt: Label 'token_type', Locked = true;        ExpiresInParamNameTxt: Label 'expires_in', Locked = true;        ClientIdParamNameTxt: Label 'client_id', Locked = true;        AudienceParamNameTxt: Label 'aud', Locked = true;        IssuerParamNameTxt: Label 'iss', Locked = true;        TokenTypeBearerTxt: Label 'Bearer', Locked = true;        AppStorePathTxt: Label '#/apps/Tradeshift.AppStore/apps/', Locked = true;        DefaultSignUpUrlProdTxt: Label 'https://go.tradeshift.com/register', Locked = true;        DefaultSignInUrlProdTxt: Label 'https://go.tradeshift.com/login', Locked = true;        DefaultServiceUrlProdTxt: Label 'https://api.tradeshift.com/tradeshift/rest/external', Locked = true;        DefaultAuthUrlProdTxt: Label 'https://api.tradeshift.com/tradeshift/auth/login', Locked = true;        DefaultTokenUrlProdTxt: Label 'https://api.tradeshift.com/tradeshift/auth/token', Locked = true;        DefaultSignUpUrlSandboxTxt: Label 'https://sandbox.tradeshift.com/register', Locked = true;        DefaultSignInUrlSandboxTxt: Label 'https://sandbox.tradeshift.com/login', Locked = true;        DefaultServiceUrlSandboxTxt: Label 'https://api-sandbox.tradeshift.com/tradeshift/rest/external', Locked = true;        DefaultAuthUrlSandboxTxt: Label 'https://api-sandbox.tradeshift.com/tradeshift/auth/login', Locked = true;        DefaultTokenUrlSandboxTxt: Label 'https://api-sandbox.tradeshift.com/tradeshift/auth/token', Locked = true;        SandboxTxt: Label 'sandbox', Locked = true;        DefaultVersionTxt: Label '/v1.0', Locked = true;        TokenExpiredTxt: Label 'The token has expired.';        RenewTokenActionTxt: Label 'Renew Token';        RenewTokenNotificationTxt: Label 'The token for connecting to the document exchange service has expired.';        RenewTokenNotificationIdTxt: Label '3788e60d-366b-4b69-8827-591237ffe8b1', Locked = true;        ActivateAppActionTxt: Label 'Activate App';        ActivateAppNotificationTxt: Label 'To connect to the document exchange service, your administrator must activate the integration app.';        ActivateAppNotificationIdTxt: Label '7031414b-bc7a-4660-b175-fccf773ddd26', Locked = true;        MissingClientIdTxt: Label 'The client ID has not been initialized. Sandbox: %1.', Locked = true;        MissingClientSecretTxt: Label 'The client secret has not been initialized. Sandbox: %1.', Locked = true;        MissingClientIdOrSecretInSaasTxt: Label 'The client ID or client secret have not been initialized.';        MissingClientIdOrSecretOnPremTxt: Label 'You must register an app that will be used to connect to the document exchange service and specify the client ID, client secret and redirect URL in the Document Exchange Service Setup page.';        GuiNotAllowedTxt: Label 'The GUI is not allowed, so acquiring the authorization code through the interactive experience is not possible.';        AcquireAuthorizationCodeTxt: Label 'Attempting to acquire an authorization code.', Locked = true;        AcquireAccessTokenByAuthorizationCodeTxt: Label 'Attempting to acquire an access token by authorization code.', Locked = true;        AcquireAccessTokenByRefreshTokenTxt: Label 'Attempting to acquire an access token by refresh token.', Locked = true;        CannotGetResponseTxt: Label 'Cannot get a response. Status: %1. Message: %2', Comment = '%1 - response status code, %2 - error message';        CannotGetResponseWithDetailsTxt: Label 'Cannot get a response. Status: %1. Message: %2. Details: %3', Comment = '%1 - response status code, %2 - error message, %3 - error details';        CannotParseResponseTxt: Label 'Cannot parse a response.';        CannotParseIdTokenTxt: Label 'Cannot parse the ID token. %1', Comment = '%1 - error details';        IdTokenParsedTxt: Label 'Succeed to parse the ID token.', Locked = true;        CannotGetParamValueTxt: Label 'Cannot get the parameter value from the response. Parameter name: %1.', Comment = '%1 - parameter name';        NotMatchingParamValueTxt: Label 'The parameter value does not match. Parameter name: %1.', Comment = '%1 - parameter name';        SucceedRenewTokenTxt: Label 'The token was successfully renewed.';        SucceedRetrieveAccessTokenTxt: Label 'The access token was successfully retrieved. The token lifetime is %1.', Locked = true;        FailedAcquireAuthorizationCodeTxt: Label 'Failed to acquire an authorization code. %1', Comment = '%1 - error details';        SucceedAcquireAuthorizationCodeTxt: Label 'The authorization code was successfully acquired.', Locked = true;        FailedAcquireAccessTokenByAuthorizationCodeTxt: Label 'Failed to acquire an access token by authorization code. %1', Comment = '%1 - error details';        SucceedAcquireAccessTokenByAuthorizationCodeTxt: Label 'Acquiring an access token by the authorization code was successful.', Locked = true;        FailedAcquireAccessTokenByRefreshTokenTxt: Label 'Failed to acquire an access token by refresh token. %1', Comment = '%1 - error details';        SucceedAcquireAccessTokenByRefreshTokenTxt: Label 'Acquiring an access token by the refresh token was successful.', Locked = true;        FieldNotSpecifiedTxt: Label 'The field value is not specified. Field: %1', Comment = '%1 - field caption';        EmptyAccessTokenTxt: Label 'The access token is empty.';        EmptyRefreshTokenTxt: Label 'The refresh token is empty.';        EmptyIdTokenTxt: Label 'The ID token is empty.';    procedure IsSandbox(var DocExchServiceSetup: Record "Doc. Exch. Service Setup"): Boolean    begin        exit(DocExchServiceSetup."Service URL".Contains(SandboxTxt));    end;    procedure SetURLsToDefault(var DocExchServiceSetup: Record "Doc. Exch. Service Setup")    begin        SetURLsToDefault(DocExchServiceSetup, false);    end;    [Scope('OnPrem')]    procedure SetURLsToDefault(var DocExchServiceSetup: Record "Doc. Exch. Service Setup"; Sandbox: Boolean)    var        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeSetURLsToDefault(DocExchServiceSetup, Sandbox, IsHandled);        if IsHandled then            exit;        if not Sandbox then begin            DocExchServiceSetup."Sign-up URL" := DefaultSignUpUrlProdTxt;            DocExchServiceSetup."Sign-in URL" := DefaultSignInUrlProdTxt;            DocExchServiceSetup."Service URL" := DefaultServiceUrlProdTxt;            DocExchServiceSetup."Auth URL" := DefaultAuthUrlProdTxt;            DocExchServiceSetup."Token URL" := DefaultTokenUrlProdTxt;        end else begin            DocExchServiceSetup."Sign-up URL" := DefaultSignUpUrlSandboxTxt;            DocExchServiceSetup."Sign-in URL" := DefaultSignInUrlSandboxTxt;            DocExchServiceSetup."Service URL" := DefaultServiceUrlSandboxTxt;            DocExchServiceSetup."Auth URL" := DefaultAuthUrlSandboxTxt;            DocExchServiceSetup."Token URL" := DefaultTokenUrlSandboxTxt;        end;        DocExchServiceSetup.SetDefaultRedirectUrl();        DocExchServiceSetup."User Agent" := CopyStr(CompanyName() + DefaultVersionTxt, 1, MaxStrLen(DocExchServiceSetup."User Agent"));    end;    [Scope('OnPrem')]    procedure GetAppUrl(var DocExchServiceSetup: Record "Doc. Exch. Service Setup"): Text    var        ClientId: Text;        SignInUrl: Text;        AppUrl: Text;        Sandbox: Boolean;    begin        SignInUrl := DocExchServiceSetup."Sign-in URL".TrimEnd('/');        if SignInUrl = '' then            exit('');        Sandbox := IsSandbox(DocExchServiceSetup);        ClientId := GetClientId(Sandbox);        if ClientId = '' then            exit('');        AppUrl := SignInUrl.Substring(1, SignInUrl.LastIndexOf('/')) + AppStorePathTxt + ClientId;        exit(AppUrl);    end;    [Scope('OnPrem')]    procedure GetDefaultRedirectUrl(): Text    var        OAuth2: Codeunit "OAuth2";        RedirectUrl: Text;    begin        OAuth2.GetDefaultRedirectUrl(RedirectUrl);        exit(RedirectUrl);    end;    [Scope('OnPrem')]    procedure SetDefaultRedirectUrl(var DocExchServiceSetup: Record "Doc. Exch. Service Setup")    var        RedirectUrl: Text;    begin        RedirectUrl := GetDefaultRedirectUrl();        DocExchServiceSetup."Redirect URL" := CopyStr(RedirectUrl, 1, MaxStrLen(DocExchServiceSetup."Redirect URL"));    end;    local procedure SetPropertiesBasedOnAuthRequestUrlAndRunOAuth2ControlAddIn(AuthRequestUrl: Text; State: Text; var AuthCode: SecretText; var ErrorMessage: Text)    var        DocExchServiceAuth: Page "Doc. Exch. Service Auth.";    begin        if AuthRequestUrl = '' then begin            Clear(AuthCode);            exit;        end;        DocExchServiceAuth.SetOAuth2Properties(AuthRequestUrl, State);        Commit();        DocExchServiceAuth.RunModal();        AuthCode := DocExchServiceAuth.GetAuthCodeAsSecretText();        ErrorMessage := DocExchServiceAuth.GetAuthError();    end;    local procedure AcquireAccessTokenByAuthorizationCode(ClientId: Text; ClientSecret: SecretText; RedirectUrl: Text; AuthUrl: Text; TokenUrl: Text; var AccessToken: SecretText; var RefreshToken: SecretText; var IdToken: SecretText)    var        AuthRequestUrl: Text;        AuthorizationCode: SecretText;        State: Text;        RequestBody: SecretText;        ErrorMessage: Text;    begin        Session.LogMessage('0000EXU', AcquireAuthorizationCodeTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);        State := GetGUID();        AuthRequestUrl := StrSubstNo(AuthorizationCodeRequestUrlTxt, AuthUrl, UrlEncode(ClientId), UrlEncode(RedirectUrl), UrlEncode(AuthCodeScopeTxt), UrlEncode(State));        SetPropertiesBasedOnAuthRequestUrlAndRunOAuth2ControlAddIn(AuthRequestUrl, State, AuthorizationCode, ErrorMessage);        if AuthorizationCode.IsEmpty() then begin            Session.LogMessage('0000EXW', StrSubstNo(FailedAcquireAuthorizationCodeTxt, ErrorMessage), Verbosity::Warning, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FailedAcquireAuthorizationCodeTxt, ErrorMessage);        end;        Session.LogMessage('0000EXX', SucceedAcquireAuthorizationCodeTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);        Session.LogMessage('0000EXY', AcquireAccessTokenByAuthorizationCodeTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);        if RedirectUrl = '' then            RedirectUrl := GetDefaultRedirectUrl();        RequestBody := SecretStrSubstNo(AuthorizationCodeRequestBodyTxt, UrlEncode(ClientId), UrlEncode(ClientSecret), UrlEncode(AuthorizationCode), UrlEncode(RedirectUrl));        if not TryAcquireAccessToken(TokenUrl, ClientId, ClientSecret, RequestBody, AccessToken, RefreshToken, IdToken, ErrorMessage, true) then begin            if ErrorMessage = '' then                ErrorMessage := GetLastErrorText();            Session.LogMessage('0000EXZ', StrSubstNo(FailedAcquireAccessTokenByAuthorizationCodeTxt, ErrorMessage), Verbosity::Warning, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FailedAcquireAccessTokenByAuthorizationCodeTxt, ErrorMessage);        end;        if AccessToken.IsEmpty() then begin            Session.LogMessage('0000EY0', StrSubstNo(FailedAcquireAccessTokenByAuthorizationCodeTxt, ''), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FailedAcquireAccessTokenByAuthorizationCodeTxt, '');        end;        if RefreshToken.IsEmpty() then            Session.LogMessage('0000EYQ', EmptyRefreshTokenTxt, Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);        if IdToken.IsEmpty() then            Session.LogMessage('0000EZ6', EmptyIdTokenTxt, Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);        Session.LogMessage('0000EY1', SucceedAcquireAccessTokenByAuthorizationCodeTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok)    end;    local procedure AcquireAccessTokenByRefreshToken(ClientId: Text; ClientSecret: SecretText; TokenUrl: Text; var AccessToken: SecretText; var RefreshToken: SecretText)    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        OldRefreshToken: SecretText;        RequestBody: SecretText;        ErrorMessage: Text;        IdToken: SecretText;    begin        Session.LogMessage('0000EY2', AcquireAccessTokenByRefreshTokenTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);        GetServiceSetUp(DocExchServiceSetup);        OldRefreshToken := DocExchServiceSetup.GetRefreshTokenAsSecretText();        if OldRefreshToken.IsEmpty() then begin            ErrorMessage := EmptyRefreshTokenTxt;            Session.LogMessage('0000EY3', StrSubstNo(FailedAcquireAccessTokenByRefreshTokenTxt, EmptyRefreshTokenTxt), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FailedAcquireAccessTokenByRefreshTokenTxt, ErrorMessage);        end;        RequestBody := SecretStrSubstNo(RefreshTokenRequestBodyTxt, UrlEncode(ClientId), UrlEncode(ClientSecret), UrlEncode(OldRefreshToken), UrlEncode(ClientId));        if not TryAcquireAccessToken(TokenUrl, ClientId, ClientSecret, RequestBody, AccessToken, RefreshToken, IdToken, ErrorMessage, false) then begin            if ErrorMessage = '' then                ErrorMessage := GetLastErrorText();            Session.LogMessage('0000EY4', StrSubstNo(FailedAcquireAccessTokenByRefreshTokenTxt, ErrorMessage), Verbosity::Warning, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FailedAcquireAccessTokenByRefreshTokenTxt, ErrorMessage);        end;        if AccessToken.IsEmpty() then begin            Session.LogMessage('0000EY5', StrSubstNo(FailedAcquireAccessTokenByRefreshTokenTxt, ''), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FailedAcquireAccessTokenByRefreshTokenTxt, '');        end;        if RefreshToken.IsEmpty() then begin            Session.LogMessage('0000EZ7', EmptyRefreshTokenTxt, Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(EmptyRefreshTokenTxt);        end;        Session.LogMessage('0000EY6', SucceedAcquireAccessTokenByRefreshTokenTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);    end;    [NonDebuggable]    [TryFunction]    local procedure TryAcquireAccessToken(TokenUrl: Text; ClientId: Text; ClientSecret: SecretText; RequestBody: SecretText; var AccessToken: SecretText; var RefreshToken: SecretText; var IdToken: SecretText; var ErrorMessage: Text; ParseIdToken: Boolean)    var        TempBlob: Codeunit "Temp Blob";        OutStream: OutStream;        HttpStatusCode: DotNet HttpStatusCode;        ResponseHeaders: DotNet NameValueCollection;        ResponseBody: Text;        ErrorDetails: Text;        TokenType: Text;        ResponseClientId: Text;        ExpiresIn: Integer;        HttpStatusCodeNumber: Integer;    begin        TempBlob.CreateOutStream(OutStream, TextEncoding::UTF8);        OutStream.WriteText(RequestBody.Unwrap());        HttpWebRequestMgt.Initialize(TokenUrl);        HttpWebRequestMgt.DisableUI();        HttpWebRequestMgt.SetMethod(MethodPostTxt);        HttpWebRequestMgt.SetContentType(ApplicationFormTxt);        HttpWebRequestMgt.SetContentLength(TempBlob.Length());        HttpWebRequestMgt.SetUserAgent(GetUserAgent());        HttpWebRequestMgt.SetReturnType(ApplicationJsonTxt);        HttpWebRequestMgt.AddHeader(AcceptEncodingHeaderNameTxt, EncodingUtf8Txt);        HttpWebRequestMgt.AddBasicAuthentication(ClientId, ClientSecret);        HttpWebRequestMgt.AddBodyBlob(TempBlob);        if not HttpWebRequestMgt.SendRequestAndReadTextResponse(ResponseBody, ErrorMessage, ErrorDetails, HttpStatusCode, ResponseHeaders) then begin            if not IsNull(HttpStatusCode) then                HttpStatusCodeNumber := HttpStatusCode;            Session.LogMessage('0000EY7', StrSubstNo(CannotGetResponseWithDetailsTxt, HttpStatusCodeNumber, ErrorMessage, ErrorDetails), Verbosity::Warning, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(CannotGetResponseWithDetailsTxt, HttpStatusCodeNumber, ErrorMessage, ErrorDetails);        end;        ParseTokenResponse(ResponseBody, AccessToken, RefreshToken, IdToken, TokenType, ResponseClientId, ExpiresIn, ParseIdToken);        if TokenType <> TokenTypeBearerTxt then begin            Session.LogMessage('0000EY8', StrSubstNo(NotMatchingParamValueTxt, TokenTypeParamNameTxt), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(NotMatchingParamValueTxt, TokenTypeParamNameTxt);        end;        if ResponseClientId <> ClientId then begin            Session.LogMessage('0000EY9', StrSubstNo(NotMatchingParamValueTxt, ClientIdParamNameTxt), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(NotMatchingParamValueTxt, ClientIdParamNameTxt);        end;        Session.LogMessage('0000EYA', StrSubstNo(SucceedRetrieveAccessTokenTxt, ExpiresIn), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);    end;    [TryFunction]    [NonDebuggable]    local procedure TryGetSecurityToken(Token: SecretText; var JwtSecurityToken: DotNet JwtSecurityToken)    var        JwtSecurityTokenHandler: DotNet JwtSecurityTokenHandler;    begin        JwtSecurityTokenHandler := JwtSecurityTokenHandler.JwtSecurityTokenHandler();        JwtSecurityToken := JwtSecurityTokenHandler.ReadToken(Token.Unwrap());        Session.LogMessage('0000EYB', IdTokenParsedTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);    end;    [NonDebuggable]    local procedure ParseTokenResponse(ResponseBody: Text; var AccessToken: SecretText; var RefreshToken: SecretText; var IdToken: SecretText; var TokenType: Text; var ClientId: Text; var ExpiresIn: Integer; ParseIdToken: Boolean)    var        JsonObject: JsonObject;        AccessTokenAsText, RefreshTokenAsText, IdTokenAsText : Text;    begin        if not JsonObject.ReadFrom(ResponseBody) then begin            Session.LogMessage('0000EYC', CannotParseResponseTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(CannotParseResponseTxt);        end;        if not GetJsonKeyValue(JsonObject, AccessTokenParamNameTxt, AccessTokenAsText) then begin            Session.LogMessage('0000EYD', StrSubstNo(CannotGetParamValueTxt, AccessTokenParamNameTxt), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(CannotGetParamValueTxt, AccessTokenParamNameTxt);        end;        AccessToken := AccessTokenAsText;        if not GetJsonKeyValue(JsonObject, RefreshTokenParamNameTxt, RefreshTokenAsText) then begin            Session.LogMessage('0000EYE', StrSubstNo(CannotGetParamValueTxt, RefreshTokenParamNameTxt), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(CannotGetParamValueTxt, RefreshTokenParamNameTxt);        end;        RefreshToken := RefreshTokenAsText;        if not GetJsonKeyValue(JsonObject, TokenTypeParamNameTxt, TokenType) then begin            Session.LogMessage('0000EYF', StrSubstNo(CannotGetParamValueTxt, TokenTypeParamNameTxt), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(CannotGetParamValueTxt, TokenTypeParamNameTxt);        end;        if ParseIdToken then            if not GetJsonKeyValue(JsonObject, IdTokenParamNameTxt, IdTokenAsText) then begin                Session.LogMessage('0000EYG', StrSubstNo(CannotGetParamValueTxt, IdTokenParamNameTxt), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);                Error(CannotGetParamValueTxt, IdTokenParamNameTxt);            end;        IdToken := IdTokenAsText;        if not GetJsonKeyValue(JsonObject, ExpiresInParamNameTxt, ExpiresIn) then            Session.LogMessage('0000EYH', StrSubstNo(CannotGetParamValueTxt, ExpiresInParamNameTxt), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);        if not GetJsonKeyValue(JsonObject, ClientIdParamNameTxt, ClientId) then begin            Session.LogMessage('0000EYI', StrSubstNo(CannotGetParamValueTxt, ClientIdParamNameTxt), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(CannotGetParamValueTxt, ClientIdParamNameTxt);        end;    end;    [NonDebuggable]    local procedure GetJsonKeyValue(var JsonObject: JsonObject; KeyName: Text; var KeyValue: Text): Boolean    var        JsonToken: JsonToken;    begin        if not JsonObject.Get(KeyName, JsonToken) then            exit(false);        KeyValue := JsonToken.AsValue().AsText();        exit(true);    end;    [NonDebuggable]    local procedure GetJsonKeyValue(var JsonObject: JsonObject; KeyName: Text; var KeyValue: Integer): Boolean    var        JsonToken: JsonToken;    begin        if not JsonObject.Get(KeyName, JsonToken) then            exit(false);        KeyValue := JsonToken.AsValue().AsInteger();        exit(true);    end;    local procedure MarkTokenAsExpired()    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";    begin        GetServiceSetUp(DocExchServiceSetup);        DocExchServiceSetup."Token Expired" := true;        DocExchServiceSetup.Modify();    end;    [Scope('OnPrem')]    procedure SendRenewTokenNotification()    var        RenewTokenNotification: Notification;    begin        if not GuiAllowed() then            exit;        RenewTokenNotification.Id := GetRenewTokenNotificationId();        RenewTokenNotification.Message := RenewTokenNotificationTxt;        RenewTokenNotification.Scope := NotificationScope::LocalScope;        RenewTokenNotification.AddAction(RenewTokenActionTxt, Codeunit::"Doc. Exch. Service Mgt.", 'RenewToken');        RenewTokenNotification.Send();    end;    procedure RecallActivateAppNotification()    var        ActivateAppNotification: Notification;    begin        ActivateAppNotification.Id := GetActivateAppNotificationId();        if not ActivateAppNotification.Recall() then;    end;    [Scope('OnPrem')]    procedure SendActivateAppNotification()    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        ActivateAppNotification: Notification;        ClientId: Text;        Sandbox: Boolean;        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeSendActivateAppNotification(IsHandled);        if IsHandled then            exit;        if not GuiAllowed() then            exit;        if not DocExchServiceSetup.Get() then            exit;        Sandbox := IsSandbox(DocExchServiceSetup);        ClientId := GetClientId(Sandbox);        if ClientId = '' then            exit;        ActivateAppNotification.Id := GetActivateAppNotificationId();        ActivateAppNotification.Recall();        ActivateAppNotification.Message := ActivateAppNotificationTxt;        ActivateAppNotification.Scope := NotificationScope::LocalScope;        if GetAppUrl(DocExchServiceSetup) <> '' then            ActivateAppNotification.AddAction(ActivateAppActionTxt, Codeunit::"Doc. Exch. Service Mgt.", 'ActivateApp');        ActivateAppNotification.Send();    end;    [Scope('OnPrem')]    procedure ActivateApp(var ActivateAppNotification: Notification)    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";    begin        SendActivateAppNotification();        GetServiceSetUp(DocExchServiceSetup);        Hyperlink(GetAppUrl(DocExchServiceSetup));    end;    [Scope('OnPrem')]    procedure RenewToken(var RenewTokenNotification: Notification)    begin        RenewToken(true);    end;    [Scope('OnPrem')]    procedure RenewToken(TryRefreshToken: Boolean)    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        AccessToken: SecretText;        RefreshToken: SecretText;        Renewed: Boolean;    begin        if TryRefreshToken then            if TryAcquireAccessTokenByRefreshToken(AccessToken, RefreshToken) then begin                SaveTokens(AccessToken, RefreshToken);                Renewed := TryCheckConnection();            end;        if not Renewed then begin            AcquireAccessTokenByAuthorizationCode(true);            Renewed := TryCheckConnection();        end;        GetServiceSetUp(DocExchServiceSetup);        if Renewed then begin            LogActivitySucceeded(DocExchServiceSetup.RecordId(), RenewTokenTxt, SucceedRenewTokenTxt);            if GuiAllowed() then                Message(SucceedRenewTokenTxt);            exit;        end;        LogActivityFailedAndError(DocExchServiceSetup.RecordId(), RenewTokenTxt, GetLastErrorText());    end;    local procedure GetRenewTokenNotificationId(): Guid    begin        exit(TextToGuid(RenewTokenNotificationIdTxt));    end;    local procedure GetActivateAppNotificationId(): Guid    begin        exit(TextToGuid(ActivateAppNotificationIdTxt));    end;    local procedure TextToGuid(TextVar: Text): Guid    var        GuidVar: Guid;    begin        if not Evaluate(GuidVar, TextVar) then;        exit(GuidVar);    end;    internal procedure GetFeatureTelemetryName(): Text    var        DocumentExchangeTelemetryNameTxt: Label 'Document Exchange', Locked = true;    begin        exit(DocumentExchangeTelemetryNameTxt);    end;    [TryFunction]    local procedure TryCheckConnection()    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";    begin        VerifyPrerequisites(true);        GetServiceSetUp(DocExchServiceSetup);        ExecuteWebServiceGetRequest(GetCheckConnectionURL());    end;    [Scope('OnPrem')]    procedure CheckConnection()    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";    begin        VerifyPrerequisites(true);        GetServiceSetUp(DocExchServiceSetup);        if not ExecuteWebServiceGetRequest(GetCheckConnectionURL()) then            LogActivityFailedAndError(DocExchServiceSetup.RecordId(), CheckConnectionTxt, GetLastErrorText());        LogActivitySucceeded(DocExchServiceSetup.RecordId(), CheckConnectionTxt, ConnectionSuccessMsg);        if GuiAllowed() then            Message(ConnectionSuccessMsg);        if GLBTraceLogEnabled then            Trace.LogStreamToTempFile(GLBResponseInStream, 'checkstatus', TempBlobTrace);    end;    [Scope('OnPrem')]    procedure SendUBLDocument(DocVariant: Variant; var TempBlob: Codeunit "Temp Blob"): Text    var        DocRecRef: RecordRef;        FeatureTelemetry: Codeunit "Feature Telemetry";    begin        CheckServiceEnabled();        FeatureTelemetry.LogUptake('0000IM9', TelemetryCategoryTok, Enum::"Feature Uptake Status"::Used);        FeatureTelemetry.LogUsage('0000IMP', TelemetryCategoryTok, 'Document send');        DocRecRef.GetTable(DocVariant);        CheckDocumentStatus(DocRecRef);        if not ExecuteWebServicePostRequest(GetPostSalesURL(DocRecRef), TempBlob) then            LogActivityFailedAndError(DocRecRef.RecordId, SendDocTxt, '');        LogActivitySucceeded(DocRecRef.RecordId, SendDocTxt, DocSendSuccessMsg);        DocExchLinks.UpdateDocumentRecord(DocRecRef, GLBLastUsedGUID, '');        LogTelemetryDocumentSent();        if GuiAllowed then            Message(DocSendSuccessMsg);        exit(GLBLastUsedGUID);    end;    [Scope('OnPrem')]    procedure SendDocument(DocVariant: Variant; var TempBlob: Codeunit "Temp Blob"): Text    var        DocRecRef: RecordRef;        DocIdentifier: Text;    begin        CheckServiceEnabled();        DocIdentifier := GetGUID();        DocRecRef.GetTable(DocVariant);        CheckDocumentStatus(DocRecRef);        PutDocument(TempBlob, DocIdentifier, DocRecRef);        DispatchDocument(DocIdentifier, DocRecRef);        LogTelemetryDocumentSent();        if GuiAllowed() then            Message(DocSendSuccessMsg);        exit(DocIdentifier);    end;    [Scope('OnPrem')]    procedure HasPredefinedOAuth2Params(): Boolean    begin        if GetPredefinedClientId(false) = '' then            exit(false);        if GetPredefinedClientSecret(false).IsEmpty() then            exit(false);        if GetPredefinedClientId(true) = '' then            exit(false);        if GetPredefinedClientSecret(true).IsEmpty() then            exit(false);        exit(true);    end;    [Scope('OnPrem')]    procedure GetClientId(Sandbox: Boolean): Text    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        ClientId: Text;    begin        ClientId := GetPredefinedClientId(Sandbox);        if ClientId = '' then            if DocExchServiceSetup.Get() then                ClientId := DocExchServiceSetup."Client Id";        exit(ClientId);    end;    local procedure GetPredefinedClientId(Sandbox: Boolean): Text    var        AzureKeyVault: Codeunit "Azure Key Vault";        SecretName: Text;        ClientId: Text;    begin        if not Sandbox then            SecretName := ClientIdAKVSecretNameProdTxt        else            SecretName := ClientIdAKVSecretNameSandboxTxt;        if EnvironmentInfo.IsSaaSInfrastructure() then            if not AzureKeyVault.GetAzureKeyVaultSecret(SecretName, ClientId) then                Session.LogMessage('0000EYJ', StrSubstNo(MissingClientIdTxt, Sandbox), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok)            else                exit(ClientId);        if ClientId = '' then            OnGetClientId(ClientId);        exit(ClientId);    end;    [Scope('OnPrem')]    procedure GetClientSecretAsSecretText(Sandbox: Boolean): SecretText    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        ClientSecret: SecretText;    begin        ClientSecret := GetPredefinedClientSecret(Sandbox);        if ClientSecret.IsEmpty() then            if DocExchServiceSetup.Get() then                ClientSecret := DocExchServiceSetup.GetClientSecretAsSecretText();        exit(ClientSecret);    end;    local procedure GetPredefinedClientSecret(Sandbox: Boolean): SecretText    var        AzureKeyVault: Codeunit "Azure Key Vault";        ClientSecret: SecretText;        [NonDebuggable]        ClientSecretFromEvent: Text;        SecretName: Text;    begin        if not Sandbox then            SecretName := ClientSecretAKVSecretNameProdTxt        else            SecretName := ClientSecretAKVSecretNameSandboxTxt;        if EnvironmentInfo.IsSaaSInfrastructure() then            if not AzureKeyVault.GetAzureKeyVaultSecret(SecretName, ClientSecret) then                Session.LogMessage('0000EYK', StrSubstNo(MissingClientSecretTxt, Sandbox), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok)            else                exit(ClientSecret);        if ClientSecret.IsEmpty() then begin            OnGetClientSecret(ClientSecretFromEvent);            ClientSecret := ClientSecretFromEvent;        end;        exit(ClientSecret);    end;    [NonDebuggable]    local procedure VerifyIdToken(IdToken: SecretText)    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        JwtSecurityToken: DotNet JwtSecurityToken;        ErrorMessage: Text;        ClientId: Text;        AuthUrl: Text;        ExpectedIss: Text;        Aud: Text;        Iss: Text;        Sandbox: Boolean;    begin        if not TryGetSecurityToken(IdToken, JwtSecurityToken) then begin            ErrorMessage := GetLastErrorText();            Session.LogMessage('0000EYL', StrSubstNo(CannotParseIdTokenTxt, ErrorMessage), Verbosity::Warning, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(CannotParseIdTokenTxt, ErrorMessage);        end;        GetServiceSetUp(DocExchServiceSetup);        AuthUrl := DocExchServiceSetup."Auth URL".ToLower();        Sandbox := IsSandbox(DocExchServiceSetup);        ClientId := GetClientId(Sandbox);        Aud := JwtSecurityToken.Payload().Aud().Item(0);        if Aud <> ClientId then begin            Session.LogMessage('0000EYM', StrSubstNo(NotMatchingParamValueTxt, AudienceParamNameTxt), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(NotMatchingParamValueTxt, AudienceParamNameTxt);        end;        Iss := JwtSecurityToken.Payload().Iss().ToLower();        ExpectedIss := AuthUrl.Substring(1, StrLen(Iss)).ToLower();        if Iss <> ExpectedIss then begin            Session.LogMessage('0000EYN', StrSubstNo(NotMatchingParamValueTxt, IssuerParamNameTxt), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(NotMatchingParamValueTxt, IssuerParamNameTxt);        end;    end;    local procedure ParseIdToken(IdToken: SecretText; var Json: Text; var Subject: Text; var IssuedAt: DateTime)    begin        if IdToken.IsEmpty() then begin            Session.LogMessage('0000EZ8', EmptyIdTokenTxt, Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            exit;        end;        if not TryParseIdToken(IdToken, Json, Subject, IssuedAt) then begin            Session.LogMessage('0000EZ9', StrSubstNo(CannotParseIdTokenTxt, GetLastErrorText()), Verbosity::Warning, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            exit;        end;    end;    [TryFunction]    local procedure TryParseIdToken(IdToken: SecretText; var Json: Text; var Subject: Text; var IssuedAt: DateTime)    var        JwtSecurityToken: DotNet JwtSecurityToken;        DotNetDateTime: DotNet DateTime;        DotNetTimeSpan: DotNet TimeSpan;        DotNetDateTimeKind: DotNet DateTimeKind;        Iat: BigInteger;    begin        if not TryGetSecurityToken(IdToken, JwtSecurityToken) then begin            Session.LogMessage('0000EYO', StrSubstNo(CannotParseIdTokenTxt, GetLastErrorText()), Verbosity::Warning, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            exit;        end;        Json := JwtSecurityToken.Payload().SerializeToJson();        Subject := JwtSecurityToken.Payload().Sub();        Iat := JwtSecurityToken.Payload().Iat;        if Iat > 0 then begin            DotNetDateTime := DotNetDateTime.DateTime(1970, 1, 1, 0, 0, 0, DotNetDateTimeKind.Utc);            DotNetTimeSpan := DotNetTimeSpan.FromSeconds(Iat);            IssuedAt := DotNetDateTime.Add(DotNetTimeSpan).ToLocalTime();        end;    end;    local procedure SaveTokens(AccessToken: SecretText; RefreshToken: SecretText)    var        IdToken: Text;    begin        SaveTokens(AccessToken, RefreshToken, IdToken);    end;    local procedure SaveTokens(AccessToken: SecretText; RefreshToken: SecretText; IdToken: SecretText)    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        Json: Text;        Subject: Text;        IssuedAt: DateTime;    begin        GetServiceSetUp(DocExchServiceSetup);        DocExchServiceSetup.SetAccessToken(AccessToken);        DocExchServiceSetup.SetRefreshToken(RefreshToken);        if not IdToken.IsEmpty() then begin            ParseIdToken(IdToken, Json, Subject, IssuedAt);            if Json <> '' then begin                DocExchServiceSetup."Id Token" := CopyStr(Json, 1, MaxStrLen(DocExchServiceSetup."Id Token"));                DocExchServiceSetup."Token Subject" := CopyStr(Subject, 1, MaxStrLen(DocExchServiceSetup."Token Subject"));            end;        end else            if not AccessToken.IsEmpty() then                IssuedAt := CurrentDateTime();        DocExchServiceSetup."Token Issued At" := IssuedAt;        DocExchServiceSetup."Token Expired" := false;        DocExchServiceSetup.Modify();    end;    [Scope('OnPrem')]    procedure AcquireAccessTokenByAuthorizationCode(EnabledOnly: Boolean)    var        AccessToken: SecretText;        RefreshToken: SecretText;        IdToken: SecretText;    begin        AcquireAccessTokenByAuthorizationCode(EnabledOnly, AccessToken, RefreshToken, IdToken);        VerifyIdToken(IdToken);        SaveTokens(AccessToken, RefreshToken, IdToken);    end;    local procedure AcquireAccessTokenByAuthorizationCode(EnabledOnly: Boolean; var AccessToken: SecretText; var RefreshToken: SecretText; var IdToken: SecretText)    var        ClientId: Text;        ClientSecret: SecretText;        RedirectUrl: Text;        AuthUrl: text;        TokenUrl: Text;    begin        if not GuiAllowed() then begin            Session.LogMessage('0000EYP', GuiNotAllowedTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(GuiNotAllowedTxt);        end;        GetOAuth2Params(EnabledOnly, ClientId, ClientSecret, RedirectUrl, AuthUrl, TokenUrl);        AcquireAccessTokenByAuthorizationCode(ClientId, ClientSecret, RedirectUrl, AuthUrl, TokenUrl, AccessToken, RefreshToken, IdToken);    end;    [Scope('OnPrem')]    procedure AcquireAccessTokenByRefreshToken()    var        AccessToken: SecretText;        RefreshToken: SecretText;    begin        AcquireAccessTokenByRefreshToken(AccessToken, RefreshToken);        SaveTokens(AccessToken, RefreshToken);    end;    [TryFunction]    local procedure TryAcquireAccessTokenByRefreshToken(var AccessToken: SecretText; var RefreshToken: SecretText)    begin        AcquireAccessTokenByRefreshToken(AccessToken, RefreshToken);    end;    local procedure AcquireAccessTokenByRefreshToken(var AccessToken: SecretText; var RefreshToken: SecretText)    var        ClientId: Text;        ClientSecret: SecretText;        RedirectUrl: Text;        AuthUrl: Text;        TokenUrl: Text;    begin        GetOAuth2Params(true, ClientId, ClientSecret, RedirectUrl, AuthUrl, TokenUrl);        AcquireAccessTokenByRefreshToken(ClientId, ClientSecret, TokenUrl, AccessToken, RefreshToken);    end;    local procedure GetOAuth2Params(EnabledOnly: Boolean; var ClientId: Text; var ClientSecret: SecretText; var RedirectUrl: Text; var AuthUrl: Text; var TokenUrl: Text)    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        Sandbox: Boolean;    begin        GetServiceSetUp(DocExchServiceSetup);        if EnabledOnly then            CheckServiceEnabled(DocExchServiceSetup);        RedirectUrl := DocExchServiceSetup."Redirect URL";        if RedirectUrl = '' then begin            Session.LogMessage('0000EYS', StrSubstNo(FieldNotSpecifiedTxt, DocExchServiceSetup.FieldCaption("Redirect URL")), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FieldNotSpecifiedTxt, DocExchServiceSetup.FieldCaption("Redirect URL"));        end;        AuthUrl := DocExchServiceSetup."Auth URL";        if AuthUrl = '' then begin            Session.LogMessage('0000EYT', StrSubstNo(FieldNotSpecifiedTxt, DocExchServiceSetup.FieldCaption("Auth URL")), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FieldNotSpecifiedTxt, DocExchServiceSetup.FieldCaption("Auth URL"));        end;        TokenUrl := DocExchServiceSetup."Token URL";        if TokenUrl = '' then begin            Session.LogMessage('0000EYU', StrSubstNo(FieldNotSpecifiedTxt, DocExchServiceSetup.FieldCaption("Token URL")), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FieldNotSpecifiedTxt, DocExchServiceSetup.FieldCaption("Token URL"));        end;        Sandbox := IsSandbox(DocExchServiceSetup);        ClientId := GetClientId(Sandbox);        if ClientId = '' then begin            Session.LogMessage('0000EYV', StrSubstNo(MissingClientIdTxt, Sandbox), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(GetMissingClientIdOrSecretErr());        end;        ClientSecret := GetClientSecretAsSecretText(Sandbox);        if ClientSecret.IsEmpty() then begin            Session.LogMessage('0000EYW', StrSubstNo(MissingClientSecretTxt, Sandbox), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(GetMissingClientIdOrSecretErr());        end;    end;    local procedure GetMissingClientIdOrSecretErr(): Text    begin        if EnvironmentInfo.IsSaaSInfrastructure() then            exit(MissingClientIdOrSecretInSaasTxt);        exit(MissingClientIdOrSecretOnPremTxt);    end;    local procedure PutDocument(var TempBlob: Codeunit "Temp Blob"; DocIdentifier: Text; DocRecRef: RecordRef)    var        Succeed: Boolean;    begin        if not ExecuteWebServicePutRequest(GetPUTDocURL(DocIdentifier), TempBlob) then            LogActivityFailedAndError(DocRecRef.RecordId, SendDocTxt, '');        if not IsNull(GLBHttpStatusCode) then            Succeed := GLBHttpStatusCode.Equals(GLBHttpStatusCode.NoContent);        if not Succeed then            LogActivityFailedAndError(DocRecRef.RecordId, SendDocTxt, '');        LogActivitySucceeded(DocRecRef.RecordId, SendDocTxt, DocUploadSuccessMsg);        if GLBTraceLogEnabled then            Trace.LogStreamToTempFile(GLBResponseInStream, 'put', TempBlobTrace);    end;    local procedure DispatchDocument(DocOrigIdentifier: Text; DocRecRef: RecordRef)    var        TempBlob: Codeunit "Temp Blob";        DocIdentifier: Text;        PlaceholderGuid: Guid;        Succeed: Boolean;    begin        if not ExecuteWebServicePostRequest(GetDispatchDocURL(DocOrigIdentifier), TempBlob) then            LogActivityFailedAndError(DocRecRef.RecordId, DispatchDocTxt, '');        if not IsNull(GLBHttpStatusCode) then            Succeed := GLBHttpStatusCode.Equals(GLBHttpStatusCode.Created);        if not Succeed then begin            DocExchLinks.UpdateDocumentRecord(DocRecRef, '', DocOrigIdentifier);            LogActivityFailedAndError(DocRecRef.RecordId, DispatchDocTxt, DocDispatchFailedMsg);        end;        if GLBTraceLogEnabled then            Trace.LogStreamToTempFile(GLBResponseInStream, 'dispatch', TempBlobTrace);        DocIdentifier := GLBResponseHeaders.Get(GetDocumentIDKey());        if not Evaluate(PlaceholderGuid, DocIdentifier) then            LogActivityFailedAndError(DocRecRef.RecordId, DispatchDocTxt, InvalidHeaderResponseMsg);        DocExchLinks.UpdateDocumentRecord(DocRecRef, DocIdentifier, DocOrigIdentifier);        LogActivitySucceeded(DocRecRef.RecordId, DispatchDocTxt, DocDispatchSuccessMsg);    end;    [Scope('OnPrem')]    procedure GetDocumentStatus(DocRecordID: RecordID; DocIdentifier: Text[50]; DocOrigIdentifier: Text[50]): Text    var        Errors: Text;    begin        CheckServiceEnabled();        // Check for dispatch errors first        if DocOrigIdentifier <> '' then            if GetDocDispatchErrors(DocRecordID, DocOrigIdentifier, Errors) then                if Errors <> '' then                    exit('FAILED');        // Check metadata        if not GetDocumentMetadata(DocRecordID, DocIdentifier, Errors) then            exit('PENDING');        // If metadata exist it means doc has been dispatched        exit(Errors);    end;    local procedure GetDocDispatchErrors(DocRecordID: RecordID; DocIdentifier: Text; var Errors: Text): Boolean    var        XmlDoc: DotNet XmlDocument;    begin        CheckServiceEnabled();        if not ExecuteWebServiceGetRequest(GetDispatchErrorsURL(DocIdentifier)) then begin            LogActivityFailed(DocRecordID, GetDocErrorTxt, '');            exit(false);        end;        if not HttpWebRequestMgt.TryLoadXMLResponse(GLBResponseInStream, XmlDoc) then begin            LogActivityFailed(DocRecordID, GetDocErrorTxt, '');            exit(false);        end;        Errors := XMLDOMMgt.FindNodeTextWithNamespace(XmlDoc.DocumentElement, GetErrorXPath(),            GetPrefix(), GetApiNamespace());        LogActivitySucceeded(DocRecordID, GetDocErrorTxt, Errors);        if GLBTraceLogEnabled then            Trace.LogStreamToTempFile(GLBResponseInStream, 'dispatcherrors', TempBlobTrace);        exit(true);    end;    [Scope('OnPrem')]    procedure GetDocumentMetadata(DocRecordID: RecordID; DocIdentifier: Text[50]; var NewStatus: Text): Boolean    var        XmlDoc: DotNet XmlDocument;    begin        CheckServiceEnabled();        NewStatus := '';        if not ExecuteWebServiceGetRequest(GetDocStatusURL(DocIdentifier)) then begin            LogActivityFailed(DocRecordID, GetDocStatusTxt, '');            exit(false);        end;        if not HttpWebRequestMgt.TryLoadXMLResponse(GLBResponseInStream, XmlDoc) then begin            LogActivityFailed(DocRecordID, GetDocStatusTxt, '');            exit(false);        end;        if GLBTraceLogEnabled then            Trace.LogStreamToTempFile(GLBResponseInStream, 'checkstatus', TempBlobTrace);        NewStatus := XMLDOMMgt.FindNodeTextWithNamespace(XmlDoc.DocumentElement(), GetStatusXPath(), GetPrefix(), GetPublicNamespace());        LogActivitySucceeded(DocRecordID, GetDocStatusTxt, StrSubstNo(DocStatusOKMsg, NewStatus));        exit(true);    end;    [Scope('OnPrem')]    procedure ReceiveDocuments(ContextRecordID: RecordID)    var        XmlDoc: DotNet XmlDocument;    begin        CheckServiceEnabled();        if not ExecuteWebServiceGetRequest(GetRetrieveDocsURL()) then            LogActivityFailedAndError(ContextRecordID, GetDocsTxt, '');        if not HttpWebRequestMgt.TryLoadXMLResponse(GLBResponseInStream, XmlDoc) then            LogActivityFailedAndError(ContextRecordID, GetDocsTxt, '');        ProcessReceivedDocs(ContextRecordID, XmlDoc);    end;    local procedure ProcessReceivedDocs(ContextRecordID: RecordID; XmlDocs: DotNet XmlDocument)    var        IncomingDocument: Record "Incoming Document";        XMLRootNode: DotNet XmlNode;        Node: DotNet XmlNode;        DummyGuid: Guid;        DocIdentifier: Text;        Description: Text;    begin        XMLRootNode := XmlDocs.DocumentElement;        foreach Node in XMLRootNode.ChildNodes do begin            DocIdentifier := XMLDOMMgt.FindNodeTextWithNamespace(Node, GetDocumentIDXPath(),                GetPrefix(), GetPublicNamespace());            if not Evaluate(DummyGuid, DocIdentifier) then                LogActivityFailedAndError(ContextRecordID, GetDocsTxt, MalformedGuidErr);            if TryGetDocumentDescription(Node, Description) then;            if DelChr(Description, '<>', ' ') = '' then                Description := DocIdentifier;            GetOriginalDocument(ContextRecordID, DocIdentifier);            CreateIncomingDocEntry(IncomingDocument, ContextRecordID, DocIdentifier, Description);            if not MarkDocBusinessProcessed(DocIdentifier) then begin                IncomingDocument.Delete();                LogActivityFailed(ContextRecordID, MarkBusinessProcessedTxt, '');            end else                LogActivitySucceeded(ContextRecordID, MarkBusinessProcessedTxt, StrSubstNo(DocIdImportedTxt, DocIdentifier));            Commit();            IncomingDocument.Find();            LogTelemetryDocumentReceived();            OnAfterIncomingDocReceivedFromDocExch(IncomingDocument);        end;    end;    local procedure GetOriginalDocument(ContextRecordID: RecordID; DocIdentifier: Text)    begin        CheckServiceEnabled();        // If can't get the original, it means it was not a 2-step. Get the actual TS-UBL        if not ExecuteWebServiceGetRequest(GetRetrieveOriginalDocIDURL(DocIdentifier)) then            GetDocument(ContextRecordID, DocIdentifier);    end;    local procedure GetDocument(ContextRecordID: RecordID; DocIdentifier: Text)    begin        CheckServiceEnabled();        if not ExecuteWebServiceGetRequest(GetRetrieveDocIDURL(DocIdentifier)) then            LogActivityFailedAndError(ContextRecordID, GetDocsTxt, '');    end;    [TryFunction]    local procedure MarkDocBusinessProcessed(DocIdentifier: Text)    var        TempBlob: Codeunit "Temp Blob";    begin        CheckServiceEnabled();        ExecuteWebServicePutRequest(GetSetTagURL(DocIdentifier), TempBlob);    end;    local procedure CreateIncomingDocEntry(var IncomingDocument: Record "Incoming Document"; ContextRecordID: RecordID; DocIdentifier: Text; Description: Text)    var        IncomingDocumentAttachment: Record "Incoming Document Attachment";        XmlDoc: DotNet XmlDocument;    begin        // Assert response is XML        if not HttpWebRequestMgt.TryLoadXMLResponse(GLBResponseInStream, XmlDoc) then            LogActivityFailedAndError(ContextRecordID, GetDocsTxt, StrSubstNo(FileInvalidTxt, DocIdentifier));        IncomingDocument.CreateIncomingDocument(          CopyStr(Description, 1, MaxStrLen(IncomingDocument.Description)), GetExternalDocURL(DocIdentifier));        // set received XML as main attachment and extract additional ones as secondary attachments        IncomingDocument.AddAttachmentFromStream(IncomingDocumentAttachment, DocIdentifier, 'xml', GLBResponseInStream);        ProcessAttachments(IncomingDocument, XmlDoc);    end;    local procedure ProcessAttachments(var IncomingDocument: Record "Incoming Document"; XmlDoc: DotNet XmlDocument)    var        NodeList: DotNet XmlNodeList;        Node: DotNet XmlNode;    begin        XMLDOMMgt.FindNodesWithNamespace(XmlDoc.DocumentElement, GetEmbeddedDocXPath(), GetPrefix(), GetCBCNamespace(),          NodeList);        foreach Node in NodeList do            ExtractAdditionalAttachment(IncomingDocument, Node);    end;    local procedure ExtractAdditionalAttachment(var IncomingDocument: Record "Incoming Document"; Node: DotNet XmlNode)    var        FileMgt: Codeunit "File Management";        Convert: DotNet Convert;        TempFile: DotNet File;        FilePath: Text;        FileName: Text;    begin        FileName := XMLDOMMgt.GetAttributeValue(Node, 'filename');        FilePath := FileMgt.ServerTempFileName(FileMgt.GetExtension(FileName));        FileMgt.IsAllowedPath(FilePath, false);        TempFile.WriteAllBytes(FilePath, Convert.FromBase64String(Node.InnerText));        IncomingDocument.AddAttachmentFromServerFile(FileName, FilePath);    end;    local procedure Initialize(URL: Text; Method: Text[6]; var TempBlob: Codeunit "Temp Blob")    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        AccessToken: SecretText;    begin        CheckCredentials();        GetServiceSetUp(DocExchServiceSetup);        AccessToken := DocExchServiceSetup.GetAccessTokenAsSecretText();        if AccessToken.IsEmpty() then begin            Session.LogMessage('0000EYR', EmptyAccessTokenTxt, Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(EmptyAccessTokenTxt);        end;        Clear(HttpWebRequestMgt);        HttpWebRequestMgt.Initialize(URL);        HttpWebRequestMgt.SetMethod(Method);        HttpWebRequestMgt.AddHeader(AuthorizationHeaderNameTxt, SecretStrSubstNo(AuthorizationHeaderValueTxt, AccessToken));        SetDefaults(TempBlob);    end;    local procedure SetDefaults(var TempBlob: Codeunit "Temp Blob")    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";    begin        HttpWebRequestMgt.SetContentType(TextXmlTxt);        HttpWebRequestMgt.SetReturnType(TextXmlTxt);        HttpWebRequestMgt.SetUserAgent(GetUserAgent());        HttpWebRequestMgt.AddHeader(AcceptEncodingHeaderNameTxt, EncodingUtf8Txt);        HttpWebRequestMgt.AddBodyBlob(TempBlob);        // Set tracing        GetServiceSetUp(DocExchServiceSetup);        GLBTraceLogEnabled := DocExchServiceSetup."Log Web Requests";        HttpWebRequestMgt.SetTraceLogEnabled(DocExchServiceSetup."Log Web Requests");    end;    procedure CheckCredentials()    var        DocExchServiceSetup: Page "Doc. Exch. Service Setup";    begin        if not VerifyPrerequisites(false) then            if GuiAllowed() and Confirm(StrSubstNo(NotConfiguredQst, DocExchServiceSetup.Caption()), true) then begin                Commit();                DocExchServiceSetup.RunModal();                if not VerifyPrerequisites(false) then                    Error(NotConfiguredErr, DocExchServiceSetup.Caption());            end else                Error(NotConfiguredErr, DocExchServiceSetup.Caption());    end;    local procedure ExecuteWebServiceGetRequest(URL: Text): Boolean    var        TempBlob: Codeunit "Temp Blob";    begin        exit(ExecuteWebServiceRequest(URL, MethodGetTxt, TempBlob));    end;    local procedure ExecuteWebServicePostRequest(URL: Text; var TempBlob: Codeunit "Temp Blob"): Boolean    begin        exit(ExecuteWebServiceRequest(URL, MethodPostTxt, TempBlob));    end;    local procedure ExecuteWebServicePutRequest(URL: Text; var TempBlob: Codeunit "Temp Blob"): Boolean    begin        exit(ExecuteWebServiceRequest(URL, MethodPutTxt, TempBlob));    end;    local procedure ExecuteWebServiceRequest(URL: Text; Method: Text[6]; var TempBlob: Codeunit "Temp Blob"): Boolean    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        ErrorMessage: Text;    begin        Initialize(URL, Method, TempBlob);        if ExecuteWebServiceRequest() then            exit(true);        if IsNull(GLBHttpStatusCode) then            exit(false);        if not GLBHttpStatusCode.Equals(GLBHttpStatusCode.Unauthorized) then            exit(false);        AcquireAccessTokenByRefreshToken();        Initialize(URL, Method, TempBlob);        if ExecuteWebServiceRequest() then            exit(true);        if IsNull(GLBHttpStatusCode) then            exit(false);        if not GLBHttpStatusCode.Equals(GLBHttpStatusCode.Unauthorized) then            exit(false);        ErrorMessage := GetLastErrorText();        GetServiceSetUp(DocExchServiceSetup);        LogActivityFailed(DocExchServiceSetup.RecordId(), TokenExpiredTxt, ErrorMessage);        MarkTokenAsExpired();        SendRenewTokenNotification();        exit(false);    end;    [TryFunction]    local procedure ExecuteWebServiceRequest()    var        ErrorMessage: Text;        HttpStatusCodeNumber: Integer;    begin        Clear(GLBHttpStatusCode);        Clear(GLBResponseHeaders);        Clear(TempBlobResponse);        TempBlobResponse.CreateInStream(GLBResponseInStream);        if not GuiAllowed() then            HttpWebRequestMgt.DisableUI();        if not HttpWebRequestMgt.GetResponse(GLBResponseInStream, GLBHttpStatusCode, GLBResponseHeaders) then begin            if not HttpWebRequestMgt.ProcessFaultXMLResponse('', GetErrorXPath(), GetPrefix(), GetApiNamespace(), GLBHttpStatusCode, GLBResponseHeaders) then                ; // catch            ErrorMessage := GetLastErrorText();            if not IsNull(GLBHttpStatusCode) then                HttpStatusCodeNumber := GLBHttpStatusCode;            Session.LogMessage('0000EYX', StrSubstNo(CannotGetResponseTxt, HttpStatusCodeNumber, ErrorMessage), Verbosity::Warning, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(ErrorMessage); // rethrow        end;    end;    procedure CheckServiceEnabled()    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";    begin        GetServiceSetUp(DocExchServiceSetup);        CheckServiceEnabled(DocExchServiceSetup);    end;    procedure GetServiceSetUp(var DocExchServiceSetup: Record "Doc. Exch. Service Setup")    begin        if not DocExchServiceSetup.Get() then begin            Session.LogMessage('0000EYY', NotSetUpTxt, Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(NotSetUpTxt);        end;    end;    local procedure CheckServiceEnabled(var DocExchServiceSetup: Record "Doc. Exch. Service Setup")    begin        if not DocExchServiceSetup.Enabled then begin            Session.LogMessage('0000EYZ', NotEnabledTxt, Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(NotEnabledTxt);        end;    end;    local procedure CheckDocumentStatus(DocRecRef: RecordRef)    var        SalesInvoiceHeader: Record "Sales Invoice Header";        SalesCrMemoHeader: Record "Sales Cr.Memo Header";        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeCheckDocumentStatus(DocRecRef, IsHandled);        if IsHandled then            exit;        case DocRecRef.Number of            DATABASE::"Sales Invoice Header":                begin                    DocRecRef.SetTable(SalesInvoiceHeader);                    if SalesInvoiceHeader."Document Exchange Status" in                       [SalesInvoiceHeader."Document Exchange Status"::"Sent to Document Exchange Service",                        SalesInvoiceHeader."Document Exchange Status"::"Delivered to Recipient",                        SalesInvoiceHeader."Document Exchange Status"::"Pending Connection to Recipient"]                    then                        Error(CannotResendErr);                end;            DATABASE::"Sales Cr.Memo Header":                begin                    DocRecRef.SetTable(SalesCrMemoHeader);                    if SalesCrMemoHeader."Document Exchange Status" in                       [SalesCrMemoHeader."Document Exchange Status"::"Sent to Document Exchange Service",                        SalesCrMemoHeader."Document Exchange Status"::"Delivered to Recipient",                        SalesCrMemoHeader."Document Exchange Status"::"Pending Connection to Recipient"]                    then                        Error(CannotResendErr);                end;            else                Error(UnSupportedTableTypeErr, DocRecRef.Number);        end;    end;    local procedure GetUserAgent(): Text    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";    begin        GetServiceSetUp(DocExchServiceSetup);        if DocExchServiceSetup."User Agent" = '' then begin            Session.LogMessage('0000EZ0', StrSubstNo(FieldNotSpecifiedTxt, DocExchServiceSetup.FieldCaption("User Agent")), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FieldNotSpecifiedTxt, DocExchServiceSetup.FieldCaption("User Agent"));        end;        exit(DocExchServiceSetup."User Agent");    end;    local procedure GetFullURL(PartialURL: Text): Text    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";    begin        GetServiceSetUp(DocExchServiceSetup);        if DocExchServiceSetup."Service URL" = '' then begin            Session.LogMessage('0000EZ1', StrSubstNo(FieldNotSpecifiedTxt, DocExchServiceSetup.FieldCaption("Service URL")), Verbosity::Warning, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);            Error(FieldNotSpecifiedTxt, DocExchServiceSetup.FieldCaption("Service URL"));        end;        exit(DocExchServiceSetup."Service URL" + PartialURL);    end;    local procedure GetCheckConnectionURL(): Text    begin        exit(GetFullURL('/account/info'));    end;    local procedure GetPostSalesURL(DocRecRef: RecordRef) URL: Text    begin        OnBeforeGetPostSalesURL(DocRecRef, URL);        if URL <> '' then            exit(URL);        case DocRecRef.Number of            DATABASE::"Sales Invoice Header":                exit(GetPostSalesInvURL());            DATABASE::"Sales Cr.Memo Header":                exit(GetPostSalesCrMemoURL());            else                Error(UnSupportedTableTypeErr, DocRecRef.Number);        end;    end;    procedure GetPostSalesInvURL(): Text    begin        exit(            GetFullURL(StrSubstNo('/documents/dispatcher?documentId=%1&documentProfileId=tradeshift.invoice.ubl.1.0', GetGUID())));    end;    procedure GetPostSalesCrMemoURL(): Text    begin        exit(            GetFullURL(StrSubstNo('/documents/dispatcher?documentId=%1&documentProfileId=tradeshift.creditnote.ubl.1.0', GetGUID())));    end;    local procedure GetDocStatusURL(DocIdentifier: Text): Text    begin        exit(GetFullURL(StrSubstNo('/documents/%1/metadata', DocIdentifier)));    end;    local procedure GetPUTDocURL(FileName: Text): Text    begin        exit(GetFullURL(StrSubstNo('/documentfiles/%1/file?directory=outbox', FileName)));    end;    local procedure GetDispatchDocURL(FileName: Text): Text    begin        exit(GetFullURL(StrSubstNo('/documentfiles/%1/dispatcher?directory=outbox', FileName)));    end;    local procedure GetDispatchErrorsURL(DocIdentifier: Text): Text    begin        exit(GetFullURL(StrSubstNo('/documentfiles/%1/errors', DocIdentifier)));    end;    local procedure GetRetrieveDocsURL(): Text    begin        exit(GetFullURL(StrSubstNo('/documents?stag=inbox&withouttag=BusinessDelivered&limit=%1', GetChunckSize())));    end;    local procedure GetRetrieveDocIDURL(DocIdentifier: Text): Text    begin        exit(GetFullURL(StrSubstNo('/documents/%1', DocIdentifier)));    end;    local procedure GetRetrieveOriginalDocIDURL(DocIdentifier: Text): Text    begin        exit(GetFullURL(StrSubstNo('/documents/%1/original', DocIdentifier)));    end;    local procedure GetSetTagURL(DocIdentifier: Text): Text    begin        exit(GetFullURL(StrSubstNo('/documents/%1/tags/BusinessDelivered', DocIdentifier)));    end;    local procedure GetGUID(): Text    begin        GLBLastUsedGUID := DelChr(DelChr(Format(CreateGuid()), '=', '{'), '=', '}');        exit(GLBLastUsedGUID);    end;    local procedure UrlEncode(UrlComponent: Text): Text    var        HttpUtility: DotNet HttpUtility;    begin        exit(HttpUtility.UrlEncode(UrlComponent));    end;    [NonDebuggable]    local procedure UrlEncode(UrlComponent: SecretText): SecretText    var        HttpUtility: DotNet HttpUtility;    begin        exit(HttpUtility.UrlEncode(UrlComponent.Unwrap()));    end;    local procedure GetChunckSize(): Integer    begin        exit(100);    end;    local procedure GetApiNamespace(): Text    begin        exit('http://tradeshift.com/api/1.0');    end;    local procedure GetPublicNamespace(): Text    begin        exit('http://tradeshift.com/api/public/1.0');    end;    local procedure GetCBCNamespace(): Text    begin        exit('urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2');    end;    local procedure GetErrorXPath(): Text    begin        exit(StrSubstNo('//%1:Message', GetPrefix()));    end;    local procedure GetStatusXPath(): Text    begin        exit(StrSubstNo('//%1:DeliveryState', GetPrefix()));    end;    local procedure GetDocumentIDXPath(): Text    begin        exit(StrSubstNo('.//%1:DocumentId', GetPrefix()));    end;    local procedure GetDocumentTypeXPath(): Text    begin        exit(StrSubstNo('.//%1:DocumentType', GetPrefix()));    end;    local procedure GetDocumentIDForDescriptionXPath(): Text    begin        exit(StrSubstNo('.//%1:ID', GetPrefix()));    end;    local procedure GetEmbeddedDocXPath(): Text    begin        exit(StrSubstNo('//%1:EmbeddedDocumentBinaryObject', GetPrefix()));    end;    local procedure GetPrefix(): Text    begin        exit('newnamespace');    end;    local procedure GetDocumentIDKey(): Text    begin        exit('X-Tradeshift-DocumentId');    end;    [TryFunction]    local procedure TryGetDocumentDescription(Node: DotNet XmlNode;    var        Description: Text)    var        SrchNode: DotNet XmlNode;    begin        Description := '';        XMLDOMMgt.FindNodeWithNamespace(Node, GetDocumentTypeXPath(), GetPrefix(),          GetPublicNamespace(), SrchNode);        Description := MapDocumentType(XMLDOMMgt.GetAttributeValue(SrchNode, 'type'));        Description += ' ' + XMLDOMMgt.FindNodeTextWithNamespace(Node, GetDocumentIDForDescriptionXPath(),            GetPrefix(), GetPublicNamespace());    end;    local procedure MapDocumentType(DocType: Text): Text    var        PurchaseHeader: Record "Purchase Header";    begin        case DocType of            'invoice':                PurchaseHeader."Document Type" := PurchaseHeader."Document Type"::Invoice;            'creditnote':                PurchaseHeader."Document Type" := PurchaseHeader."Document Type"::"Credit Memo";            else                exit('');        end;        exit(Format(PurchaseHeader."Document Type"));    end;    procedure LogActivitySucceeded(RelatedRecordID: RecordID; ActivityDescription: Text; ActivityMessage: Text)    var        ActivityLog: Record "Activity Log";    begin        ActivityLog.LogActivity(RelatedRecordID, ActivityLog.Status::Success, LoggingConstTxt,          ActivityDescription, ActivityMessage);    end;    procedure LogActivityFailed(RelatedRecordID: RecordID; ActivityDescription: Text; ActivityMessage: Text)    var        ActivityMessageVar: Text;    begin        ActivityMessageVar := ActivityMessage;        LogActivityFailedCommon(RelatedRecordID, ActivityDescription, ActivityMessageVar);    end;    procedure LogActivityFailedAndError(RelatedRecordID: RecordID; ActivityDescription: Text; ActivityMessage: Text)    begin        LogActivityFailedCommon(RelatedRecordID, ActivityDescription, ActivityMessage);        if DelChr(ActivityMessage, '<>', ' ') <> '' then            Error(ActivityMessage);    end;    local procedure LogActivityFailedCommon(RelatedRecordID: RecordID; ActivityDescription: Text; var ActivityMessage: Text)    var        ActivityLog: Record "Activity Log";    begin        ActivityMessage := GetLastErrorText + ' ' + ActivityMessage;        ClearLastError();        ActivityLog.LogActivity(RelatedRecordID, ActivityLog.Status::Failed, LoggingConstTxt,          ActivityDescription, ActivityMessage);        if ActivityMessage = '' then            ActivityLog.SetDetailedInfoFromStream(GLBResponseInStream);        Commit();    end;    procedure EnableTraceLog(NewTraceLogEnabled: Boolean)    begin        GLBTraceLogEnabled := NewTraceLogEnabled;    end;    [EventSubscriber(ObjectType::Table, Database::"Service Connection", 'OnRegisterServiceConnection', '', false, false)]    procedure HandleVANRegisterServiceConnection(var ServiceConnection: Record "Service Connection")    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        RecRef: RecordRef;    begin        if not DocExchServiceSetup.Get() then begin            DocExchServiceSetup.Init();            DocExchServiceSetup.Insert();        end;        RecRef.GetTable(DocExchServiceSetup);        if DocExchServiceSetup.Enabled then            ServiceConnection.Status := ServiceConnection.Status::Enabled        else            ServiceConnection.Status := ServiceConnection.Status::Disabled;        ServiceConnection.InsertServiceConnection(            ServiceConnection, RecRef.RecordId(), DocExchServiceSetup.TableCaption(), DocExchServiceSetup."Service URL", PAGE::"Doc. Exch. Service Setup");    end;    [IntegrationEvent(true, false)]    [Scope('OnPrem')]    procedure OnAfterIncomingDocReceivedFromDocExch(var IncomingDocument: Record "Incoming Document")    begin    end;    [IntegrationEvent(false, false)]    local procedure OnGetClientId(var ClientId: Text)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnGetClientSecret(var ClientSecret: Text)    begin    end;    procedure GetExternalDocURL(DocID: Text): Text    var        URLPart: Text;    begin        URLPart := 'www';        if StrPos(GetFullURL(''), SandboxTxt) > 0 then            URLPart := SandboxTxt;        exit(StrSubstNo('https://%1.tradeshift.com/app/Tradeshift.Migration#::conversation/view/%2::', URLPart, DocID));    end;    procedure VerifyPrerequisites(ShowFailure: Boolean): Boolean    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";        PageDocExchServiceSetup: Page "Doc. Exch. Service Setup";        Success: Boolean;        IsHandled: Boolean;    begin        IsHandled := false;        OnBeforeVerifyPrerequisites(ShowFailure, Success, IsHandled);        if IsHandled then            exit(Success);        if DocExchServiceSetup.Get() then            if DocExchServiceSetup."Service URL" <> '' then                if DocExchServiceSetup."Auth URL" <> '' then                    if DocExchServiceSetup."Token URL" <> '' then                        Success := true;        if not Success then            if ShowFailure then                Error(NotConfiguredErr, PageDocExchServiceSetup.Caption());        exit(Success);    end;    local procedure LogTelemetryDocumentSent()    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";    begin        GetServiceSetUp(DocExchServiceSetup);        Session.LogMessage('000089R', DocExchServiceDocumentSuccessfullySentTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);        Session.LogMessage('000089S', DocExchServiceSetup."Service URL", Verbosity::Normal, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);    end;    local procedure LogTelemetryDocumentReceived()    var        DocExchServiceSetup: Record "Doc. Exch. Service Setup";    begin        GetServiceSetUp(DocExchServiceSetup);        Session.LogMessage('000089T', DocExchServiceDocumentSuccessfullyReceivedTxt, Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);        Session.LogMessage('000089U', DocExchServiceSetup."Service URL", Verbosity::Normal, DataClassification::CustomerContent, TelemetryScope::ExtensionPublisher, 'Category', TelemetryCategoryTok);    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeSendActivateAppNotification(var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeSetURLsToDefault(var DocExchServiceSetup: Record "Doc. Exch. Service Setup"; Sandbox: Boolean; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeVerifyPrerequisites(ShowFailure: Boolean; var Success: Boolean; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(false, false)]    local procedure OnBeforeCheckDocumentStatus(DocRecRef: RecordRef; var IsHandled: Boolean)    begin    end;    [IntegrationEvent(true, false)]    local procedure OnBeforeGetPostSalesURL(DocRecRef: RecordRef; var URL: Text)    begin    end;}