Page 2501 Extension Details
src/System Application/App/Extension Management/src/ExtensionDetails.Page.al497 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 System.Apps;using System.Environment;using System.Globalization;/// <summary>/// Displays details about the selected extension, and offers features for installing and uninstalling it./// </summary>page 2501 "Extension Details"{ Extensible = false; DeleteAllowed = false; InsertAllowed = false; PageType = NavigatePage; SourceTable = "Published Application"; SourceTableTemporary = true; ContextSensitiveHelpPage = 'ui-extensions'; Permissions = tabledata "Published Application" = r, tabledata "Windows Language" = r; layout { area(Content) { group("Install NAV Extension") { Caption = 'Install Extension'; Editable = false; Visible = Step1Enabled; group(InstallGroup) { Caption = 'Install Extension'; Editable = false; InstructionalText = 'Extensions add new capabilities that extend and enhance functionality.'; field(In_Name; Rec.Name) { ApplicationArea = All; Caption = 'Name'; ToolTip = 'Specifies the name of the extension.'; } field(In_Des; AppDescription) { ApplicationArea = All; Caption = 'Description'; Editable = false; MultiLine = true; ToolTip = 'Specifies the description of the extension.'; } field(In_Ver; VersionDisplay) { ApplicationArea = All; Caption = 'Version'; ToolTip = 'Specifies the version of the extension.'; } field(In_Pub; Rec.Publisher) { ApplicationArea = All; Caption = 'Publisher'; ToolTip = 'Specifies the publisher of the extension.'; } field(In_Id; AppIdDisplay) { ApplicationArea = All; Caption = 'App ID'; ToolTip = 'Specifies the app ID of the extension.'; } field(In_PublishedAs; Rec."Published As") { ApplicationArea = All; Caption = 'Published As'; Editable = false; ToolTip = 'Specifies whether the extension is published as a per-tenant, development, or a global extension.'; } field(In_Url; UrlLbl) { ApplicationArea = All; Caption = 'Website'; Editable = false; ShowCaption = false; ToolTip = 'Open a website for more information about the extension.'; trigger OnDrillDown() begin HyperLink(Rec.Url); end; } field(In_Help; HelpLbl) { ApplicationArea = All; Caption = 'Help'; Editable = false; ShowCaption = false; ToolTip = 'Get help with using the extension.'; trigger OnDrillDown() begin HyperLink(Rec.Help); end; } } } group("Uninstall NAV Extension") { Caption = 'Uninstall Extension'; Visible = IsInstalled; group(UninstallGroup) { Caption = 'Uninstall Extension'; InstructionalText = 'Uninstall extension to remove added features.'; field(Un_Name; Rec.Name) { ApplicationArea = All; Caption = 'Name'; Editable = false; ToolTip = 'Specifies the name of the extension.'; } field(Un_Des; AppDescription) { ApplicationArea = All; Caption = 'Description'; ToolTip = 'Specifies the description of the extension.'; Editable = false; MultiLine = true; } field(Un_Ver; VersionDisplay) { ApplicationArea = All; Caption = 'Version'; ToolTip = 'Specifies the version of the extension.'; Editable = false; } field(Un_Pub; Rec.Publisher) { ApplicationArea = All; Caption = 'Publisher'; ToolTip = 'Specifies the publisher of the extension.'; Editable = false; } field(Un_Id; AppIdDisplay) { ApplicationArea = All; Caption = 'App ID'; ToolTip = 'Specifies the app ID of the extension.'; Editable = false; } field(Un_PublishedAs; Rec."Published As") { ApplicationArea = All; Caption = 'Published As'; Editable = false; ToolTip = 'Specifies whether the extension is published as a per-tenant, development, or a global extension.'; } field(Un_ClearSchema; ClearSchema) { ApplicationArea = All; Caption = 'Delete Extension Data'; Editable = true; ToolTip = 'Specifies if the tables that contain data owned by this extension should be deleted on uninstall. This action cannot be undone.'; trigger OnValidate() begin ExtensionInstallationImpl.GetClearExtensionSchemaConfirmation(Rec."Package ID", ClearSchema); end; } field(Un_Terms; TermsLbl) { ApplicationArea = All; Caption = 'Terms and Conditions'; ToolTip = 'View the terms and conditions for the extension.'; Editable = false; ShowCaption = false; Visible = Legal; trigger OnDrillDown() var EnvironmentInfo: Codeunit "Environment Information"; begin if EnvironmentInfo.IsSaaS() then if Rec.EULA = OnPremEULALbl then Rec.EULA := SaaSEULALbl; HyperLink(Rec.EULA); end; } field(Un_Privacy; PrivacyLbl) { ApplicationArea = All; Caption = 'Privacy Statement'; ToolTip = 'View the privacy statement for the extension.'; Editable = false; ShowCaption = false; Visible = Legal; trigger OnDrillDown() var EnvironmentInfo: Codeunit "Environment Information"; begin if EnvironmentInfo.IsSaaS() then if Rec."Privacy Statement" = OnPremPrivacyLbl then Rec."Privacy Statement" := SaaSPrivacyLbl; HyperLink(Rec."Privacy Statement"); end; } field(Un_Url; UrlLbl) { ApplicationArea = All; Caption = 'Website'; ToolTip = 'Opens the extension''s website.'; Editable = false; ShowCaption = false; trigger OnDrillDown() begin HyperLink(Rec.Url); end; } field(Un_Help; HelpLbl) { ApplicationArea = All; Caption = 'Help'; ToolTip = 'Get help with using the extension.'; Editable = false; ShowCaption = false; trigger OnDrillDown() begin HyperLink(Rec.Help); end; } } } group(Installation) { Caption = 'Installation'; Visible = BackEnabled; group("Review Extension Information before installation") { Caption = 'Review Extension Information before installation'; field(Name; Rec.Name) { ApplicationArea = All; Caption = 'Name'; ToolTip = 'Specifies the name of the extension.'; Editable = false; } field(Publisher; Rec.Publisher) { ApplicationArea = All; Caption = 'Publisher'; ToolTip = 'Specifies the publisher of the extension.'; Editable = false; } field(Language; LanguageName) { ApplicationArea = All; Caption = 'Language'; ToolTip = 'Specifies the language of the extension.'; Editable = false; trigger OnAssistEdit() var Language: Codeunit Language; begin Language.LookupApplicationLanguageId(LanguageID); LanguageName := Language.GetWindowsLanguageName(LanguageID); end; } group(Control30) { ShowCaption = false; Visible = Legal; field(Terms; TermsLbl) { ApplicationArea = All; Caption = 'Terms and Conditions'; ToolTip = 'View the terms and conditions for the extension.'; Editable = false; ShowCaption = false; Visible = Legal; trigger OnDrillDown() begin HyperLink(Rec.EULA); end; } field(Privacy; PrivacyLbl) { ApplicationArea = All; Caption = 'Privacy Statement'; ToolTip = 'View the privacy statement for the extension.'; Editable = false; ShowCaption = false; Visible = Legal; trigger OnDrillDown() begin HyperLink(Rec."Privacy Statement"); end; } field(Accepted; IsAccepted) { ApplicationArea = All; Caption = 'I accept the terms and conditions'; ToolTip = 'Specifies the acceptance of terms and conditions.'; Visible = Legal; } } } } group(Links) { Caption = 'Application operation best practices links'; ShowCaption = false; Visible = true; field(BestPractices; 'Read more about the best practices for installing and publishing extensions') { ApplicationArea = All; ShowCaption = false; Editable = false; ToolTip = 'Read more about the best practices for installing and publishing extensions.'; trigger OnDrillDown() var ExtensionInstallationImpl: Codeunit "Extension Installation Impl"; begin Hyperlink(ExtensionInstallationImpl.GetInstallationBestPracticesURL()); end; } } } } actions { area(Processing) { action(Back) { ApplicationArea = All; Caption = 'Back'; ToolTip = 'Back'; Image = PreviousRecord; InFooterBar = true; Visible = BackEnabled; trigger OnAction() begin BackEnabled := false; NextEnabled := true; Step1Enabled := true; InstallEnabled := false; end; } action(Next) { ApplicationArea = All; Caption = 'Next'; ToolTip = 'Next'; Image = NextRecord; InFooterBar = true; Visible = NextEnabled; trigger OnAction() begin BackEnabled := true; NextEnabled := false; Step1Enabled := false; InstallEnabled := true; end; } action(Install) { ApplicationArea = All; Caption = 'Install'; ToolTip = 'Install'; Enabled = IsAccepted; Image = Approve; InFooterBar = true; Visible = InstallEnabled and (not IsInstalled); trigger OnAction() begin ExtensionInstallationImpl.InstallExtensionWithConfirmDialog(Rec."Package ID", LanguageID); CurrPage.Close(); end; } action(Uninstall) { ApplicationArea = All; Caption = 'Uninstall'; ToolTip = 'Uninstall'; Image = Approve; InFooterBar = true; Visible = IsInstalled; trigger OnAction() begin ExtensionInstallationImpl.UninstallExtensionWithConfirmDialog(Rec."Package ID", false, ClearSchema); CurrPage.Close(); end; } } } trigger OnOpenPage() begin PublishedApplication.SetRange("Package ID", Rec."Package ID"); PublishedApplication.SetRange("Tenant Visible", true); if not PublishedApplication.FindFirst() then CurrPage.Close(); SetPublishedAppRecord(); SetPageConfig(); SetLanguageConfig(); end; var PublishedApplication: Record "Published Application"; ExtensionInstallationImpl: Codeunit "Extension Installation Impl"; AppDescription: BigText; AppIdDisplay: Text; VersionDisplay: Text; LanguageName: Text; LanguageID: Integer; BackEnabled: Boolean; NextEnabled: Boolean; InstallEnabled: Boolean; IsAccepted: Boolean; IsInstalled: Boolean; Legal: Boolean; Step1Enabled: Boolean; ClearSchema: Boolean; InstallationPageCaptionMsg: Label 'Extension Installation', Comment = 'Caption for when extension needs to be installed'; UninstallationPageCaptionMsg: Label 'Extension Uninstallation', Comment = 'Caption for when extension needs to be uninstalled'; TermsLbl: Label 'Terms and Conditions'; PrivacyLbl: Label 'Privacy Statement', Comment = 'Label for privacy statement link'; UrlLbl: Label 'Website'; HelpLbl: Label 'Help'; SaaSEULALbl: Label ' https://go.microsoft.com/fwlink/?linkid=834880', Locked = true; SaaSPrivacyLbl: Label 'https://go.microsoft.com/fwlink/?linkid=834881', Locked = true; OnPremEULALbl: Label 'https://go.microsoft.com/fwlink/?linkid=2009120', Locked = true; OnPremPrivacyLbl: Label 'https://go.microsoft.com/fwlink/?LinkId=724009', Locked = true; local procedure SetPublishedAppRecord() var DescriptionStream: InStream; begin Rec.TransferFields(PublishedApplication, true); AppIdDisplay := LowerCase(DelChr(Format(Rec.ID), '=', '{}')); VersionDisplay := ExtensionInstallationImpl.GetVersionDisplayString(PublishedApplication); PublishedApplication.CalcFields(Description); PublishedApplication.Description.CreateInStream(DescriptionStream, TextEncoding::UTF8); AppDescription.Read(DescriptionStream); Rec.Insert(); end; local procedure SetLanguageConfig() var WindowsLanguageTable: Record "Windows Language"; begin LanguageID := GlobalLanguage(); WindowsLanguageTable.SetRange("Language ID", LanguageID); if WindowsLanguageTable.FindFirst() then LanguageName := WindowsLanguageTable.Name; end; local procedure SetPageConfig() begin IsInstalled := ExtensionInstallationImpl.IsInstalledByPackageId(Rec."Package ID"); if IsInstalled then begin CurrPage.Caption(UninstallationPageCaptionMsg); NextEnabled := false; Step1Enabled := false; end else begin CurrPage.Caption(InstallationPageCaptionMsg); NextEnabled := true; Step1Enabled := true; end; // Any legal info to display Legal := ((StrLen(Rec."Privacy Statement") <> 0) or (StrLen(Rec.EULA) <> 0)); // Auto accept if no legal info IsAccepted := not Legal; end;}