Einschränkungen für die Aktivierung und die JavaScript-API für Outlook-Add-Ins

  • Artikel

Um für Benutzer von Outlook-Add-Ins eine höchstmögliche Benutzerfreundlichkeit zu gewährleisten, sollten Sie bestimmte Richtlinien in Bezug auf Aktivierung und API-Verwendung kennen und Ihre Outlook-Add-Ins so implementieren, dass diese Grenzwerte eingehalten werden. Diese Richtlinien sind vorhanden, sodass ein einzelnes Add-In nicht verlangen kann, dass Exchange Server oder Outlook einen ungewöhnlich langen Zeitraum für die Verarbeitung seiner Aktivierungsregeln oder Aufrufe an die Office JavaScript-API benötigt, was sich auf die allgemeine Benutzererfahrung für Outlook und andere Add-Ins auswirkt. Diese Grenzwerte gelten für das Entwerfen von Aktivierungsregeln im Add-In-Manifest und die Verwendung von benutzerdefinierten Eigenschaften, Roamingeinstellungen, Empfängern, EXCHANGE-Webdienstanforderungen und -antworten sowie asynchronen Aufrufen.

Hinweis

Sie müssen auch überprüfen, ob Ihr Add-In bestimmte Grenzwerte für die Laufzeitressourcennutzung erfüllt. Weitere Informationen finden Sie unter Runtimes in Office-Add-Ins.

Grenzen für die Aktivierung von Add-Ins

Weitere Informationen dazu, wo Add-Ins funktionieren und nicht aktivieren, finden Sie im Abschnitt "Postfachelemente für Add-Ins verfügbar" der Übersicht über Outlook-Add-Ins.

Grenzwerte für JavaScript-API

Jeder Outlook-Client erzwingt bestimmte Grenzwerte im JavaScript-Objektmodell, wie in der folgenden Tabelle beschrieben.

Feature Grenze Zugehörige API Beschreibung
Benutzerdefinierte Eigenschaften 2.500 Zeichen Objekt CustomProperties

Item.loadCustomPropertiesAsync-Methode		 Grenzwert für alle benutzerdefinierten Eigenschaften für ein Termin- oder Nachricht-Objekt. Alle Outlook-Clients geben einen Fehler zurück, wenn die Gesamtgröße aller benutzerdefinierten Eigenschaften eines Add-Ins diesen Grenzwert überschreitet.
Roaming-Einstellungen Zeichenanzahl: 32 KB Objekt RoamingSettings

Context.roamingSettings-Eigenschaft		 Grenzwert für alle Roamingeinstellungen des Outlook-Add-Ins. Alle Outlook-Clients geben einen Fehler zurück, wenn Ihre Einstellungen diesen Grenzwert überschreiten.
Internetkopfzeilen 256 KB pro Nachricht in Exchange Online

Von den Administratoren des organization in Exchange lokal festgelegte Größenbeschränkung für Header		 InternetHeaders.setAsync-Methode Der Grenzwert für die Gesamtgröße von Headern, die auf eine Nachricht angewendet werden können.
Exchange-Webdienste 5 MB Anzahl von Zeichen in Outlook im Web, unter Windows (ab Version 2303 (Build 16225.10000)), auf Mac (ab Version 16.73 (23042601)) und in neuem Outlook unter Windows

1 MB Zeichen in früheren Versionen von Outlook unter Windows (klassisch) und auf Mac		 Mailbox.makeEwsRequestAsync-Methode Grenzwert für eine Anforderung oder Antwort auf einen Mailbox.makeEwsRequestAsync Anruf.
Mehrfachauswahl von Elementen 100 Nachrichten Mailbox.getSelectedItemsAsync-Methode Die maximale Anzahl ausgewählter Nachrichten, für die ein Outlook-Add-In aktiviert werden kann.
Empfänger Variiert je nach Outlook-Clients Item.requiredAttendees-Eigenschaft

Item.optionalAttendees-Eigenschaft

Item.to-Eigenschaft

Item.cc-Eigenschaft

Methode Recipients.addAsync

Methode Recipients.getAsync

Methode Recipients.setAsync		 Grenzwert für die Empfänger, die in jeder Eigenschaft oder Methode angegeben sind. Informationen zu den Empfängergrenzwerten für einen bestimmten Outlook-Client finden Sie in der API-Dokumentation für die Eigenschaft oder Methode.
Anzeigename 255 Zeichen Eigenschaft EmailAddressDetails.displayName

Objekt Recipients

Item.requiredAttendees-Eigenschaft

Item.optionalAttendees-Eigenschaft

Item.to-Eigenschaft

Item.cc-Eigenschaft		 Grenzwert für die Länge eines Anzeigenamens in einem Termin oder einer Nachricht.
Festlegen des Betreffs 255 Zeichen DisplayedSubject.setAsync (Vorschau)

Methode Mailbox.displayNewAppointmentForm

Methode Subject.setAsync		 Grenzwert für den Betreff im neuen Terminformular oder für das Festlegen des Betreffs eines Termins oder einer Nachricht.
Festlegen des Orts 255 Zeichen Methode Location.setAsync Grenzwert für das Festlegen des Ortes eines Termins oder einer Besprechungsanfrage.
Hauptteil in einem neuen Terminformular Zeichenanzahl: 32 KB Methode Mailbox.displayNewAppointmentForm Grenzwert für den Hauptteil in einem neuen Terminformular.
Anzeigen des Textkörpers eines vorhandenen Elements Zeichenanzahl: 32 KB Mailbox.displayAppointmentForm-Methode

Mailbox.displayMessageForm-Methode		 Für Outlook im Web, mobile Geräte und neue Outlook unter Windows: Grenzwert für den Text in einem vorhandenen Termin- oder Nachrichtenformular.
Festlegen des Textkörpers Zeichenanzahl: 1 MB Methode Body.prependAsync

Body.setAsync

Methode Body.setSelectedDataAsync

DisplayedBody.setAsync (Vorschau)		 Grenzwert für das Festlegen des Hauptteils eines Termin- oder Nachrichtenobjekts.
Festlegen der Signatur 30.000 Zeichen Body.setSignatureAsync-Methode Grenzwert für die Länge einer Signatur in einem Termin oder einer Nachricht.
Anzahl der Anlagen 499 Dateien in Outlook im Web und neuen Outlook unter Windows Item.addFileAttachmentAsync-Methode Grenzwert für die Anzahl von Dateien, die an ein Element beim Senden angehängt werden können. Outlook im Web und neue Outlook unter Windows beschränken in der Regel das Anfügen von bis zu 499 Dateien über die Benutzeroberfläche und addFileAttachmentAsync Methode. Outlook unter Windows (klassisch) und auf Mac schränkt die Anzahl von Dateianlagen nicht speziell ein. Alle Outlook-Clients beachten jedoch den Grenzwert für die Größe von Anlagen (siehe Zeile "Größe von Anlagen" in dieser Tabelle).
Anlagengröße Abhängig von Exchange Server im klassischen Outlook unter Windows und Outlook für Mac

25 MB in Outlook im Web und neuem Outlook unter Windows		 Item.addFileAttachmentAsync-Methode Grenzwert für die Größe aller Anlagen, die einem E-Mail-Element hinzugefügt werden. Im klassischen Outlook unter Windows und Outlook für Mac wird der Grenzwert von einem Administrator für die Exchange Server des Postfachs des Benutzers konfiguriert. In diesen Clients beschränkt dies auch die Anzahl der Anlagen eines Elements. Bei Outlook im Web und neuen Outlook unter Windows schränkt der geringere der beiden Grenzwerte – die Anzahl der Anlagen und die Größe aller Anlagen – die tatsächlichen Anlagen eines Elements ein.
Dateiname der Anlage 255 Zeichen Item.addFileAttachmentAsync-Methode Grenzwert für die Länge des Dateinamens einer einem Objekt hinzuzufügenden Anlage.
Anlagen-URI 2048 Zeichen Item.addFileAttachmentAsync-Methode

Item.addFileAttachmentFromBase64Async-Methode		 Grenzwert für den URI des Dateienamens, der einem Objekt als Anlage hinzugefügt werden soll.
Base64-codierte Zeichenfolge einer Anlage 27.892.122 Zeichen (ca. 25 MB) Item.addFileAttachmentFromBase64Async-Methode Grenzwert für die Base64-codierte Zeichenfolge, die als Anlage zu einem Element hinzugefügt werden soll.
Anlagen-ID 100 Zeichen Item.addItemAttachmentAsync-Methode

Item.removeAttachmentAsync-Methode		 Grenzwert für die ID der Anlage, die einem Objekt hinzugefügt oder von ihm entfernt werden soll.
Asynchrone Aufrufe 3 Aufrufe Item.addFileAttachmentAsync-Methode

Item.addItemAttachmentAsync-Methode

Item.removeAttachmentAsync-Methode

Methode Body.getTypeAsync

Methode Body.prependAsync

Methode Body.setSelectedDataAsync

Methode CustomProperties.saveAsync

Item.LoadCustomPropertiesAsync-Methode

Methode Location.getAsync

Methode Location.setAsync

Mailbox.getCallbackTokenAsync-Methode

Mailbox.getUserIdentityTokenAsync-Methode

Mailbox.makeEwsRequestAsync-Methode

Methode Recipients.addAsync

Methode Recipients.getAsync

Methode Recipients.setAsync

Methode RoamingSettings.saveAsync

Methode Subject.getAsync

Methode Subject.setAsync

Methode Time.getAsync

Methode Time.setAsync		 Für Outlook im Web und auf mobilen Geräten und neues Outlook unter Windows: Grenzwert für die Anzahl gleichzeitiger asynchroner Anrufe, da Browser nur eine begrenzte Anzahl von asynchronen Anrufen an Server zulassen.
Anfügen bei Senden 5.000 Zeichen Body.appendOnSendAsync-Methode Grenzwert für den Inhalt, der beim Senden an eine Nachricht oder einen Termintext angefügt werden soll.
Prepend-on-Send 5.000 Zeichen Body.prependOnSendAsync-Methode Begrenzung des Inhalts, der einer Nachricht oder einem Termintext beim Senden vorangestellt werden soll.

Einschränkungen der Aktivierungsregeln für kontextbezogene Outlook-Add-Ins

Wichtig

Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Als alternative Lösung können Sie Regeln für reguläre Ausdrücke in Ihrem Kontext-Add-In implementieren. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

Befolgen Sie diese Richtlinien beim Entwerfen von Aktivierungsregeln für kontextbezogene Outlook-Add-Ins.

  • Beschränken Sie die Größe des Manifests auf 256 KB. Sie können das Outlook-Add-In für ein Exchange-Postfach nicht installieren, wenn Sie diesen Grenzwert überschreiten.

    Hinweis

    Outlook-Add-In-Features, die von Aktivierungsregeln abhängen, werden nicht unterstützt, wenn das Add-In ein einheitliches App-Manifest für Microsoft 365 verwendet.

  • Legen Sie bis zu 15 Aktivierungsregeln für das Outlook-Add-Ins fest. Sie können das Add-In nicht installieren, wenn Sie diesen Grenzwert überschreiten.

  • Wenn Sie reguläre Ausdrücke in der ItemHasRegularExpressionMatch-Regel verwenden, beachten Sie die folgenden Grenzwerte und Richtlinien, die im Allgemeinen für jede Outlook-Anwendung gelten, sowie die in den Tabellen der nachfolgenden Abschnitte beschriebenen, die je nach Anwendung unterschiedlich sind.

    • Geben Sie in Aktivierungsregeln in einem Add-In nur bis zu fünf reguläre Ausdrücke an. Sie können ein Add-In nicht installieren, wenn Sie diesen Grenzwert überschreiten.
    • Geben Sie reguläre Ausdrücke so an, dass die erwarteten Ergebnisse vom getRegExMatches Methodenaufruf innerhalb der ersten 50 Übereinstimmungen zurückgegeben werden.
    • Wichtig: Text wird basierend auf Zeichenfolgen hervorgehoben, die sich aus der Übereinstimmung mit dem regulären Ausdruck ergeben. Die hervorgehobenen Vorkommen stimmen jedoch möglicherweise nicht genau mit dem überein, was sich aus tatsächlichen Assertionen regulärer Ausdrücke wie negativem Look-Ahead (?!text), Look-Behind (?<=text)und negativem Look-Behind (?<!text)ergeben sollte. Wenn Sie beispielsweise den regulären Ausdruck under(?!score) für "Like under, under score, and unterstrich" verwenden, wird die Zeichenfolge "under" für alle Vorkommen hervorgehoben, anstatt nur die ersten beiden.

Unterschiede bei der Unterstützung für reguläre Ausdrücke

In der folgenden Tabelle sind die Grenzwerte aufgeführt und die Unterschiede bei der Unterstützung für reguläre Ausdrücke in Outlook-Clients beschrieben. Die Unterstützung ist nicht abhängig von spezifischen Gerätetypen und Hauptteilen von Elementen.

Outlook im Web, auf dem neuen Windows-Client und auf mobilen Geräten Outlook unter Windows (klassisch) und auf Mac
Clients verwenden die Auswertung regulärer Ausdrücke, die Teil von JavaScript ist. Es wird vom Browser bereitgestellt und unterstützt eine Obermenge von ECMAScript 5. Clients verwenden die C++-Engine für reguläre Ausdrücke, die als Teil der Visual Studio-Standardvorlagenbibliothek bereitgestellt wird. Dieses Modul erfüllt die ECMAScript 5-Normen.
Sie sollten jeden RegEx auf jedem Outlook-Client gründlich testen. Wenn ein RegEx andere Ergebnisse zurückgibt, schreiben Sie den RegEx neu. Aufgrund der unterschiedlichen RegEx-Engines kann ein RegEx, der eine benutzerdefinierte Zeichenklasse enthält, die auf vordefinierten Zeichenklassen basiert, in Outlook unter Windows (klassisch) und auf Mac andere Ergebnisse als in Outlook im Web, auf mobilen Geräten und in neuen Outlook unter Windows zurückgeben.

Beispielsweise gleicht der regex [\s\S]{0,100} eine beliebige Zahl zwischen 0 und 100 einzelner Zeichen ab, bei denen es sich um ein Leerzeichen oder nicht um ein Leerzeichen handelt. Dieser regex gibt je nach Outlook-Client unterschiedliche Ergebnisse zurück.

Als Problemumgehung sollten Sie den RegEx in (\s\|\S){0,100}umschreiben. Dieser regex entspricht einer beliebigen Zahl von Leerzeichen oder Nicht-Leerzeichen zwischen 0 und 100.

Sie sollten jeden RegEx auf jedem Outlook-Client gründlich testen. Wenn ein RegEx andere Ergebnisse zurückgibt, schreiben Sie den RegEx neu.
Die in Outlook unter Windows (klassisch) und auf Mac unterstützten Ressourcenüberwachungs- und Registrierungseinstellungen werden in Outlook im Web, auf mobilen Geräten und in outlook unter Windows nicht unterstützt. Add-Ins mit regulären Ausdrücken, die in Outlook unter Windows (klassisch) und auf Mac eine übermäßige Auswertungszeit erfordern, sind jedoch für dasselbe Postfach auf allen Outlook-Clients deaktiviert. Standardmäßig ist die Auswertung aller regulären Ausdrücke für ein Add-In auf eine Sekunde beschränkt. Das Überschreiten dieses Grenzwerts führt zu einer erneuten Auswertung von bis zu dreimal. Über das Neubewertungslimit hinaus verhindert Outlook unter Windows (klassisch) und auf Mac, dass das Add-In für dasselbe Postfach auf einem der Outlook-Clients ausgeführt wird.

Administratoren können diese Auswertungsgrenzwerte mithilfe der OutlookActivationAlertThreshold Registrierungsschlüssel und OutlookActivationManagerRetryLimit überschreiben.

Grenzwerte für die Größe des überprüften Hauptteils des Elements

Die folgende Tabelle enthält die Grenzwerte und beschreibt die Unterschiede im Teil des Elementtexts, auf den jeder Outlook-Client einen regulären Ausdruck anwendet. Einige dieser Grenzwerte hängen von der Art des Geräts und vom Textkörper ab, wenn der reguläre Ausdruck auf den Textkörper des Elements angewendet wird.

Outlook im Web und auf dem neuen Windows-Client Outlook unter Windows (klassisch) und auf Mac Outlook auf mobilen Geräten
Gerätegrößen Alle unterstützten Geräte außer Android-Smartphones, iPads und iPhones. Jedes unterstützte Gerät. Android-Smartphones, iPads oder iPhones.
Nur-Text-Hauptteil des Elements Aktiviert das Add-In nur, wenn der Text < 500.000 Zeichen umfasst. Wendet den regulären Ausdruck auf das erste MB der Daten im Hauptteil an, nicht jedoch auf den Rest des Hauptteils, der diesen Grenzwert überschreitet. Aktiviert das Add-In nur, wenn der Text < 16.000 Zeichen umfasst.
Hauptteil des HTML-Elements Aktiviert das Add-In nur, wenn der Text < 500.000 Zeichen umfasst. Wendet den regulären Ausdruck auf die ersten 512 KB der Daten des Texts an, jedoch nicht auf den Rest des Texts, der diesen Grenzwert überschreitet. (Die tatsächliche Anzahl von Zeichen hängt von der Codierung ab, die zwischen 1 und 4 Bytes pro Zeichen reichen kann.) Wendet den regulären Ausdruck auf die ersten 64.000 Zeichen (inkl. HTML-Tag-Zeichen) an, nicht jedoch auf den Rest des Hauptteils, der diesen Grenzwert überschreitet.

Grenzwerte für die zurückgegebenen Treffer

In der folgenden Tabelle sind die Grenzwerte aufgeführt und die Unterschiede in den Übereinstimmungen beschrieben, die jeder Outlook-Client nach dem Auswerten eines regulären Ausdrucks zurückgibt. Die Unterstützung ist nicht abhängig von bestimmten Arten von Geräten, hängt jedoch möglicherweise von der Art des Hauptteils des Elements ab, wenn der reguläre Ausdruck auf den Hauptteil des Elements angewendet wird.

Outlook im Web, auf dem neuen Windows-Client und auf mobilen Geräten Outlook unter Windows (klassisch) und auf Mac
Reihenfolge der zurückgegebenen Übereinstimmungen Angenommen, die getRegExMatches Methode gibt unterschiedliche Übereinstimmungen für denselben regulären Ausdruck zurück, der auf dasselbe E-Mail-Element in Outlook unter Windows (klassisch) und auf Dem Mac angewendet wird, im Vergleich zu Outlook im Web, auf mobilen Geräten und in neuen Outlook unter Windows. Angenommen, die getRegExMatches Methode gibt unterschiedliche Übereinstimmungen für denselben regulären Ausdruck zurück, der auf dasselbe E-Mail-Element in Outlook unter Windows (klassisch) und auf Dem Mac angewendet wird, im Vergleich zu Outlook im Web, auf mobilen Geräten und in neuen Outlook unter Windows.
Nur-Text-Hauptteil des Elements getRegExMatches gibt alle Übereinstimmungen mit bis zu 3.072 (3 KB) Zeichen für maximal 50 Übereinstimmungen zurück. Die getRegExMatches -Methode gibt alle Übereinstimmungen mit bis zu 1.536 (1,5 KB) Zeichen für maximal 50 Übereinstimmungen zurück.

Hinweis: getRegExMatches Gibt keine Übereinstimmungen in einer bestimmten Reihenfolge im zurückgegebenen Array zurück. Im Allgemeinen wird davon ausgegangen, dass die Reihenfolge der Übereinstimmungen für denselben regulären Ausdruck, der auf dasselbe E-Mail-Element in Outlook unter Windows (klassisch) und auf Dem Mac angewendet wird, sich von der Reihenfolge in Outlook im Web, auf mobilen Geräten und in neuen Outlook unter Windows unterscheidet.
Hauptteil des HTML-Elements getRegExMatches gibt alle Übereinstimmungen mit bis zu 3.072 (3 KB) Zeichen für maximal 50 Übereinstimmungen zurück. getRegExMatches gibt alle Übereinstimmungen mit bis zu 3.072 (3 KB) Zeichen für maximal 50 Übereinstimmungen zurück.

Hinweis: getRegExMatches Gibt keine Übereinstimmungen in einer bestimmten Reihenfolge im zurückgegebenen Array zurück. Im Allgemeinen wird davon ausgegangen, dass die Reihenfolge der Übereinstimmungen für denselben regulären Ausdruck, der auf dasselbe E-Mail-Element in Outlook unter Windows (klassisch) und auf Dem Mac angewendet wird, sich von der Reihenfolge in Outlook im Web, auf mobilen Geräten und in neuen Outlook unter Windows unterscheidet.

Siehe auch