Codeunit 4311 Agent Task Msg. Builder Impl.

System Application, System.Agents

src/System Application/App/Agent/Interaction/Internal/AgentTaskMsgBuilderImpl.Codeunit.al345 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;codeunit 4311 "Agent Task Msg. Builder Impl."{    Access = Internal;    InherentEntitlements = X;    InherentPermissions = X;    var        TempAgentTaskFileToAttach: Record "Agent Task File" temporary;        GlobalAgentTask: Record "Agent Task";        GlobalAgentTaskMessage: Record "Agent Task Message";        GlobalIgnoreAttachmentsList: Dictionary of [BigInteger, Boolean];        GlobalIgnoredReasonByFileId: Dictionary of [BigInteger, Text[250]];        GlobalFrom: Text[250];        GlobalMessageExternalID: Text[2048];        GlobalMessageText: Text;        GlobalRequiresReview: Boolean;        GlobalIgnoreAttachment: Boolean;        GlobalSkipSanitizeMessage: Boolean;    [Scope('OnPrem')]    procedure Initialize(MessageText: Text): codeunit "Agent Task Msg. Builder Impl."    var        CurrentUserId: Text[250];    begin        CurrentUserId := CopyStr(UserId(), 1, MaxStrLen(CurrentUserId));        exit(Initialize(CurrentUserId, MessageText));    end;    [Scope('OnPrem')]    procedure Initialize(From: Text[250]; MessageText: Text): codeunit "Agent Task Msg. Builder Impl."    begin        GlobalRequiresReview := true;        GlobalIgnoreAttachment := false;        GlobalFrom := From;        GlobalMessageText := MessageText;        exit(this);    end;    [Scope('OnPrem')]    procedure SetRequiresReview(RequiresReview: Boolean): codeunit "Agent Task Msg. Builder Impl."    begin        GlobalRequiresReview := RequiresReview;        exit(this);    end;    [Scope('OnPrem')]    procedure SetIgnoreAttachment(IgnoreAttachment: Boolean): codeunit "Agent Task Msg. Builder Impl."    begin        GlobalIgnoreAttachment := IgnoreAttachment;        exit(this);    end;    [Scope('OnPrem')]    procedure SetSkipMessageSanitization(SkipSanitizeMessage: Boolean): codeunit "Agent Task Msg. Builder Impl."    begin        GlobalSkipSanitizeMessage := SkipSanitizeMessage;        exit(this);    end;    [Scope('OnPrem')]    procedure SetMessageExternalID(ExternalId: Text[2048]): codeunit "Agent Task Msg. Builder Impl."    begin        GlobalMessageExternalID := ExternalId;        exit(this);    end;    [Scope('OnPrem')]    procedure SetAgentTask(ParentAgentTask: Record "Agent Task"): codeunit "Agent Task Msg. Builder Impl."    begin        GlobalAgentTask.Copy(ParentAgentTask);    end;    [Scope('OnPrem')]    procedure SetAgentTask(ParentAgentTaskID: BigInteger): codeunit "Agent Task Msg. Builder Impl."    begin        GlobalAgentTask.Get(ParentAgentTaskID);    end;    procedure Create(): Record "Agent Task Message"    begin        exit(Create(true));    end;    [Scope('OnPrem')]    procedure Create(SetTaskStatusToReady: Boolean): Record "Agent Task Message"    var        AgentTaskImpl: Codeunit "Agent Task Impl.";        AgentMessageImpl: Codeunit "Agent Message Impl.";        IgnoreAttachment: Boolean;        IgnoredReason: Text[250];        MessageText: Text;    begin        VerifyMandatoryFieldsSet();        MessageText := GlobalSkipSanitizeMessage ? GlobalMessageText : SanitizeMessage(GlobalMessageText);        GlobalAgentTaskMessage := AgentTaskImpl.AddMessage(GlobalFrom, MessageText, GlobalMessageExternalID, GlobalAgentTask, GlobalRequiresReview);        TempAgentTaskFileToAttach.Reset();        TempAgentTaskFileToAttach.SetAutoCalcFields(Content);        if TempAgentTaskFileToAttach.FindSet() then            repeat                IgnoreAttachment := false;                if GlobalIgnoreAttachmentsList.ContainsKey(TempAgentTaskFileToAttach.ID) then                    IgnoreAttachment := GlobalIgnoreAttachmentsList.Get(TempAgentTaskFileToAttach.ID);                IgnoredReason := '';                if GlobalIgnoredReasonByFileId.ContainsKey(TempAgentTaskFileToAttach.ID) then                    IgnoredReason := GlobalIgnoredReasonByFileId.Get(TempAgentTaskFileToAttach.ID);                AgentMessageImpl.SetIgnoreAttachment(GlobalIgnoreAttachment or IgnoreAttachment);                AgentMessageImpl.AddAttachment(GlobalAgentTaskMessage, TempAgentTaskFileToAttach, IgnoredReason);            until TempAgentTaskFileToAttach.Next() = 0;        if SetTaskStatusToReady then            AgentTaskImpl.SetTaskStatusToReadyIfPossible(GlobalAgentTask);        exit(GlobalAgentTaskMessage);    end;    [Scope('OnPrem')]    procedure GetAgentTaskMessage(): Record "Agent Task Message"    begin        exit(GlobalAgentTaskMessage);    end;    [Scope('OnPrem')]    procedure AddAttachment(FileName: Text[250]; FileMIMEType: Text[100]; InStream: InStream): codeunit "Agent Task Msg. Builder Impl."    begin        AddAttachment(FileName, FileMIMEType, InStream, false, '');        exit(this);    end;    [Scope('OnPrem')]    procedure AddAttachment(FileName: Text[250]; FileMIMEType: Text[100]; InStream: InStream; Ignored: Boolean): codeunit "Agent Task Msg. Builder Impl."    begin        AddAttachment(FileName, FileMIMEType, InStream, Ignored, '');        exit(this);    end;    [Scope('OnPrem')]    procedure AddAttachment(FileName: Text[250]; FileMIMEType: Text[100]; InStream: InStream; Ignored: Boolean; IgnoredReason: Text[250]): codeunit "Agent Task Msg. Builder Impl."    var        FileOutStream: OutStream;    begin        Clear(TempAgentTaskFileToAttach);        TempAgentTaskFileToAttach."File Name" := FileName;        TempAgentTaskFileToAttach."File MIME Type" := FileMIMEType;        TempAgentTaskFileToAttach.ID := TempAgentTaskFileToAttach.Count() + 1;        TempAgentTaskFileToAttach.Insert();        TempAgentTaskFileToAttach.Content.CreateOutStream(FileOutStream);        CopyStream(FileOutStream, InStream);        TempAgentTaskFileToAttach.Modify();        GlobalIgnoreAttachmentsList.Add(TempAgentTaskFileToAttach.ID, Ignored);        if Ignored then            GlobalIgnoredReasonByFileId.Add(TempAgentTaskFileToAttach.ID, IgnoredReason);        exit(this);    end;    [Scope('OnPrem')]    procedure AddAttachment(var AgentTaskFile: Record "Agent Task File"): codeunit "Agent Task Msg. Builder Impl."    var        FileInStream: InStream;    begin        AgentTaskFile.CalcFields(Content);        AgentTaskFile.Content.CreateInStream(FileInStream);        AddAttachment(AgentTaskFile."File Name", AgentTaskFile."File MIME Type", FileInStream);        exit(this);    end;    [Scope('OnPrem')]    procedure AddAttachment(File: FileUpload): codeunit "Agent Task Msg. Builder Impl."    begin        AddAttachment(File, false, '');        exit(this);    end;    [Scope('OnPrem')]    procedure AddAttachment(File: FileUpload; Ignored: Boolean): codeunit "Agent Task Msg. Builder Impl."    begin        AddAttachment(File, Ignored, '');        exit(this);    end;    [Scope('OnPrem')]    procedure AddAttachment(File: FileUpload; Ignored: Boolean; IgnoredReason: Text[250]): codeunit "Agent Task Msg. Builder Impl."    var        FileInStream: InStream;        FileName: Text;        FileNameTooLongErr: Label 'File name ''%1'' exceeds the maximum allowed length of 250 characters.', Comment = '%1 = the uploaded file name';    begin        // Adapter for fileuploadaction triggers; callers loop over List of [FileUpload]        // to support multi-file selection from the browser file picker. MS-DOS encoding keeps        // binary attachments (PDF, PNG, XLSX, ...) byte-safe, matching the Email SDK precedent.        FileName := File.FileName;        if FileName = '' then            exit(this);        File.CreateInStream(FileInStream, TextEncoding::MSDos);        if StrLen(FileName) > 250 then            Error(FileNameTooLongErr, FileName);        AddAttachment(            CopyStr(FileName, 1, 250),            CopyStr(GetContentTypeFromFilename(FileName), 1, 100),            FileInStream,            Ignored,            IgnoredReason);        exit(this);    end;    [Scope('OnPrem')]    procedure UploadAttachment(): Boolean    var        SelectAttachmentLbl: Label 'Select a file to upload';        FileInStream: InStream;        FileName: Text;    begin        if not File.UploadIntoStream(SelectAttachmentLbl, '', '', FileName, FileInStream) then            exit(false);#pragma warning disable AA0139        AddAttachment(FileName, GetContentTypeFromFilename(FileName), FileInStream);#pragma warning restore AA0139        exit(true);    end;    [Scope('OnPrem')]    procedure GetLastAttachment(): Record "Agent Task File"    var        NoAttachmentsWereAddedErr: Label 'No attachments were added to the task message.';    begin        if TempAgentTaskFileToAttach.Count() = 0 then            Error(NoAttachmentsWereAddedErr);        exit(TempAgentTaskFileToAttach);    end;    [Scope('OnPrem')]    procedure GetAttachments(var TempAttachments: record "Agent Task File" temporary): Boolean    begin        if not TempAgentTaskFileToAttach.FindSet() then            exit(false);        repeat            TempAgentTaskFileToAttach.Copy(TempAttachments);            TempAttachments.Insert();        until TempAgentTaskFileToAttach.Next() = 0;        exit(true);    end;    local procedure VerifyMandatoryFieldsSet()    var        GlobalFromIsMandatoryErr: Label 'The From field is mandatory. Please set it before creating the task message.';        GlobalMessageTextIsMandatoryErr: Label 'The Message Text field is mandatory. Please set it before creating the task message.';        GlobalAgentTaskIDErr: Label 'The Agent Task ID field is mandatory. Please set it before creating the task message.';        CodingErrorInfo: ErrorInfo;    begin        if GlobalFrom = '' then            CodingErrorInfo.Message(GlobalFromIsMandatoryErr);        if GlobalMessageText = '' then            CodingErrorInfo.Message(GlobalMessageTextIsMandatoryErr);        if GlobalAgentTask.ID = 0 then            CodingErrorInfo.Message(GlobalAgentTaskIDErr);        if CodingErrorInfo.Message = '' then            exit;        CodingErrorInfo.ErrorType := ErrorType::Internal;        Error(CodingErrorInfo);    end;    procedure GetContentTypeFromFilename(FileName: Text): Text[250]    var        LowerCaseFileName: text;    begin        LowerCaseFileName := LowerCase(FileName);        if LowerCaseFileName.EndsWith('.graphql') or LowerCaseFileName.EndsWith('.gql') then            exit('application/graphql');        if LowerCaseFileName.EndsWith('.js') then            exit('application/javascript');        if LowerCaseFileName.EndsWith('.json') then            exit('application/json');        if LowerCaseFileName.EndsWith('.doc') then            exit('application/msword(.doc)');        if LowerCaseFileName.EndsWith('.pdf') then            exit('application/pdf');        if LowerCaseFileName.EndsWith('.sql') then            exit('application/sql');        if LowerCaseFileName.EndsWith('.xls') then            exit('application/vnd.ms-excel(.xls)');        if LowerCaseFileName.EndsWith('.ppt') then            exit('application/vnd.ms-powerpoint(.ppt)');        if LowerCaseFileName.EndsWith('.odt') then            exit('application/vnd.oasis.opendocument.text(.odt)');        if LowerCaseFileName.EndsWith('.pptx') then            exit('application/vnd.openxmlformats-officedocument.presentationml.presentation(.pptx)');        if LowerCaseFileName.EndsWith('.xlsx') then            exit('application/vnd.openxmlformats-officedocument.spreadsheetml.sheet(.xlsx)');        if LowerCaseFileName.EndsWith('.docx') then            exit('application/vnd.openxmlformats-officedocument.wordprocessingml.document(.docx)');        if LowerCaseFileName.EndsWith('.xml') then            exit('application/xml');        if LowerCaseFileName.EndsWith('.zip') then            exit('application/zip');        if LowerCaseFileName.EndsWith('.zst') then            exit('application/zstd(.zst)');        if LowerCaseFileName.EndsWith('.mpeg') then            exit('audio/mpeg');        if LowerCaseFileName.EndsWith('.ogg') then            exit('audio/ogg');        if LowerCaseFileName.EndsWith('.gif') then            exit('application/gif');        if LowerCaseFileName.EndsWith('.jpeg') then            exit('application/jpeg');        if LowerCaseFileName.EndsWith('.jpg') then            exit('application/jpg');        if LowerCaseFileName.EndsWith('.png') then            exit('application/png');        if LowerCaseFileName.EndsWith('.css') then            exit('text/css');        if LowerCaseFileName.EndsWith('.csv') then            exit('text/csv');        if LowerCaseFileName.EndsWith('.html') then            exit('text/html');        if LowerCaseFileName.EndsWith('.php') then            exit('text/php');        if LowerCaseFileName.EndsWith('.txt') then            exit('text/plain');        exit('');    end;    internal procedure SanitizeMessage(MessageBody: Text): Text    var        AppHTMLSanitizer: DotNet AppHtmlSanitizer;    begin        AppHTMLSanitizer := AppHTMLSanitizer.AppHtmlSanitizer();        exit(AppHTMLSanitizer.SanitizeEmail(MessageBody));    end;}