Aktivieren Ihres Outlook-Add-Ins für mehrere Nachrichten

Mit der Mehrfachauswahlfunktion für Elemente kann Ihr Outlook-Add-In jetzt mehrere ausgewählte Nachrichten auf einmal aktivieren und Vorgänge ausführen. Bestimmte Vorgänge, z. B. das Hochladen von Nachrichten in Ihr CRM-System (Customer Relationship Management) oder das Kategorisieren zahlreicher Elemente, können jetzt problemlos mit einem einzigen Klick abgeschlossen werden.

In den folgenden Abschnitten wird beschrieben, wie Sie Ihr Add-In so konfigurieren, dass die Betreffzeile mehrerer Nachrichten im Lesemodus abgerufen wird.

Einrichten der Umgebung

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

Konfigurieren des Manifests

Konfigurieren des Aufgabenbereichs

Die Mehrfachauswahl von Elementen basiert auf dem SelectedItemsChanged-Ereignis , um zu bestimmen, wann Nachrichten ausgewählt oder deaktiviert werden. Dieses Ereignis erfordert eine Aufgabenbereichsimplementierung.

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

2. Ersetzen Sie im <body-Element> das gesamte <Standard-Element> durch das folgende Markup.

   <main id="app-body" class="ms-welcome__main">
       <h2 class="ms-font-xl">Retrieve the subject line of multiple messages with one click!</h2>
       <ul id="selected-items"></ul>
       <div role="button" id="run" class="ms-welcome__action ms-Button ms-Button--hero ms-font-xl">
           <span class="ms-Button-label">Run</span>
       </div>
   </main>
   

3. Speichern Sie Ihre Änderungen.

Implementieren eines Handlers für das SelectedItemsChanged-Ereignis

Um Ihr Add-In zu benachrichtigen, wenn das SelectedItemsChanged Ereignis eintritt, müssen Sie einen Ereignishandler mithilfe der addHandlerAsync -Methode registrieren.

1. Öffnen Sie im Ordner ./src/taskpanetaskpane.js.

2. Ersetzen Sie in der Office.onReady() Rückruffunktion den vorhandenen Code durch Folgendes:

   if (info.host === Office.HostType.Outlook) {
       document.getElementById("sideload-msg").style.display = "none";
       document.getElementById("app-body").style.display = "flex";
       document.getElementById("run").onclick = run;
   
       // Register an event handler to identify when messages are selected.
       Office.context.mailbox.addHandlerAsync(Office.EventType.SelectedItemsChanged, run, asyncResult => {
         if (asyncResult.status === Office.AsyncResultStatus.Failed) {
           console.log(asyncResult.error.message);
           return;
         }
   
         console.log("Event handler added.");
       });
   }
   

Abrufen der Betreffzeile ausgewählter Nachrichten

Nachdem Sie nun einen Ereignishandler registriert haben, rufen Sie die getSelectedItemsAsync-Methode auf, um die Betreffzeile der ausgewählten Nachrichten abzurufen und im Aufgabenbereich zu protokollieren. Die getSelectedItemsAsync -Methode kann auch verwendet werden, um andere Nachrichteneigenschaften abzurufen, z. B. die Element-ID, den Elementtyp (Message ist derzeit der einzige unterstützte Typ) und den Elementmodus (Read oder Compose).

1. Navigieren Sietaskpane.jszur run Funktion, und fügen Sie den folgenden Code ein.

   // Clear list of previously selected messages, if any.
   const list = document.getElementById("selected-items");
   while (list.firstChild) {
       list.removeChild(list.firstChild);
   }
   
   // Retrieve the subject line of the selected messages and log it to a list in the task pane.
   Office.context.mailbox.getSelectedItemsAsync(asyncResult => {
       if (asyncResult.status === Office.AsyncResultStatus.Failed) {
           console.log(asyncResult.error.message);
           return;      
       }
   
       asyncResult.value.forEach(item => {
           const listItem = document.createElement("li");
           listItem.textContent = item.subject;
           list.appendChild(listItem);
       });
   });
   

2. Speichern Sie Ihre Änderungen.

Probieren Sie es aus

1. Führen Sie in einem Terminal den folgenden Code im Stammverzeichnis Ihres Projekts aus. Dadurch wird der lokale Webserver gestartet und das Add-In querladen.

   npm start
   

   Tipp

   Wenn Ihr Add-In nicht automatisch querladen wird, befolgen Sie die Anweisungen unter Querladen von Outlook-Add-Ins zum Testen , um es manuell in Outlook querzuladen.

2. Stellen Sie in Outlook sicher, dass der Lesebereich aktiviert ist. Informationen zum Aktivieren des Lesebereichs finden Sie unter Verwenden und Konfigurieren des Lesebereichs für eine Vorschau von Nachrichten.

3. Navigieren Sie zu Ihrem Posteingang, und wählen Sie mehrere Nachrichten aus, indem Sie strg gedrückt halten, während Sie Nachrichten auswählen.

4. Wählen Sie im Menüband Aufgabenbereich anzeigen aus.

5. Wählen Sie im Aufgabenbereich Ausführen aus, um eine Liste der Betreffzeilen der ausgewählten Nachrichten anzuzeigen.

   

6. Wenn Sie den lokalen Webserver beenden und das Add-In deinstallieren möchten, befolgen Sie die entsprechenden Anweisungen:

   • Führen Sie den folgenden Befehl aus, um den Server zu beenden. Wenn Sie verwendet haben npm start, sollte auch der folgende Befehl das Add-In deinstallieren.

     npm stop
     

   • Wenn Sie das Add-In manuell quergeladen haben, lesen Sie Entfernen eines quergeladenen Add-Ins.

Multiauswahlverhalten und Einschränkungen von Elementen

Die Mehrfachauswahl von Elementen unterstützt nur Nachrichten innerhalb eines Exchange-Postfachs sowohl im Lese- als auch im Verfassenmodus. Ein Outlook-Add-In wird nur für mehrere Nachrichten aktiviert, wenn die folgenden Bedingungen erfüllt sind.

• Die Nachrichten müssen jeweils aus einem Exchange-Postfach ausgewählt werden. Nicht-Exchange-Postfächer werden nicht unterstützt.
• Die Nachrichten müssen jeweils aus einem Postfachordner ausgewählt werden. Ein Add-In wird nicht für mehrere Nachrichten aktiviert, wenn sie sich in verschiedenen Ordnern befinden, es sei denn, die Unterhaltungsansicht ist aktiviert. Weitere Informationen finden Sie unter Mehrfachauswahl in Unterhaltungen.
• Ein Add-In muss einen Aufgabenbereich implementieren, um das SelectedItemsChanged Ereignis zu erkennen.
• Der Lesebereich in Outlook muss aktiviert sein. Eine Ausnahme besteht darin, wenn die Mehrfachauswahlfunktion des Elements über das Feature "Kein Elementkontext" im Manifest aktiviert ist. Weitere Informationen finden Sie unter Aktivieren Ihres Outlook-Add-Ins ohne aktivierten Lesebereich oder ausgewählte Nachricht.
• Es können maximal 100 Nachrichten gleichzeitig ausgewählt werden.

Mehrfachauswahl in Unterhaltungen

Die Mehrfachauswahl von Elementen unterstützt die Unterhaltungsansicht unabhängig davon, ob sie für Ihr Postfach oder für bestimmte Ordner aktiviert ist. In der folgenden Tabelle werden die erwarteten Verhaltensweisen beschrieben, wenn Unterhaltungen erweitert oder reduziert werden, wenn die Unterhaltungskopfzeile ausgewählt ist und sich Unterhaltungsnachrichten in einem anderen Ordner befinden als der aktuell angezeigte.

Anheften des Aufgabenbereichs in Add-Ins mit mehrfacher Auswahl

In Outlook im Web und im neuen Outlook unter Windows wird der Aufgabenbereich eines Add-Ins mit mehrfacher Auswahl automatisch an den Outlook-Client angeheftet. Sie bleibt auch dann angeheftet, wenn ein Benutzer zu einem anderen E-Mail-Element wechselt oder das Stecknadelsymbol im Aufgabenbereich auswählt. Der Aufgabenbereich kann nur durch Auswählen der Schaltfläche Schließen im Aufgabenbereich geschlossen werden.

Umgekehrt wird in Outlook unter Windows (klassisch) und auf Mac der Aufgabenbereich nicht automatisch angeheftet und geschlossen, wenn ein Benutzer zu einem anderen E-Mail-Element wechselt.

Nächste Schritte

Nachdem Sie Ihr Add-In nun für die Verwendung mehrerer ausgewählter Nachrichten aktiviert haben, können Sie die Funktionen Ihres Add-Ins erweitern und die Benutzerfreundlichkeit weiter verbessern. Erkunden Sie die Durchführung komplexerer Vorgänge mithilfe der Element-IDs der ausgewählten Nachrichten mit Diensten wie Microsoft Graph.

Siehe auch

• Office-Add-In-Manifeste
• Aufrufen von Webdiensten aus einem Outlook-Add-In
• Übersicht über Microsoft Graph
• Aktivieren Ihres Outlook-Add-Ins ohne aktivierten Lesebereich oder ohne ausgewählte Nachricht