Page 1275 Doc. Exch. Service Setup

Base Application, Microsoft.EServices.EDocument

src/Layers/W1/BaseApp/eServices/EDocument/DocExchServiceSetup.Page.al462 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.Utilities;using System.Environment;using System.Security.Encryption;using System.Telemetry;page 1275 "Doc. Exch. Service Setup"{    AdditionalSearchTerms = 'electronic document,e-invoice,incoming document,ocr,ecommerce';    ApplicationArea = Basic, Suite;    Caption = 'Document Exchange Service Setup';    DeleteAllowed = false;    InsertAllowed = false;    LinksAllowed = false;    PageType = Card;    ShowFilter = false;    SourceTable = "Doc. Exch. Service Setup";    UsageCategory = Administration;    layout    {        area(content)        {            group(General)            {                Caption = 'General';                field("User Agent"; Rec."User Agent")                {                    ApplicationArea = Basic, Suite;                    Editable = EditableByNotEnabled;                    ShowMandatory = true;                }                field(Sandbox; Sandbox)                {                    Caption = 'Sandbox';                    ShowCaption = true;                    Editable = EditableByNotEnabled;                    ApplicationArea = Basic, Suite;                    ToolTip = 'Specifies if the service is enabled in Sandbox';                    trigger OnValidate()                    begin                        Rec.SetURLsToDefault(Sandbox);                        AppUrl := DocExchServiceMgt.GetAppUrl(Rec);                        CurrPage.SaveRecord();                        DocExchServiceMgt.SendActivateAppNotification();                    end;                }                field(Enabled; Rec.Enabled)                {                    ApplicationArea = Basic, Suite;                    trigger OnValidate()                    begin                        if Rec.IsEnabledChanged() then begin                            CurrPage.Update(true);                            UpdateBasedOnEnable();                        end;                    end;                }            }            group(Token)            {                Caption = 'Token';                Visible = StatusVisible;                field("Token Issued At"; Rec."Token Issued At")                {                    Caption = 'Issued At';                    ApplicationArea = Basic, Suite;                    Editable = false;                }                field("Token Expired"; Rec."Token Expired")                {                    Caption = 'Expired';                    ApplicationArea = Basic, Suite;                    Editable = false;                    StyleExpr = TokenStyleExpr;                    trigger OnDrillDown()                    begin                        if TokenStatus then begin                            Message(ValidTokenMsg);                            exit;                        end;                        if not Confirm(RenewExpiredTokenQst) then                            exit;                        DocExchServiceMgt.RenewToken(false);                        Rec.Get();                        CurrPage.Update(false);                    end;                }            }            group(Service)            {                Caption = 'Service';                field("Sign-up URL"; Rec."Sign-up URL")                {                    ApplicationArea = Basic, Suite;                    Editable = EditableByNotEnabled;                }                field("Sign-in URL"; Rec."Sign-in URL")                {                    ApplicationArea = Basic, Suite;                    Editable = EditableByNotEnabled;                    trigger OnValidate()                    begin                        AppUrl := DocExchServiceMgt.GetAppUrl(Rec);                    end;                }                field("App URL"; AppUrl)                {                    Caption = 'App URL';                    ApplicationArea = Basic, Suite;                    Editable = false;                    ExtendedDatatype = URL;                    ToolTip = 'Specifies the app URL in the document exchange service app store.';                }                field("Service URL"; Rec."Service URL")                {                    ApplicationArea = Basic, Suite;                    Editable = EditableByNotEnabled;                    ShowMandatory = true;                    trigger OnValidate()                    begin                        Sandbox := DocExchServiceMgt.IsSandbox(Rec);                    end;                }                field("Auth URL"; Rec."Auth URL")                {                    ApplicationArea = Basic, Suite;                    Visible = OAuth2Visible;                    Editable = EditableByNotEnabled;                    ShowMandatory = true;                }                field("Token URL"; Rec."Token URL")                {                    ApplicationArea = Basic, Suite;                    Visible = OAuth2Visible;                    Editable = EditableByNotEnabled;                    ShowMandatory = true;                }                field("Log Web Requests"; Rec."Log Web Requests")                {                    ApplicationArea = Basic, Suite;                    Editable = EditableByNotEnabled;                }            }            group(Authorization)            {                Caption = 'Authorization';                Visible = OAuth2Visible;                field("Client Id"; Rec."Client Id")                {                    Caption = 'Client ID';                    ApplicationArea = Basic, Suite;                    Editable = EditableByNotEnabled;                    trigger OnValidate()                    var                        BlankSecretText: SecretText;                    begin                        if Rec."Client Id" = '' then begin                            AppUrl := '';                            exit;                        end;                        if Rec."Client Id" = xRec."Client Id" then                            exit;                        Rec.SetAccessToken(BlankSecretText);                        Rec.SetRefreshToken(BlankSecretText);                        Rec."Id Token" := '';                        Rec."Token Subject" := '';                        Rec."Token Issued At" := 0DT;                        Rec."Token Expired" := false;                        CurrPage.SaveRecord();                        AppUrl := DocExchServiceMgt.GetAppUrl(Rec);                        DocExchServiceMgt.SendActivateAppNotification();                    end;                }                field("Client Secret"; ClientSecret)                {                    ApplicationArea = Basic, Suite;                    Caption = 'Client Secret';                    Editable = EditableByNotEnabled;                    ExtendedDatatype = Masked;                    ToolTip = 'Specifies the client secret of the application that will be used to connect to the document exchange service.';                    trigger OnValidate()                    begin                        if not CurrPage.Editable then begin                            ClientSecret := SavedClientSecret;                            exit;                        end;                        if not Rec.IsTemporary() then                            if ClientSecret <> '' then                                CheckEncryption();                        Rec.SetClientSecret(ClientSecret);                        SavedClientSecret := ClientSecret;                    end;                }                field("Redirect URL"; Rec."Redirect URL")                {                    ApplicationArea = Basic, Suite;                    Editable = EditableByNotEnabled and not SoftwareAsAService;                }            }        }    }    actions    {        area(processing)        {            action(SetURLsToDefault)            {                ApplicationArea = Basic, Suite;                Caption = 'Set URLs to Default';                Enabled = EditableByNotEnabled;                Image = Restore;                ToolTip = 'Change the service, sign-up, and sign-in URLs back to their default values. The changes occur immediately when you choose this action.';                trigger OnAction()                begin                    Rec.SetURLsToDefault(Sandbox);                    AppUrl := DocExchServiceMgt.GetAppUrl(Rec);                end;            }            action(RenewToken)            {                ApplicationArea = Basic, Suite;                Caption = 'Renew Token';                Image = Restore;                ToolTip = 'Renew the token for connecting to the document exchange service. This might require administrator account credentials for the document exchange service.';                trigger OnAction()                begin                    if not Confirm(RenewTokenQst) then                        exit;                    DocExchServiceMgt.RenewToken(true);                    Rec.Get();                    CurrPage.Update(false);                end;            }            action(TestConnection)            {                ApplicationArea = Basic, Suite;                Caption = 'Test Connection';                Image = Link;                ToolTip = 'Check that the settings that you added are correct and the connection to the document exchange service is working.';                trigger OnAction()                begin                    Rec.CheckConnection();                    Rec.Get();                    CurrPage.Update(false);                end;            }            action(JobQueueEntry)            {                ApplicationArea = Basic, Suite;                Caption = 'Job Queue Entry';                Enabled = Rec.Enabled;                Image = JobListSetup;                ToolTip = 'View or edit the jobs that automatically process the incoming and outgoing electronic documents.';                trigger OnAction()                begin                    Rec.ShowJobQueueEntry();                end;            }        }        area(navigation)        {            action(EncryptionManagement)            {                ApplicationArea = Basic, Suite;                Caption = 'Encryption Management';                Image = EncryptionKeys;                RunObject = Page "Data Encryption Management";                RunPageMode = View;                ToolTip = 'Enable or disable data encryption. Data encryption helps make sure that unauthorized users cannot read business data.';            }            action(ActivityLog)            {                ApplicationArea = Basic, Suite;                Caption = 'Activity Log';                Image = Log;                ToolTip = 'See the status and any errors for the electronic document or OCR file that you send through the document exchange service.';                trigger OnAction()                var                    ActivityLog: Record "Activity Log";                begin                    ActivityLog.ShowEntries(Rec);                end;            }        }        area(Promoted)        {            group(Category_Process)            {                Caption = 'Process', Comment = 'Generated from the PromotedActionCategories property index 1.';                actionref(TestConnection_Promoted; TestConnection)                {                }                actionref(SetURLsToDefault_Promoted; SetURLsToDefault)                {                }                actionref(RenewToken_Promoted; RenewToken)                {                }                actionref(JobQueueEntry_Promoted; JobQueueEntry)                {                }            }            group(Category_Report)            {                Caption = 'Page', Comment = 'Generated from the PromotedActionCategories property index 2.';            }            group(Category_Category4)            {                Caption = 'Encryption', Comment = 'Generated from the PromotedActionCategories property index 3.';                actionref(EncryptionManagement_Promoted; EncryptionManagement)                {                }            }        }    }    trigger OnAfterGetCurrRecord()    begin        UpdateBasedOnEnable();        SetStyleExpr();    end;    trigger OnAfterGetRecord()    begin        EditableByNotEnabled := not Rec.Enabled;    end;    trigger OnOpenPage()    var        FeatureTelemetry: Codeunit "Feature Telemetry";        ClientId: Text;    begin        Rec.Reset();        FeatureTelemetry.LogUptake('0000IM8', DocExchServiceMgt.GetFeatureTelemetryName(), Enum::"Feature Uptake Status"::Discovered);        if not Rec.Get() then begin            Rec.Init();            Rec.SetURLsToDefault(false);            Rec.Insert(true);        end;        Sandbox := DocExchServiceMgt.IsSandbox(Rec);        AppUrl := DocExchServiceMgt.GetAppUrl(Rec);        SetClientSecretGlobal();        SavedClientSecret := ClientSecret;        if (Rec."Redirect URL" = '') or (SoftwareAsAservice and (Rec."Redirect URL" <> DocExchServiceMgt.GetDefaultRedirectUrl())) then begin            Rec.SetDefaultRedirectUrl();            Rec.Modify();        end;        UpdateBasedOnEnable();        if Rec.Enabled and Rec."Token Expired" then begin            DocExchServiceMgt.SendRenewTokenNotification();            exit;        end;        ClientId := DocExchServiceMgt.GetClientId(Sandbox);        if (ClientId <> '') and (Rec."Token Issued At" = 0DT) then            DocExchServiceMgt.SendActivateAppNotification();    end;    trigger OnInit()    var        EnvironmentInformation: Codeunit "Environment Information";    begin        SoftwareAsAService := EnvironmentInformation.IsSaaSInfrastructure();        if not SoftwareAsAService then            OAuth2Visible := true        else            OAuth2Visible := not DocExchServiceMgt.HasPredefinedOAuth2Params();    end;    trigger OnQueryClosePage(CloseAction: Action): Boolean    begin        if not Rec.Enabled then            if not Confirm(StrSubstNo(EnableServiceQst, CurrPage.Caption), true) then                exit(false);    end;    var        DocExchServiceMgt: Codeunit "Doc. Exch. Service Mgt.";        Sandbox: Boolean;        OAuth2Visible: Boolean;        StatusVisible: Boolean;        SoftwareAsAService: Boolean;        EditableByNotEnabled: Boolean;        CheckedEncryption: Boolean;        TokenStatus: Boolean;        TokenStyleExpr: Text;        AppUrl: Text;        [NonDebuggable]        ClientSecret: Text;        [NonDebuggable]        SavedClientSecret: Text;        ValidTokenMsg: Label 'The token is not expired.';        EnableServiceQst: Label 'The %1 is not enabled. Are you sure you want to exit?', Comment = '%1 = page caption (Document Exchange Service Setup)';        RenewTokenQst: Label 'Do you want to renew the token to connect to the document exchange service?\\You might have to sign in to your account for the document exchange service.';        RenewExpiredTokenQst: Label 'The token for connecting to the document exchange service has expired.\\To renew the token, choose the Renew Token action.\\You might have to sign in to your account for the document exchange service.';        EncryptionIsNotActivatedQst: Label 'Data encryption is not activated. It is recommended that you encrypt data. \Do you want to open the Data Encryption Management window?';    local procedure UpdateBasedOnEnable()    begin        StatusVisible := Rec.Enabled;        EditableByNotEnabled := not Rec.Enabled;    end;    local procedure SetStyleExpr()    begin        TokenStatus := not Rec."Token Expired";        TokenStyleExpr := GetStyleExpr(TokenStatus);    end;    local procedure GetStyleExpr(Status: Boolean): Text    begin        if Status then            exit('Favorable');        exit('Unfavorable');    end;    local procedure CheckEncryption()    begin        if not CheckedEncryption and not EncryptionEnabled() then begin            CheckedEncryption := true;            if Confirm(EncryptionIsNotActivatedQst) then begin                PAGE.Run(PAGE::"Data Encryption Management");                CheckedEncryption := false;            end;        end;    end;    [NonDebuggable]    local procedure SetClientSecretGlobal()    begin        ClientSecret := Rec.GetClientSecretAsSecretText().Unwrap();    end;}