Methode Mailbox.makeEwsRequestAsync (JavaScript-API für Office v1.1)
Richtet eine asynchrone Anforderung an einen EWS-Dienst (Exchange Web Services) auf dem Exchange-Server, der das Postfach des Benutzers hostet.
Letzte Änderung: Montag, 24. November 2014
Zutreffende Outlook-Modi |
Verfassen oder lesen |
Verfügbar in Anforderungssätzen |
Postfach |
Office.context.mailbox.makeEwsRequestAsync(data, callback, userContext);
Parameter
data
Die EWS-Anforderung. Erforderlich.
callback
Die aufzurufende Methode, wenn der asynchrone Ladevorgang abgeschlossen ist. Erforderlich.
userContext
Statusdaten, die an die asynchrone Methode übergeben werden. Optional.
Hinweise
Die makeEwsRequestAsync-Methode sendet eine EWS-Anforderung an Exchange Online, Exchange Online als Bestandteil von Office 365 oder eine Version von Exchange ab Exchange 2013, welche das Postfach des Benutzers hostet. Wenn die Anforderung erfolgt ist, wird die vom callback-Parameter angegebene Methode mit einem Parameter aufgerufen, dem Ergebnisobjekt. Das Ergebnisobjekt besitzt zwei Eigenschaften: Die context-Eigenschaft enthält die Daten im userContext-Parameter, und die value-Eigenschaft enthält die XML-Ergebnisse der EWS-Anforderung. Wenn das Ergebnis größer als 1 MB ist, wird eine Fehlermeldung zurückgegeben.
Sie können keine Elemente, die Ordnern zugeordnet sind, mit der makeEwsRequestAsync-Methode anfordern.
Die XML-Anfrage muss UTF-8-Codierung angeben.
<?xml version="1.0" encoding="utf-8"?>"
Ihre Mail-App muss über die ReadWriteMailbox-Berechtigung verfügen, um die makeEwsRequestAsync-Methode verwenden zu können. Informationen zur ReadWriteMailbox-Berechtigung und die EWS-Vorgänge, die Sie mit der makeEwsRequestAsync-Methode aufrufen können, finden Sie unter Angeben von Berechtigungen für den Mail-App-Zugriff auf die Benutzerpostfächer.
Hinweis
Der Serveradministrator muss "OAuthAuthentication" im EWS-Verzeichnis des Clientzugriffsservers auf true festlegen, damit die makeEwsRequestAsync-Methode EWS-Anforderungen erzeugen kann.
Versionsunterschiede
Wenn Sie die makeEwsRequestAsync-Methode in Mail-Apps verwenden, die in älteren Outlook-Versionen als Version 15.0.4535.1004 ausgeführt werden, sollten Sie den Codierungswert auf ISO-8859-1 festlegen.
<?xml version="1.0" encoding="iso-8859-1"?>"
Sie müssen den Codierungswert nicht festlegen, wenn Ihre Mail-App in Outlook Web App ausgeführt wird. Sie können mithilfe der mailbox.diagnostics.hostName-Eigenschaft ermitteln, ob Ihre Mail-App in Outlook oder Outlook Web App ausgeführt wird. Sie können mithilfe der mailbox.diagnostics.hostVersion-Eigenschaft ermitteln, welche Version von Outlook ausgeführt wird.
Anforderungen
App-Typen |
Mail-App |
Unterstützte Clients |
Outlook 2013, Outlook 2013 SP1, Outlook 2013 RT, Outlook Web App und OWA für mobile Geräte |
Bibliothek |
Office.js |
Namespace |
Office |