---
id: change/bcapps/10302
type: change
title: "#10302 [SOA] Clarify contact mapping options for unknown email senders"
summary: The contact-link dialog for unmatched email senders now clearly separates task-level contact overrides from updating contact data, shows the sender's email address, explains that matching uses both E-Mail and E-Mail 2, and spells out the E-Mail 2 replacement values.
tier: official
language: en
tags:
  - other
  - main
  - bc30
  - codeunit soa filters impl.
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:08:36.806Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-change: 1
  input_hash: 72784b4e01448f84b7e23208f0f9f34b918274e1
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/pull/10302
    title: "microsoft/BCApps#10302: [SOA] Clarify contact mapping options for unknown email senders"
    date: "2026-08-18"
    commit: 72784b4e01448f84b7e23208f0f9f34b918274e1
    t: null
    quote: Improve the contact-link dialog shown when an email sender does not match an existing contact.
links:
  learn: []
  objects:
    - object/codeunit/4305
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 10302
repo: microsoft/BCApps
source_id: bcapps-prs
url: https://github.com/microsoft/BCApps/pull/10302
kind: pr
base_branch: main
major: "30"
merged_at: "2026-08-18T14:34:15Z"
author: tomasevicst
author_type: User
community_contribution: false
labels:
  - "AL: Apps (W1)"
  - "Team: SCM"
change_class: code
change_kind: other
behavior_change: false
breaking: false
files:
  count: 1
  additions: 7
  deletions: 7
  al: 1
apps:
  - SalesOrderAgent
objects_touched:
  - 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:
  - 640618
systems:
  - development
quote: Improve the contact-link dialog shown when an email sender does not match an existing contact.
joined_against:
  major: "30"
  commit: ecbc028c25dbe83b61313bc566e6c1d41184bb1c
---

# #10302 [SOA] Clarify contact mapping options for unknown email senders

> The contact-link dialog for unmatched email senders now clearly separates task-level contact overrides from updating contact data, shows the sender's email address, explains that matching uses both E-Mail and E-Mail 2, and spells out the E-Mail 2 replacement values.

[Pull request](https://github.com/microsoft/BCApps/pull/10302) · merged into `main` (BC30) on 2026-08-18 by tomasevicst · 1 file (+7 -7), 1 AL · other · tier official · reviewed (checked by Opus)

## What changed

- Dialog now shows the unmatched sender's email address
- Clarifies the difference between a task-level contact override and updating contact data
- Explains that matching checks both E-Mail and E-Mail 2
- E-Mail 2 replacement confirmation shows the field, current value and replacement value
- Caption-only change; matching logic and option ordering are unchanged

## AL objects touched

- [Codeunit 4305 "SOA Filters Impl."](../../objects/codeunit/4305.md), SalesOrderAgent: modified

## Context

- Work items: AB#640618
- Labels: AL: Apps (W1), Team: SCM
- Systems: development
- From the description: "Improve the contact-link dialog shown when an email sender does not match an existing contact."

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).