---
title: "Codeunit 4417 SOA Item Selector"
author: "JOP-AL"
url: https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/
type: codeunit
id: 4417
name: "SOA Item Selector"
app: "Sales Order Agent"
namespace: Microsoft.Agent.SalesOrderAgent
versions: "28-29"
build: 29.0.54011.55644
countries: "W1, DE, US"
source: "https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/"
checked: 2026-11-20
changed: 2026-10-05
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 4417 SOA Item Selector

JOP-AL, https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/

| | |
| --- | --- |
| App | Sales Order Agent |
| Namespace | Microsoft.Agent.SalesOrderAgent |
| Versions | 28-29 |
| Minors | W1 28.3-29.0; DE 28.3-29.0; US 28.3-29.0, [every minor](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/editions.json) |
| Access | Internal |
| Source file | src/ItemSearch/SOAItemSelector.Codeunit.al |

## Procedures

| Name | Parameters | Returns | Access | Versions | Obsolete | Reason |
| --- | --- | --- | --- | --- | --- | --- |
| SelectBestMatchingItem | (SearchQuery: Text; CandidateArray: JsonArray; var MatchingItemFilter: Text; var AlternativeItemFilter: Text) | Boolean | internal | 28 | - | - |
| SelectBestMatchingItems | (SearchQuery: Text; MessageContent: Text; CandidateArray: JsonArray; var MatchingItemFilter: Text; var AlternativeItemFilter: Text; var MatchingItemVariants: Dictionary of [Text, List of [Code[10]]]; var AlternativeItemVariants: Dictionary of [Text, List of [Code[10]]]) | 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.
