{"title":"Page 4400 SOA Setup, extension points 29","url":"https://jonas-paprotka.de/ref/page/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-11-14","object":{"type":"page","id":4400,"name":"SOA Setup","app":"Sales Order Agent","url":"https://jonas-paprotka.de/ref/page/4400-soa-setup/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/page/4400-soa-setup/source/","path":"src/Apps/W1/SalesOrderAgent/app/src/Setup/SOASetup.Page.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:4415":{"name":"SOA Create Task Impl","url":"https://jonas-paprotka.de/ref/codeunit/4415-soa-create-task-impl/"},"table:4310":{"name":"Agent Setup Buffer","url":"https://jonas-paprotka.de/ref/table/4310-agent-setup-buffer/"},"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:4317":{"name":"Agent System Permissions","url":"https://jonas-paprotka.de/ref/codeunit/4317-agent-system-permissions/"},"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:4324":{"name":"Agent Setup","url":"https://jonas-paprotka.de/ref/codeunit/4324-agent-setup/"},"codeunit:4304":{"name":"SOA Session Events","url":"https://jonas-paprotka.de/ref/codeunit/4304-soa-session-events/"},"codeunit:4413":{"name":"SOA Shipment Date Mgt.","url":"https://jonas-paprotka.de/ref/codeunit/4413-soa-shipment-date-mgt/"},"page:99000958":{"name":"Order Promising Setup","url":"https://jonas-paprotka.de/ref/page/99000958-order-promising-setup/"},"codeunit:8901":{"name":"Email","url":"https://jonas-paprotka.de/ref/codeunit/8901-email/"},"codeunit:8894":{"name":"Email Account","url":"https://jonas-paprotka.de/ref/codeunit/8894-email-account/"},"page:4444":{"name":"Email Account Folders","url":"https://jonas-paprotka.de/ref/page/4444-email-account-folders/"},"page:8886":{"name":"Email Account Wizard","url":"https://jonas-paprotka.de/ref/page/8886-email-account-wizard/"},"page:8887":{"name":"Email Accounts","url":"https://jonas-paprotka.de/ref/page/8887-email-accounts/"},"page:4407":{"name":"SOA Email Template","url":"https://jonas-paprotka.de/ref/page/4407-soa-email-template/"}},"procs":[{"name":"AgentName.OnValidate","line":53,"kind":"trigger","steps":[[55,"call","ConfigUpdated",0]]},{"name":"AgentInitials.OnValidate","line":64,"kind":"trigger","steps":[[66,"call","ConfigUpdated",0]]},{"name":"MailEnabled.OnValidate","line":77,"kind":"trigger","steps":[[79,"call","ConfigUpdated",0]]},{"name":"Mailbox.OnAssistEdit","line":89,"kind":"trigger","steps":[[91,"call","OnAssistEditMailbox",0]]},{"name":"Mailbox.OnValidate","line":94,"kind":"trigger","steps":[[96,"call","ConfigUpdated",0]]},{"name":"MailboxFolder.OnAssistEdit","line":105,"kind":"trigger","steps":[[107,"call","OnAssistEditMailboxFolder",0]]},{"name":"SOACreateTask.OnDrillDown","line":125,"kind":"trigger","steps":[[137,"ext","codeunit",4415,"OpenCreateTaskPageForData",4],[144,"validate",4310,"State"],[145,"write",4310,"Modify"],[150,"write",4325,"Modify"],[154,"call","ApplySetup",1],[159,"write",4310,"Rename"],[165,"ext","codeunit",4415,"SetAgentUserSecurityID",1],[166,"ext","codeunit",4415,"CreateTask",3]]},{"name":"RegisteredSenderInputMessageReview.OnValidate","line":215,"kind":"trigger","steps":[[217,"call","ConfigUpdated",0]]},{"name":"UnregisteredSenderInputMessageReview.OnValidate","line":228,"kind":"trigger","steps":[[230,"call","ConfigUpdated",0]]},{"name":"SearchOnlyAvailableItems.OnValidate","line":247,"kind":"trigger","steps":[[252,"call","ConfigUpdated",0]]},{"name":"IncludeCapableToPromise.OnValidate","line":260,"kind":"trigger","steps":[[263,"call","VerifyOrderPromisingSetupConfigured",0],[264,"call","ConfigUpdated",0]]},{"name":"RequestQuoteReview.OnValidate","line":283,"kind":"trigger","steps":[[285,"call","ConfigUpdated",0]]},{"name":"SendSalesQuote.OnValidate","line":293,"kind":"trigger","steps":[[295,"call","ConfigUpdated",0]]},{"name":"CreateOrderFromQuote.OnValidate","line":313,"kind":"trigger","steps":[[317,"call","ConfigUpdated",0]]},{"name":"RequestOrderReview.OnValidate","line":326,"kind":"trigger","steps":[[328,"call","ConfigUpdated",0]]},{"name":"EarliestSyncAt.OnValidate","line":348,"kind":"trigger","steps":[[350,"call","ConfigUpdated",0]]},{"name":"AnalyzeAttachments.OnValidate","line":369,"kind":"trigger","steps":[[371,"call","ConfigUpdated",0]]},{"name":"MarkEmailAsRead.OnValidate","line":386,"kind":"trigger","steps":[[388,"call","ConfigUpdated",0]]},{"name":"DailyEmailLimit.OnValidate","line":415,"kind":"trigger","steps":[[418,"call","ConfigUpdated",0]]},{"name":"EmailTemplate.OnDrillDown","line":451,"kind":"trigger","steps":[[453,"call","UpdateEmailSignature",0]]},{"name":"OnOpenPage","line":480,"kind":"trigger","steps":[[491,"ext","codeunit",7771,"IsEnabled",1],[496,"call","IsFirstConfig",0],[501,"ext","codeunit",4317,"CurrentUserCanManageAgent",1],[505,"ext","table",4325,"GetBasedOnAgentUserSecurityID",2],[515,"ext","codeunit",4400,"GetSOAUsername",0],[520,"ext","codeunit",4400,"GetSOAUserDisplayName",1],[521,"ext","codeunit",4400,"GetAgentSummary",0],[522,"call","UpdateAgentSetupBuffer",0],[525,"ext","codeunit",4400,"MustTreatAgentAsArchived",1],[526,"call","UpdateControls",0],[530,"call","NotifyAgentArchived",0],[533,"ext","codeunit",8703,"LogUptake",3],[533,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"OnAfterGetCurrRecord","line":536,"kind":"trigger","steps":[[538,"call","UpdateAgentSetupBuffer",0],[539,"ext","codeunit",4324,"GetChangesMade",1]]},{"name":"OnQueryClosePage","line":542,"kind":"trigger","steps":[[547,"call","ApplySetup",1]]},{"name":"ApplySetup","line":550,"kind":"procedure","access":"local","params":1,"steps":[[568,"call","EnabledAgentFirstConfig",0],[570,"call","ActivateAgent",0],[572,"call","ShouldOfferActivation",1],[574,"call","ActivateAgent",0],[576,"call","UpdateAgentSetupBuffer",0],[577,"call","StateChanged",0],[578,"ext","codeunit",4304,"BindUserEvents",0],[580,"call","CheckIsValidConfig",0],[582,"call","SetDefaultInboxFolder",0],[584,"ext","codeunit",4400,"GetInboxEmailCount",1],[590,"ext","codeunit",4400,"ValidateEmailConnection",4],[590,"call","StateChanged",0],[604,"call","ShowDeactivateAgentEmailPermissionsWarning",0],[608,"call","StateChanged",0],[609,"ext","codeunit",4400,"UpdateSOASetupActivationDT",1],[611,"ext","codeunit",4400,"ValidateAgentIdentity",1],[612,"ext","codeunit",4400,"CheckMailboxUnique",1],[614,"ext","codeunit",4400,"UpdateAgent",3],[614,"call","ShouldScheduleTask",0]]},{"name":"StateChanged","line":623,"kind":"procedure","access":"local","params":0,"steps":[[625,"call","IsFirstConfig",0]]},{"name":"ShouldOfferActivation","line":628,"kind":"procedure","access":"local","params":1,"steps":[[633,"call","UpdateAgentSetupBuffer",0],[634,"ext","codeunit",4324,"GetChangesMade",1]]},{"name":"ActivateAgent","line":642,"kind":"procedure","access":"local","params":0,"steps":[[644,"call","UpdateAgentSetupBuffer",0],[645,"validate",4310,"State"],[646,"write",4310,"Modify"]]},{"name":"ShouldScheduleTask","line":651,"kind":"procedure","access":"local","params":0,"steps":[[653,"call","StateChanged",0]]},{"name":"ShowDeactivateAgentEmailPermissionsWarning","line":656,"kind":"procedure","access":"local","params":0,"steps":[[660,"call","UpdateAgentSetupBuffer",0],[665,"call","StateChanged",0],[665,"call","IsFirstConfig",0],[666,"ext","codeunit",4400,"ValidateEmailConnectionStatus",1]]},{"name":"UpdateControls","line":679,"kind":"procedure","access":"local","params":0,"steps":[[685,"ext","codeunit",4400,"GetSOASetup",2],[691,"call","CheckIsValidConfig",0],[702,"ext","table",4325,"GetDefaultMessageLimit",0],[707,"call","CheckIsValidConfig",0]]},{"name":"ConfigUpdated","line":710,"kind":"procedure","access":"local","params":0,"steps":[[713,"call","CheckIsValidConfig",0],[717,"call","EnabledAgentFirstConfig",0]]},{"name":"VerifyOrderPromisingSetupConfigured","line":721,"kind":"procedure","access":"local","params":0,"steps":[[726,"ext","codeunit",4413,"OrderPromisingSetupConfigured",0],[731,"run","page",99000958],[733,"ext","codeunit",4413,"OrderPromisingSetupConfigured",0]]},{"name":"EnabledAgentFirstConfig","line":737,"kind":"procedure","access":"local","params":0,"steps":[[739,"call","IsFirstConfig",0],[739,"call","CheckIsValidConfig",0]]},{"name":"SetDefaultInboxFolder","line":752,"kind":"procedure","access":"local","params":0,"steps":[[762,"ext","codeunit",8901,"GetMailFolders",3]]},{"name":"CheckMailboxExists","line":778,"kind":"procedure","access":"local","params":0,"steps":[[784,"ext","codeunit",8894,"GetAllAccounts",2]]},{"name":"OnAssistEditMailboxFolder","line":801,"kind":"procedure","access":"local","params":0,"steps":[[818,"ext","page",4444,"SetEmailAccount",2],[824,"call","ConfigUpdated",0]]},{"name":"OnAssistEditMailbox","line":828,"kind":"procedure","access":"local","params":0,"steps":[[838,"call","CheckMailboxExists",0],[839,"run","page",8886],[841,"call","CheckMailboxExists",0],[844,"ext","page",8887,"EnableLookupMode",0],[845,"ext","page",8887,"SetShowCreateAccount",1],[846,"ext","page",8887,"FilterConnectorV4Accounts",1],[848,"ext","page",8887,"GetAccount",1],[852,"ext","codeunit",4400,"CheckMailboxUnique",1],[858,"call","ConfigUpdated",0]]},{"name":"UpdateEmailSignature","line":866,"kind":"procedure","access":"local","params":0,"steps":[[877,"ext","page",4407,"SetCurrentSignatureAsTxt",1],[877,"ext","table",4325,"GetEmailSignatureAsTxt",0],[879,"ext","page",4407,"IsValueUpdated",0],[880,"ext","table",4325,"SetEmailSignature",1],[880,"ext","page",4407,"GetNewSignatureAsTxt",0],[881,"write",4325,"Modify"]]}]}