Page 2501 Extension Details in 28

// ------------------------------------------------------------------------------------------------
// 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;
}