Edit

Share via

PreProcessingDialog element

  • Article

Configures the preprocessing dialog of a spam-reporting add-in in Outlook, so that users can provide additional information about the message they're reporting.

To learn more about how to implement the spam reporting feature in your add-in, see Implement an integrated spam-reporting add-in.

Add-in type: Mail

Valid only in these VersionOverrides schemas:

  • Mail 1.1

For more information, see Version overrides in the add-in only manifest.

Associated with these requirement sets:

Contained in

Attributes

None.

Child elements

Element Required Description
Title Yes Specifies the custom title of the preprocessing dialog. Its resid attribute must be set to the value of the id attribute of a String in the ShortStrings element under the Resources element.
Description Yes Specifies the custom text that appears in the preprocessing dialog. Its resid attribute must be set to the value of the id attribute of a String in the LongStrings element under the Resources element.
NeverShowAgainOption (preview)* No When set to true, adds a "Don't show me this message again" checkbox to prevent the preprocessing dialog from appearing again. Consider specifying this element in your manifest when the preprocessing dialog of your spam-reporting add-in doesn't require user input. If you set this element to true and also specify the <ReportingOptions> and <FreeTextLabel> elements, the "Don't show me this message again" checkbox isn't shown on the preprocessing dialog.
ReportingOptions No Lists up to five options a user can select from the preprocessing dialog to provide a reason for reporting a message.
FreeTextLabel No Adds a text box to the preprocessing dialog to allow users to provide additional information on the message they're reporting. Its resid attribute sets the title of the text box. The resid attribute must be set to the value of the id attribute of a String in the ShortStrings element under the Resources element.
MoreInfo No Specifies the custom text and URL to provide informational resources to the users. The custom text and URL configured in this element appear below the text provided in the <Description> element.

* The <NeverShowAgainOption> element is currently in preview in Outlook on the web and on Windows (new and classic). To preview this feature in classic Outlook on Windows, install Version 2411 (Build 18227.20034) or later. Then, join the Microsoft 365 Insider program and select the Beta Channel option.

Example

<PreProcessingDialog>
  <Title resid="PreProcessingDialog.Label"/>
  <Description resid="PreProcessingDialog.Description"/>
  <ReportingOptions>
    <Title resid="OptionsTitle.Label"/>
    <Option resid="Option1.Label"/>
    <Option resid="Option2.Label"/>
    <Option resid="Option3.Label"/>
    <Option resid="Option4.Label"/>
  </ReportingOptions>
  <FreeTextLabel resid="FreeText.Label"/>
  <MoreInfo>
    <MoreInfoText resid="MoreInfo.Label"/>
    <MoreInfoUrl resid="MoreInfo.Url"/>
  </MoreInfo>
</PreProcessingDialog>