{"title":"Codeunit 4402 SOA Output Message Setup, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/4402-soa-output-message-setup/points/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-11-14","object":{"type":"codeunit","id":4402,"name":"SOA Output Message Setup","app":"Sales Order Agent","url":"https://jonas-paprotka.de/ref/codeunit/4402-soa-output-message-setup/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/4402-soa-output-message-setup/source/","path":"src/Apps/W1/SalesOrderAgent/app/src/OutputMessage/SOAOutputMessageSetup.Codeunit.al","commit":"4303e5e584d3aa5d9e98cbc615525a5396ad6ed7","lines":"a line is <source url>#L<line>"},"steps":{"event":"[line, \"event\", name, handled]: raises an event of this object; handled 1 when it has an IsHandled parameter","call":"[line, \"call\", name, arguments]: calls a procedure of this object","ext":"[line, \"ext\", type, id, name, arguments]: calls a procedure of another object, through a variable declared with that type","write":"[line, \"write\", table id, method, 1 when called with true]: Insert, Modify, ModifyAll, Delete, DeleteAll or Rename","validate":"[line, \"validate\", table id, field name]","run":"[line, \"run\", type, id]: Codeunit.Run, Page.Run, Report.Run and their kin"},"objects":{"codeunit:4590":{"name":"SOA Billing","url":"https://jonas-paprotka.de/ref/codeunit/4590-soa-billing/"},"table:4325":{"name":"SOA Setup","url":"https://jonas-paprotka.de/ref/table/4325-soa-setup/"},"codeunit:7771":{"name":"Azure OpenAI","url":"https://jonas-paprotka.de/ref/codeunit/7771-azure-openai/"},"codeunit:7768":{"name":"AOAI Deployments","url":"https://jonas-paprotka.de/ref/codeunit/7768-aoai-deployments/"},"codeunit:7763":{"name":"AOAI Chat Messages","url":"https://jonas-paprotka.de/ref/codeunit/7763-aoai-chat-messages/"},"codeunit:7761":{"name":"AOAI Chat Completion Params","url":"https://jonas-paprotka.de/ref/codeunit/7761-aoai-chat-completion-params/"},"codeunit:7770":{"name":"AOAI Operation Response","url":"https://jonas-paprotka.de/ref/codeunit/7770-aoai-operation-response/"},"codeunit:4407":{"name":"SOA Email Template Validation","url":"https://jonas-paprotka.de/ref/codeunit/4407-soa-email-template-validation/"},"codeunit:7758":{"name":"AOAI Function Response","url":"https://jonas-paprotka.de/ref/codeunit/7758-aoai-function-response/"},"codeunit:4403":{"name":"SOA Output Message Validation","url":"https://jonas-paprotka.de/ref/codeunit/4403-soa-output-message-validation/"},"table:2000000263":{"name":"Agent Task Message","url":"https://jonas-paprotka.de/ref/table/2000000263-agent-task-message/"},"codeunit:4400":{"name":"SOA Setup","url":"https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/"},"codeunit:8703":{"name":"Feature Telemetry","url":"https://jonas-paprotka.de/ref/codeunit/8703-feature-telemetry/"},"codeunit:4598":{"name":"SOA Instructions","url":"https://jonas-paprotka.de/ref/codeunit/4598-soa-instructions/"}},"procs":[{"name":"CheckSignature","line":23,"kind":"procedure","access":"internal","params":1,"steps":[[43,"call","GetSignatureImagesTotalSize",1],[45,"call","CheckMailTemplate",4],[46,"call","LogTelemetryError",2]]},{"name":"PrepareOutputMessage","line":60,"kind":"procedure","access":"internal","params":1,"steps":[[68,"ext","codeunit",4590,"LogEmailGenerated",3],[70,"ext","table",4325,"GetBasedOnAgentUserSecurityID",2],[73,"call","AddSignatureToMessageBody",1],[74,"call","LogTelemetryError",2]]},{"name":"CheckMailTemplate","line":78,"kind":"procedure","access":"local","params":4,"steps":[[89,"ext","codeunit",7771,"SetAuthorization",2],[89,"ext","codeunit",7768,"GetGPT56CeresLatest",0],[90,"ext","codeunit",7771,"SetCopilotCapability",1],[92,"call","GetMailTemplateCheckSystemInstructions",0],[93,"ext","codeunit",7763,"SetPrimarySystemMessage",1],[95,"ext","codeunit",7763,"AddTool",1],[96,"ext","codeunit",7763,"SetToolChoice",0],[97,"ext","codeunit",7763,"SetToolInvokePreference",1],[99,"ext","codeunit",7763,"AddUserMessage",1],[101,"ext","codeunit",7761,"SetMaxTokens",1],[101,"call","GetMaxTokens",0],[102,"ext","codeunit",7761,"SetTemperature",1],[104,"ext","codeunit",7771,"GenerateChatCompletion",3],[105,"ext","codeunit",7770,"IsSuccess",0],[107,"ext","codeunit",7770,"IsFunctionCall",0],[109,"ext","codeunit",7770,"GetFunctionResponses",0],[110,"ext","codeunit",4407,"Execute",1],[110,"ext","codeunit",7758,"GetArguments",0],[112,"ext","codeunit",4407,"GetInvalidReason",0],[113,"ext","codeunit",4407,"GetIsHarmful",0]]},{"name":"AddSignatureToMessageBody","line":120,"kind":"procedure","access":"local","params":1,"steps":[[133,"ext","codeunit",7771,"SetAuthorization",2],[133,"ext","codeunit",7768,"GetGPT56CeresLatest",0],[134,"ext","codeunit",7771,"SetCopilotCapability",1],[136,"call","GetAddSignatureSystemInstructions",0],[137,"ext","codeunit",7763,"SetPrimarySystemMessage",1],[139,"ext","codeunit",7763,"AddTool",1],[140,"ext","codeunit",7763,"SetToolChoice",0],[141,"ext","codeunit",7763,"SetToolInvokePreference",1],[143,"ext","codeunit",7763,"AddUserMessage",1],[143,"call","GetMailBody",1],[144,"ext","codeunit",7763,"AddUserMessage",1],[144,"call","PrepareSignatureText",2],[144,"call","GetSignatureText",1],[146,"ext","codeunit",7761,"SetMaxTokens",1],[146,"call","GetMaxTokens",0],[147,"ext","codeunit",7761,"SetTemperature",1],[149,"ext","codeunit",7771,"GenerateChatCompletion",3],[150,"ext","codeunit",7770,"IsSuccess",0],[151,"call","LogTelemetryError",2],[154,"ext","codeunit",7770,"IsFunctionCall",0],[156,"ext","codeunit",7770,"GetFunctionResponses",0],[157,"ext","codeunit",4403,"Execute",1],[157,"ext","codeunit",7758,"GetArguments",0],[159,"call","ReturnImagesToSignature",2],[161,"call","DoUpdateAgentTaskMessageContent",2]]},{"name":"DoUpdateAgentTaskMessageContent","line":166,"kind":"procedure","access":"local","params":2,"steps":[[176,"write",2000000263,"Modify"]]},{"name":"PrepareSignatureText","line":191,"kind":"procedure","access":"local","params":2,"steps":[[196,"call","ExtractImageFromSignature",2]]},{"name":"GetSignatureImagesTotalSize","line":209,"kind":"procedure","access":"local","params":1,"steps":[[215,"call","PrepareSignatureText",2]]},{"name":"ExtractImageFromSignature","line":222,"kind":"procedure","access":"local","params":2,"steps":[[236,"call","UpdateDictionaryWithImages",2]]},{"name":"GetSignatureText","line":250,"kind":"procedure","access":"local","params":1,"steps":[[257,"ext","table",4325,"GetBasedOnAgentUserSecurityID",2],[259,"ext","table",4325,"GetEmailSignatureAsTxt",0],[261,"ext","codeunit",4400,"GetDefaultEmailSignatureAsTxt",0]]},{"name":"LogTelemetryError","line":264,"kind":"procedure","access":"local","params":2,"steps":[[270,"ext","codeunit",8703,"LogError",4],[270,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"GetAddSignatureSystemInstructions","line":279,"kind":"procedure","access":"local","params":0,"steps":[[283,"ext","codeunit",4598,"GetOutputMessageSignatureUpdateSystemPrompt",0]]},{"name":"GetMailTemplateCheckSystemInstructions","line":287,"kind":"procedure","access":"local","params":0,"steps":[[291,"ext","codeunit",4598,"GetMailTemplateCheckSystemPrompt",0]]}]}