{"title":"Codeunit 4400 SOA Setup, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/4400-soa-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-10-30","object":{"type":"codeunit","id":4400,"name":"SOA Setup","app":"Sales Order Agent","url":"https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/source/","path":"src/Apps/W1/SalesOrderAgent/app/src/Setup/SOASetup.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:4324":{"name":"Agent Setup","url":"https://jonas-paprotka.de/ref/codeunit/4324-agent-setup/"},"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/"},"table:4325":{"name":"SOA Setup","url":"https://jonas-paprotka.de/ref/table/4325-soa-setup/"},"codeunit:4317":{"name":"Agent System Permissions","url":"https://jonas-paprotka.de/ref/codeunit/4317-agent-system-permissions/"},"codeunit:9024":{"name":"Azure AD Graph User","url":"https://jonas-paprotka.de/ref/codeunit/9024-azure-ad-graph-user/"},"table:2000000260":{"name":"Agent","url":"https://jonas-paprotka.de/ref/table/2000000260-agent/"},"codeunit:4321":{"name":"Agent","url":"https://jonas-paprotka.de/ref/codeunit/4321-agent/"},"codeunit:43":{"name":"Language","url":"https://jonas-paprotka.de/ref/codeunit/43-language/"},"codeunit:8703":{"name":"Feature Telemetry","url":"https://jonas-paprotka.de/ref/codeunit/8703-feature-telemetry/"},"codeunit:4002":{"name":"SOA Prompt Builder","url":"https://jonas-paprotka.de/ref/codeunit/4002-soa-prompt-builder/"},"codeunit:4395":{"name":"Global Item Search","url":"https://jonas-paprotka.de/ref/codeunit/4395-global-item-search/"},"table:2000000291":{"name":"Access Control Buffer","url":"https://jonas-paprotka.de/ref/table/2000000291-access-control-buffer/"},"codeunit:8894":{"name":"Email Account","url":"https://jonas-paprotka.de/ref/codeunit/8894-email-account/"},"table:2000000279":{"name":"Agent Task User Int Suggestion","url":"https://jonas-paprotka.de/ref/table/2000000279-agent-task-user-int-suggestion/"},"codeunit:4305":{"name":"SOA Filters Impl.","url":"https://jonas-paprotka.de/ref/codeunit/4305-soa-filters-impl/"},"table:4":{"name":"Currency","url":"https://jonas-paprotka.de/ref/table/4-currency/"},"table:98":{"name":"General Ledger Setup","url":"https://jonas-paprotka.de/ref/table/98-general-ledger-setup/"},"table:2000000285":{"name":"Agent Task Page Context","url":"https://jonas-paprotka.de/ref/table/2000000285-agent-task-page-context/"},"codeunit:4397":{"name":"SOA Test Setup","url":"https://jonas-paprotka.de/ref/codeunit/4397-soa-test-setup/"},"codeunit:457":{"name":"Environment Information","url":"https://jonas-paprotka.de/ref/codeunit/457-environment-information/"},"codeunit:4396":{"name":"SOA Email Setup","url":"https://jonas-paprotka.de/ref/codeunit/4396-soa-email-setup/"},"codeunit:3110":{"name":"PDF Document","url":"https://jonas-paprotka.de/ref/codeunit/3110-pdf-document/"}},"procs":[{"name":"CreateDefaultAgentNoEmail","line":38,"kind":"procedure","params":0,"steps":[[47,"ext","codeunit",4324,"GetSetupRecord",6],[50,"ext","codeunit",4400,"GetSOAUsername",0],[51,"ext","codeunit",4400,"GetSOAUserDisplayName",0],[52,"ext","codeunit",4400,"GetAgentSummary",0],[56,"ext","codeunit",4324,"SaveChanges",1],[57,"call","GetSOASetup",2],[60,"call","UpdateAgent",3]]},{"name":"CreateAgent","line":63,"kind":"procedure","access":"local","params":2,"steps":[[67,"call","EnsureAgentIdentityDefaults",1],[68,"call","ValidateAgentIdentity",1],[69,"call","CheckMailboxUnique",1],[70,"call","GetSOAUserDisplayName",1],[71,"call","GetSOAUsername",0],[72,"ext","codeunit",4324,"SaveChanges",1],[73,"call","UpdateInstructions",1],[77,"call","UpdateSyncDateTime",2],[78,"call","UpdateSOASetupActivationDT",1],[80,"call","UpdateSOASetup",1],[83,"call","EnableItemSearch",0],[85,"ext","codeunit",4587,"ScheduleSOAgent",1]]},{"name":"GetInitials","line":89,"kind":"procedure","access":"internal","params":0,"steps":[[91,"call","GetDefaultSOAInitials",0]]},{"name":"GetInitials","line":94,"kind":"procedure","access":"internal","params":1,"steps":[[99,"ext","table",4325,"GetBasedOnAgentUserSecurityID",2],[103,"call","GetDefaultSOAInitials",0]]},{"name":"AllowCreateNewSOAgent","line":116,"kind":"procedure","access":"internal","params":0,"steps":[[120,"ext","codeunit",4317,"CurrentUserHasCanManageAllAgentsPermission",0],[124,"call","ActiveSOAgentCount",1],[124,"call","MaxSOAInstances",0]]},{"name":"ActiveSOAgentCount","line":131,"kind":"procedure","access":"internal","params":1,"steps":[[136,"call","CountNonArchivedSetups",1]]},{"name":"CountNonArchivedSetups","line":165,"kind":"procedure","access":"internal","params":1,"steps":[[171,"call","IsAgentArchived",1]]},{"name":"FindFirstNonArchivedSetup","line":179,"kind":"procedure","access":"internal","params":1,"steps":[[185,"call","IsAgentArchived",1]]},{"name":"MustTreatAgentAsArchived","line":244,"kind":"procedure","access":"internal","params":1,"steps":[[254,"call","IsAgentArchived",1]]},{"name":"CheckAgentNotArchived","line":257,"kind":"procedure","access":"internal","params":1,"steps":[[259,"call","MustTreatAgentAsArchived",1]]},{"name":"UpdateAgent","line":278,"kind":"procedure","access":"internal","params":3,"steps":[[284,"ext","codeunit",9024,"IsUserDelegatedAdmin",0],[284,"ext","codeunit",9024,"IsUserDelegatedHelpdesk",0],[293,"call","CheckAgentNotArchived",1],[295,"call","EnsureAgentIdentityDefaults",1],[298,"call","CreateAgent",2],[300,"ext","table",4325,"GetBasedOnAgentUserSecurityID",2],[305,"call","ValidateAgentIdentity",1],[306,"call","CheckMailboxUnique",1],[307,"call","GetSOAUserDisplayName",1],[308,"ext","codeunit",4324,"SaveChanges",1],[310,"call","UpdateSOASetupActivationDT",1],[311,"call","UpdateInstructions",1],[313,"call","UpdateSyncDateTime",2],[317,"call","EnableItemSearch",0],[319,"ext","codeunit",4587,"ScheduleSOAgent",1],[322,"ext","codeunit",4587,"RemoveScheduledTask",1],[324,"call","UpdateSOASetup",1],[327,"call","SyncAgentIdentity",2],[330,"call","LogTelemetry",2]]},{"name":"SyncAgentIdentity","line":333,"kind":"procedure","access":"local","params":2,"steps":[[347,"call","GetSOAUserDisplayName",1],[353,"write",2000000260,"Modify"]]},{"name":"UpdateSOASetup","line":357,"kind":"procedure","access":"local","params":1,"steps":[[361,"ext","table",4325,"GetBasedOnAgentUserSecurityID",2],[388,"call","CopyMailSignatureField",2],[394,"write",4325,"Modify"],[400,"write",4325,"Insert"],[402,"write",4325,"Insert"]]},{"name":"LogTelemetry","line":406,"kind":"procedure","access":"local","params":2,"steps":[[415,"ext","codeunit",4321,"GetUserSettings",2],[417,"ext","codeunit",43,"GetCultureName",1],[421,"ext","codeunit",43,"GetCultureName",1],[449,"ext","codeunit",8703,"LogUptake",4],[449,"call","GetFeatureName",0],[451,"ext","codeunit",8703,"LogUptake",4],[451,"call","GetFeatureName",0]]},{"name":"SetDefaultEmailSignature","line":480,"kind":"procedure","access":"local","params":1,"steps":[[482,"ext","table",4325,"SetEmailSignature",1],[482,"call","GetDefaultEmailSignatureAsTxt",0]]},{"name":"UpdateInstructions","line":490,"kind":"procedure","access":"internal","params":1,"steps":[[495,"call","CheckAgentNotArchived",1],[497,"ext","codeunit",4002,"PrepareInstructions",2],[498,"ext","codeunit",4321,"SetInstructions",2]]},{"name":"InstructionsSyncRequired","line":502,"kind":"procedure","access":"internal","params":1,"steps":[[513,"call","GetSOAInstructionsSyncPeriod",0]]},{"name":"UpdateSOASetupInstructionsLastSync","line":519,"kind":"procedure","access":"internal","params":1,"steps":[[527,"write",4325,"Modify"]]},{"name":"EnableItemSearch","line":540,"kind":"procedure","access":"local","params":0,"steps":[[544,"ext","codeunit",4395,"EnableItemSearch",0]]},{"name":"GetDefaultAgentAccessControl","line":547,"kind":"procedure","access":"internal","params":2,"steps":[[551,"ext","codeunit",4321,"GetUserAccess",2]]},{"name":"GetDefaultProfile","line":554,"kind":"procedure","access":"internal","params":1,"steps":[[559,"ext","codeunit",4321,"PopulateDefaultProfile",3]]},{"name":"GetDefaultAccessControls","line":562,"kind":"procedure","access":"internal","params":1,"steps":[[572,"write",2000000291,"Insert"]]},{"name":"GetSOASetup","line":575,"kind":"procedure","access":"internal","params":2,"steps":[[580,"call","SetSOASetupDefaults",2],[589,"write",4325,"Insert"],[593,"call","SetSOASetupDefaults",2],[597,"ext","table",4325,"GetBasedOnAgentUserSecurityID",2],[600,"write",4325,"Insert"],[603,"call","SetSOASetupDefaults",2]]},{"name":"ValidateAgentIdentity","line":624,"kind":"procedure","access":"internal","params":1,"steps":[[640,"call","FindFirstNonArchivedSetup",1],[646,"call","FindFirstNonArchivedSetup",1]]},{"name":"CheckMailboxUnique","line":650,"kind":"procedure","access":"internal","params":1,"steps":[[663,"call","FindFirstNonArchivedSetup",1],[669,"call","FindFirstNonArchivedSetup",1]]},{"name":"GetEmailAccount","line":673,"kind":"procedure","access":"internal","params":2,"steps":[[678,"ext","codeunit",8894,"GetAllAccounts",2]]},{"name":"GetDefaultEmailAccount","line":685,"kind":"procedure","access":"internal","params":1,"steps":[[689,"ext","codeunit",8894,"GetAllAccounts",2]]},{"name":"GetAgentTaskUserInterventionSuggestions","line":693,"kind":"procedure","access":"internal","params":2,"steps":[[702,"call","GetUpdatedQuoteInterventionSuggestionCode",0],[706,"write",2000000279,"Insert"],[711,"call","GetUpdatedOrderInterventionSuggestionCode",0],[715,"write",2000000279,"Insert"],[726,"write",2000000279,"Insert"],[735,"write",2000000279,"Insert"],[742,"write",2000000279,"Insert"],[751,"write",2000000279,"Insert"]]},{"name":"GetAgentTaskPageContext","line":757,"kind":"procedure","access":"internal","params":2,"steps":[[792,"ext","codeunit",4305,"GetSecurityFiltersForCustomers",1],[792,"ext","codeunit",4305,"GetSecurityFiltersForContacts",1],[801,"call","GetCommunicationLanguageCodeAndFormat",3],[803,"ext","codeunit",43,"GetLanguageId",1],[812,"call","SetAgentTaskPageContext",5],[812,"ext","table",4,"GetCurrencySymbol",0],[815,"call","SetAgentTaskPageContext",5],[815,"ext","table",98,"GetCurrencySymbol",0]]},{"name":"GetCommunicationLanguageCodeAndFormat","line":821,"kind":"procedure","access":"internal","params":3,"steps":[[829,"ext","codeunit",4305,"GetSecurityFiltersForContacts",1],[832,"ext","codeunit",4305,"GetSecurityFiltersForCustomers",1],[840,"ext","codeunit",4305,"GetExcludeAllFilter",0]]},{"name":"SetAgentTaskPageContext","line":851,"kind":"procedure","access":"local","params":5,"steps":[[858,"write",2000000285,"Insert"]]},{"name":"SetSOASetupDefaults","line":861,"kind":"procedure","access":"local","params":2,"steps":[[868,"call","SetDefaultSalesDocConfig",2],[873,"call","GetDefaultSOAAgentName",0],[874,"call","GetDefaultSOAInitials",0],[875,"call","SetDefaultEmailSignature",1],[876,"write",4325,"Insert"]]},{"name":"GetSOAUserDisplayName","line":879,"kind":"procedure","access":"internal","params":0,"steps":[[881,"call","GetDefaultSOAAgentName",0]]},{"name":"GetSOAUsername","line":892,"kind":"procedure","access":"internal","params":0,"steps":[[900,"call","BuildSOAUserName",1],[901,"call","UserNameExists",1],[904,"call","MaxAgentIdentitySuffix",0]]},{"name":"EnsureAgentIdentityDefaults","line":911,"kind":"procedure","access":"local","params":1,"steps":[[914,"call","GetDefaultSOAAgentName",0],[917,"call","GetDefaultSOAInitials",0]]},{"name":"GetNextAvailableAgentIdentityIndex","line":948,"kind":"procedure","access":"local","params":0,"steps":[[954,"call","GetFirstAvailableAgentNameIndex",0],[955,"call","GetFirstAvailableAgentInitialsIndex",0],[960,"call","MaxAgentIdentitySuffix",0],[961,"call","AgentNameExists",1],[961,"call","BuildSOAAgentName",1],[962,"call","InitialsExists",1],[962,"call","BuildSOAAgentInitials",1]]},{"name":"GetFirstAvailableAgentNameIndex","line":973,"kind":"procedure","access":"local","params":0,"steps":[[980,"call","BuildSOAAgentName",1],[981,"call","AgentNameExists",1],[984,"call","MaxAgentIdentitySuffix",0]]},{"name":"GetDefaultSOAAgentName","line":989,"kind":"procedure","access":"local","params":0,"steps":[[991,"call","BuildSOAAgentName",1],[991,"call","GetNextAvailableAgentIdentityIndex",0]]},{"name":"GetFirstAvailableAgentInitialsIndex","line":1022,"kind":"procedure","access":"local","params":0,"steps":[[1029,"call","BuildSOAAgentInitials",1],[1030,"call","InitialsExists",1],[1033,"call","MaxAgentIdentitySuffix",0]]},{"name":"GetDefaultSOAInitials","line":1038,"kind":"procedure","access":"local","params":0,"steps":[[1040,"call","BuildSOAAgentInitials",1],[1040,"call","GetNextAvailableAgentIdentityIndex",0]]},{"name":"ValidateEmailConnectionStatus","line":1056,"kind":"procedure","access":"internal","params":1,"steps":[[1060,"ext","codeunit",4397,"SetTestEmailConnection",1],[1061,"run","codeunit",4397]]},{"name":"ValidateEmailConnection","line":1064,"kind":"procedure","access":"internal","params":4,"steps":[[1073,"call","UpdateSyncDateTime",2],[1075,"call","ValidateEmailConnectionStatus",1],[1080,"ext","codeunit",457,"IsSandbox",0]]},{"name":"UpdateSyncDateTime","line":1097,"kind":"procedure","access":"local","params":2,"steps":[[1106,"call","GetEmailsCount",1],[1114,"ext","codeunit",4396,"GetMaxNoOfEmails",0]]},{"name":"GetEmailsCount","line":1126,"kind":"procedure","access":"local","params":1,"steps":[[1130,"ext","codeunit",4397,"SetTestEmailCount",1],[1131,"run","codeunit",4397],[1132,"ext","codeunit",4397,"GetEmailCount",0]]},{"name":"GetInboxEmailCount","line":1135,"kind":"procedure","access":"internal","params":1,"steps":[[1140,"call","GetEmailsCount",1]]},{"name":"DocumentExceedsPageCountThreshold","line":1172,"kind":"procedure","access":"internal","params":2,"steps":[[1176,"ext","codeunit",3110,"GetPdfPageCount",1],[1176,"call","PageCountThreshold",0]]}]}