Implementieren eines integrierten Spamberichts-Add-Ins (Vorschau)

  • Artikel

Da die Anzahl der unerwünschten E-Mails steigt, steht die Sicherheit im Vordergrund der Add-In-Nutzung. Derzeit werden Partner-Spamberichts-Add-Ins zum Outlook-Menüband hinzugefügt, aber sie werden in der Regel am Ende des Menübands oder im Überlaufmenü angezeigt. Dies erschwert es Benutzern, das Add-In zu finden, um unerwünschte E-Mails zu melden. Neben der Konfiguration, wie Nachrichten verarbeitet werden, wenn sie gemeldet werden, müssen Entwickler auch zusätzliche Aufgaben ausführen, um dem Benutzer Verarbeitungsdialoge oder zusätzliche Informationen anzuzeigen.

Das integrierte Spam-Reporting-Feature erleichtert die Entwicklung einzelner Add-In-Komponenten von Grund auf. Noch wichtiger ist, dass ihr Add-In an einer prominenten Stelle auf dem Outlook-Menüband angezeigt wird, sodass Benutzer es leichter finden und Spamnachrichten melden können. Implementieren Sie dieses Feature in Ihrem Add-In für Folgendes:

  • Verbessern Sie, wie unerwünschte Nachrichten nachverfolgt werden.
  • Bieten Sie Benutzern eine bessere Anleitung zum Melden verdächtiger Nachrichten.
  • Ermöglichen Sie es dem Security Operations Center (SOC) eines organization oder IT-Administratoren, Spam- und Phishing-Simulationen für Bildungszwecke einfach durchzuführen.

Wichtig

Die integrierte Spamberichterstattungsfunktion befindet sich derzeit in Outlook im Web, in outlook für Windows (Vorschau), in klassischem Outlook unter Windows und in Outlook für Mac in der Vorschauphase. Features in der Vorschau sollten nicht in Produktions-Add-Ins verwendet werden. Wir laden Sie ein, dieses Feature in Test- oder Entwicklungsumgebungen auszuprobieren und Feedback zu Ihrer Erfahrung über GitHub zu begrüßen (siehe Den Abschnitt Feedback am Ende dieser Seite).

Vorschau der integrierten Spamberichterstattungsfunktion

Um eine Vorschau der integrierten Spamberichterstattungsfunktion anzuzeigen, benötigen Sie einen der folgenden unterstützten Clients.

Tipp

Wenn Sie in Ihrem Outlook-Client unter Windows keinen Kanal auswählen können, lesen Sie Zulassen, dass Benutzer auswählen können, welchen Microsoft 365 Insider-Kanal sie auf Windows-Geräten installieren möchten.

Einrichten der Umgebung

Tipp

Informationen zum sofortigen Testen einer abgeschlossenen Add-In-Lösung für die Spamberichterstattung finden Sie im Beispiel Melden von Spam- oder Phishing-E-Mails in Outlook (Vorschau).

Schließen Sie den Outlook-Schnellstart ab, der ein Add-In-Projekt mit dem Yeoman-Generator für Office-Add-Ins erstellt.

Konfigurieren des Manifests

Hinweis

Die integrierte Spamberichterstattung wird für das einheitliche Manifest für Microsoft 365 noch nicht unterstützt.

Um die integrierte Spamberichterstattungsfunktion in Ihrem Add-In zu implementieren, müssen Sie den VersionOverridesV1_1 Knoten Ihres Manifests entsprechend konfigurieren.

  • In Outlook im Web und auf Dem Mac und im neuen Outlook unter Windows wird ein Add-In, das die integrierte Spamberichterstattungsfunktion implementiert, in einer Browserruntime ausgeführt. Sie müssen die HTML-Datei angeben, die auf den Code verweist oder enthält, um das Spam-Reporting-Ereignis im resid -Attribut des Runtime-Elements zu behandeln.
  • Im klassischen Outlook unter Windows wird ein Add-In, das die integrierte Spamberichterstattungsfunktion implementiert, in einer reinen JavaScript-Runtime ausgeführt. Daher müssen Sie die JavaScript-Datei angeben, die den Code zum Behandeln des Spamberichterstattungsereignisses im untergeordneten Element Überschreiben des <Runtime-Elements> enthält.
  • Um das Add-In im Outlook-Menüband zu aktivieren und zu verhindern, dass es am Ende des Menübands oder im Überlaufabschnitt angezeigt wird, legen Sie das xsi:type Attribut des <ExtensionPoint-Elements> auf ReportPhishingCommandSurface fest.
  • Zum Anpassen der Menübandschaltfläche und des Vorverarbeitungsdialogfelds müssen Sie den Knoten ReportPhishingCustomization definieren.

    • Ein Benutzer meldet eine unerwünschte Nachricht über die Schaltfläche des Add-Ins im Menüband. Legen Sie zum Konfigurieren der Menübandschaltfläche das xsi:type -Attribut des Control-Elements auf fest Button. Legen Sie dann das xsi:type Attribut des untergeordneten Action-Elements auf festExecuteFunction, und geben Sie den Namen des Spamberichterstattungs-Ereignishandlers im untergeordneten FunctionName-Element> an<. Ein Add-In zur Spamberichterstattung kann nur Funktionsbefehle implementieren.

      Im Folgenden finden Sie ein Beispiel dafür, wie die Schaltfläche eines Add-Ins für die Spamberichterstattung auf dem Menüband des Outlook-Clients unter Windows angezeigt wird. Die Menüband-Benutzeroberfläche kann je nach Plattform variieren, auf der der Outlook-Client des Benutzers ausgeführt wird.

      Eine Beispielmenübandschaltfläche eines Add-Ins für die Spamberichterstattung.

    • Das Vorverarbeitungsdialogfeld wird einem Benutzer angezeigt, wenn er die Add-In-Schaltfläche auswählt. Sie wird über das PreProcessingDialog-Element Ihres Manifests konfiguriert. Obwohl das Dialogfeld einen Titel und eine Beschreibung aufweisen muss, können Sie optional die folgenden Elemente einschließen.

      • Eine Mehrfachauswahlliste mit Auswahlmöglichkeiten, mit deren Hilfe ein Benutzer den Typ der Nachricht identifizieren kann, die er meldet. Informationen zum Konfigurieren dieser Berichterstellungsoptionen finden Sie unter ReportingOptions-Element.
      • Ein Textfeld, in dem der Benutzer zusätzliche Informationen zu der Nachricht bereitstellt, die er meldet. Informationen zum Implementieren eines Textfelds finden Sie unter FreeTextLabel-Element.
      • Benutzerdefinierter Text und die URL zum Bereitstellen von Informationsressourcen für den Benutzer. Informationen zum Personalisieren dieser Elemente finden Sie unter MoreInfo-Element.

      Wenn ein Benutzer im Dialogfeld Bericht auswählt, wird das SpamReporting-Ereignis aktiviert und dann vom JavaScript-Ereignishandler behandelt.

      Es folgt ein Beispiel für ein Vorverarbeitungsdialogfeld in Outlook unter Windows. Beachten Sie, dass das Erscheinungsbild des Dialogfelds je nach Plattform variieren kann, auf der der Outlook-Client des Benutzers ausgeführt wird.

      Ein Beispieldialogfeld für die Vorverarbeitung eines Add-Ins für die Spamberichterstattung.

Es folgt ein Beispiel für einen <VersionOverrides-Knoten> , der für die Spamberichterstattung konfiguriert ist.

  1. Öffnen Sie in Ihrem bevorzugten Code-Editor das Add-In-Projekt, das Sie erstellt haben.

  2. Öffnen Sie die manifest.xml Datei, die sich im Stammverzeichnis Ihres Projekts befindet.

  3. Wählen Sie den gesamten <Knoten VersionOverrides> (einschließlich der Open- und Close-Tags) aus, und ersetzen Sie ihn durch den folgenden Code.

    <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
    <Requirements>
      <bt:Sets DefaultMinVersion="1.13">
        <bt:Set Name="Mailbox"/>
      </bt:Sets>
    </Requirements>
    <Hosts>
      <Host xsi:type="MailHost">
        <Runtimes>
            <!-- References the HTML file that links to the spam-reporting event handler.
                 This is used by Outlook on the web and on the new Mac UI, and new Outlook on Windows (preview). -->
          <Runtime resid="WebViewRuntime.Url">
            <!-- References the JavaScript file that contains the spam-reporting event handler. This is used by classic Outlook on Windows. -->
            <Override type="javascript" resid="JSRuntime.Url"/>
          </Runtime>
        </Runtimes>
        <DesktopFormFactor>
          <FunctionFile resid="WebViewRuntime.Url"/>
          <!-- Implements the integrated spam-reporting feature in the add-in. -->
          <ExtensionPoint xsi:type="ReportPhishingCommandSurface">
            <ReportPhishingCustomization>
              <!-- Configures the ribbon button. -->
              <Control xsi:type="Button" id="spamReportingButton">
                <Label resid="spamButton.Label"/>
                <Supertip>
                  <Title resid="spamButton.Label"/>
                  <Description resid="spamSuperTip.Text"/>
                </Supertip>
                <Icon>
                  <bt:Image size="16" resid="Icon.16x16"/>
                  <bt:Image size="32" resid="Icon.32x32"/>
                  <bt:Image size="80" resid="Icon.80x80"/>
                </Icon>
                <Action xsi:type="ExecuteFunction">
                  <FunctionName>onSpamReport</FunctionName>
                </Action>
              </Control>
              <!-- Configures the preprocessing dialog. -->
              <PreProcessingDialog>
                <Title resid="PreProcessingDialog.Label"/>
                <Description resid="PreProcessingDialog.Text"/>
                <ReportingOptions>
                  <Title resid="OptionsTitle.Label"/>
                  <Option resid="Option1.Label"/>
                  <Option resid="Option2.Label"/>
                  <Option resid="Option3.Label"/>
                </ReportingOptions>
                <FreeTextLabel resid="FreeText.Label"/>
                <MoreInfo>
                  <MoreInfoText resid="MoreInfo.Label"/>
                  <MoreInfoUrl resid="MoreInfo.Url"/>
                </MoreInfo>
              </PreProcessingDialog>
             <!-- Identifies the runtime to be used. This is also referenced by the Runtime element. -->
              <SourceLocation resid="WebViewRuntime.Url"/>
            </ReportPhishingCustomization> 
          </ExtensionPoint>
        </DesktopFormFactor>
      </Host>
    </Hosts>
    <Resources>
      <bt:Images>
        <bt:Image id="Icon.16x16" DefaultValue="https://localhost:3000/assets/icon-16.png"/>
        <bt:Image id="Icon.32x32" DefaultValue="https://localhost:3000/assets/icon-32.png"/>
        <bt:Image id="Icon.80x80" DefaultValue="https://localhost:3000/assets/icon-80.png"/>
      </bt:Images>
      <bt:Urls>
        <bt:Url id="WebViewRuntime.Url" DefaultValue="https://localhost:3000/commands.html"/>
        <bt:Url id="JSRuntime.Url" DefaultValue="https://localhost:3000/spamreporting.js"/>
        <bt:Url id="MoreInfo.Url" DefaultValue="https://www.contoso.com/spamreporting"/>
      </bt:Urls>
      <bt:ShortStrings>
        <bt:String id="spamButton.Label" DefaultValue="Report Spam Message"/>
        <bt:String id="PreProcessingDialog.Label" DefaultValue="Report Spam Message"/>
        <bt:String id="OptionsTitle.Label" DefaultValue="Why are you reporting this email?"/>
        <bt:String id="FreeText.Label" DefaultValue="Provide additional information, if any:"/>
        <bt:String id="MoreInfo.Label" DefaultValue="To learn more about reporting unsolicited messages, see "/>
        <bt:String id="Option1.Label" DefaultValue="Received spam email."/>
        <bt:String id="Option2.Label" DefaultValue="Received a phishing email."/>
        <bt:String id="Option3.Label" DefaultValue="I'm not sure this is a legitimate email."/>
      </bt:ShortStrings>
      <bt:LongStrings>
        <bt:String id="spamSuperTip.Text" DefaultValue="Report an unsolicited message."/>
        <bt:String id="PreProcessingDialog.Text" DefaultValue="Thank you for reporting this message."/>
      </bt:LongStrings>
    </Resources>
  </VersionOverrides>
</VersionOverrides>

  4. Speichern Sie Ihre Änderungen.

Implementieren des Ereignishandlers

Wenn Ihr Add-In zum Melden einer Nachricht verwendet wird, generiert es ein SpamReporting-Ereignis , das dann vom Ereignishandler in der JavaScript-Datei Ihres Add-Ins verarbeitet wird. Um den Namen des Ereignishandlers, den Sie im <FunctionName-Element> Ihres Manifests angegeben haben, der JavaScript-Entsprechung zuzuordnen, müssen Sie Office.actions.associate in Ihrem Code aufrufen.

  1. Navigieren Sie in Ihrem Add-In-Projekt zum Verzeichnis ./src . Erstellen Sie dann einen neuen Ordner namens spamreporting.

  2. Erstellen Sie im Ordner ./src/spamreporting eine neue Datei namens spamreporting.js.

  3. Öffnen Sie die neu erstellte spamreporting.js-Datei , und fügen Sie den folgenden JavaScript-Code hinzu.

    // Handles the SpamReporting event to process a reported message.
function onSpamReport(event) {
  // TODO - Send a copy of the reported message.

  // TODO - Get the user's responses.

  // TODO - Signal that the spam-reporting event has completed processing.
}

// IMPORTANT: To ensure your add-in is supported in the Outlook client on Windows, remember to map the event handler name specified in the manifest to its JavaScript counterpart.
if (Office.context.platform === Office.PlatformType.PC || Office.context.platform == null) {
  Office.actions.associate("onSpamReport", onSpamReport);
}

  4. Speichern Sie Ihre Änderungen.

Weiterleiten einer Kopie der Nachricht und Abrufen der Vorverarbeitungsdialogantworten

Ihr Ereignishandler ist für die Verarbeitung der gemeldeten Nachricht verantwortlich. Sie können es so konfigurieren, dass Informationen, z. B. eine Kopie der Nachricht oder die vom Benutzer im Vorverarbeitungsdialogfeld ausgewählten Optionen, zur weiteren Untersuchung an ein internes System weitergeleitet werden.

Um eine Kopie der gemeldeten Nachricht effizient zu senden, rufen Sie die getAsFileAsync-Methode in Ihrem Ereignishandler auf. Dadurch wird das Base64-codierte EML-Format einer Nachricht abgerufen, die Sie dann an Ihr internes System weiterleiten können.

Wichtig

Um die getAsFileAsync Methode zu testen, während sie sich noch in der Vorschau in Outlook unter Windows befindet, müssen Sie die Registrierung Ihres Computers konfigurieren.

Outlook unter Windows enthält eine lokale Kopie der Produktions- und Betaversionen von Office.js anstelle des Ladens aus dem Content Delivery Network (CDN). Standardmäßig wird auf die lokale Produktionskopie der API verwiesen. Um auf die lokale Betakopie der API zu verweisen, müssen Sie die Registrierung Ihres Computers wie folgt konfigurieren:

  1. Navigieren Sie in der Registrierung zu HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\Outlook\Options\WebExt\Developer. Wenn der Schlüssel nicht vorhanden ist, erstellen Sie ihn.

  2. Create einen Eintrag namens EnableBetaAPIsInJavaScript und legen seinen Wert auf 1fest.

    Der Registrierungswert EnableBetaAPIsInJavaScript ist auf 1 festgelegt.

Wenn Sie die Antworten des Benutzers auf die Optionen und das Textfeld im Vorverarbeitungsdialogfeld nachverfolgen müssen, extrahieren Sie die options Werte und freeText aus dem SpamReporting Ereignisobjekt. Weitere Informationen zu diesen Eigenschaften finden Sie unter Office.SpamReportingEventArgs.

Im Folgenden finden Sie ein Beispiel für einen Ereignishandler zur Spamberichterstattung, der die getAsFileAsync -Methode aufruft und die Antworten des Benutzers vom SpamReporting Ereignisobjekt abruft.

  1. Ersetzen Sie in der spamreporting.js-Datei ihren Inhalt durch den folgenden Code.

    // Handles the SpamReporting event to process a reported message.
function onSpamReport(event) {
  // Get the Base64-encoded EML format of a reported message.
  Office.context.mailbox.item.getAsFileAsync({ asyncContext: event }, (asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Failed) {
      console.log(`Error encountered during message processing: ${asyncResult.error.message}`);
      return;
    }

    // Get the user's responses to the options and text box in the preprocessing dialog.
    const spamReportingEvent = asyncResult.asyncContext;
    const reportedOptions = spamReportingEvent.options;
    const additionalInfo = spamReportingEvent.freeText;

    // Run additional processing operations here.

    // TODO - Signal that the spam-reporting event has completed processing.
  });
}

// IMPORTANT: To ensure your add-in is supported in the Outlook client on Windows, remember to map the event handler name specified in the manifest to its JavaScript counterpart.
if (Office.context.platform === Office.PlatformType.PC || Office.context.platform == null) {
  Office.actions.associate("onSpamReport", onSpamReport);
}

  2. Speichern Sie Ihre Änderungen.

Hinweis

Zum Konfigurieren des einmaligen Anmeldens (Single Sign-On, SSO) oder der ressourcenübergreifenden Ressourcenfreigabe (Cross-Origin Resource Sharing, CORS) in Ihrem Spam-Reporting-Add-In müssen Sie Ihr Add-In und die zugehörige JavaScript-Datei einem bekannten URI hinzufügen. Eine Anleitung zum Konfigurieren dieser Ressource finden Sie unter Verwenden des einmaligen Anmeldens (Single Sign-On, SSO) oder der ressourcenübergreifenden Ressourcenfreigabe (Cross-Origin Resource Sharing, CORS) in Ihrem ereignisbasierten Outlook-Add-In oder Outlook-Add-In für Spamberichterstattung.

Signalisieren, wenn das Ereignis verarbeitet wurde

Nachdem der Ereignishandler die Verarbeitung der Nachricht abgeschlossen hat, muss er die event.completed-Methode aufrufen. Zusätzlich zum Signalisieren des Add-Ins, dass das Spamberichterstattungsereignis verarbeitet wurde, kann auch verwendet werden, event.completed um ein Nachbearbeitungsdialogfeld so anzupassen, dass es dem Benutzer angezeigt wird, oder zusätzliche Vorgänge für die Nachricht ausführen, z. B. das Löschen aus dem Posteingang. Eine Liste der Eigenschaften, die Sie in ein JSON-Objekt einschließen können, das als Parameter an die event.completed -Methode übergeben werden soll, finden Sie unter Office.SpamReportingEventCompletedOptions.

Hinweis

  • Nach dem event.completed Aufruf hinzugefügter Code wird nicht garantiert ausgeführt.
  • In Outlook im Web oder in outlook unter Windows (Vorschau) wird kein Nachbearbeitungsdialogfeld angezeigt, sobald das Add-In die Verarbeitung einer gemeldeten Nachricht abgeschlossen ist. Dies gilt auch, wenn die showPostProcessingDialog -Eigenschaft im event.completed Aufruf konfiguriert ist. Je nachdem, wie Sie die moveItemTo Eigenschaft im event.completed Anruf konfiguriert haben, wird jedoch eine Benachrichtigung angezeigt, die signalisiert, wenn die gemeldete Nachricht gelöscht oder in einen anderen Ordner im Postfach verschoben wird.

  1. Ersetzen Sie in der spamreporting.js-Datei ihren Inhalt durch den folgenden Code.

    // Handles the SpamReporting event to process a reported message.
function onSpamReport(event) {
  // Get the Base64-encoded EML format of a reported message.
  Office.context.mailbox.item.getAsFileAsync({ asyncContext: event }, (asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Failed) {
      console.log(`Error encountered during message processing: ${asyncResult.error.message}`);
      return;
    }

    // Get the user's responses to the options and text box in the preprocessing dialog.
    const spamReportingEvent = asyncResult.asyncContext;
    const reportedOptions = spamReportingEvent.options;
    const additionalInfo = spamReportingEvent.freeText;

    // Run additional processing operations here.

    /**
     * Signals that the spam-reporting event has completed processing.
     * It then moves the reported message to the Junk Email folder of the mailbox, then
     * shows a post-processing dialog to the user. If an error occurs while the message
     * is being processed, the `onErrorDeleteItem` property determines whether the message
     * will be deleted.
     */
    const event = asyncResult.asyncContext;
    event.completed({
      onErrorDeleteItem: true,
      moveItemTo: Office.MailboxEnums.MoveSpamItemTo.JunkFolder,
      showPostProcessingDialog: {
        title: "Contoso Spam Reporting",
        description: "Thank you for reporting this message.",
      },
    });
  });
}

// IMPORTANT: To ensure your add-in is supported in the Outlook client on Windows, remember to map the event handler name specified in the manifest to its JavaScript counterpart
if (Office.context.platform === Office.PlatformType.PC || Office.context.platform == null) {
  Office.actions.associate("onSpamReport", onSpamReport);
}

    Hinweis

    Wenn Sie das klassische Outlook unter Windows Version 2308 (Build 16724.10000) oder höher, Outlook auf Mac, Outlook im Web oder neues Outlook unter Windows (Vorschau) verwenden, müssen Sie die moveItemTo -Eigenschaft im event.completed Aufruf verwenden, um den Ordner anzugeben, in den eine gemeldete Nachricht verschoben wird, nachdem sie von Ihrem Add-In verarbeitet wurde. In früheren Outlook-Builds unter Windows, die die integrierte Spamberichterstattungsfunktion unterstützen, müssen Sie die postProcessingAction -Eigenschaft verwenden.

  2. Speichern Sie Ihre Änderungen.

Im Folgenden sehen Sie ein Beispieldialogfeld für die Nachbearbeitung, das dem Benutzer angezeigt wird, sobald das Add-In die Verarbeitung einer gemeldeten Nachricht in Outlook unter Windows abgeschlossen hat. Beachten Sie, dass das Erscheinungsbild des Dialogfelds je nach Plattform variieren kann, auf der der Outlook-Client des Benutzers ausgeführt wird.

Ein Beispiel für ein Nachbearbeitungsdialogfeld, das angezeigt wird, nachdem eine gemeldete Spamnachricht vom Add-In verarbeitet wurde.

Tipp

Beachten Sie folgendes, wenn Sie ein Add-In für die Spamberichterstattung entwickeln, das in Outlook unter Windows ausgeführt wird.

  • Importe werden derzeit in der JavaScript-Datei, die den Code zum Behandeln des Spam-Reporting-Ereignisses enthält, nicht unterstützt.
  • Code, der in den Office.onReady() Funktionen und Office.initialize enthalten ist, wird nicht ausgeführt. Sie müssen Ihren Ereignishandlern stattdessen eine beliebige Add-In-Startlogik hinzufügen, z. B. die Überprüfung der Outlook-Version des Benutzers.

Aktualisieren der HTML-Datei für Befehle

  1. Öffnen Sie im Ordner ./src/commandscommands.html.

  2. Ersetzen Sie unmittelbar vor dem schließenden Headtag (</head>) den vorhandenen Skripteintrag durch den folgenden Code.

    <script type="text/javascript" src="https://appsforoffice.microsoft.com/lib/beta/hosted/office.js"></script>
<script type="text/javascript" src="../spamreporting/spamreporting.js"></script>

  3. Speichern Sie Ihre Änderungen.

Aktualisieren der Webpack-Konfigurationseinstellungen

  1. Öffnen Sie im Stammverzeichnis Ihres Add-In-Projekts die webpack.config.js Datei.

  2. Suchen Sie das plugins Array im config -Objekt, und fügen Sie dieses neue Objekt am Anfang des Arrays hinzu.

    new CopyWebpackPlugin({
  patterns: [
    {
      from: "./src/spamreporting/spamreporting.js",
      to: "spamreporting.js",
    },
  ],
}),

  3. Speichern Sie Ihre Änderungen.

Testen und Überprüfen Ihres Add-Ins

  1. Laden Sie das Add-In in einen unterstützten Outlook-Client quer.

  2. Wählen Sie eine Nachricht aus Ihrem Posteingang aus, und wählen Sie dann im Menüband die Schaltfläche des Add-Ins aus.

  3. Wählen Sie im Vorverarbeitungsdialog einen Grund für das Melden der Nachricht aus, und fügen Sie Informationen zur Nachricht hinzu, falls konfiguriert. Wählen Sie dann Bericht aus.

  4. (Optional) Wählen Sie im Dialogfeld Nachbearbeitung die Option OK aus.

    Tipp

    In Outlook im Web oder in outlook unter Windows (Vorschau) wird kein Nachbearbeitungsdialogfeld angezeigt, sobald das Add-In die Verarbeitung einer gemeldeten Nachricht abgeschlossen ist. Dies gilt auch, wenn die showPostProcessingDialog -Eigenschaft im event.completed Aufruf konfiguriert ist. Je nachdem, wie Sie die moveItemTo Eigenschaft im event.completed Anruf konfiguriert haben, wird jedoch eine Benachrichtigung angezeigt, die signalisiert, wenn die gemeldete Nachricht gelöscht oder in einen anderen Ordner im Postfach verschoben wird.

Überprüfen des Featureverhaltens und der Einschränkungen

Achten Sie beim Entwickeln und Testen der integrierten Spamberichterstattungsfunktion in Ihrem Add-In auf dessen Merkmale und Einschränkungen.

  • Ein Add-In zur Spamberichterstattung kann nach der Aktivierung maximal fünf Minuten lang ausgeführt werden. Jede Verarbeitung, die über fünf Minuten hinaus erfolgt, führt zu einem Timeout für das Add-In. Wenn für das Add-In ein Zeitüberschreitungsereignis angezeigt wird, wird dem Benutzer ein Dialogfeld angezeigt, in dem er darüber benachrichtigt wird.

    Das Dialogfeld, das angezeigt wird, wenn für ein Add-In für die Spamberichterstattung ein Zeitüberschreitungsereignis aufgetreten ist.

  • Ein Add-In für die Spamberichterstattung kann verwendet werden, um eine Nachricht zu melden, auch wenn der Lesebereich des Outlook-Clients deaktiviert ist. Dies wird jedoch in Outlook für Mac nicht unterstützt. In Outlook für Mac muss der Lesebereich aktiviert sein, um ein Add-In für die Spamberichterstattung zu verwenden.

  • Im klassischen Outlook unter Windows kann jeweils nur eine Nachricht gemeldet werden. Wenn ein Benutzer versucht, eine andere Nachricht zu melden, während die vorherige noch verarbeitet wird, wird ein Dialogfeld angezeigt, in dem er darüber benachrichtigt wird.

    Das Dialogfeld, das angezeigt wird, wenn der Benutzer versucht, eine andere Nachricht zu melden, während die vorherige noch verarbeitet wird.

    Dies gilt nicht für Outlook auf Mac oder im Web oder für neues Outlook unter Windows (Vorschau). In diesen Outlook-Clients kann ein Benutzer eine Nachricht aus dem Lesebereich melden und gleichzeitig jede Nachricht melden, die in einem separaten Fenster geöffnet ist.

  • Das Add-In kann die gemeldete Nachricht auch dann verarbeiten, wenn der Benutzer von der ausgewählten Nachricht weg navigiert. In Outlook für Mac wird dies nur unterstützt, wenn ein Benutzer eine Nachricht meldet, während sie in einem separaten Fenster geöffnet ist. Wenn der Benutzer eine Nachricht meldet, während er sie aus dem Lesebereich anzeigt und dann weg navigiert, wird der Berichterstellungsprozess beendet.

  • Die Schaltflächen, die in den Vorverarbeitungs- und Nachbearbeitungsdialogen angezeigt werden, können nicht angepasst werden. Darüber hinaus können der Text und die Schaltflächen in den Dialogfeldern für timeout und laufende Berichte nicht geändert werden.

  • Die integrierten Features für Spamberichterstattung und ereignisbasierte Aktivierung müssen dieselbe Laufzeit verwenden. Mehrere Runtimes werden in Outlook derzeit nicht unterstützt. Weitere Informationen zu Runtimes finden Sie unter Runtimes in Office-Add-Ins.

  • Ein Aufgabenbereichbefehl kann der Schaltfläche "Spamberichterstattung" im Menüband nicht zugewiesen werden. Wenn Sie einen Aufgabenbereich in Ihrem Add-In implementieren möchten, müssen Sie das Action-Element in das Manifest einschließen und dessen xsi:type Attribut auf ShowTaskpanefestlegen. Beachten Sie, dass dem Menüband eine separate Schaltfläche zum Aktivieren des Aufgabenbereichs hinzugefügt wird, die aber nicht im dedizierten Spamberichtsbereich des Menübands angezeigt wird.

  • In Outlook im Web oder in outlook unter Windows (Vorschau) wird kein Nachbearbeitungsdialogfeld angezeigt, sobald das Add-In die Verarbeitung einer gemeldeten Nachricht abgeschlossen ist. Dies gilt auch, wenn die showPostProcessingDialog -Eigenschaft im event.completed Aufruf konfiguriert ist. Je nachdem, wie Sie die moveItemTo Eigenschaft im event.completed Anruf konfiguriert haben, wird jedoch eine Benachrichtigung angezeigt, die signalisiert, wenn die gemeldete Nachricht gelöscht oder in einen anderen Ordner im Postfach verschoben wird.

    Die Benachrichtigung, die angezeigt wird, wenn ein Benutzer eine Nachricht in Outlook im Web oder in neuem Outlook unter Windows löscht.

Problembehandlung für Ihr Add-In

Während Sie Ihr Add-In für die Spamberichterstattung entwickeln, müssen Sie möglicherweise Probleme beheben, z. B. das Add-In wird nicht geladen. Eine Anleitung zur Problembehandlung eines Add-Ins für die Spamberichterstattung finden Sie unter Problembehandlung bei ereignisbasierten Add-Ins und Spamberichts-Add-Ins.

Siehe auch