Outlook-Add-Ins und EWS in Exchange

  • Artikel

In diesem Artikel finden Sie Informationen über Outlook-Add-Ins und ihre Zusammenarbeit mit EWS in Exchange.

Outlook-Add-Ins bieten eine einzige Oberfläche und ein Programmiermodell, das Webstandards verwendet, mit denen Sie eine benutzerdefinierte Erfahrung für Ihre E-Mail-Benutzer erstellen können. Sie können Mail-Apps erstellen, die kontextbezogene oder hilfreiche Informationen in einen HTML5-Frame anzeigen, der in Outlook gehostet wird; eine Mail-App kann beispielsweise eine Bing-Karte mit einer hervorgehobenen Adresse anzeigen, wenn eine E-Mail eine Adresse enthält. Oder wenn ein Benutzer eine Nachricht verfasst, können in einer Mail-App mit nur einem Klick zusätzliche Informationen zum Empfänger angezeigt und eine Standardbegrüßung in die E-Mail eingefügt werden.

Hinweis

"Outlook" bezieht sich in diesem Artikel auf den Outlook-Rich-Client, Outlook RT, Outlook Web App und OWA für Geräte.

Die Mail-Apps-Schnittstelle ist Teil der JavaScript-API für Office. Mithilfe der API können Sie auf Informationen in Exchange zugreifen, um folgende Funktionen für Ihre Mail-App zu aktivieren:

  • Erkennen von Entitäten wie z. B. Adressen, Telefonnummern, Aufgabenvorschlägen oder Besprechungsvorschlägen in einer E-Mail

  • Öffnen und Anzeigen von vorhandenen Nachrichten und Terminen in einer separaten Ansicht, sodass Benutzer Querverweise zwischen Informationen in einer oder mehreren Nachrichten erstellen können

  • Stellen von EWS-Anforderungen an den Exchange-Server, auf dem das Postfach des Benutzers gehostet wird. Eine Mail-App kann beispielsweise eine Liste von Ordnern abrufen, sodass der Benutzer einen Ordner zum Speichern der Nachricht auswählen kann, alle Elemente in einer Unterhaltung anzeigen oder eine E-Mail-Nachricht als Junk markieren.

  • Abrufen ein Tokens zur eindeutigen Identifizierung ein E-Mail-Kontos, um einmaliges Anmelden bei einem Drittanbieterdienst zu ermöglichen

  • Abrufen ein Tokens, das es einem Drittanbieterdienst ermöglicht, EWS-Anforderungen im Auftrag des Benutzers durchzuführen, beispielweise um die Anlagen aus einem Element zu extrahieren oder ein Element für die weitere Verarbeitung vom Exchange-Server abzurufen

Mithilfe von Mail-Apps können Sie die Benutzeroberfläche von Outlook Web App für Ihre Benutzer anpassen; zum Anpassen des "Erscheinungsbilds" von Outlook Web App lesen Sie die folgenden Artikel im TechNet:

Ihre Organisation kann Mail-Apps auf einem internen Server installieren, um den Zugriff auf autorisierte Benutzer zu beschränken; alternativ können Sie und andere Mail-App-Entwickler Mail-Apps im Office Store zum allgemeinen Verkauf veröffentlichen. Jeder Benutzer, auf dessen Gerät Outlook ausgeführt wird, kann Mail-Apps aus dem Marketplace herunterladen und diese installieren und verwenden.

Weitere Informationen zum Erstellen von Mail-Apps finden Sie in der Dokumentation zu Outlook-Add-Ins oder im Beispiel zum Durchführen einer EWS-Anforderung.

EWS und Outlook-Add-Ins

Sie können eine Teilmenge der EWS-Vorgänge auf dem Exchange-Server verwenden, das der Konto hostet, auf dem eine Mail-App ausgeführt wird.

Die mailbox.makeEwsRequestAsync-Funktionen ermöglichen es Ihnen, EWS-Anforderungen von Ihrer Mail-App zurück an den Server zu stellen, auf dem das Postfach des Benutzers gehostet wird. Sie erstellen den SOAP-Umschlag und die XML-Anforderung, und die makeEwsRequestAsync -Funktion ruft EWS mit einem Authentifizierungstoken auf, das das Postfach und die Mail-App identifiziert, die die Anforderung durchführt. Als Sicherheitsmaßnahme für das Benutzerpostfach lehnt der Exchange-Server alle Anforderungen ab, die nicht von der Mail-App oder von einem Postfach stammen, das nicht auf dem Server gehostet wird.

Wie jede andere Anwendung benötigt eine Mail-App Berechtigungen. Der Administrator muss Folgendes durchführen:

Sie müssen außerdem sicherstellen, dass Ihre App die Lesen/Schreiben-Berechtigung für das Postfach im Apps für Office-Berechtigungsmodell anfordert.

Wenn diese Schritte abgeschlossen sind, kann die Mail-App eine Teilmenge der EWS-Vorgänge für Ordner und Elemente nutzen.

Tabelle 1. EWS-Vorgänge für Ordner und Elemente, die von Mail-Apps genutzt werden können

Ordnervorgänge Elementvorgänge
CreateFolder-Vorgang
FindFolder-Vorgang
GetFolder-Vorgang
UpdateFolder-Vorgang
CopyItem-Vorgang
CreateItem-Vorgang
FindItem-Vorgang
FindConversation-Vorgang
GetConversationItems-Vorgang
GetItem-Vorgang
MarkAsJunk-Vorgang
MoveItem-Vorgang
SendItem-Vorgang
UpdateItem-Vorgang

Dienstrückruftoken

Mithilfe von Dienstrückruftoken können Mail-Apps ein Zugriffstoken an einen Drittanbieterdienst übergeben, sodass der Dienst EWS-Anforderungen an den Exchange-Server stellen kann, der das Postfach hostet. Beispielsweise kann eine Mail-App ein Dienstrückruftoken zusammen mit einer Liste von Anlagen-IDs für an eine E-Mail angefügte Bilder an einen Drittanbieterdienst übergeben. Der Dienst kann dann die Anlagen-IDs und die Rückruftoken verwenden, um eine EWS-Anforderung an den Exchange-Server des Benutzers zu stellen und die angefügten Bilder abzurufen. Mail-Apps können das Dienstrückruftoken auch mit einer Liste von Element-IDs verwenden, um E-Mail- und Terminelemente vom Exchange-Server abzurufen.

Das Dienstrückruftoken ist ein undurchsichtiges Token, das der Drittanbieterdienst an die EWS-Anforderung in einem Trägerauthentifizierungsheader anfügt. Das Token identifiziert die Mail-App und das Postfach, um die EWS-Anforderung zu schützen. Informationen zur Verwendung von Dienstrückruftoken finden Sie im Beispiel Outlook-Add-Ins: Abrufen von Anlagen von einem Exchange-Server.

Siehe auch