Page 4310 Agent Setup Part

System Application, System.Agents

src/System Application/App/Agent/Setup/SetupPart/AgentSetupPart.Page.al203 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.Agents;/// <summary>/// Setup part that is representing the first page of the configuration dialog/// </summary>page 4310 "Agent Setup Part"{    PageType = CardPart;    ApplicationArea = All;    Extensible = false;    Caption = 'Configure Agent';    InstructionalText = 'Choose how the agent helps with inquiries, quotes, and orders.';    SourceTable = "Agent Setup Buffer";    RefreshOnActivate = true;    InherentEntitlements = X;    InherentPermissions = X;    layout    {        area(Content)        {            group(Header)            {                field(Badge; Rec.Initials)                {                    ShowCaption = false;                    Editable = false;                    ToolTip = 'The badge of the agent.';                }                field(Type; AgentPublisherText)                {                    ShowCaption = false;                    Editable = false;                    ToolTip = 'Specifies the publisher/type of the agent.';                }                field(Name; Rec."Display Name")                {                    ShowCaption = false;                    Editable = false;                    ToolTip = 'Specifies the name of the agent.';                }                field(State; Rec.State)                {                    Caption = 'Active';                    ToolTip = 'Specifies the state of the agent, such as active or inactive.';                    trigger OnValidate()                    begin                        Rec."State Updated" := true;                        Rec.Modify();                        CurrPage.Update(false);                    end;                }                field(LanguageAndRegion; LanguageAndRegionLbl)                {                    ShowCaption = false;                    Editable = false;                    ToolTip = 'Specifies the language and region settings for the agent.';                    trigger OnDrillDown()                    begin                        if AgentSetup.OpenLanguageAndRegionPage(Rec) then begin                            UpdateAgentSummaryDisplayText();                            CurrPage.Update(false);                        end;                    end;                }                field(UserAccessLink; ManageUserAccessLbl)                {                    Caption = 'Coworkers can use this agent.';                    Editable = false;                    ToolTip = 'Specifies the user access control settings for the agent.';                    trigger OnDrillDown()                    begin                        if AgentSetup.UpdateUserAccessControl(Rec) then                            CurrPage.Update(false);                    end;                }            }            field(Summary; AgentSummaryDisplayText)            {                Caption = 'Summary';                MultiLine = true;                Editable = false;                ToolTip = 'Specifies a brief description of the agent.';            }            field(LanguageUsed; Rec."Language Used")            {                Caption = 'Language used';                Editable = false;                ToolTip = 'Specifies the language that the agent uses to communicate.';            }        }    }    /// <summary>    /// Initializes the setup page.    /// </summary>    /// <param name="UserSecurityID">Represents the User Security ID of the agent being configured. It should be a null guid if it is a new agent</param>    /// <param name="AgentMetadataProvider">The metadata provider for the agent being configured.</param>    /// <param name="DefaultUserName">Default user name to use if creating a new agent.</param>    /// <param name="DefaultDisplayName">Default display name to use if creating a new agent.</param>    /// <param name="NewAgentSummary">Summary information about the agent showing the agent capabilities.</param>    procedure Initialize(UserSecurityID: Guid; AgentMetadataProvider: Enum "Agent Metadata Provider"; DefaultUserName: Code[50]; DefaultDisplayName: Text[80]; NewAgentSummary: Text)    begin        AgentSetup.GetSetupRecord(Rec, UserSecurityID, AgentMetadataProvider, DefaultUserName, DefaultDisplayName, NewAgentSummary);        AgentSummary := NewAgentSummary;        UpdateAgentSummaryDisplayText();        UpdateAgentPublisherText();    end;    /// <summary>    /// Returns the setup buffer from this page that can be used to save the agent configuration. See <see cref="SaveChanges"/> method in <see cref="Agent Setup"/> codeunit.    /// </summary>    /// <param name="AgentSetupBuffer">The setup buffer that is used for configuring the agent.</param>    procedure GetAgentSetupBuffer(var AgentSetupBuffer: Record "Agent Setup Buffer")    var        AgentSetupImpl: Codeunit "Agent Setup Impl.";    begin        AgentSetupImpl.CopySetupRecord(AgentSetupBuffer, Rec);    end;    /// <summary>    /// Sets the agent setup buffer as the new record.    /// You need to update the page manually after calling this method.    /// </summary>    /// <param name="AgentSetupBuffer">    /// The setup buffer that is used for configuring the agent that will be set as a new record.    /// </param>    procedure SetAgentSetupBuffer(var AgentSetupBuffer: Record "Agent Setup Buffer")    var        AgentSetupImpl: Codeunit "Agent Setup Impl.";    begin        AgentSetupImpl.CopySetupRecord(Rec, AgentSetupBuffer);        AgentSummary := AgentSetupImpl.GetAgentSummary(AgentSetupBuffer);        UpdateAgentSummaryDisplayText();        UpdateAgentPublisherText();    end;    /// <summary>    /// Sets the agent summary to the page.    /// You need to update the page manually after calling this method.    /// </summary>    /// <param name="NewAgentSummary">    /// The new summary information about the agent.    /// </param>    procedure SetAgentSummary(NewAgentSummary: Text)    begin        AgentSummary := NewAgentSummary;        UpdateAgentSummaryDisplayText();    end;    /// <summary>    /// Returns if the changes were made to the setup.    /// </summary>    /// <returns>>True if there are changes made, false otherwise.</returns>    procedure GetChangesMade(): Boolean    begin        exit(AgentSetup.GetChangesMade(Rec));    end;    local procedure UpdateAgentSummaryDisplayText()    var        AgentSetupImpl: Codeunit "Agent Setup Impl.";    begin        AgentSummaryDisplayText := AgentSetupImpl.AppendAgentSummary(Rec, AgentSummary);    end;    local procedure UpdateAgentPublisherText()    begin        AgentPublisherText := GetAgentPublisherText();    end;    local procedure GetAgentPublisherText(): Text    var        AgentUtilities: Codeunit "Agent Utilities";        AgentPublisherType: Enum "Agent Publisher Type";        AgentPublisherName: Text[250];    begin        if not AgentUtilities.TryGetAgentPublisherInfo(Rec."Agent Metadata Provider", AgentPublisherName, AgentPublisherType) then            exit('');        if AgentPublisherType = AgentPublisherType::User then            exit(UserCreatedAgentPublisherLbl);        exit(StrSubstNo(AgentPublisherLbl, AgentPublisherName));    end;    var        AgentSetup: Codeunit "Agent Setup";        AgentSummaryDisplayText: Text;        AgentSummary: Text;        AgentPublisherText: Text;        AgentPublisherLbl: Label 'By %1', Comment = '%1 is The agent publisher name';        UserCreatedAgentPublisherLbl: Label 'Agent';        ManageUserAccessLbl: Label 'Manage user access';        LanguageAndRegionLbl: Label 'Language and region';}