{"title":"Codeunit 4582 SOA Retrieve Emails, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/4582-soa-retrieve-emails/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-10-30","object":{"type":"codeunit","id":4582,"name":"SOA Retrieve Emails","app":"Sales Order Agent","url":"https://jonas-paprotka.de/ref/codeunit/4582-soa-retrieve-emails/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/4582-soa-retrieve-emails/source/","path":"src/Apps/W1/SalesOrderAgent/app/src/Integration/SOARetrieveEmails.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:4400":{"name":"SOA Setup","url":"https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/"},"codeunit:4587":{"name":"SOA Impl","url":"https://jonas-paprotka.de/ref/codeunit/4587-soa-impl/"},"codeunit:4396":{"name":"SOA Email Setup","url":"https://jonas-paprotka.de/ref/codeunit/4396-soa-email-setup/"},"codeunit:8703":{"name":"Feature Telemetry","url":"https://jonas-paprotka.de/ref/codeunit/8703-feature-telemetry/"},"table:8885":{"name":"Email Retrieval Filters","url":"https://jonas-paprotka.de/ref/table/8885-email-retrieval-filters/"},"codeunit:8901":{"name":"Email","url":"https://jonas-paprotka.de/ref/codeunit/8901-email/"},"table:4585":{"name":"SOA Email","url":"https://jonas-paprotka.de/ref/table/4585-soa-email/"},"codeunit:4315":{"name":"Agent Task Builder","url":"https://jonas-paprotka.de/ref/codeunit/4315-agent-task-builder/"},"codeunit:8904":{"name":"Email Message","url":"https://jonas-paprotka.de/ref/codeunit/8904-email-message/"},"codeunit:4316":{"name":"Agent Task Message Builder","url":"https://jonas-paprotka.de/ref/codeunit/4316-agent-task-message-builder/"},"codeunit:4398":{"name":"SOA Task Message","url":"https://jonas-paprotka.de/ref/codeunit/4398-soa-task-message/"},"codeunit:4590":{"name":"SOA Billing","url":"https://jonas-paprotka.de/ref/codeunit/4590-soa-billing/"},"table:8886":{"name":"Email Inbox","url":"https://jonas-paprotka.de/ref/table/8886-email-inbox/"}},"procs":[{"name":"OnRun","line":21,"kind":"trigger","steps":[[23,"call","RetrieveEmails",1]]},{"name":"RetrieveEmails","line":51,"kind":"procedure","access":"local","params":1,"steps":[[61,"ext","codeunit",4400,"CheckSOASetupStillValid",1],[64,"ext","codeunit",4587,"GetProcessLimitPerDay",1],[65,"ext","codeunit",4396,"GetEmailCountProcessedWithin24hrs",1],[69,"ext","codeunit",8703,"LogUsage",4],[69,"ext","codeunit",4400,"GetFeatureName",0],[74,"ext","codeunit",4396,"GetMaxNoOfEmails",0],[79,"ext","table",8885,"AddCategoryFilter",1],[80,"write",8885,"Insert"],[82,"ext","codeunit",8901,"RetrieveEmails",4],[85,"ext","codeunit",8703,"LogUsage",4],[85,"ext","codeunit",4400,"GetFeatureName",0],[87,"ext","codeunit",8703,"LogUsage",4],[87,"ext","codeunit",4400,"GetFeatureName",0],[89,"ext","codeunit",4400,"CheckSOASetupStillValid",1],[93,"ext","codeunit",4400,"InstructionsSyncRequired",1],[94,"ext","codeunit",4400,"UpdateInstructions",1],[95,"ext","codeunit",4400,"UpdateSOASetupInstructionsLastSync",1],[98,"call","AddEmailInboxToSOAEmails",2],[108,"event","OnAddEmailToAgentTask",0],[114,"ext","codeunit",8703,"LogUsage",4],[114,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"AddEmailToAgentTask","line":121,"kind":"procedure","access":"local","params":2,"steps":[[128,"ext","codeunit",8703,"LogUsage",4],[128,"ext","codeunit",4400,"GetFeatureName",0],[129,"write",4585,"Delete",1],[133,"ext","codeunit",4315,"TaskExists",2],[134,"call","AddEmailToExistingAgentTask",3],[136,"call","AddEmailToNewAgentTask",3],[138,"event","OnAfterProcessEmail",0]]},{"name":"AddEmailInboxToSOAEmails","line":141,"kind":"procedure","params":2,"steps":[[157,"write",4585,"Insert"],[159,"ext","codeunit",8901,"MarkAsRead",3],[160,"ext","codeunit",8901,"ApplyEmailCategory",4]]},{"name":"AddEmailToNewAgentTask","line":165,"kind":"procedure","params":3,"steps":[[176,"ext","codeunit",8904,"Get",1],[177,"ext","codeunit",8904,"GetSubject",0],[177,"ext","codeunit",8904,"GetBody",0],[178,"call","GetAgentTaskTitle",1],[180,"ext","codeunit",4316,"Initialize",2],[182,"ext","codeunit",4398,"MessageRequiresReview",3],[185,"ext","codeunit",4315,"Initialize",2],[189,"call","AddEmailAttachmentToTaskMessage",3],[190,"ext","codeunit",4315,"Create",0],[192,"ext","codeunit",4315,"GetAgentTaskMessageCreated",0],[193,"ext","table",4585,"SetAgentMessageFields",1],[194,"call","SetAttachmentsTransferred",2],[195,"write",4585,"Modify"],[196,"ext","codeunit",4590,"LogEmailRead",2],[197,"ext","codeunit",8703,"LogUsage",4],[197,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"AddEmailAttachmentToTaskMessage","line":200,"kind":"procedure","access":"local","params":3,"steps":[[216,"ext","codeunit",8904,"Attachments_First",0],[221,"ext","codeunit",8904,"Attachments_IsInline",0],[222,"ext","codeunit",8904,"Attachments_GetLength",0],[223,"ext","codeunit",8904,"Attachments_GetContentType",0],[225,"ext","codeunit",4400,"GetMaxAttachmentSizeInBytes",0],[228,"call","CreateIgnoredAttachmentPlaceholder",5],[228,"ext","codeunit",8904,"Attachments_GetName",0],[229,"ext","codeunit",4316,"AddAttachment",5],[230,"call","LogIgnoredAttachmentTelemetry",4],[232,"ext","codeunit",8904,"Attachments_GetContent",1],[237,"ext","codeunit",4316,"AddAttachment",5],[237,"ext","codeunit",8904,"Attachments_GetName",0],[240,"ext","codeunit",4400,"SupportedAttachmentContentType",1],[242,"ext","codeunit",4400,"IsPdfAttachmentContentType",1],[244,"ext","codeunit",4400,"DocumentExceedsPageCountThreshold",2],[245,"ext","codeunit",8703,"LogError",4],[245,"ext","codeunit",4400,"GetFeatureName",0],[247,"ext","codeunit",8703,"LogUsage",3],[247,"ext","codeunit",4400,"GetFeatureName",0],[247,"ext","codeunit",4400,"PageCountThreshold",0],[250,"ext","codeunit",8904,"Attachments_GetContent",1],[254,"call","IgnoreAttachment",5],[255,"ext","codeunit",4316,"AddAttachment",5],[255,"ext","codeunit",8904,"Attachments_GetName",0],[258,"call","LogIgnoredAttachmentTelemetry",4],[262,"ext","codeunit",8703,"LogUsage",3],[262,"ext","codeunit",4400,"GetFeatureName",0],[264,"ext","codeunit",8703,"LogUsage",3],[264,"ext","codeunit",4400,"GetFeatureName",0],[271,"ext","codeunit",8904,"Attachments_Next",0],[273,"ext","codeunit",4400,"GetMaxNoOfAttachmentsPerEmail",0],[274,"ext","codeunit",8703,"LogUsage",3],[274,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"IgnoreAttachment","line":277,"kind":"procedure","access":"local","params":5,"steps":[[296,"ext","codeunit",4400,"GetMaxNoOfAttachmentsPerEmail",0]]},{"name":"LogIgnoredAttachmentTelemetry","line":318,"kind":"procedure","access":"local","params":4,"steps":[[325,"ext","codeunit",8703,"LogUsage",4],[325,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"SetAttachmentsTransferred","line":328,"kind":"procedure","access":"local","params":2,"steps":[[330,"ext","codeunit",8904,"Attachments_First",0]]},{"name":"AddEmailToExistingAgentTask","line":333,"kind":"procedure","params":3,"steps":[[346,"ext","codeunit",8703,"LogError",6],[346,"ext","codeunit",4400,"GetFeatureName",0],[354,"ext","codeunit",8703,"LogUsage",4],[354,"ext","codeunit",4400,"GetFeatureName",0],[358,"ext","codeunit",8904,"Get",1],[359,"ext","codeunit",8904,"GetSubject",0],[359,"ext","codeunit",8904,"GetBody",0],[361,"ext","codeunit",4316,"Initialize",2],[363,"ext","codeunit",4398,"MessageRequiresReview",3],[367,"call","AddEmailAttachmentToTaskMessage",3],[368,"ext","codeunit",4316,"Create",0],[370,"ext","table",4585,"SetAgentMessageFields",1],[371,"call","SetAttachmentsTransferred",2],[373,"write",4585,"Modify"],[375,"ext","codeunit",4590,"LogEmailRead",2],[376,"ext","codeunit",8703,"LogUsage",4],[376,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"OnAddEmailToAgentTaskSubscriber","line":397,"kind":"procedure","access":"local","params":2,"steps":[[399,"call","AddEmailToAgentTask",2]]},{"name":"OnAfterEmailProcessed","line":403,"kind":"procedure","access":"local","params":1,"steps":[[410,"write",4585,"Modify"],[412,"ext","codeunit",8703,"LogUsage",4],[412,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"OnBeforeDeleteSOAEmailEvent","line":417,"kind":"procedure","access":"local","params":2,"steps":[[422,"write",8886,"Delete",1]]}]}