Table 4310 Agent Setup Buffer
src/System Application/App/Agent/Setup/SetupPart/AgentSetupBuffer.Table.al227 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;using System.Environment.Configuration;/// <summary>/// Setup record used to configure the agents. It should be used together with <see cref="Agent Setup"/> codeunit and <see cref="Agent Setup Part"/> page./// </summary>table 4310 "Agent Setup Buffer"{ Caption = 'Agent Setup Buffer'; TableType = Temporary; ReplicateData = false; DataClassification = SystemMetadata; InherentEntitlements = X; InherentPermissions = X; fields { /// <summary> /// The unique security identifier for the user account associated with this agent. /// </summary> field(1; "User Security ID"; Guid) { Caption = 'User Security ID'; Tooltip = 'Specifies the unique identifier for the agent user.'; } /// <summary> /// The provider that supplies metadata and configuration information for this agent. /// </summary> field(2; "Agent Metadata Provider"; Enum "Agent Metadata Provider") { Caption = 'Agent Metadata Provider'; Tooltip = 'Specifies the provider for the agent metadata.'; } /// <summary> /// The user name of the account associated with this agent. /// </summary> field(3; "User Name"; Code[50]) { Caption = 'User Name'; Tooltip = 'Specifies the name of the user that is associated with the agent.'; trigger OnValidate() begin Rec."Values Updated" := true; end; } /// <summary> /// The display name shown for this agent in the user interface. /// </summary> field(4; "Display Name"; Text[80]) { Caption = 'Display Name'; Tooltip = 'Specifies the display name of the user that is associated with the agent.'; trigger OnValidate() begin Rec."Values Updated" := true; end; } /// <summary> /// The current operational state of the agent (Enabled or Disabled). /// </summary> field(5; "State"; Option) { Caption = 'State'; OptionCaption = 'Active,Inactive'; OptionMembers = Enabled,Disabled; Tooltip = 'Specifies the state of the user that is associated with the agent.'; InitValue = Disabled; trigger OnValidate() begin SetStateUpdated(); end; } /// <summary> /// The initials displayed on the agent's icon in the timeline and user interface. /// </summary> field(15; Initials; Text[4]) { Caption = 'Initials'; ToolTip = 'Specifies the initials to be displayed on the icon opening the agent''s timeline.'; } /// <summary> /// Short summary of the agents capabilities and role. /// </summary> field(5000; "Agent Summary"; Blob) { Caption = 'Agent Summary'; ToolTip = 'Specifies a short summary of the agents capabilities and role. Value is changed through code.'; } /// <summary> /// Specifies the language that is used for task details and outgoing messages unless language is changed by the code /// </summary> field(5001; "Language Used"; Text[1024]) { Caption = 'Language Used'; ToolTip = 'Specifies the language that is used for task details and outgoing messages unless language is changed by the code. Value is changed through code.'; Editable = false; AllowInCustomizations = Never; } /// <summary> /// Specifies whether the values are updated. Example of the fields that are tracked are - user name, user display name, initials. Value is changed through code. /// </summary> field(5002; "Values Updated"; Boolean) { Caption = 'Config Updated'; ToolTip = 'Specifies whether the configuration has been updated. Value is changed through code.'; Editable = false; AllowInCustomizations = Never; } /// <summary> /// Specifies whether the access control to the agent is updated. This means that the settings on who can access the agent were changed. /// </summary> field(5003; "Access Updated"; Boolean) { Caption = 'Access Updated'; ToolTip = 'Specifies whether the access control has been updated. Value is changed through code.'; Editable = false; AllowInCustomizations = Never; } /// <summary> /// Specifies whether the user settings (language, regional settings, time zone) have been updated. /// </summary> field(5004; "User Settings Updated"; Boolean) { Caption = 'User Settings Updated'; ToolTip = 'Specifies whether the user settings (language, regional settings, time zone) have been updated. Value is changed through code.'; Editable = false; AllowInCustomizations = Never; } /// <summary> /// Specifies whether the state (Active or Inactive) was updated. /// </summary> field(5005; "State Updated"; Boolean) { Caption = 'State Updated'; ToolTip = 'Specifies whether the state has been updated. Value is changed through code.'; Editable = false; AllowInCustomizations = Never; } /// <summary> /// Specifies the last user who configured the agent. /// </summary> field(5020; "Configured By"; Guid) { Caption = 'Configured By'; ToolTip = 'Specifies the last user who configured the agent.'; Editable = false; } } keys { key(PK; "User Security ID") { Clustered = true; } } internal procedure SetTempAgentAccessControl(var NewTempAgentAccessControl: Record "Agent Access Control" temporary) begin TempAgentAccessControl.Reset(); TempAgentAccessControl.DeleteAll(); CopyTempAgentAccessControl(NewTempAgentAccessControl, TempAgentAccessControl); end; internal procedure GetTempAgentAccessControl(var TempCopiedTempAccessControl: Record "Agent Access Control" temporary) begin CopyTempAgentAccessControl(TempAgentAccessControl, TempCopiedTempAccessControl); TempCopiedTempAccessControl.Reset(); end; internal procedure CopyTempAgentAccessControl(var SourceTempAgentAccessControl: Record "Agent Access Control" temporary; var TargetTempAgentAccessControl: Record "Agent Access Control" temporary) begin TargetTempAgentAccessControl.Reset(); TargetTempAgentAccessControl.DeleteAll(); if not SourceTempAgentAccessControl.FindSet() then exit; repeat TargetTempAgentAccessControl.TransferFields(SourceTempAgentAccessControl, true); TargetTempAgentAccessControl.Insert() until SourceTempAgentAccessControl.Next() = 0; end; internal procedure GetUserSettings(var TempNewUserSetting: Record "User Settings" temporary) var TempFetchedUserSettings: Record "User Settings"; Agent: Codeunit Agent; UpdateTempUserSettings: Boolean; begin UpdateTempUserSettings := not TempUserSettings.FindFirst(); UpdateTempUserSettings := UpdateTempUserSettings or (TempUserSettings."User Security ID" <> Rec."User Security ID"); if UpdateTempUserSettings then begin TempUserSettings.Reset(); TempUserSettings.DeleteAll(); Agent.GetUserSettings(Rec."User Security ID", TempFetchedUserSettings); TempUserSettings.Copy(TempFetchedUserSettings); TempUserSettings.Insert(); end; TempNewUserSetting.Copy(TempUserSettings, true); end; internal procedure SetUserSettings(var UserSettingsRec: Record "User Settings") begin TempUserSettings.Reset(); TempUserSettings.DeleteAll(); TempUserSettings.Copy(UserSettingsRec); TempUserSettings.Insert(); end; local procedure SetStateUpdated() begin Rec."State Updated" := true; end; var TempAgentAccessControl: Record "Agent Access Control" temporary; TempUserSettings: Record "User Settings" temporary;}