---
id: change/bcapps/10411
type: change
title: "#10411 [SOA] Allow changing or clearing manually selected contacts"
summary: Users can now select, change, or clear manually chosen contacts in the Sales Order Agent through a dedicated lookup interface and assist-edit, with changes isolated to one-time overrides that don't modify underlying contact fields.
tier: official
language: en
tags:
  - feature
  - main
  - bc30
  - page soa contact lookup
  - page soa email message
  - table soa task contact override
  - permissionset soa - objects
  - codeunit soa filters impl.
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:08:09.911Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-change: 1
  input_hash: 66eaeaf9afd9215ba3792bf3b56dcec59a7b05f4
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/pull/10411
    title: "microsoft/BCApps#10411: [SOA] Allow changing or clearing manually selected contacts"
    date: "2026-08-20"
    commit: 66eaeaf9afd9215ba3792bf3b56dcec59a7b05f4
    t: null
    quote: Users can now select the correct contact directly from the duplicate-contact notification.
links:
  learn: []
  objects:
    - object/page/4412
    - object/page/4404
    - object/table/4588
    - object/permissionset/4406
    - object/codeunit/4305
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 10411
repo: microsoft/BCApps
source_id: bcapps-prs
url: https://github.com/microsoft/BCApps/pull/10411
kind: pr
base_branch: main
major: "30"
merged_at: "2026-08-20T16:58:21Z"
author: tomasevicst
author_type: User
community_contribution: false
labels:
  - "AL: Apps (W1)"
  - "Team: SCM"
change_class: code
change_kind: feature
behavior_change: true
breaking: false
files:
  count: 5
  additions: 238
  deletions: 41
  al: 5
apps:
  - SalesOrderAgent
objects_touched:
  - key: page/4412
    page: page/4412
    type: page
    id: 4412
    name: SOA Contact Lookup
    app: SalesOrderAgent
    status: added
  - key: page/4404
    page: page/4404
    type: page
    id: 4404
    name: SOA Email Message
    app: SalesOrderAgent
    status: modified
  - key: table/4588
    page: table/4588
    type: table
    id: 4588
    name: SOA Task Contact Override
    app: SalesOrderAgent
    status: modified
  - key: permissionset/4406
    page: permissionset/4406
    type: permissionset
    id: 4406
    name: SOA - Objects
    app: SalesOrderAgent
    status: modified
  - key: codeunit/4305
    page: codeunit/4305
    type: codeunit
    id: 4305
    name: SOA Filters Impl.
    app: SalesOrderAgent
    status: modified
objects_unjoined: []
obsoletions: []
backports: []
fixes_issues: []
work_items:
  - 640656
systems:
  - development
quote: Users can now select the correct contact directly from the duplicate-contact notification.
joined_against:
  major: "30"
  commit: ecbc028c25dbe83b61313bc566e6c1d41184bb1c
---

# #10411 [SOA] Allow changing or clearing manually selected contacts

> Users can now select, change, or clear manually chosen contacts in the Sales Order Agent through a dedicated lookup interface and assist-edit, with changes isolated to one-time overrides that don't modify underlying contact fields.

[Pull request](https://github.com/microsoft/BCApps/pull/10411) · merged into `main` (BC30) on 2026-08-20 by tomasevicst · 5 files (+238 -41), 5 AL · feature · tier official · reviewed (checked by Opus)

## What changed

- New contact lookup page allows matching both E-Mail and E-Mail 2 fields without standard restrictions
- Users can change a previously selected one-time contact or clear the mapping to return to email-based matching
- Changes are isolated to task-message overrides; existing contact email fields remain unmodified
- Authorization checks continue to restrict mapping changes to configured owner or agent
- Backward compatible - existing contact matching unchanged until user explicitly selects a contact
- Behaviour changes for users or extensions.

## AL objects touched

- [Page 4412 "SOA Contact Lookup"](../../objects/page/4412.md), SalesOrderAgent: added
- [Page 4404 "SOA Email Message"](../../objects/page/4404.md), SalesOrderAgent: modified
- [Table 4588 "SOA Task Contact Override"](../../objects/table/4588.md), SalesOrderAgent: modified
- [Permission set 4406 "SOA - Objects"](../../objects/permissionset/4406.md), SalesOrderAgent: modified
- [Codeunit 4305 "SOA Filters Impl."](../../objects/codeunit/4305.md), SalesOrderAgent: modified

## Context

- Work items: AB#640656
- Labels: AL: Apps (W1), Team: SCM
- Systems: development
- From the description: "Users can now select the correct contact directly from the duplicate-contact notification."

Source: metadata of a merged pull request in microsoft/BCApps (bcapps): title, labels, changed paths and counts, with a summary in our words. No source text and no description beyond one short quote (D10, D61).