Limites pour l’activation et l’API JavaScript pour les compléments Outlook

Article
03/02/2024

Pour offrir une expérience satisfaisante aux utilisateurs de compléments Outlook, il convient de connaître certaines recommandations relatives à l’activation et à l’utilisation de l’API afin d’implémenter vos compléments tout en respectant ces limites. Ces instructions existent de sorte qu’un complément individuel ne peut pas nécessiter Exchange Server ou Outlook pour passer une période inhabituellement longue pour traiter ses règles d’activation ou appels à l’API JavaScript Office, ce qui affecte l’expérience utilisateur globale pour Outlook et d’autres compléments. Ces limites s’appliquent à la conception de règles d’activation dans le manifeste du complément et à l’utilisation de propriétés personnalisées, de paramètres d’itinérance, de destinataires, de requêtes et de réponses des services Web Exchange (EWS) et d’appels asynchrones.

Remarque

Vous devez également vérifier que votre complément s’exécute dans certaines limites d’utilisation des ressources d’exécution. Pour plus d’informations, voir Runtimes dans les compléments Office.

Limites relatives à l’emplacement d’activation des compléments

Pour en savoir plus sur l’emplacement où les compléments s’activent et ne s’activent pas, consultez la section « Éléments de boîte aux lettres disponibles pour les compléments » de la vue d’ensemble des compléments Outlook.

Limites pour l’API JavaScript

Chaque client Outlook applique certaines limites dans le modèle objet JavaScript, comme décrit dans le tableau suivant.

Fonctionnalité	Limite	API associées	Description
Propriétés personnalisées	2 500 caractères	Objet CustomProperties Méthode Item.loadCustomPropertiesAsync	Limite pour toutes les propriétés personnalisées d’un élément de rendez-vous ou de message. Tous les clients Outlook retournent une erreur si la taille totale de toutes les propriétés personnalisées d’un complément dépasse cette limite.
Paramètres d’itinérance	32 Ko de caractères	Objet RoamingSettings Propriété Context.roamingSettings	Limite pour tous les paramètres d’itinérance du complément. Tous les clients Outlook retournent une erreur si vos paramètres dépassent cette limite.
En-têtes Internet	256 Ko par message dans Exchange Online Limite de taille d’en-tête déterminée par les administrateurs du organization dans Exchange local	Méthode InternetHeaders.setAsync	Limite de taille totale des en-têtes qui peuvent être appliqués à un message.
Extraire des entités connues	2 000 caractères	Méthode Item.getEntities Méthode Item.getEntitiesByType Méthode Item.getFilteredEntitiesByName	Limite utilisée par le serveur Exchange Server pour extraire les entités connues sur le corps d’élément. Le serveur Exchange Server ignore les entités au-delà de cette limite. Notez que cette limite est indépendante du fait que le complément utilise ou non une `ItemHasKnownEntity` règle.
Services Web Exchange	5 Mo de caractères dans Outlook sur le web, sur Windows (à partir de la version 2303 (build 16225.10000)), sur Mac (à partir de la version 16.73 (23042601)) et dans le nouvel Outlook sur Windows (préversion) 1 Mo de caractères dans les versions antérieures d’Outlook sur Windows et sur Mac	Méthode Mailbox.makeEwsRequestAsync	Limite pour une demande ou une réponse à un `Mailbox.makeEwsRequestAsync` appel.
Multi-sélection d'éléments	100 messages	Méthode Mailbox.getSelectedItemsAsync	Nombre maximal de messages sélectionnés sur lesquels un complément Outlook peut être activé.
Recipients	Varie selon les clients Outlook	Propriété Item.requiredAttendees Propriété Item.optionalAttendees Item.to propriété Item.cc propriété Méthode Recipients.addAsync Méthode Recipients.getAsync Méthode Recipients.setAsync	Limite pour les destinataires spécifiés dans chaque propriété ou méthode. Pour en savoir plus sur les limites de destinataires pour un client Outlook spécifique, consultez la documentation de l’API pour la propriété ou la méthode .
Nom d’affichage	255 caractères	Propriété EmailAddressDetails.displayName Objet Recipients Propriété Item.requiredAttendees Propriété Item.optionalAttendees Item.to propriété Item.cc propriété	Limite pour la longueur du nom d’affichage d’un rendez-vous ou d’un message.
Définition de l’objet	255 caractères	DisplayedSubject.setAsync (préversion) Méthode Mailbox.displayNewAppointmentForm Méthode Subject.setAsync	Limite pour l’objet du nouveau formulaire de rendez-vous ou limite pour la définition de l’objet d’un rendez-vous ou d’un message.
Définition de l’emplacement	255 caractères	Méthode Location.setAsync	Limite pour la définition de l’emplacement d’un rendez-vous ou d’une demande de réunion.
Corps dans un nouveau formulaire de rendez-vous	32 Ko de caractères	Méthode Mailbox.displayNewAppointmentForm	Limite pour le corps dans un nouveau formulaire de rendez-vous.
Afficher le corps d’un élément existant	32 Ko de caractères	Méthode Mailbox.displayAppointmentForm Mailbox.displayMessageForm, méthode	Pour les Outlook sur le web, les appareils mobiles et les nouveaux Outlook sur Windows (préversion) : limite pour le corps d’un formulaire de rendez-vous ou de message existant.
Définir le corps	1 Mo de caractères	Méthode Body.prependAsync Body.setAsync Méthode Body.setSelectedDataAsync DisplayedBody.setAsync (préversion)	Limite pour la définition du corps d’un élément de rendez-vous ou de message.
Définir la signature	30 000 caractères	Méthode Body.setSignatureAsync	Limite de la longueur d’une signature dans un rendez-vous ou un message.
Nombre de pièces jointes	499 fichiers dans Outlook sur le web, sur les appareils mobiles et dans le nouvel Outlook sur Windows (préversion)	Méthode Item.addFileAttachmentAsync	Limite du nombre de fichiers pouvant être joints à un élément à envoyer. Outlook sur le web et sur les appareils mobiles, et les nouveaux outlook sur Windows (préversion) limitent généralement l’attachement jusqu’à 499 fichiers via l’interface utilisateur et `addFileAttachmentAsync` la méthode. Outlook sur Windows et sur Mac ne limitent pas spécifiquement le nombre de pièces jointes. Toutefois, tous les clients Outlook respectent la limite de taille des pièces jointes déterminée par la Exchange Server de l’utilisateur (voir la ligne « Taille des pièces jointes » dans ce tableau).
Taille des pièces jointes	En fonction du serveur Exchange Server	Méthode Item.addFileAttachmentAsync	La taille de toutes les pièces jointes d’un élément de courrier est limitée, qu’un administrateur peut configurer sur le Exchange Server de la boîte aux lettres de l’utilisateur. Pour Outlook sur Windows et sur Mac, cela limite le nombre de pièces jointes pour un élément. Pour les Outlook sur le web et sur les appareils mobiles, et la nouvelle version d’Outlook sur Windows (préversion), la plus petite des deux limites (le nombre de pièces jointes et la taille de toutes les pièces jointes) limite les pièces jointes réelles pour un élément.
Nom de fichier des pièces jointes	255 caractères	Méthode Item.addFileAttachmentAsync	Limite pour la longueur du nom de fichier d’une pièce jointe à ajouter à un élément.
URI des pièces jointes	2 048 caractères	Méthode Item.addFileAttachmentAsync Méthode Item.addFileAttachmentFromBase64Async	Limite pour l’URI du nom de fichier à ajouter en tant que pièce jointe à un élément.
Chaîne encodée en base64 d’une pièce jointe	27 892 122 caractères (environ 25 Mo)	Méthode Item.addFileAttachmentFromBase64Async	Limite de la chaîne encodée en Base64 à ajouter en tant que pièce jointe à un élément.
ID des pièces jointes	100 caractères	Méthode Item.addItemAttachmentAsync Méthode Item.removeAttachmentAsync	Limite pour la longueur de l’ID de la pièce jointe à ajouter à un élément ou à supprimer d’un élément.
Appels asynchrones	3 appels	Méthode Item.addFileAttachmentAsync Méthode Item.addItemAttachmentAsync Méthode Item.removeAttachmentAsync Méthode Body.getTypeAsync Méthode Body.prependAsync Méthode Body.setSelectedDataAsync Méthode CustomProperties.saveAsync Méthode Item.LoadCustomPropertiesAsync Méthode Location.getAsync Méthode Location.setAsync Méthode Mailbox.getCallbackTokenAsync Méthode Mailbox.getUserIdentityTokenAsync Méthode Mailbox.makeEwsRequestAsync Méthode Recipients.addAsync Méthode Recipients.getAsync Méthode Recipients.setAsync Méthode RoamingSettings.saveAsync Méthode Subject.getAsync Méthode Subject.setAsync Méthode Time.getAsync Méthode Time.setAsync	Pour Outlook sur le web et sur les appareils mobiles, et nouveau Outlook sur Windows (préversion) : limite du nombre d’appels asynchrones simultanés à tout moment, car les navigateurs n’autorisent qu’un nombre limité d’appels asynchrones aux serveurs.
Ajout lors de l’envoi	5 000 caractères	Méthode Body.appendOnSendAsync	Limite du contenu à ajouter à un corps de message ou de rendez-vous lors de l’envoi.
Prepend-on-send	5 000 caractères	Méthode Body.prependOnSendAsync	Limite du contenu à ajouter au corps d’un message ou d’un rendez-vous lors de l’envoi.

Limites des règles d’activation pour les compléments Outlook contextuels

Importante

Les compléments Outlook contextuels basés sur des entités seront mis hors service au deuxième trimestre 2024. Le travail de mise hors service de cette fonctionnalité commencera en mai et se poursuivra jusqu’à la fin du mois de juin. Après juin, les compléments contextuels ne seront plus en mesure de détecter les entités dans les éléments de courrier pour effectuer des tâches sur ces derniers. Les API suivantes seront également mises hors service.

Pour réduire les interruptions potentielles, les éléments suivants seront toujours pris en charge une fois les compléments contextuels basés sur des entités mis hors service.

Une autre implémentation du bouton Participer à une réunion , qui est activé par les compléments de réunion en ligne, est en cours de développement. Une fois la prise en charge des compléments contextuels basés sur des entités terminée, les compléments de réunion en ligne passent automatiquement à l’implémentation alternative pour activer le bouton Participer à une réunion .
Les règles d’expression régulière continueront d’être prises en charge une fois les compléments contextuels basés sur des entités mis hors service. Nous vous recommandons de mettre à jour votre complément contextuel pour utiliser des règles d’expression régulière comme solution alternative. Pour obtenir des conseils sur la façon d’implémenter ces règles, voir Utiliser des règles d’activation d’expression régulière pour afficher un complément Outlook.

Pour plus d’informations, consultez Retrait des compléments Outlook contextuels basés sur des entités.

Suivez ces instructions lors de la conception de règles d’activation pour les compléments Outlook contextuels.

Limitez la taille du manifeste à 256 Ko. Vous ne pouvez pas installer le complément Outlook pour une boîte aux lettres Exchange si vous dépassez cette limite.

Remarque

Les fonctionnalités du complément Outlook qui dépendent de règles d’activation ne sont pas prises en charge lorsque le complément utilise un manifeste unifié pour Microsoft 365.
Spécifiez jusqu’à quinze règles d’activation pour le complément. Vous ne pouvez pas installer le complément si vous dépassez cette limite.
Dans Outlook sur Windows et sur Mac, si vous utilisez une règle ItemHasKnownEntity sur le corps de l’élément sélectionné, attendez-vous à ce que la règle soit appliquée uniquement sur les 1 premiers Mo du corps et non sur le reste du corps au-dessus de cette limite. Votre complément ne s’activera pas si les correspondances existent uniquement après le premier Mo du corps. Si vous pensez qu’il s’agit d’un scénario probable, redéfinissez vos conditions d’activation.
Si vous utilisez des expressions régulières dans ItemHasKnownEntity ou des règles ItemHasRegularExpressionMatch , tenez compte des limites et des instructions suivantes qui s’appliquent généralement à toute application Outlook et celles décrites dans les tableaux des sections suivantes qui diffèrent selon l’application.
- Spécifiez jusqu’à cinq expressions régulières dans les règles d’activation d’un complément. Vous ne pouvez pas installer un complément si vous dépassez cette limite.
- Spécifiez des expressions régulières de sorte que les résultats que vous prévoyez soient retournés par l’appel getRegExMatches de méthode dans les 50 premières correspondances.
- Important : le texte est mis en surbrillance en fonction des chaînes qui résultent de la correspondance avec l’expression régulière. Toutefois, les occurrences mises en surbrillance peuvent ne pas correspondre exactement à ce qui doit résulter d’assertions d’expression régulière réelles telles que la perspective (?!text)négative, la recherche derrière (?<=text)et l’apparence négative.(?<!text) Par exemple, si vous utilisez l’expression under(?!score) régulière sur « J’aime sous, sous le score et le trait de soulignement », la chaîne « under » est mise en surbrillance pour toutes les occurrences au lieu des deux premières.

Différences dans la prise en charge des expressions régulières

Le tableau suivant répertorie les limites et décrit les différences de prise en charge des expressions régulières entre les clients Outlook. The support is independent of any specific type of device and item body.

Outlook sur le web, sur les appareils mobiles et sur le nouveau client Windows (préversion)	Outlook sur Windows et sur Mac
Les clients utilisent l’évaluation des expressions régulières qui fait partie de JavaScript. Il est fourni par le navigateur et prend en charge un sur-ensemble d’ECMAScript 5.	Les clients utilisent le moteur d’expression régulière C++ fourni dans le cadre de la bibliothèque de modèles standard Visual Studio. Ce moteur est conforme aux normes ECMAScript 5.
Vous devez tester soigneusement chaque expression régulière sur chaque client Outlook. Si une expression régulière retourne des résultats différents, réécrire l’expression régulière.	En raison des différents moteurs d’expression régulière, une expression régulière qui inclut une classe de caractères personnalisée basée sur des classes de caractères prédéfinies peut retourner des résultats différents dans Outlook sur Windows et sur Mac et dans Outlook sur le web, sur les appareils mobiles et dans le nouvel Outlook sur Windows (préversion) . Par exemple, l’expression `[\s\S]{0,100}` régulière correspond à n’importe quel nombre, compris entre 0 et 100, de caractères uniques qui est un espace blanc ou un espace non blanc. Cette expression régulière retourne des résultats différents en fonction de votre client Outlook. Pour contourner ce problème, vous devez réécrire l’expression régulière en tant que `(\s\\|\S){0,100}`. Cette expression régulière correspond à n’importe quel nombre, compris entre 0 et 100, d’espace blanc ou d’espace non blanc. Vous devez tester soigneusement chaque expression régulière sur chaque client Outlook. Si une expression régulière retourne des résultats différents, réécrire l’expression régulière.
Les paramètres de surveillance des ressources et de Registre pris en charge dans Outlook sur Windows et sur Mac ne sont pas pris en charge dans Outlook sur le web, sur les appareils mobiles et dans la nouvelle version d’Outlook sur Windows (préversion). Toutefois, les compléments avec des expressions régulières qui nécessitent un temps d’évaluation excessif dans Outlook sur Windows et sur Mac sont désactivés pour la même boîte aux lettres sur tous les clients Outlook.	Par défaut, l’évaluation de toutes les expressions régulières pour un complément est limitée à une seconde. Le dépassement de cette limite entraîne une réévaluation jusqu’à trois fois. Au-delà de la limite de réévaluation, Outlook sur Windows et sur Mac empêchent le complément de s’exécuter pour la même boîte aux lettres dans l’un des clients Outlook. Les administrateurs peuvent remplacer ces limites d’évaluation à l’aide des clés de `OutlookActivationAlertThreshold` Registre et `OutlookActivationManagerRetryLimit` .

Limites de la taille du corps d’élément évalué

Le tableau suivant répertorie les limites et décrit les différences dans la partie du corps de l’élément à laquelle chaque client Outlook applique une expression régulière. Certaines de ces limites dépendent du type d’appareil et de corps d’élément, si l’expression régulière est appliquée sur le corps d’élément.

	Outlook sur le web et sur le nouveau client Windows (préversion)	Outlook sur le client Windows classique et sur Mac	Outlook sur les appareils mobiles
Facteur de forme	Tout appareil pris en charge autre que les smartphones Android, iPad et iPhone.	Tout appareil pris en charge.	Smartphones Android, iPad ou iPhone.
Corps d’élément en texte brut	Active le complément uniquement si le corps < est de 500 000 caractères.	Applique le regex sur le premier mégaoctet des données du corps, mais pas sur le reste du corps au-delà de cette limite.	Active le complément uniquement si le corps < est de 16 000 caractères.
Corps d’élément HTML	Active le complément uniquement si le corps < est de 500 000 caractères.	Applique le regex sur les premiers 512 Ko des données du corps, mais pas sur le reste du corps au-delà de cette limite. (Le nombre réel de caractères dépend de l’encodage qui peut varier de 1 à 4 octets par caractère.)	Applique l’expression régulière sur les 64 000 premiers caractères (y compris les caractères de balises HTML), mais pas sur le reste du corps au-delà de cette limite.

Limites sur les correspondances retournées

Le tableau suivant répertorie les limites et décrit les différences dans les correspondances que chaque client Outlook retourne après l’évaluation d’une expression régulière. La prise en charge est indépendante du type spécifique d’appareil, mais peut dépendre du type de corps d’élément, si l’expression régulière est appliquée sur le corps d’élément.

	Outlook sur le web, sur les appareils mobiles et sur le nouveau client Windows (préversion)	Outlook sur le client Windows classique et sur Mac
Ordre des correspondances renvoyées	Supposons que la `getRegExMatches` méthode retourne des correspondances différentes pour la même expression régulière appliquée sur le même élément de courrier dans Outlook sur Windows et sur Mac par rapport à Outlook sur le web, sur les appareils mobiles et dans le nouvel Outlook sur Windows (préversion).	Supposons que la `getRegExMatches` méthode retourne des correspondances différentes pour la même expression régulière appliquée sur le même élément de courrier dans Outlook sur Windows et sur Mac par rapport à Outlook sur le web, sur les appareils mobiles et dans le nouvel Outlook sur Windows (préversion) .
Corps d’élément en texte brut	`getRegExMatches` retourne toutes les correspondances pouvant atteindre 3 072 caractères (3 Ko), pour un maximum de 50 correspondances.	La `getRegExMatches` méthode retourne toutes les correspondances contenant jusqu’à 1 536 caractères (1,5 Ko), pour un maximum de 50 correspondances. Remarque : `getRegExMatches` ne retourne aucune correspondance dans un ordre spécifique dans le tableau retourné. En règle générale, supposons que l’ordre des correspondances pour la même expression régulière appliquée sur le même élément de courrier dans Outlook sur Windows et sur Mac est différent de celui dans Outlook sur le web, sur les appareils mobiles et dans le nouvel Outlook sur Windows (préversion).
Corps d’élément HTML	`getRegExMatches` retourne toutes les correspondances pouvant atteindre 3 072 caractères (3 Ko), pour un maximum de 50 correspondances.	`getRegExMatches` retourne toutes les correspondances pouvant atteindre 3 072 caractères (3 Ko), pour un maximum de 50 correspondances. Remarque : `getRegExMatches` ne retourne aucune correspondance dans un ordre spécifique dans le tableau retourné. En règle générale, supposons que l’ordre des correspondances pour la même expression régulière appliquée sur le même élément de courrier dans Outlook sur Windows et sur Mac est différent de celui dans Outlook sur le web, sur les appareils mobiles et dans le nouvel Outlook sur Windows (préversion).