{"title":"Codeunit 4400 SOA Setup, changes","url":"https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/changes/","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","versions":"25-29","url":"https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/","json":"https://jonas-paprotka.de/ref/codeunit/4400-soa-setup.json"},"aspect":"changes","total":57,"rows":[{"version":29,"kind":"procedure","change":"added","name":"ActiveSOAgentCount","member":{"name":"ActiveSOAgentCount","sig":"(Guid)","named":"(OwnerUserSecurityID: Guid)","returns":"Integer","kind":"procedure","access":"internal","obsolete":null}},{"version":29,"kind":"procedure","change":"added","name":"ActiveSOAgentSetupExists","member":{"name":"ActiveSOAgentSetupExists","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":29,"kind":"procedure","change":"added","name":"CountNonArchivedSetups","member":{"name":"CountNonArchivedSetups","sig":"(var Record SOA Setup)","named":"(var SOASetup: Record \"SOA Setup\")","returns":"Integer","kind":"procedure","access":"internal","obsolete":null}},{"version":29,"kind":"procedure","change":"added","name":"FindFirstNonArchivedSetup","member":{"name":"FindFirstNonArchivedSetup","sig":"(var Record SOA Setup)","named":"(var SOASetup: Record \"SOA Setup\")","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":29,"kind":"procedure","change":"added","name":"IsAgentArchived","member":{"name":"IsAgentArchived","sig":"(Guid)","named":"(AgentUserSecurityID: Guid)","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":29,"kind":"procedure","change":"added","name":"IsAgentActive","member":{"name":"IsAgentActive","sig":"(Guid)","named":"(AgentUserSecurityID: Guid)","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":29,"kind":"procedure","change":"added","name":"MustTreatAgentAsArchived","member":{"name":"MustTreatAgentAsArchived","sig":"(Guid)","named":"(AgentUserSecurityID: Guid)","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":29,"kind":"procedure","change":"added","name":"CheckAgentNotArchived","member":{"name":"CheckAgentNotArchived","sig":"(Guid)","named":"(AgentUserSecurityID: Guid)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":29,"kind":"procedure","change":"added","name":"IsImageAttachmentContentType","member":{"name":"IsImageAttachmentContentType","sig":"(Text)","named":"(FileMIMEType: Text)","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"gone","name":"GetAgent","member":{"name":"GetAgent","sig":"(var Record Agent)","named":"(var TempSOAgent: Record Agent temporary)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"gone","name":"GetDefaultSOASetup","member":{"name":"GetDefaultSOASetup","sig":"(var Record SOA Setup, var Record Agent)","named":"(var TempSOASetup: Record \"SOA Setup\" temporary; var TempSOAgent: Record Agent temporary)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"gone","name":"ValidateEmailConnection","member":{"name":"ValidateEmailConnection","sig":"(Boolean, var Record SOA Setup)","named":"(StateChanged: Boolean; var TempSOASetup: Record \"SOA Setup\" temporary)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"gone","name":"UpdateAgent","member":{"name":"UpdateAgent","sig":"(var Record Agent, var Record Agent Access Control, var Record SOA Setup, Boolean, Boolean, Boolean, Record User Settings)","named":"(var TempAgent: Record Agent; var TempAgentAccessControl: Record \"Agent Access Control\" temporary; var TempSOASetup: Record \"SOA Setup\" temporary; AccessUpdated: Boolean; Schedule: Boolean; LocalizationSettingsUpdated: Boolean; UserSettings: Record \"User Settings\")","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetInitials","member":{"name":"GetInitials","sig":"(Guid)","named":"(AgentUserSecurityID: Guid)","returns":"Text[4]","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"MaxSOAInstances","member":{"name":"MaxSOAInstances","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetDispatcherBaseDelaySeconds","member":{"name":"GetDispatcherBaseDelaySeconds","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetDispatcherDelayIncrementSeconds","member":{"name":"GetDispatcherDelayIncrementSeconds","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"UpdateAgent","member":{"name":"UpdateAgent","sig":"(var Record Agent Setup Buffer, var Record SOA Setup, Boolean)","named":"(var AgentSetupBuffer: Record \"Agent Setup Buffer\"; var TempSOASetup: Record \"SOA Setup\" temporary; Schedule: Boolean)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetSOASetup","member":{"name":"GetSOASetup","sig":"(var Record SOA Setup, Guid)","named":"(var TempSOASetup: Record \"SOA Setup\" temporary; AgentUserSecurityID: Guid)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"ValidateAgentIdentity","member":{"name":"ValidateAgentIdentity","sig":"(Record SOA Setup)","named":"(SOASetup: Record \"SOA Setup\")","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"CheckMailboxUnique","member":{"name":"CheckMailboxUnique","sig":"(Record SOA Setup)","named":"(SOASetup: Record \"SOA Setup\")","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetSOAUserDisplayName","member":{"name":"GetSOAUserDisplayName","sig":"()","named":"()","returns":"Text[80]","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetSOAUserDisplayName","member":{"name":"GetSOAUserDisplayName","sig":"(Text[50])","named":"(AgentName: Text[50])","returns":"Text[80]","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetSOAUsername","member":{"name":"GetSOAUsername","sig":"()","named":"()","returns":"Text[50]","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"ValidateEmailConnection","member":{"name":"ValidateEmailConnection","sig":"(Boolean, var Record SOA Setup, Boolean, Boolean)","named":"(StateChanged: Boolean; var TempSOASetup: Record \"SOA Setup\" temporary; MailboxChanged: Boolean; IsFirstActivation: Boolean)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetInboxEmailCount","member":{"name":"GetInboxEmailCount","sig":"(var Record SOA Setup)","named":"(var SOASetup: Record \"SOA Setup\")","returns":"Integer","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetUpdatedQuoteInterventionSuggestionCode","member":{"name":"GetUpdatedQuoteInterventionSuggestionCode","sig":"()","named":"()","returns":"Code[20]","kind":"procedure","access":"internal","obsolete":null}},{"version":28,"kind":"procedure","change":"added","name":"GetUpdatedOrderInterventionSuggestionCode","member":{"name":"GetUpdatedOrderInterventionSuggestionCode","sig":"()","named":"()","returns":"Code[20]","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"gone","name":"CreateAgent","member":{"name":"CreateAgent","sig":"(var Record Agent, var Record Agent Access Control, var Record SOA Setup, var Record Email Account)","named":"(var TempAgent: Record Agent; var TempAgentAccessControl: Record \"Agent Access Control\" temporary; var TempSOASetup: Record \"SOA Setup\" temporary; var TempEmailAccount: Record \"Email Account\" temporary)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"gone","name":"GetAgentTaskUserInterventionSuggestions","member":{"name":"GetAgentTaskUserInterventionSuggestions","sig":"(Guid, BigInteger, Integer, RecordId, var Record Agent Task User Int Suggestion)","named":"(AgentUserId: Guid; AgentTaskId: BigInteger; PageId: Integer; RecordId: RecordId; var AgentTaskUserInterventionSuggestion: Record \"Agent Task User Int Suggestion\")","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"gone","name":"UpdateAgent","member":{"name":"UpdateAgent","sig":"(var Record Agent, var Record Agent Access Control, var Record SOA Setup, var Record Email Account, Boolean, Boolean)","named":"(var TempAgent: Record Agent; var TempAgentAccessControl: Record \"Agent Access Control\" temporary; var TempSOASetup: Record \"SOA Setup\" temporary; var TempEmailAccount: Record \"Email Account\" temporary; AccessUpdated: Boolean; Schedule: Boolean)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"gone","name":"GetAgentTaskPageContext","member":{"name":"GetAgentTaskPageContext","sig":"(Guid, BigInteger, Integer, RecordId, var Record Agent Task Page Context)","named":"(AgentUserId: Guid; AgentTaskId: BigInteger; PageId: Integer; RecordId: RecordId; var AgentTaskPageContext: Record \"Agent Task Page Context\")","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"UpdateAgent","member":{"name":"UpdateAgent","sig":"(var Record Agent, var Record Agent Access Control, var Record SOA Setup, Boolean, Boolean, Boolean, Record User Settings)","named":"(var TempAgent: Record Agent; var TempAgentAccessControl: Record \"Agent Access Control\" temporary; var TempSOASetup: Record \"SOA Setup\" temporary; AccessUpdated: Boolean; Schedule: Boolean; LocalizationSettingsUpdated: Boolean; UserSettings: Record \"User Settings\")","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"GetDefaultEmailSignatureAsTxt","member":{"name":"GetDefaultEmailSignatureAsTxt","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"InstructionsSyncRequired","member":{"name":"InstructionsSyncRequired","sig":"(var Record SOA Setup)","named":"(var SOASetup: Record \"SOA Setup\")","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"UpdateSOASetupInstructionsLastSync","member":{"name":"UpdateSOASetupInstructionsLastSync","sig":"(var Record SOA Setup)","named":"(var SOASetup: Record \"SOA Setup\")","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"GetDefaultProfile","member":{"name":"GetDefaultProfile","sig":"(var Record All Profile)","named":"(var TempAllProfile: Record \"All Profile\" temporary)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"GetDefaultAccessControls","member":{"name":"GetDefaultAccessControls","sig":"(var Record Access Control Buffer)","named":"(var TempAccessControlBuffer: Record \"Access Control Buffer\" temporary)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"GetAgentTaskUserInterventionSuggestions","member":{"name":"GetAgentTaskUserInterventionSuggestions","sig":"(Record Agent User Int Request Details, var Record Agent Task User Int Suggestion)","named":"(AgentTaskUserInterventionRequestDetails: Record \"Agent User Int Request Details\"; var AgentTaskUserInterventionSuggestion: Record \"Agent Task User Int Suggestion\")","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"GetAgentTaskPageContext","member":{"name":"GetAgentTaskPageContext","sig":"(Record Agent Task Page Context Req., var Record Agent Task Page Context)","named":"(AgentTaskPageContextRequest: Record \"Agent Task Page Context Req.\"; var AgentTaskPageContext: Record \"Agent Task Page Context\")","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"SupportedAttachmentContentType","member":{"name":"SupportedAttachmentContentType","sig":"(Text)","named":"(FileMIMEType: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"IsPdfAttachmentContentType","member":{"name":"IsPdfAttachmentContentType","sig":"(Text)","named":"(FileMIMEType: Text)","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"DocumentExceedsPageCountThreshold","member":{"name":"DocumentExceedsPageCountThreshold","sig":"(InStream, var Boolean)","named":"(DocInStream: InStream; var Exceeds: Boolean)","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"PageCountThreshold","member":{"name":"PageCountThreshold","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"GetMaxNoOfAttachmentsPerEmail","member":{"name":"GetMaxNoOfAttachmentsPerEmail","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"internal","obsolete":null}},{"version":27,"kind":"procedure","change":"added","name":"GetFeatureName","member":{"name":"GetFeatureName","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"gone","name":"UpdateAgent","member":{"name":"UpdateAgent","sig":"(var Record Agent, var Record Agent Access Control, var Record SOA Setup, var Record Email Account, Boolean)","named":"(var TempAgent: Record Agent; var TempAgentAccessControl: Record \"Agent Access Control\" temporary; var TempSOASetup: Record \"SOA Setup\" temporary; var TempEmailAccount: Record \"Email Account\" temporary; AccessUpdated: Boolean)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"gone","name":"UpdateInstructions","member":{"name":"UpdateInstructions","sig":"(Guid, var Record SOA Setup)","named":"(AgentUserSecurityID: Guid; var TempSOASetup: Record \"SOA Setup\" temporary)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"gone","name":"TestEmailConnection","member":{"name":"TestEmailConnection","sig":"(var Record SOA Setup, var Boolean)","named":"(var TempSOASetup: Record \"SOA Setup\" temporary; var ConnectionSuccess: Boolean)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"gone","name":"UpdateSyncDateTime","member":{"name":"UpdateSyncDateTime","sig":"(var Record SOA Setup)","named":"(var TempSetup: Record \"SOA Setup\" temporary)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"added","name":"UpdateAgent","member":{"name":"UpdateAgent","sig":"(var Record Agent, var Record Agent Access Control, var Record SOA Setup, var Record Email Account, Boolean, Boolean)","named":"(var TempAgent: Record Agent; var TempAgentAccessControl: Record \"Agent Access Control\" temporary; var TempSOASetup: Record \"SOA Setup\" temporary; var TempEmailAccount: Record \"Email Account\" temporary; AccessUpdated: Boolean; Schedule: Boolean)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"added","name":"UpdateInstructions","member":{"name":"UpdateInstructions","sig":"(var Record SOA Setup)","named":"(var TempSOASetup: Record \"SOA Setup\" temporary)","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"added","name":"CheckSOASetupStillValid","member":{"name":"CheckSOASetupStillValid","sig":"(var Record SOA Setup)","named":"(var SOASetup: Record \"SOA Setup\")","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"added","name":"GetAgentTaskPageContext","member":{"name":"GetAgentTaskPageContext","sig":"(Guid, BigInteger, Integer, RecordId, var Record Agent Task Page Context)","named":"(AgentUserId: Guid; AgentTaskId: BigInteger; PageId: Integer; RecordId: RecordId; var AgentTaskPageContext: Record \"Agent Task Page Context\")","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"added","name":"GetCommunicationLanguageCodeAndFormat","member":{"name":"GetCommunicationLanguageCodeAndFormat","sig":"(BigInteger, var Code[10], var Text[80])","named":"(AgentTaskId: BigInteger; var LanguageCode: Code[10]; var FormatRegion: Text[80])","returns":"","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"added","name":"ValidateEmailConnectionStatus","member":{"name":"ValidateEmailConnectionStatus","sig":"(var Record SOA Setup)","named":"(var TempSOASetup: Record \"SOA Setup\" temporary)","returns":"Boolean","kind":"procedure","access":"internal","obsolete":null}},{"version":26,"kind":"procedure","change":"added","name":"ValidateEmailConnection","member":{"name":"ValidateEmailConnection","sig":"(Boolean, var Record SOA Setup)","named":"(StateChanged: Boolean; var TempSOASetup: Record \"SOA Setup\" temporary)","returns":"","kind":"procedure","access":"internal","obsolete":null}}]}