Outlook feature configuration

The OutlookFeatureConfig setting (configurable in the DataSourceAdminApp / dashboard) centrally controls various behaviours of the Outlook add-in (classic). The value is an XML document with the root element <OutlookFeatureConfig>.

Basic structure

<OutlookFeatureConfig>
  <AutoChangeProfile>
    <OnSentOnBehalfOfNameExistsOrChanged ProfileFieldIdMatch="User.Email" />
  </AutoChangeProfile>
  <DisableAutoSignatureFunction>false</DisableAutoSignatureFunction>
  <DisableSignatureTypingProtection>false</DisableSignatureTypingProtection>
</OutlookFeatureConfig>

Automatic profile switch (AutoChangeProfile)

Automatically switches the primedocs profile (including the signature) while composing an email, which is useful with shared mailboxes or when sending "on behalf of".

<AutoChangeProfile>
  <OnSentOnBehalfOfNameExistsOrChanged ProfileFieldIdMatch="User.Email"
                                       IncludeSendUsingAccountSmtpAddress="true" />
</AutoChangeProfile>

Behaviour: If a "sent on behalf of" name (SentOnBehalfOfName) is set or changes while composing, primedocs looks for a profile whose ProfileFieldIdMatch field matches that value and switches to it automatically. If no SentOnBehalfOfName is set and IncludeSendUsingAccountSmtpAddress="true", the SMTP address of the selected sending account (SendUsingAccount) is used for the match instead.

Attribute	Required	Description
ProfileFieldIdMatch	yes	Profile field whose value is compared against the "on behalf of" name or the sender SMTP address (e.g. User.Email).
IncludeSendUsingAccountSmtpAddress	optional	When true: if no SentOnBehalfOfName is set, the SMTP address of the selected sending account is used for the match.

note

The match is case-insensitive. IncludeSendUsingAccountSmtpAddress (sometimes referred to as "SendUsingAccounts" in customer contexts) covers the case where sending on behalf of someone is done with a normal account rather than a shared mailbox. No SentOnBehalfOfName is set there.

Further options

Element	Type	Description
DisableAutoSignatureFunction	boolean	When true: the Auto signature function is initially switched off in every new message. primedocs then no longer switches between the internal and external signature by itself based on the recipients. Users can switch it back on per message via the Auto signature checkbox in the ribbon.
DisableSignatureTypingProtection	boolean	When true: the typing protection in the signature area is disabled (relevant e.g. for inserting text via Microsoft Copilot). The choice between internal and external signature when replying also works with the typing protection switched off.

Subject tagging (SubjectTagging)

Shows a selection in the ribbon that lets the user prepend a tag (e.g. a classification) to the subject. If the <SubjectTagging> element is absent, the feature is disabled.

The element contains a <Tags> list with individual <Tag> entries. Selecting an entry first removes all configured tags from the subject and then prepends the selected text. A <Tag> with an empty <Name /> acts as a "no classification" entry and only removes existing tags.

<SubjectTagging>
  <Tags>
    <Tag>
      <Name />
      <Title>Nicht klassifiziert</Title>
      <Title Language="en">Unclassified</Title>
    </Tag>
    <Tag>
      <Name>[CONFIDENTIAL] </Name>
      <Title>Vertraulich</Title>
      <Title Language="en">Confidential</Title>
    </Tag>
  </Tags>
</SubjectTagging>

Element / attribute	Description
<Tag>	A tag entry. Can be repeated any number of times.
<Name>	The text prepended to the subject, e.g. [CONFIDENTIAL] (a trailing space is part of the value). Empty (<Name />) = entry that removes the tag.
<Title>	Display name of the entry in the ribbon. Can be provided multiple times for different languages.
<Title Language="…">	Language variant of the display name (two-letter language code, e.g. en). Case is ignored. The <Title> without a Language attribute serves as the default/fallback for unconfigured languages.

Sensitivity in the ribbon (ClassicSensitivityInRibbon)

Shows a toggle button in the ribbon that switches the email's Outlook sensitivity (Sensitivity) between "Normal" and a configured target level. If the <ClassicSensitivityInRibbon> element is absent, the feature is disabled.

note

NOTE
This refers to Outlook's built-in "Sensitivity" property (Normal / Personal / Private / Confidential), not Microsoft Purview sensitivity labels.

<ClassicSensitivityInRibbon SensitivityTarget="olPrivate">
  <Title>Privat</Title>
  <Title Language="en">Private</Title>
</ClassicSensitivityInRibbon>

Attribute / element	Description
SensitivityTarget	Target sensitivity level to switch to. Possible values are the names of the Outlook OlSensitivity enumeration: olNormal, olPersonal, olPrivate, olConfidential. If the attribute is missing or the value is unknown, olPrivate is used.
<Title>	Label of the ribbon button. Can be provided multiple times for different languages. The <Title> without a Language attribute serves as the default/fallback.