Automatisches Aktualisieren Ihrer Signatur beim Wechseln zwischen Exchange-Konten

Das Anwenden der richtigen Signatur auf Nachrichten bei Verwendung mehrerer Exchange-Konten wird jetzt durch das Hinzufügen der OnMessageFromChanged - und OnAppointmentFromChanged -Ereignisse zum ereignisbasierten Aktivierungsfeature vereinfacht. Das OnMessageFromChanged Ereignis tritt auf, wenn das Konto im Feld Von einer nachricht, die zusammengestellt wird, geändert wird, während das OnAppointmentFromChanged Ereignis auftritt, wenn der Organisator einer Besprechung geändert wird, die zusammengestellt wird. Diese Ereignisse erweitern die Funktionen von Signatur-Add-Ins und ermöglichen folgendes:

• Bieten Sie Benutzern den Komfort, benutzerdefinierte Signaturen für jedes ihrer Konten anzuwenden.
• Ermöglichen Sie Postfachdelegaten, ausgehende Nachrichten und Besprechungsanfragen aus mehreren Postfächern genauer und effizienter zu verwalten.
• Stellen Sie sicher, dass die Nachrichten und Termine der Benutzer den Kommunikations- und Marketingrichtlinien ihrer organization entsprechen.

In den folgenden Abschnitten erfahren Sie, wie Sie ein ereignisbasiertes Add-In entwickeln, das das Ereignis behandelt, um die OnMessageFromChanged Signatur einer Nachricht automatisch zu aktualisieren, wenn das E-Mail-Konto im Feld Von geändert wird.

Unterstützte Clients und Plattformen

In den folgenden Tabellen sind Client-Server-Kombinationen aufgeführt, die die OnMessageFromChanged Ereignisse und OnAppointmentFromChanged unterstützen. Wählen Sie die Registerkarte für das entsprechende Ereignis aus.

Voraussetzungen

Zum Testen der exemplarischen Vorgehensweise müssen Sie über mindestens zwei Exchange-Konten verfügen.

Einrichten der Umgebung

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

Implementieren der Ereignishandler

Ereignishandler müssen für die OnNewMessageCompose Ereignisse und OnMessageFromChanged konfiguriert werden. Die onNewMessageComposeHandler Funktion fügt einer neu erstellten Nachricht eine Signatur hinzu, wenn noch keine Standardsignatur für das aktuelle Konto konfiguriert ist. Wenn das Konto im Feld Von geändert wird, aktualisiert die onMessageFromChangedHandler Funktion die Signatur basierend auf diesem neu ausgewählten Konto.

1. Navigieren Sie aus demselben Schnellstartprojekt zum Verzeichnis ./src , und erstellen Sie dann einen neuen Ordner mit dem Namen launchevent.

2. Erstellen Sie im Ordner ./src/launchevent eine neue Datei mit dem Namen launchevent.js.

3. Öffnen Sie die Datei ./src/launchevent/launchevent.js in Ihrem Code-Editor, und fügen Sie den folgenden JavaScript-Code hinzu.

   /*
    * Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
    * See LICENSE in the project root for license information.
    */
   
   // The OnNewMessageCompose event handler that adds a signature to a new message.
   function onNewMessageComposeHandler(event) {
       const platform = Office.context.platform;
       const signature = "<i>This is a sample signature.</i>";
   
       // On supported platforms, check if a default Outlook signature is already configured.
       if (platform !== Office.PlatformType.Android && platform !== Office.PlatformType.iOS) {
           Office.context.mailbox.item.isClientSignatureEnabledAsync({ asyncContext: { event: event, signature: signature } }, (result) => {
               if (result.status === Office.AsyncResultStatus.Failed) {
                   console.log(result.error.message);
                   return;
               }
   
               // Add a signature if there's no default Outlook signature configured.
               const signatureEnabled = result.value;
               if (signatureEnabled === false) {
                   const event = result.asyncContext.event;
                   const signature = result.asyncContext.signature;
                   setSignature(signature, event);
               }
           });
       } else {
           setSignature(signature, event);
       }
   }
   
   // The OnMessageFromChanged event handler that updates the signature when the email address in the From field is changed.
   function onMessageFromChangedHandler(event) {
       const item = Office.context.mailbox.item;
       const signatureIcon =
       "iVBORw0KGgoAAAANSUhEUgAAACcAAAAnCAMAAAC7faEHAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAzUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKMFRskAAAAQdFJOUwAQIDBAUGBwgI+fr7/P3+8jGoKKAAAACXBIWXMAAA7DAAAOwwHHb6hkAAABT0lEQVQ4T7XT2ZalIAwF0DAJhMH+/6+tJOQqot6X6joPiouNBo3w9/Hd6+hrYnUt6vhLcjEAJevVW0zJxABSlcunhERpjY+UKoNN5+ZgDGu2onNz0OngjP2FM1VdyBW1LtvGeYrBLs7U5I1PTXZt+zifcS3Icw2GcS3vxRY3Vn/iqx31hUyTnV515kdTfbaNhZLI30AceqDiIo4tyKEmJpKdP5M4um+nUwfDWxAXdzqMNKQ14jLdL5ntXzxcRF440mhS6yu882Kxa30RZcUIjTCJg7lscsR4VsMjfX9Q0Vuv/Wd3YosD1J4LuSRtaL7bzXGN1wx2cytUdncDuhA3fu6HPTiCvpQUIjZ3sCcHVbvLtbNTHlysx2w9/s27m9gEb+7CTri6hR1wcTf2gVf3wBRe3CMbcHYvTODkXhnD0+178K/pZ9+n/C1ru/2HAPwAo7YM1X4+tLMAAAAASUVORK5CYII=";
   
       // Get the currently selected From account.
       item.from.getAsync({ asyncContext: event }, (result) => {
           if (result.status === Office.AsyncResultStatus.Failed) {
               console.log(result.error.message);
               return;
           }
   
           // Create a signature based on the currently selected From account.
           const name = result.value.displayName;
           const options = { asyncContext: { event: result.asyncContext, name: name }, isInline: true };
           item.addFileAttachmentFromBase64Async(signatureIcon, "signatureIcon.png", options, (result) => {
               if (result.status === Office.AsyncResultStatus.Failed) {
                   console.log(result.error.message);
                   return;
               }
   
               // Add the created signature to the mail item.
               const signature = "<img src='cid:signatureIcon.png'>" + result.asyncContext.name;
               const event = result.asyncContext.event;
               setSignature(signature, event);
           });
       });
   }
   
   // Sets the custom signature and adds it to the mail item.
   function setSignature(signature, event) {
       Office.context.mailbox.item.body.setSignatureAsync(
           signature,
           { asyncContext: event, coercionType: Office.CoercionType.Html },
           (result) => {
               if (result.status === Office.AsyncResultStatus.Failed) {
                   console.log(result.error.message);
                   return;
               }
   
               console.log("Successfully added signature.");
               const event = result.asyncContext;
               event.completed();
           }
       );
   }
   
   // 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("onNewMessageComposeHandler", onNewMessageComposeHandler);
   Office.actions.associate("onMessageFromChangedHandler", onMessageFromChangedHandler);
   

Aktualisieren der HTML-Datei für Befehle

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

2. Fügen Sie den folgenden Code unterhalb des vorhandenen Skripttags hinzu.

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

3. Speichern Sie Ihre Änderungen.

Aktualisieren der Webpack-Konfigurationseinstellungen

1. Öffnen Sie im Stammverzeichnis des Projekts die dateiwebpack.config.js .

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

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

3. Speichern Sie Ihre Änderungen.

Probieren Sie es aus

1. Führen Sie die folgenden Befehle im Stammverzeichnis Ihres Projekts aus. Wenn Sie ausführen npm start, wird der lokale Webserver gestartet (sofern er noch nicht ausgeführt wird), und Ihr Add-In wird quergeladen.

   npm run build
   

   npm start
   

   Hinweis

   • Wenn Sie den Yeoman-Generator zum ersten Mal zum Entwickeln eines Office-Add-Ins verwenden, öffnet Ihr Standardbrowser ein Fenster, in dem Sie aufgefordert werden, sich bei Ihrem Microsoft 365-Konto anzumelden. Wenn kein Anmeldefenster angezeigt wird und ein Sideloading- oder Anmeldetimeoutfehler auftritt, führen Sie vor atk auth login m365 der erneuten Ausführung aus npm start .

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

2. Erstellen Sie in Ihrem bevorzugten Outlook-Client eine neue Nachricht. Wenn Sie keine Outlook-Standardsignatur konfiguriert haben, fügt das Add-In der neu erstellten Nachricht eine hinzu. In Outlook auf mobilen Geräten fügt das Add-In eine Beispielsignatur hinzu, auch wenn Sie eine Standardsignatur konfiguriert haben.

   

3. Aktivieren Sie ggf. das Feld Von . Eine Anleitung zum Aktivieren finden Sie im Abschnitt "Warum fehlt die Schaltfläche Von?" unter Ändern des Kontos, das zum Senden von E-Mail-Nachrichten verwendet wird.

4. Wählen Sie Von und dann ein anderes Exchange-Konto aus. Alternativ können Sie die Exchange-E-Mail-Adresse manuell eingeben, indem Sie Von>anderer Email Adresse auswählen. Der Nachricht wird eine aktualisierte Signatur hinzugefügt, die die vorherige signatur ersetzt.

   

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

Problembehandlung für Ihr Add-In

Eine Anleitung zur Problembehandlung ihres ereignisbasierten Aktivierungs-Add-Ins finden Sie unter Problembehandlung bei ereignisbasierten Add-Ins und Spamberichts-Add-Ins.

Bereitstellen für Benutzer

Eine Anleitung zum Bereitstellen Ihres ereignisbasierten Add-Ins finden Sie im Abschnitt "Bereitstellen Ihres Add-Ins" unter Aktivieren von Add-Ins mit Ereignissen.

Ereignisverhalten und Einschränkungen

Da die OnMessageFromChanged Ereignisse und OnAppointmentFromChanged über die ereignisbasierte Aktivierungsfunktion unterstützt werden, gelten das gleiche Verhalten und die gleichen Einschränkungen für Add-Ins, die als Ergebnis dieses Ereignisses aktiviert werden. Eine ausführliche Beschreibung finden Sie unter Ereignisbasiertes Aktivierungsverhalten und Einschränkungen.

Zusätzlich zu diesen Merkmalen gelten auch die folgenden Aspekte, wenn ein Add-In für diese Ereignisse aktiviert wird.

• Das OnMessageFromChanged Ereignis wird nur im Nachrichtenerstellungsmodus unterstützt, während das OnAppointmentFromChanged Ereignis nur im Terminerstellungsmodus unterstützt wird.
• In Outlook im Web, unter Windows (neu und klassisch) und auf mobilen Geräten wird nur das OnMessageFromChanged Ereignis unterstützt.
• Die OnMessageFromChanged Ereignisse und OnAppointmentFromChanged unterstützen nur Exchange-Konten. Wenn ein Benutzer im Feld Von oder Organisator zu einem Nicht-Exchange-Konto wechselt, löscht der Outlook-Client automatisch die vom zuvor ausgewählten Konto festgelegte Signatur.
• Abhängig von Ihrem Outlook-Client wird das Exchange-Konto in nachrichten, die erstellt werden, aus der Dropdownliste Des-Felds ausgewählt oder manuell in das Feld eingegeben. Outlook auf mobilen Geräten unterstützt nur die Auswahl eines Kontos aus der Dropdownliste "Von ". Bei Terminen, die zusammengestellt werden, wird das Exchange-Konto in der Dropdownliste des Organisatorfelds ausgewählt.
• In Outlook im Web, unter Windows (neu und klassisch) und unter Mac unterstützen die OnMessageFromChanged Ereignisse und OnAppointmentFromChanged Szenarien für Delegaten und freigegebene Postfächer. Diese Szenarien werden in Outlook auf mobilen Geräten nicht unterstützt.
• Das OnAppointmentFromChanged Ereignis wird in Microsoft 365-Gruppenkalendern nicht unterstützt. Wenn ein Benutzer im Organisatorfeld von einem Exchange-Konto zu einem Microsoft 365-Gruppenkalenderkonto wechselt, löscht der Outlook-Client automatisch die vom Exchange-Konto festgelegte Signatur.
• Wenn Sie im Feld Von oder Organisator zu einem anderen Exchange-Konto wechseln, werden die Add-Ins für das zuvor ausgewählte Konto (sofern vorhanden) beendet, und die Add-Ins, die dem neu ausgewählten Konto zugeordnet sind, werden geladen, bevor das OnMessageFromChanged Ereignis oder OnAppointmentFromChanged initiiert wird.
• In Outlook im Web, unter Windows (neu und klassisch) und unter Mac werden E-Mail-Kontoaliase unterstützt. Wenn im Feld Von oder Organisator ein Alias für das aktuelle Konto ausgewählt wird, tritt das - oder OnAppointmentFromChanged -OnMessageFromChangedEreignis auf, ohne dass die Add-Ins des Kontos neu geladen werden. Email Kontoaliase werden in Outlook auf mobilen Geräten nicht unterstützt.
• Wenn die Dropdownliste Des - oder Organisatorfelds versehentlich geöffnet wird oder dasselbe Konto, das im Feld Von oder Organisator angezeigt wird, erneut ausgewählt wird, tritt das OnMessageFromChanged - oder OnAppointmentFromChanged -Ereignis auf, die Add-Ins des Kontos werden jedoch nicht beendet oder erneut geladen.

Siehe auch

• Aktivieren von Add-Ins mit Ereignissen
• Microsoft Marketplace-Auflistungsoptionen für Ihr ereignisbasiertes Add-In