Codeunit 4308 Agent Message Impl.

System Application, System.Agents

src/System Application/App/Agent/Interaction/Internal/AgentMessageImpl.Codeunit.al319 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.IO;using System.Utilities;codeunit 4308 "Agent Message Impl."{    Access = Internal;    InherentEntitlements = X;    InherentPermissions = X;    var        GlobalIgnoreAttachment: Boolean;        AttachmentsFilenameLbl: Label 'attachments_task%1_%2.zip', Comment = 'Filename format for downloading multiple attachments as a zip file. %1 = task ID, %2 = date/time stamp', Locked = true;    procedure GetText(TaskID: BigInteger; MessageID: Guid): Text    var        AgentTaskMessage: Record "Agent Task Message";    begin        AgentTaskMessage.Get(TaskID, MessageID);        exit(GetText(AgentTaskMessage));    end;    procedure GetText(var AgentTaskMessage: Record "Agent Task Message"): Text    var        AgentTaskImpl: Codeunit "Agent Task Impl.";        ContentInStream: InStream;        ContentText: Text;    begin        AgentTaskMessage.CalcFields(Content);        AgentTaskMessage.Content.CreateInStream(ContentInStream, AgentTaskImpl.GetDefaultEncoding());        ContentInStream.Read(ContentText);        exit(ContentText);    end;    procedure UpdateText(TaskID: BigInteger; MessageID: Guid; NewMessageText: Text)    var        AgentTaskMessage: Record "Agent Task Message";    begin        AgentTaskMessage."Task ID" := TaskID;        AgentTaskMessage.ID := MessageID;        UpdateText(AgentTaskMessage, NewMessageText);    end;    procedure UpdateText(var AgentTaskMessage: Record "Agent Task Message"; NewMessageText: Text)    var        AgentTaskMessageToModify: Record "Agent Task Message";        AgentTaskImpl: Codeunit "Agent Task Impl.";        ContentOutStream: OutStream;    begin        AgentTaskMessageToModify.Get(AgentTaskMessage."Task ID", AgentTaskMessage.ID);        AgentTaskMessageToModify.Content.CreateOutStream(ContentOutStream, AgentTaskImpl.GetDefaultEncoding());        ContentOutStream.Write(NewMessageText);        AgentTaskMessageToModify.Modify(true);        AgentTaskMessage.Content := AgentTaskMessageToModify.Content;    end;    procedure IsEditable(TaskID: BigInteger; MessageID: Guid): Boolean    var        AgentTaskMessage: Record "Agent Task Message";    begin        AgentTaskMessage.Get(TaskID, MessageID);        exit(IsEditable(AgentTaskMessage));    end;    procedure IsEditable(var AgentTaskMessage: Record "Agent Task Message"): Boolean    begin        if AgentTaskMessage.Type <> AgentTaskMessage.Type::Output then            exit(false);        exit((AgentTaskMessage.Status = AgentTaskMessage.Status::Draft) or (AgentTaskMessage.Status = AgentTaskMessage.Status::" "));    end;    procedure SetStatusToSent(TaskID: BigInteger; MessageID: Guid)    var        AgentTaskMessage: Record "Agent Task Message";    begin        AgentTaskMessage."Task ID" := TaskID;        AgentTaskMessage.ID := MessageID;        SetStatusToSent(AgentTaskMessage);    end;    procedure SetStatusToSent(var AgentTaskMessage: Record "Agent Task Message")    begin        UpdateStatus(AgentTaskMessage, AgentTaskMessage.Status::Sent);    end;    procedure SetStatusToFailed(TaskID: BigInteger; MessageID: Guid; StatusReason: Text[250])    var        AgentTaskMessage: Record "Agent Task Message";    begin        AgentTaskMessage."Task ID" := TaskID;        AgentTaskMessage.ID := MessageID;        SetStatusToFailed(AgentTaskMessage, StatusReason);    end;    procedure SetStatusToFailed(var AgentTaskMessage: Record "Agent Task Message"; StatusReason: Text[250])    begin        UpdateStatus(AgentTaskMessage, AgentTaskMessage.Status::Failed, StatusReason);    end;    procedure SetStatusToReviewed(TaskID: BigInteger; MessageID: Guid)    var        AgentTaskMessage: Record "Agent Task Message";    begin        AgentTaskMessage."Task ID" := TaskID;        AgentTaskMessage.ID := MessageID;        SetStatusToReviewed(AgentTaskMessage);    end;    procedure SetStatusToReviewed(var AgentTaskMessage: Record "Agent Task Message")    begin        UpdateStatus(AgentTaskMessage, AgentTaskMessage.Status::Reviewed, '');    end;    procedure SetIgnoreAttachment(IgnoreAttachment: Boolean)    begin        GlobalIgnoreAttachment := IgnoreAttachment;    end;    procedure AddAttachment(var AgentTaskMessage: Record "Agent Task Message"; var TempAgentTaskFile: Record "Agent Task File" temporary; IgnoredReason: Text[250])    var        AgentTaskImpl: Codeunit "Agent Task Impl.";        FileInstream: InStream;    begin        TempAgentTaskFile.CalcFields(Content);        if not TempAgentTaskFile.Content.HasValue() then            exit;        TempAgentTaskFile.Content.CreateInStream(FileInstream, AgentTaskImpl.GetDefaultEncoding());        AddAttachment(AgentTaskMessage, TempAgentTaskFile."File Name", TempAgentTaskFile."File MIME Type", FileInstream, IgnoredReason);    end;    procedure AddAttachment(var AgentTaskMessage: Record "Agent Task Message"; FileName: Text[250]; FileMIMEType: Text[100]; InStream: InStream)    begin        AddAttachment(AgentTaskMessage, FileName, FileMIMEType, InStream, '');    end;    procedure AddAttachment(var AgentTaskMessage: Record "Agent Task Message"; FileName: Text[250]; FileMIMEType: Text[100]; InStream: InStream; IgnoredReason: Text[250])    var        AgentTaskFile: Record "Agent Task File";        AgentTaskMessageAttachment: Record "Agent Task Message Attachment";        AgentTaskImpl: Codeunit "Agent Task Impl.";        OutStream: OutStream;    begin        // Add attachment to task file        AgentTaskFile."Task ID" := AgentTaskMessage."Task ID";        AgentTaskFile."File Name" := FileName;        AgentTaskFile."File MIME Type" := FileMIMEType;        AgentTaskFile.Content.CreateOutStream(OutStream, AgentTaskImpl.GetDefaultEncoding());        CopyStream(OutStream, InStream);        AgentTaskFile.Insert();        // Link task file to task message        AgentTaskMessageAttachment."Task ID" := AgentTaskMessage."Task ID";        AgentTaskMessageAttachment."Message ID" := AgentTaskMessage.ID;        AgentTaskMessageAttachment."File ID" := AgentTaskFile.ID;        AgentTaskMessageAttachment.Ignored := GlobalIgnoreAttachment;        AgentTaskMessageAttachment."Ignored Reason" := CopyStr(IgnoredReason, 1, MaxStrLen(AgentTaskMessageAttachment."Ignored Reason"));        AgentTaskMessageAttachment.Insert();    end;    procedure DownloadAttachments(var AgentTaskMessage: Record "Agent Task Message")    var        AgentTaskMessageAttachment: Record "Agent Task Message Attachment";        AgentTaskFile: Record "Agent Task File";        DataCompression: Codeunit "Data Compression";        TempBlob: Codeunit "Temp Blob";        AgentTaskImpl: Codeunit "Agent Task Impl.";        FileInStream: InStream;        ZipOutStream: OutStream;        ZipInStream: InStream;        FileName: Text;        AttachmentCount: Integer;        DownloadDialogTitleLbl: Label 'Download Email Attachment';    begin        AgentTaskMessageAttachment.SetRange("Task ID", AgentTaskMessage."Task ID");        AgentTaskMessageAttachment.SetRange("Message ID", AgentTaskMessage.ID);        if not AgentTaskMessageAttachment.FindSet() then            exit;        // Count attachments        AttachmentCount := AgentTaskMessageAttachment.Count();        // If single file, download directly        if AttachmentCount = 1 then begin            ShowOrDownloadAttachment(AgentTaskMessageAttachment."Task ID", AgentTaskMessageAttachment."File ID", true);            exit;        end;        // If multiple files, create a zip        DataCompression.CreateZipArchive();        repeat            if AgentTaskFile.Get(AgentTaskMessageAttachment."Task ID", AgentTaskMessageAttachment."File ID") then begin                AgentTaskFile.CalcFields(Content);                AgentTaskFile.Content.CreateInStream(FileInStream, AgentTaskImpl.GetDefaultEncoding());                DataCompression.AddEntry(FileInStream, AgentTaskFile."File Name");            end;        until AgentTaskMessageAttachment.Next() = 0;        TempBlob.CreateOutStream(ZipOutStream);        DataCompression.SaveZipArchive(ZipOutStream);        DataCompression.CloseZipArchive();        TempBlob.CreateInStream(ZipInStream);        FileName := StrSubstNo(AttachmentsFilenameLbl, Format(AgentTaskMessage."Task ID"), Format(AgentTaskMessage.SystemCreatedAt));        File.DownloadFromStream(ZipInStream, DownloadDialogTitleLbl, '', '', FileName);    end;    procedure ShowOrDownloadAttachment(TaskID: BigInteger; FileID: BigInteger; ForceDownloadAttachment: Boolean)    var        AgentTaskFile: Record "Agent Task File";    begin        if not AgentTaskFile.Get(TaskID, FileID) then            exit;        ShowOrDownloadAttachment(AgentTaskFile, ForceDownloadAttachment);    end;    procedure ShowOrDownloadAttachment(var AgentTaskFile: Record "Agent Task File"; ForceDownloadAttachment: Boolean)    var        AgentTaskImpl: Codeunit "Agent Task Impl.";        InStream: InStream;        FileName: Text;        DownloadDialogTitleLbl: Label 'Download Email Attachment';    begin        FileName := AgentTaskFile."File Name";        AgentTaskFile.CalcFields(Content);        AgentTaskFile.Content.CreateInStream(InStream, AgentTaskImpl.GetDefaultEncoding());        if not ForceDownloadAttachment then            if File.ViewFromStream(InStream, FileName, false) then                exit;        File.DownloadFromStream(InStream, DownloadDialogTitleLbl, '', '', FileName);    end;    procedure GetAttachments(TaskID: BigInteger; MessageID: Guid; var TempAgentTaskFile: Record "Agent Task File" temporary)    var        AgentTaskMessageAttachment: Record "Agent Task Message Attachment";        AgentTaskFile: Record "Agent Task File";        AgentTaskFileMustBeTemporaryErr: Label 'The Agent Task File used for this procedure must be temporary.';    begin        if not TempAgentTaskFile.IsTemporary() then            Error(AgentTaskFileMustBeTemporaryErr);        if TaskID = 0 then            exit;        if IsNullGuid(MessageID) then            exit;        TempAgentTaskFile.Reset();        TempAgentTaskFile.DeleteAll();        AgentTaskMessageAttachment.SetRange("Task ID", TaskID);        AgentTaskMessageAttachment.SetRange("Message ID", MessageID);        if not AgentTaskMessageAttachment.FindSet() then            exit;        AgentTaskFile.SetAutoCalcFields(Content);        repeat            if not TempAgentTaskFile.Get(AgentTaskMessageAttachment."Task ID", AgentTaskMessageAttachment."File ID") then                if AgentTaskFile.Get(AgentTaskMessageAttachment."Task ID", AgentTaskMessageAttachment."File ID") then begin                    Clear(TempAgentTaskFile);                    TempAgentTaskFile.TransferFields(AgentTaskFile, true);                    TempAgentTaskFile.Content := AgentTaskFile.Content;                    TempAgentTaskFile.Insert();                end;        until AgentTaskMessageAttachment.Next() = 0;    end;    local procedure UpdateStatus(var AgentTaskMessage: Record "Agent Task Message"; Status: Option)    var        AgentTaskMessageToModify: Record "Agent Task Message";    begin        AgentTaskMessageToModify.Get(AgentTaskMessage."Task ID", AgentTaskMessage.ID);        AgentTaskMessageToModify.Status := Status;        AgentTaskMessageToModify.Modify(true);        AgentTaskMessage.Status := AgentTaskMessageToModify.Status;    end;    // The platform persists the status reason from the same record buffer as the status, so both fields    // must be written in a single Modify for the reason to be picked up for the resulting task log entry.    local procedure UpdateStatus(var AgentTaskMessage: Record "Agent Task Message"; Status: Option; StatusReason: Text[250])    var        AgentTaskMessageToModify: Record "Agent Task Message";    begin        AgentTaskMessageToModify.Get(AgentTaskMessage."Task ID", AgentTaskMessage.ID);        AgentTaskMessageToModify.Status := Status;        AgentTaskMessageToModify."Status Reason" := StatusReason;        AgentTaskMessageToModify.Modify(true);        AgentTaskMessage.Status := AgentTaskMessageToModify.Status;        AgentTaskMessage."Status Reason" := AgentTaskMessageToModify."Status Reason";    end;    procedure GetFileSizeDisplayText(SizeInBytes: Decimal): Text    var        FileSizeConverted: Decimal;        FileSizeUnit: Text;        FileSizeTxt: Label '%1 %2', Comment = '%1 = File Size, %2 = Unit of measurement', Locked = true;    begin        FileSizeConverted := SizeInBytes / 1024; // The smallest size we show is KB        if FileSizeConverted < 1024 then            FileSizeUnit := 'KB'        else begin            FileSizeConverted := FileSizeConverted / 1024; // The largest size we show is MB            FileSizeUnit := 'MB'        end;        exit(StrSubstNo(FileSizeTxt, Round(FileSizeConverted, 1, '>'), FileSizeUnit));    end;}