---
title: "Codeunit 4400 SOA Setup"
author: "JOP-AL"
url: https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/
type: codeunit
id: 4400
name: "SOA Setup"
app: "Sales Order Agent"
namespace: Microsoft.Agent.SalesOrderAgent
versions: "25-29"
build: 29.0.54011.55644
countries: "W1, DE, US"
source: "https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/source/"
checked: 2026-11-20
changed: 2026-10-30
subject: "Microsoft Dynamics 365 Business Central"
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/"
---

# Codeunit 4400 SOA Setup

JOP-AL, https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/

| | |
| --- | --- |
| App | Sales Order Agent |
| Namespace | Microsoft.Agent.SalesOrderAgent |
| Versions | 25-29 |
| Minors | W1 25.3-29.0; DE 26.4-29.0; US 25.2-29.0, [every minor](https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/editions.json) |
| Access | Internal |
| Source file | src/Setup/SOASetup.Codeunit.al |

## Procedures

| Name | Parameters | Returns | Access | Versions | Obsolete | Reason |
| --- | --- | --- | --- | --- | --- | --- |
| CreateDefaultAgentNoEmail | () | - | public | 25-29 | - | - |
| CreateAgent | (var TempAgent: Record Agent; var TempAgentAccessControl: Record "Agent Access Control" temporary; var TempSOASetup: Record "SOA Setup" temporary; var TempEmailAccount: Record "Email Account" temporary) | - | internal | 25-26 | - | - |
| GetInitials | () | Text[4] | internal | 25-29 | - | - |
| GetAgentType | () | Text | internal | 25-29 | - | - |
| GetAgentSummary | () | Text | internal | 25-29 | - | - |
| AllowCreateNewSOAgent | () | Boolean | internal | 25-29 | - | - |
| UpdateAgent | (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) | - | internal | 25 | - | - |
| UpdateInstructions | (AgentUserSecurityID: Guid; var TempSOASetup: Record "SOA Setup" temporary) | - | internal | 25 | - | - |
| UpdateSOASetupActivationDT | (var TempSOASetup: Record "SOA Setup" temporary) | - | internal | 25-29 | - | - |
| GetDefaultAgentAccessControl | (AgentUserSecurityID: Guid; var TempAgentAccessControl: Record "Agent Access Control" temporary) | - | internal | 25-29 | - | - |
| GetAgent | (var TempSOAgent: Record Agent temporary) | - | internal | 25-27 | - | - |
| GetDefaultSOASetup | (var TempSOASetup: Record "SOA Setup" temporary; var TempSOAgent: Record Agent temporary) | - | internal | 25-27 | - | - |
| GetEmailAccount | (var SOASetup: Record "SOA Setup"; var TempEmailAccount: Record "Email Account" temporary) | - | internal | 25-29 | - | - |
| GetDefaultEmailAccount | (var TempEmailAccount: Record "Email Account" temporary) | - | internal | 25-29 | - | - |
| GetAgentTaskUserInterventionSuggestions | (AgentUserId: Guid; AgentTaskId: BigInteger; PageId: Integer; RecordId: RecordId; var AgentTaskUserInterventionSuggestion: Record "Agent Task User Int Suggestion") | - | internal | 25-26 | - | - |
| TestEmailConnection | (var TempSOASetup: Record "SOA Setup" temporary; var ConnectionSuccess: Boolean) | - | internal | 25 | - | - |
| UpdateSyncDateTime | (var TempSetup: Record "SOA Setup" temporary) | - | internal | 25 | - | - |
| UpdateAgent | (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) | - | internal | 26 | - | - |
| UpdateInstructions | (var TempSOASetup: Record "SOA Setup" temporary) | - | internal | 26-29 | - | - |
| CheckSOASetupStillValid | (var SOASetup: Record "SOA Setup") | Boolean | internal | 26-29 | - | - |
| GetAgentTaskPageContext | (AgentUserId: Guid; AgentTaskId: BigInteger; PageId: Integer; RecordId: RecordId; var AgentTaskPageContext: Record "Agent Task Page Context") | - | internal | 26 | - | - |
| GetCommunicationLanguageCodeAndFormat | (AgentTaskId: BigInteger; var LanguageCode: Code[10]; var FormatRegion: Text[80]) | - | internal | 26-29 | - | - |
| ValidateEmailConnectionStatus | (var TempSOASetup: Record "SOA Setup" temporary) | Boolean | internal | 26-29 | - | - |
| ValidateEmailConnection | (StateChanged: Boolean; var TempSOASetup: Record "SOA Setup" temporary) | - | internal | 26-27 | - | - |
| UpdateAgent | (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") | - | internal | 27 | - | - |
| GetDefaultEmailSignatureAsTxt | () | Text | internal | 27-29 | - | - |
| InstructionsSyncRequired | (var SOASetup: Record "SOA Setup") | Boolean | internal | 27-29 | - | - |
| UpdateSOASetupInstructionsLastSync | (var SOASetup: Record "SOA Setup") | - | internal | 27-29 | - | - |
| GetDefaultProfile | (var TempAllProfile: Record "All Profile" temporary) | - | internal | 27-29 | - | - |
| GetDefaultAccessControls | (var TempAccessControlBuffer: Record "Access Control Buffer" temporary) | - | internal | 27-29 | - | - |
| GetAgentTaskUserInterventionSuggestions | (AgentTaskUserInterventionRequestDetails: Record "Agent User Int Request Details"; var AgentTaskUserInterventionSuggestion: Record "Agent Task User Int Suggestion") | - | internal | 27-29 | - | - |
| GetAgentTaskPageContext | (AgentTaskPageContextRequest: Record "Agent Task Page Context Req."; var AgentTaskPageContext: Record "Agent Task Page Context") | - | internal | 27-29 | - | - |
| SupportedAttachmentContentType | (FileMIMEType: Text) | Boolean | public | 27-29 | - | - |
| IsPdfAttachmentContentType | (FileMIMEType: Text) | Boolean | internal | 27-29 | - | - |
| DocumentExceedsPageCountThreshold | (DocInStream: InStream; var Exceeds: Boolean) | Boolean | internal | 27-29 | - | - |
| PageCountThreshold | () | Integer | internal | 27-29 | - | - |
| GetMaxNoOfAttachmentsPerEmail | () | Integer | internal | 27-29 | - | - |
| GetFeatureName | () | Text | internal | 27-29 | - | - |
| GetInitials | (AgentUserSecurityID: Guid) | Text[4] | internal | 28-29 | - | - |
| MaxSOAInstances | () | Integer | internal | 28-29 | - | - |
| GetDispatcherBaseDelaySeconds | () | Integer | internal | 28-29 | - | - |
| GetDispatcherDelayIncrementSeconds | () | Integer | internal | 28-29 | - | - |
| UpdateAgent | (var AgentSetupBuffer: Record "Agent Setup Buffer"; var TempSOASetup: Record "SOA Setup" temporary; Schedule: Boolean) | - | internal | 28-29 | - | - |
| GetSOASetup | (var TempSOASetup: Record "SOA Setup" temporary; AgentUserSecurityID: Guid) | - | internal | 28-29 | - | - |
| ValidateAgentIdentity | (SOASetup: Record "SOA Setup") | - | internal | 28-29 | - | - |
| CheckMailboxUnique | (SOASetup: Record "SOA Setup") | - | internal | 28-29 | - | - |
| GetSOAUserDisplayName | () | Text[80] | internal | 28-29 | - | - |
| GetSOAUserDisplayName | (AgentName: Text[50]) | Text[80] | internal | 28-29 | - | - |
| GetSOAUsername | () | Text[50] | internal | 28-29 | - | - |
| ValidateEmailConnection | (StateChanged: Boolean; var TempSOASetup: Record "SOA Setup" temporary; MailboxChanged: Boolean; IsFirstActivation: Boolean) | - | internal | 28-29 | - | - |
| GetInboxEmailCount | (var SOASetup: Record "SOA Setup") | Integer | internal | 28-29 | - | - |
| GetUpdatedQuoteInterventionSuggestionCode | () | Code[20] | internal | 28-29 | - | - |
| GetUpdatedOrderInterventionSuggestionCode | () | Code[20] | internal | 28-29 | - | - |
| ActiveSOAgentCount | (OwnerUserSecurityID: Guid) | Integer | internal | 29 | - | - |
| ActiveSOAgentSetupExists | () | Boolean | internal | 29 | - | - |
| CountNonArchivedSetups | (var SOASetup: Record "SOA Setup") | Integer | internal | 29 | - | - |
| FindFirstNonArchivedSetup | (var SOASetup: Record "SOA Setup") | Boolean | internal | 29 | - | - |
| IsAgentArchived | (AgentUserSecurityID: Guid) | Boolean | internal | 29 | - | - |
| IsAgentActive | (AgentUserSecurityID: Guid) | Boolean | internal | 29 | - | - |
| MustTreatAgentAsArchived | (AgentUserSecurityID: Guid) | Boolean | internal | 29 | - | - |
| CheckAgentNotArchived | (AgentUserSecurityID: Guid) | - | internal | 29 | - | - |
| IsImageAttachmentContentType | (FileMIMEType: Text) | Boolean | internal | 29 | - | - |

## Source

Symbols: Microsoft.SalesOrderAgent.symbols.23b1772f-b8b8-4e87-9339-9ff7cbb2364b, https://dynamicssmb2.pkgs.visualstudio.com/DynamicsBCPublicFeeds/_packaging/MSSymbols/nuget/v3/index.json, highest build per major on 2026-11-20.
AL source 29: https://github.com/microsoft/BCApps, MIT, releases/29.x at 4303e5e584d3aa5d9e98cbc615525a5396ad6ed7.

JOP-AL, 2026-11-20.
