Page 2012 Entity Text Part
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