{"title":"Codeunit 4591 SOA Item Search, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/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-05","object":{"type":"codeunit","id":4591,"name":"SOA Item Search","app":"Sales Order Agent","url":"https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/4591-soa-item-search/source/","path":"src/Apps/W1/SalesOrderAgent/app/src/ItemSearch/SOAItemSearch.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:4395":{"name":"Global Item Search","url":"https://jonas-paprotka.de/ref/codeunit/4395-global-item-search/"},"codeunit:4596":{"name":"SOA Broader Item Search","url":"https://jonas-paprotka.de/ref/codeunit/4596-soa-broader-item-search/"},"codeunit:4590":{"name":"SOA Billing","url":"https://jonas-paprotka.de/ref/codeunit/4590-soa-billing/"},"table:4325":{"name":"SOA Setup","url":"https://jonas-paprotka.de/ref/table/4325-soa-setup/"},"codeunit:4413":{"name":"SOA Shipment Date Mgt.","url":"https://jonas-paprotka.de/ref/codeunit/4413-soa-shipment-date-mgt/"},"codeunit:1511":{"name":"Notification Lifecycle Mgt.","url":"https://jonas-paprotka.de/ref/codeunit/1511-notification-lifecycle-mgt/"},"codeunit:4420":{"name":"SOA Task Message Reader","url":"https://jonas-paprotka.de/ref/codeunit/4420-soa-task-message-reader/"},"codeunit:4417":{"name":"SOA Item Selector","url":"https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/"},"table:27":{"name":"Item","url":"https://jonas-paprotka.de/ref/table/27-item/"},"codeunit:353":{"name":"Item Availability Forms Mgt","url":"https://jonas-paprotka.de/ref/codeunit/353-item-availability-forms-mgt/"},"codeunit:8703":{"name":"Feature Telemetry","url":"https://jonas-paprotka.de/ref/codeunit/8703-feature-telemetry/"},"codeunit:4400":{"name":"SOA Setup","url":"https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/"}},"procs":[{"name":"GetItemFilters","line":49,"kind":"procedure","access":"local","params":3,"steps":[[78,"ext","codeunit",4395,"CheckIsItemSearchReady",1],[79,"ext","codeunit",4395,"InitializeSearchOptionsObject",2],[80,"ext","codeunit",4395,"AddSearchFilter",2],[81,"ext","codeunit",4395,"AddSearchFilter",2],[82,"ext","codeunit",4395,"AddSearchRankingContext",3],[83,"ext","codeunit",4395,"SetupSOACapabilityInformation",0],[84,"ext","codeunit",4395,"SetupSearchQuery",5],[87,"ext","codeunit",4395,"SearchAndReturnResultsWithColumnValues",3],[88,"ext","codeunit",4596,"BuildResultFilterFromCandidates",2]]},{"name":"FindRecordItemFromList","line":96,"kind":"procedure","access":"local","params":5,"steps":[[100,"call","FindRecordItem",9]]},{"name":"FindRecordItemFromLookup","line":104,"kind":"procedure","access":"local","params":5,"steps":[[108,"call","FindRecordItem",9]]},{"name":"FindRecordItemFromMultiItemsAvailability","line":112,"kind":"procedure","access":"local","params":8,"steps":[[116,"call","FindRecordItem",10],[117,"call","LogTelemetryForFindItems",1]]},{"name":"LogInventoryInquiryReplied","line":121,"kind":"procedure","access":"local","params":0,"steps":[[125,"ext","codeunit",4590,"LogInventoryInquiryReplied",1]]},{"name":"OnAfterCheckItemAvailable","line":136,"kind":"procedure","access":"local","params":3,"steps":[[150,"ext","table",4325,"GetForCurrentAgentSession",0],[159,"call","IsRequiredQuantityAvailable",3],[165,"ext","codeunit",4413,"OrderPromisingSetupConfigured",0],[166,"ext","codeunit",4413,"SetParamenters",6],[167,"run","codeunit",4413],[168,"ext","codeunit",4413,"GetEarliestShipmentDate",0],[170,"ext","codeunit",4413,"GetEarliestShipmentDate",0],[173,"ext","codeunit",1511,"RecallNotificationsForRecordWithAdditionalContext",3],[173,"call","GetQuoteItemAvailabilityNotificationId",0],[177,"ext","codeunit",1511,"SendNotificationWithAdditionalContext",3],[177,"call","GetQuoteItemAvailabilityNotificationId",0]]},{"name":"FindRecordItem","line":192,"kind":"procedure","access":"local","params":10,"steps":[[234,"call","ExtractSearchKeyWords",3],[238,"call","GetItemFilters",3],[242,"ext","codeunit",4596,"BroaderItemSearch",3],[249,"call","BuildCandidateArrayFromItemFilter",2],[251,"call","AddVariantsToCandidateArray",2],[253,"ext","table",4325,"GetForCurrentAgentSession",0],[259,"call","ShouldUseItemSelector",3],[260,"call","BuildSearchQueryText",1],[261,"call","SelectBestItem",10],[261,"call","GetTaskMessageContent",1],[267,"call","CountFilterItems",1],[268,"call","CountFilterItems",1],[269,"call","CountFilterItems",1],[269,"call","CountFilterItems",1],[289,"call","BuildFilteredItemFilter",7],[291,"call","BuildFilteredItemFilter",7],[292,"call","StoreResolvedItemVariants",2],[295,"call","StoreResolvedItemVariants",2],[301,"call","BuildFilteredItemFilter",7],[302,"call","StoreResolvedItemVariants",2],[307,"call","BuildFilteredItemFilter",7],[334,"event","OnAfterFindRecordItem",0]]},{"name":"GetTaskMessageContent","line":354,"kind":"procedure","access":"local","params":1,"steps":[[357,"ext","codeunit",4420,"GetLastIncomingMessageContent",1]]},{"name":"SelectBestItem","line":364,"kind":"procedure","access":"local","params":10,"steps":[[384,"ext","codeunit",4417,"SelectBestMatchingItems",7],[399,"call","RemoveVariantlessMatchesWithConcreteAlternatives",3],[401,"call","AddSelectedItem",7],[403,"call","PreferConcreteVariantAlternatives",2],[405,"call","AddSelectedItem",7]]},{"name":"BuildCandidateArrayFromItemFilter","line":458,"kind":"procedure","access":"local","params":2,"steps":[[486,"write",27,"Insert"]]},{"name":"BuildFilteredItemFilter","line":661,"kind":"procedure","access":"local","params":7,"steps":[[678,"call","FindFirstAvailableVariant",6],[680,"call","AddAvailableItemVariant",3],[686,"call","AddAvailableItemVariant",3],[686,"call","GetFirstVariantCode",2]]},{"name":"FindFirstAvailableVariant","line":697,"kind":"procedure","access":"local","params":6,"steps":[[708,"call","IsRequiredQuantityAvailable",3],[713,"call","IsRequiredQuantityAvailable",3]]},{"name":"IsRequiredQuantityAvailable","line":794,"kind":"procedure","access":"local","params":3,"steps":[[805,"ext","codeunit",353,"CalcAvailQuantities",10],[814,"call","CalcProjAvailableBalanceInUOM",3]]},{"name":"LogTelemetryForFindItems","line":838,"kind":"procedure","access":"local","params":1,"steps":[[853,"ext","table",4325,"GetForCurrentAgentSession",0],[859,"ext","codeunit",8703,"LogUsage",4],[859,"ext","codeunit",4400,"GetFeatureName",0]]}]}