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

Artikel
03/05/2024

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.
Extrahieren bekannter Entitäten	Zeichenanzahl: 2.000	Item.getEntities-Methode Item.getEntitiesByType-Methode Item.getFilteredEntitiesByName-Methode	Grenzwert für Exchange Server, um bekannte Entitäten im Hauptteil zu extrahieren. Exchange Server ignoriert über diesen Grenzwert hinausgehende Entitäten. Beachten Sie, dass dieser Grenzwert unabhängig davon ist, ob das Add-In eine `ItemHasKnownEntity` Regel verwendet.
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 (Vorschau) 1 MB Zeichen in früheren Versionen von Outlook unter Windows und mac	Mailbox.makeEwsRequestAsync-Methode	Grenzwert für eine Anforderung oder Antwort auf einen `Mailbox.makeEwsRequestAsync` Anruf.
Mehrfachauswahl des Elements	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 (Vorschau): 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, auf mobilen Geräten und im neuen Outlook unter Windows (Vorschau)	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 auf mobilen Geräten sowie das neue Outlook unter Windows (Vorschau) schränken im Allgemeinen das Anfügen von bis zu 499 Dateien über die Benutzeroberfläche und `addFileAttachmentAsync` Methode ein. Outlook unter Windows 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, die durch die Exchange Server des Benutzers festgelegt wird (siehe Zeile "Größe von Anlagen" in dieser Tabelle).
Anlagengröße	Abhängig von Exchange Server	Item.addFileAttachmentAsync-Methode	Es gibt eine Beschränkung für die Größe aller Anlagen für ein E-Mail-Element, die ein Administrator für die Exchange Server des Postfachs des Benutzers konfigurieren kann. Für Outlook unter Windows und auf Mac beschränkt dies die Anzahl der Anlagen für ein Element. Für Outlook im Web und auf mobilen Geräten sowie für outlook unter Windows (Vorschau) schränkt der geringere der beiden Grenzwerte – die Anzahl der Anlagen und die Größe aller Anlagen – die tatsächlichen Anlagen für ein Element 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 (Vorschau): Begrenzung der Anzahl gleichzeitiger asynchroner Anrufe zu einem beliebigen Zeitpunkt, 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 im 2. Quartal 2024 eingestellt. Die Arbeiten zur Einstellung dieses Features beginnen im Mai und werden bis Ende Juni fortgesetzt. Nach Juni können Kontext-Add-Ins keine Entitäten mehr in E-Mail-Elementen erkennen, um Aufgaben für sie auszuführen. Die folgenden APIs werden ebenfalls eingestellt.

Um potenzielle Unterbrechungen zu minimieren, werden die folgenden Elemente weiterhin unterstützt, nachdem entitätsbasierte Kontext-Add-Ins eingestellt wurden.

Eine alternative Implementierung der Schaltfläche " An Besprechung teilnehmen ", die von Onlinebesprechungs-Add-Ins aktiviert wird, wird entwickelt. Sobald die Unterstützung für entitätsbasierte Kontext-Add-Ins endet, werden Onlinebesprechungs-Add-Ins automatisch zur alternativen Implementierung übergehen, um die Schaltfläche An Besprechung teilnehmen zu aktivieren.
Regeln für reguläre Ausdrücke werden weiterhin unterstützt, nachdem entitätsbasierte Kontext-Add-Ins eingestellt wurden. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Anleitungen zum Implementieren dieser Regeln finden Sie unter Verwenden von Aktivierungsregeln für reguläre Ausdrücke zum Anzeigen eines Outlook-Add-Ins.

Weitere Informationen finden Sie unter Außerbetriebnahme entitätsbasierter kontextbezogener 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ängig sind, werden nicht unterstützt, wenn das Add-In ein einheitliches 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 in Outlook unter Windows und auf Mac eine ItemHasKnownEntity-Regel für den Textkörper des ausgewählten Elements verwenden, erwarten Sie, dass die Regel nur auf die ersten 1 MB des Texts angewendet wird und nicht auf den Rest des Textkörpers, der diesen Grenzwert überschreitet. Ihr Add-In wird nicht aktiviert, wenn Übereinstimmungen erst nach dem ersten MB des Texts vorhanden sind. Wenn Sie davon ausgehen, dass dies ein wahrscheinliches Szenario ist, gestalten Sie Ihre Bedingungen für die Aktivierung um.
Wenn Sie reguläre Ausdrücke in ItemHasKnownEntity oder ItemHasRegularExpressionMatch-Regeln 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 mobilen Geräten und auf einem neuen Windows-Client (Vorschau)	Outlook unter Windows 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 und auf Mac andere Ergebnisse zurückgeben als in Outlook im Web, auf mobilen Geräten und in neuen Outlook unter Windows (Vorschau). 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 und macos unterstützten Ressourcenüberwachungs- und Registrierungseinstellungen werden in Outlook im Web, auf mobilen Geräten und in outlook unter Windows (Vorschau) nicht unterstützt. Add-Ins mit regulären Ausdrücken, die in Outlook unter Windows 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 und auf Mac, dass das Add-In für dasselbe Postfach in 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 einem neuen Windows-Client (Vorschau)	Outlook auf dem klassischen Windows-Client und auf dem 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 mobilen Geräten und auf einem neuen Windows-Client (Vorschau)	Outlook auf dem klassischen Windows-Client und auf dem 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 und auf Dem Mac angewendet wird, im Vergleich zu Outlook im Web, auf mobilen Geräten und in neuen Outlook unter Windows (Vorschau).	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 und auf Dem Mac angewendet wird, im Vergleich zu Outlook im Web, auf mobilen Geräten und in neuen Outlook unter Windows (Vorschau).
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 sich die Reihenfolge der Übereinstimmungen für denselben regulären Ausdruck, der auf dasselbe E-Mail-Element in Outlook unter Windows und auf Dem Mac angewendet wird, von der Reihenfolge in Outlook im Web, auf mobilen Geräten und in neuen Outlook unter Windows (Vorschau) 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 sich die Reihenfolge der Übereinstimmungen für denselben regulären Ausdruck, der auf dasselbe E-Mail-Element in Outlook unter Windows und auf Dem Mac angewendet wird, von der Reihenfolge in Outlook im Web, auf mobilen Geräten und in neuen Outlook unter Windows (Vorschau) unterscheidet.