Freigeben über


Implementieren eines integrierten Add-Ins für die Spamberichterstattung

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.

Hinweis

Die integrierte Spamberichterstattung wurde im Postfachanforderungssatz 1.14 eingeführt. Informationen zur Clientunterstützung für dieses Feature finden Sie unter Unterstützte Clients.

Unterstützte Clients

In der folgenden Tabelle wird angegeben, welche Outlook-Clients das integrierte Spam-Reporting-Feature unterstützen.

Client Status
Outlook im Web Unterstützt
neues Outlook unter Windows Unterstützt
Klassisches Outlook unter Windows
Version 2404 (Build 17530.15000)
Unterstützt
Outlook für Mac
Version 16.81 (23121700) oder höher
Vorschau (siehe Vorschau der integrierten Spamberichterstattungsfunktion in Outlook für Mac)
Outlook unter Android Nicht verfügbar
Outlook unter iOS Nicht verfügbar

Vorschau der integrierten Spamberichterstattungsfunktion in Outlook für Mac

Um eine Vorschau der integrierten Spamberichterstattungsfunktion in Outlook für Mac anzuzeigen, müssen Sie Version 16.81.1217.0 oder höher installieren. Nehmen Sie dann am Microsoft 365 Insider-Programm teil, und wählen Sie die Option Betakanal aus, um auf Office-Beta-Builds zuzugreifen.

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 .

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

Um die integrierte Spamberichterstattungsfunktion in Ihrem Add-In zu implementieren, müssen Sie Folgendes in Ihrem Manifest konfigurieren.

  • Die vom Add-In verwendete Runtime. Im klassischen Outlook unter Windows wird ein Add-In für die Spamberichterstattung in einer reinen JavaScript-Runtime ausgeführt. In Outlook im Web und auf Mac und im neuen Outlook unter Windows wird ein Add-In zur Spamberichterstattung in einer Browserruntime ausgeführt. Weitere Informationen finden Sie unter Runtimes in Office-Add-Ins.

  • Die Schaltfläche des Add-Ins für die Spamberichterstattung, die immer an einer prominenten Stelle im Outlook-Menüband angezeigt wird. Im Folgenden finden Sie ein Beispiel dafür, wie die Schaltfläche eines Add-Ins für die Spamberichterstattung auf dem Menüband des klassischen 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. Dieses Dialogfeld wird dem Benutzer angezeigt, wenn er die Add-In-Schaltfläche auswählt. In diesem Dialogfeld kann ein Benutzer zusätzliche Informationen zu der Meldung angeben, die er meldet. 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.

Wählen Sie die Registerkarte für den Typ des verwendeten Manifests aus.

Hinweis

Die Implementierung der integrierten Spamberichterstattung mit dem einheitlichen Manifest für Microsoft 365 befindet sich in der öffentlichen Entwicklervorschau. Es ist derzeit nur für die Verwendung im klassischen Outlook unter Windows verfügbar. Dies sollte nicht in Produktions-Add-Ins verwendet werden. Wir laden Sie ein, es in Test- oder Entwicklungsumgebungen auszuprobieren. Weitere Informationen finden Sie unter Öffentliches App-Manifestschema für Entwicklervorschau.

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

  2. Öffnen Sie die manifest.json Datei.

  3. Fügen Sie dem Array "extensions.runtimes" das folgende -Objekt hinzu. Beachten Sie Folgendes zu diesem Markup.

    • Die "minVersion" des Postfachanforderungssatzes ist auf "1.14" konfiguriert. Dies ist die niedrigste Version des Anforderungssatzes, der die integrierte Spamberichterstattungsfunktion unterstützt.
    • Die "ID" der Laufzeit wird auf einen eindeutigen beschreibenden Namen festgelegt, "spam_reporting_runtime".
    • Die Eigenschaft "code" verfügt über eine untergeordnete "page"-Eigenschaft, die auf eine HTML-Datei festgelegt ist, und eine untergeordnete "script"-Eigenschaft, die auf eine JavaScript-Datei festgelegt ist. Sie erstellen oder bearbeiten diese Dateien in späteren Schritten.
    • Die Eigenschaft "lifetime" ist auf "short" festgelegt. Dies bedeutet, dass die Runtime beginnt, wenn das SpamReporting Ereignis auftritt, und beendet wird, wenn der Ereignishandler abgeschlossen ist.
    • Das "actions"-Objekt gibt die Ereignishandlerfunktion an, die in der Laufzeit ausgeführt wird. Sie erstellen diese Funktion in einem späteren Schritt.
    {
        "requirements": {
            "capabilities": [
                {
                    "name": "Mailbox",
                    "minVersion": "1.14"
                }
            ]
        },
        "id": "spam_reporting_runtime",
        "type": "general",
        "code": {
            "page": "https://localhost:3000/commands.html",
            "script": "https://localhost:3000/spamreporting.js"
        },
        "lifetime": "short",
        "actions": [
            {
                "id": "onSpamReport",
                "type": "executeFunction"
            }
        ]
    },
    
  4. Fügen Sie dem Array "extensions.ribbons" das folgende -Objekt hinzu. Beachten Sie Folgendes zu diesem Markup.

    • Das Array "contexts" enthält die Zeichenfolge "spamReportingOverride". Dadurch wird verhindert, dass die Add-In-Schaltfläche am Ende des Menübands oder im Überlaufabschnitt angezeigt wird.
    • Das Array "fixedControls" enthält ein -Objekt, das das Aussehen und die Funktionalität der Add-In-Schaltfläche im Menüband konfiguriert. Der Name des Ereignishandlers, der in der Eigenschaft "actionId" angegeben ist, muss mit dem Wert übereinstimmen, der in der Eigenschaft "id" des Objekts im Array "actions" verwendet wird. Die Eigenschaft "enabled" muss zwar im Array angegeben werden, ihr Wert wirkt sich jedoch nicht auf die Funktionalität eines Spamberichterstattungs-Add-Ins aus.
    • Das Objekt "spamPreProcessingDialog" gibt die Informationen und Optionen an, die im Vorverarbeitungsdialogfeld angezeigt werden. Sie müssen zwar einen "Titel" und eine "Beschreibung" für das Dialogfeld angeben, aber Sie können optional die folgenden Eigenschaften konfigurieren.
      • Das Objekt "spamReportingOptions". Es bietet eine Mehrfachauswahlliste mit bis zu fünf Auswahlmöglichkeiten. Dies hilft einem Benutzer, den Typ der Nachricht zu identifizieren, die er meldet.
      • Die Eigenschaft "spamFreeTextSectionTitle". Es stellt ein Textfeld bereit, in dem der Benutzer weitere Informationen zu der Nachricht hinzufügen kann, die er meldet.
      • Das Objekt "spamMoreInfo". Sie enthält einen Link im Dialogfeld, um dem Benutzer Informationsressourcen zur Verfügung zu stellen.
    {
        "contexts": [
            "spamReportingOverride"
        ],
        "fixedControls": [
            {
                "id": "spamReportingButton",
                "type": "button",
                "label": "Report Spam Message",
                "enabled": false,
                "icons": [
                    {
                        "size": 16,
                        "url": "https://localhost:3000/assets/icon-16.png"
                    },
                    {
                        "size": 32,
                        "url": "https://localhost:3000/assets/icon-32.png"
                    },
                    {
                        "size": 80,
                        "url": "https://localhost:3000/assets/icon-80.png"
                    }
                ],
                "supertip": {
                    "title": "Report Spam Message",
                    "description": "Report an unsolicited message."
                },
                "actionId": "onSpamReport"
            }
        ],
        "spamPreProcessingDialog": {
            "title": "Report Spam Message",
            "description": "Thank you for reporting this message.",
            "spamReportingOptions": {
                "title": "Why are you reporting this email?",
                "options": [
                    "Received spam email.",
                    "Received a phishing email.",
                    "I'm not sure this is a legitimate email."
                ]
            },
            "spamFreeTextSectionTitle": "Provide additional information, if any:",
            "spamMoreInfo": {
                "text": "Reporting unsolicited messages",
                "url": "https://www.contoso.com/spamreporting"
            }
        }
    },
    
  5. Speichern Sie Ihre Änderungen.

Tipp

Weitere Informationen zu Manifesten für Outlook-Add-Ins finden Sie unter Office-Add-Ins-Manifest.

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 in Ihrem Manifest angegeben haben, seiner 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 Outlook, remember to map the event handler name specified in the manifest to its JavaScript counterpart.
    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.

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 Outlook, remember to map the event handler name specified in the manifest to its JavaScript counterpart.
    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.

  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 Outlook, remember to map the event handler name specified in the manifest to its JavaScript counterpart
    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 verwenden, müssen Sie die moveItemTo -Eigenschaft im Aufruf verwenden, um den Ordner anzugeben, in event.completed 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. Fügen Sie unmittelbar vor dem schließenden Headtag (</head>) den folgenden Skripteintrag hinzu.

    <script type="text/javascript" src="../spamreporting/spamreporting.js"></script>    
    

    Hinweis

    Das integrierte Spam-Reporting-Feature befindet sich derzeit in Outlook für Mac in der Vorschauphase. Wenn Sie das Feature in diesem Client testen, müssen Sie einen Verweis auf die Vorschauversion der Office JavaScript-API in Ihre commands.html-Datei einschließen.

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

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

  • In Outlook im Web und unter Windows (neu und klassisch) ersetzt ein integriertes Spamberichterstattungs-Add-In die native Schaltfläche Bericht im Outlook-Menüband. Wenn mehrere Add-Ins für die Spamberichterstattung installiert sind, werden sie alle im Abschnitt Bericht des Menübands angezeigt.

    Ein Beispiel für ein integriertes Add-In für die Spamberichterstattung, das die Schaltfläche Bericht im Outlook-Menüband ersetzt.

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

  • Im klassischen Outlook unter Windows kann ein Add-In für die Spamberichterstattung verwendet werden, um eine Nachricht zu melden, auch wenn der Lesebereich des Outlook-Clients deaktiviert ist. In Outlook im Web, auf dem Mac und im neuen Outlook unter Windows kann das Add-In für die Spamberichterstattung verwendet werden, wenn der Lesebereich aktiviert ist oder die zu meldende Nachricht in einem anderen Fenster geöffnet ist.

  • Es kann jeweils nur eine Nachricht gemeldet werden. Wenn Sie mehrere Zu meldende Nachrichten auswählen, ist die Schaltfläche des Add-Ins für die Spamberichterstattung nicht mehr verfügbar.

  • Im klassischen Outlook unter Windows kann jeweils nur eine gemeldete Nachricht verarbeitet 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 im Web oder macos oder für neues Outlook unter Windows. 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 Add-In für die Spamberichterstattung implementiert nur Funktionsbefehle. 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 ihn in Ihrem Manifest wie folgt konfigurieren:

    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.

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