Page 2011 Entity Text Factbox Part

System Application, System.Text

src/System Application/App/Entity Text/src/EntityTextFactboxPart.Page.al247 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.Text;/// <summary>/// A card part to use on a factbox to display the entity text./// Ensure the SetContext procedure is called OnAfterGetCurrentRecord on the parent page./// </summary>page 2011 "Entity Text Factbox Part"{    ApplicationArea = All;    Caption = 'Entity Text';    DelayedInsert = true;    InsertAllowed = false;    LinksAllowed = false;    PageType = CardPart;    Extensible = false;    SourceTable = "Entity Text";    SourceTableTemporary = true;    RefreshOnActivate = true;    layout    {        area(Content)        {            group(EntityTextGroup)            {                Caption = 'Entity Text';                ShowCaption = false;                field(EntityText; Rec."Preview Text")                {                    ApplicationArea = All;                    Editable = false;                    ShowCaption = false;                    MultiLine = true;                    Style = Attention;                    StyleExpr = CanCreate;                }                field(EmptyCaption; ComputedEmptyCaption)                {                    ApplicationArea = All;                    Editable = false;                    ShowCaption = false;                    MultiLine = true;                }            }        }    }    actions    {        area(Processing)        {            action(Edit)            {                ApplicationArea = All;                Caption = 'Edit';                Image = Edit;                ToolTip = 'Open a dialog to edit the text';                trigger OnAction()                begin                    OpenEditPage("Entity Text Actions"::Edit);                end;            }            action(Suggest)            {                ApplicationArea = All;                Caption = 'Draft with Copilot';                Visible = CanCreate;#pragma warning disable AL0482                Image = Sparkle;#pragma warning restore AL0482                ToolTip = 'Let Copilot create a new draft';                trigger OnAction()                var                    EntityTextImpl: Codeunit "Entity Text Impl.";                begin                    if not HasContext then                        Error(ContextNotSetErr);                    if not EntityTextImpl.IsEnabled(false) then                        exit;                    OpenEditPage("Entity Text Actions"::Create);                end;            }        }    }    trigger OnInit()    begin        UpdateEnabledProperties();        HasContext := false;        NavApp.GetCallerModuleInfo(CallerModuleInfo);    end;    trigger OnAfterGetCurrRecord()    begin        UpdateEnabledProperties();        if not HasContext then            exit;        ReloadLatestContext();    end;    /// <summary>    /// Sets the context for the Entity Text Factbox Part.    /// </summary>    /// <param name="SourceTableId">The ID of the table for which to retrieve the entity text.</param>    /// <param name="SourceSystemId">The ID of the entity for which to retrieve the entity text.</param>    /// <param name="SourceScenario">The entity text scenario to retrieve the entity text.</param>    /// <param name="PlaceholderText">The placeholder text to display if no entity text exists.</param>    /// <remarks>This must be called when including the part or no entity text will be rendered.</remarks>    procedure SetContext(SourceTableId: Integer; SourceSystemId: Guid; SourceScenario: Enum "Entity Text Scenario"; PlaceholderText: Text)    var        EntityTextRec: Record "Entity Text";        EntityTextImpl: Codeunit "Entity Text Impl.";    begin        HasContext := false;        CurrentTableId := SourceTableId;        CurrentSystemId := SourceSystemId;        CurrentScenario := SourceScenario;        // Ensure this temp record set only has this entity text        if not Rec.Get(CompanyName(), SourceTableId, SourceSystemId, SourceScenario) then begin            HasSuggestion := false;            Rec.DeleteAll();            Clear(Rec);            Rec.Init();            Rec.Company := CopyStr(CompanyName(), 1, MaxStrLen(Rec.Company));            Rec."Source Table Id" := SourceTableId;            Rec."Source System Id" := SourceSystemId;            Rec.Scenario := SourceScenario;            Rec.Insert();        end;        // No suggestion, load the current value        if not HasSuggestion then begin            EntityTextRec.SetRange(Company, CompanyName());            EntityTextRec.SetRange("Source Table Id", SourceTableId);            EntityTextRec.SetRange("Source System Id", SourceSystemId);            EntityTextRec.SetRange(Scenario, SourceScenario);            if EntityTextRec.FindFirst() then begin                EntityTextRec.CalcFields(Text);                Rec.TransferFields(EntityTextRec);                Rec.Modify();            end;        end;        EmptyCaption := PlaceholderText;        if EmptyCaption = '' then            EmptyCaption := DefaultPlaceholderTxt;        HasContext := true;        CurrPage.Update(false);        Session.LogMessage('0000JVC', StrSubstNo(TelemetrySetContextTxt, Format(SourceTableId), Format(SourceScenario), Format(CallerModuleInfo.Id()), CallerModuleInfo.Publisher()), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', EntityTextImpl.GetFeatureName());    end;    local procedure OpenEditPage(SourceAction: Enum "Entity Text Actions")    var        TempEntityText: Record "Entity Text" temporary;        EntityTextCod: Codeunit "Entity Text";        EntityTextImpl: Codeunit "Entity Text Impl.";        Handled: Boolean;        EditAction: Action;    begin        if not HasContext then            Error(ContextNotSetErr);        Rec.CalcFields(Text);        if Rec.IsEmpty() then            EntityTextImpl.InsertSuggestion(CurrentTableId, CurrentSystemId, CurrentScenario, '', TempEntityText)        else begin            TempEntityText.TransferFields(Rec, true);            TempEntityText.Insert();        end;        EntityTextCod.OnEditEntityTextWithTriggerAction(TempEntityText, EditAction, Handled, SourceAction);        if not Handled then begin            Session.LogMessage('0000LJ4', StrSubstNo(TelemetryNoEditPageTxt, Format(CurrentTableId), Format(CurrentScenario)), Verbosity::Error, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', EntityTextImpl.GetFeatureName());            Error(NoHandlerErr);        end;        Session.LogMessage('0000JVB', StrSubstNo(TelemetryEditHandledTxt, Format(Handled), Format(EditAction)), Verbosity::Normal, DataClassification::SystemMetadata, TelemetryScope::ExtensionPublisher, 'Category', EntityTextImpl.GetFeatureName());        if EditAction in [Action::LookupOK, Action::OK] then begin            EntityTextImpl.InsertSuggestion(CurrentTableId, CurrentSystemId, CurrentScenario, EntityTextImpl.GetText(TempEntityText));            HasSuggestion := false;        end;        ReloadLatestContext();    end;    local procedure ReloadLatestContext()    begin        if not HasContext then            Error(ContextNotSetErr);        SetContext(CurrentTableId, CurrentSystemId, CurrentScenario, EmptyCaption);    end;    local procedure UpdateEnabledProperties()    var        EntityTextImpl: Codeunit "Entity Text Impl.";    begin        CanCreate := EntityTextImpl.CanSuggest();        if CanCreate then            ComputedEmptyCaption := EmptyCaption        else            ComputedEmptyCaption := NotEnabledPlaceholderTxt;    end;    var        CurrentTableId: Integer;        CurrentSystemId: Guid;        CurrentScenario: Enum "Entity Text Scenario";        HasContext: Boolean;        EmptyCaption: Text;        ComputedEmptyCaption: Text;        CanCreate: Boolean;        HasSuggestion: Boolean;        CallerModuleInfo: ModuleInfo;        NotEnabledPlaceholderTxt: Label 'Select Edit to add text', Comment = 'Edit refers to an action on this part with the same name';        DefaultPlaceholderTxt: Label '[Create text](). Then review and edit based on your needs.', Comment = 'Text contained in [here]() will be clickable to invoke the suggest action';        ContextNotSetErr: Label 'The context has not been set on the part. Ensure SetContext has been called from the parent page, contact your partner to fix this.';        NoHandlerErr: Label 'There was no handler to provide an edit page for this entity. Contact your partner.';        TelemetryNoEditPageTxt: Label 'No custom page was specified for edit by partner: table %1, scenario %2.', Locked = true;        TelemetryEditHandledTxt: Label 'Edit result was handled: %1, with action %2.', Locked = true;        TelemetrySetContextTxt: Label 'Context set for entity text factbox. Table %1, scenario %2, calling module %3 (%4).', Locked = true;}