Page 2012 Entity Text Part

System Application, System.Text

src/System Application/App/Entity Text/src/EntityTextPart.Page.al194 lines, Copyright (c) Microsoft Corporation. MIT

#if not CLEAN24// ------------------------------------------------------------------------------------------------// Copyright (c) Microsoft Corporation. All rights reserved.// Licensed under the MIT License. See License.txt in the project root for license information.// ------------------------------------------------------------------------------------------------namespace System.Text;/// <summary>/// A reusable component to modify entity texts with a rich text editor./// See the "Entity Text" page for an example implementation./// </summary>page 2012 "Entity Text Part"{    ObsoleteState = Pending;    ObsoleteReason = 'This page part contains only a rich text editor, use the rich text editor control separately on your page instead.';    ObsoleteTag = '24.0';    ApplicationArea = All;    Caption = 'Entity Text Part';    DelayedInsert = true;    InsertAllowed = false;    LinksAllowed = false;    PageType = CardPart;    Extensible = false;    layout    {        area(Content)        {            group(EntityTextGroup)            {                ShowCaption = false;                field("Entity Text Editor"; EntityTextContent)                {                    ToolTip = 'Specifies the rich text content of the text.';                    MultiLine = true;                    ExtendedDatatype = RichContent;                    CaptionClass = ContentCaption;                    StyleExpr = false;                }            }        }    }    trigger OnInit()    begin        if ContentCaption = '' then            ContentCaption := ContentLbl;    end;    /// <summary>    /// Sets the context for the Entity Text Page Part.    /// </summary>    /// <param name="InitialText">The initial text to set in the rich text editor.</param>    /// <param name="InitialFacts">The initial facts to use for suggesting text.</param>    /// <param name="InitialTextTone">The initial tone of text to use for suggesting text.</param>    /// <param name="InitialTextFormat">The initial text format to use for suggesting text.</param>    /// <remarks>Text cannot be suggested without calling SetContext.</remarks>    procedure SetContext(InitialText: Text; var InitialFacts: Dictionary of [Text, Text]; var InitialTextTone: Enum "Entity Text Tone"; var InitialTextFormat: Enum "Entity Text Format")    var        EntityTextImpl: Codeunit "Entity Text Impl.";        CurrentModuleInfo: ModuleInfo;        EntityTextModuleInfo: ModuleInfo;    begin        NavApp.GetCallerModuleInfo(CurrentModuleInfo);        NavApp.GetCurrentModuleInfo(EntityTextModuleInfo);        if CurrentModuleInfo.Id() <> EntityTextModuleInfo.Id() then            CallerModuleInfo := CurrentModuleInfo;        Session.LogMessage('0000JVK', StrSubstNo(TelemetrySetContextTxt, Format(CallerModuleInfo.Id()), CallerModuleInfo.Publisher()), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', EntityTextImpl.GetFeatureName());        Facts := InitialFacts;        TextTone := InitialTextTone;        TextFormat := InitialTextFormat;        EntityTextContent := InitialText;    end;    /// <summary>    /// Sets the facts used for text suggestion.    /// </summary>    /// <param name="NewFacts">The new facts to use.</param>    procedure SetFacts(NewFacts: Dictionary of [Text, Text])    begin        Facts := NewFacts;    end;    /// <summary>    /// Sets the text tone used for text suggestion.    /// </summary>    /// <param name="NewTextTone">The new text tone to use.</param>    procedure SetTextTone(NewTextTone: Enum "Entity Text Tone")    begin        TextTone := NewTextTone;    end;    /// <summary>    /// Sets the text format used for text suggestion.    /// </summary>    /// <param name="NewTextFormat">The new text format to use.</param>    procedure SetTextFormat(NewTextFormat: Enum "Entity Text Format")    begin        TextFormat := NewTextFormat;    end;    /// <summary>    /// Sets the text emphasis used for text suggestion.    /// </summary>    /// <param name="NewTextEmphasis">The new text emphasis to use.</param>    procedure SetTextEmphasis(NewTextEmphasis: Enum "Entity Text Emphasis")    begin        TextEmphasis := NewTextEmphasis;    end;#if not CLEAN24    /// <summary>    /// Sets whether the parent page has advanced options used for text suggestion.    /// </summary>    /// <param name="NewHasAdvancedOptions">If the parent page has advanced options to use.</param>    [Obsolete('Moving to Prompt Dialog page for Copilot that does not support this functionality.', '24.0')]    procedure SetHasAdvancedOptions(NewHasAdvancedOptions: Boolean)    begin    end;    /// <summary>    /// Gets whether the advanced options should be visible.    /// </summary>    /// <returns>True if the advanced options should be shown.</returns>    /// <remarks>    /// If the parent page has advanced options, it is recommended to check this OnAfterGetCurrRecord.    /// Additionally, UpdatePropagation should be set to Both on the part.    /// This way, the part can notify the parent when the state changes.    /// </remarks>    [Obsolete('Moving to Prompt Dialog page for Copilot that does not support this functionality.', '24.0')]    procedure ShowAdvancedOptions(): Boolean    begin        exit(false);    end;#endif    /// <summary>    /// Updates the Entity Text record with the current text.    /// </summary>    /// <param name="EntityText">The entity text record to update.</param>    procedure UpdateRecord(var EntityText: Record "Entity Text")    var        EntityTextImpl: Codeunit "Entity Text Impl.";    begin        Session.LogMessage('0000JVL', StrSubstNo(TelemetryUpdateRecordTxt, Format(EntityText."Source Table Id"), Format(EntityText.Scenario)), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', EntityTextImpl.GetFeatureName());        EntityTextImpl.SetText(EntityText, EntityTextContent);    end;    /// <summary>    /// Sets the field caption on the rich text editor.    /// </summary>    /// <param name="NewCaption">The caption to use.</param>    /// <remarks>The caption specified here will also be used for the placeholder text in the editor if it is empty.</remarks>    procedure SetContentCaption(NewCaption: Text)    begin        ContentCaption := NewCaption;    end;    internal procedure SetModuleInfo(NewModuleInfo: ModuleInfo)    var        EntityTextImpl: Codeunit "Entity Text Impl.";        CurrentModuleInfo: ModuleInfo;        EntityTextModuleInfo: ModuleInfo;    begin        NavApp.GetCurrentModuleInfo(EntityTextModuleInfo);        NavApp.GetCallerModuleInfo(CurrentModuleInfo);        Session.LogMessage('0000JVM', StrSubstNo(TelemetrySetModuleTxt, Format(NewModuleInfo.Id()), NewModuleInfo.Publisher(), Format(CurrentModuleInfo.Id()), CurrentModuleInfo.Publisher()), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', EntityTextImpl.GetFeatureName());        if CurrentModuleInfo.Id() <> EntityTextModuleInfo.Id() then            exit;        CallerModuleInfo := NewModuleInfo;    end;    var        Facts: Dictionary of [Text, Text];        TextTone: Enum "Entity Text Tone";        TextFormat: Enum "Entity Text Format";        TextEmphasis: Enum "Entity Text Emphasis";        EntityTextContent: Text;        CallerModuleInfo: ModuleInfo;        ContentCaption: Text;        ContentLbl: Label 'Content';        TelemetrySetContextTxt: Label 'Context set for the entity text edit page. Calling module %1 (%2).', Locked = true, Comment = '%1 = the app id, %2 = the publisher name';        TelemetrySetModuleTxt: Label 'Attempting to update the calling module to %1 (%2). This was requested by %3 (%4).', Locked = true, Comment = '%1 the new app id, %2 the new publisher, %3 the calling app id, %4 the calling publisher';        TelemetryUpdateRecordTxt: Label 'Updating text on record for table %1 and scenario %2.', Locked = true, Comment = '%1 the table id, %2 the scenario id';}#endif