Page 1275 Doc. Exch. Service Setup
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;}