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

Article
08/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.
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 la nouvelle version d’Outlook sur Windows 1 Mo de caractères dans les versions antérieures d’Outlook sur Windows (classique) 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 : 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 et la nouvelle version d’Outlook sur Windows	Méthode Item.addFileAttachmentAsync	Limite du nombre de fichiers pouvant être joints à un élément à envoyer. Outlook sur le web et les nouveaux Outlook sur Windows limitent généralement l’attachement jusqu’à 499 fichiers via l’interface utilisateur et `addFileAttachmentAsync` la méthode. Outlook sur Windows (classique) 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 (voir la ligne « Taille des pièces jointes » dans ce tableau).
Taille des pièces jointes	Dépendant de Exchange Server dans Outlook classique sur Windows et Outlook sur Mac 25 Mo dans Outlook sur le web et nouveau Outlook sur Windows	Méthode Item.addFileAttachmentAsync	Limite pour la taille de toutes les pièces jointes ajoutées à un élément de courrier. Dans Outlook classique sur Windows et Outlook sur Mac, la limite est configurée par un administrateur sur le Exchange Server de la boîte aux lettres de l’utilisateur. Dans ces clients, cela limite également le nombre de pièces jointes d’un élément. Pour les Outlook sur le web et les nouveaux Outlook sur Windows, la moindre 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 d’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 : 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 sont désormais mis hors service. Comme solution alternative, implémentez des règles d’expression régulière dans votre complément contextuel. Pour obtenir des conseils sur la façon d’implémenter ces règles, consultez Compléments Outlook contextuels.

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 d’application 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.
Lorsque vous utilisez des expressions régulières dans la règle 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 le nouveau client Windows et sur les appareils mobiles	Outlook sur Windows (classique) 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 (classique) et sur Mac par rapport à Outlook sur le web, sur des appareils mobiles et dans le nouvel Outlook sur Windows. 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 (classique) 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. Toutefois, les compléments avec des expressions régulières qui nécessitent un temps d’évaluation excessif dans Outlook sur Windows (classique) 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 (classique) 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	Outlook sur 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 le nouveau client Windows et sur les appareils mobiles	Outlook sur 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 (classique) et sur Mac par rapport à Outlook sur le web, sur les appareils mobiles et dans le nouvel Outlook sur Windows.	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 (classique) et sur Mac par rapport à Outlook sur le web, sur les appareils mobiles et dans le nouvel Outlook sur Windows.
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 (classique) et sur Mac est différent de celui dans Outlook sur le web, sur les appareils mobiles et dans le nouvel Outlook sur Windows.
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 (classique) et sur Mac est différent de celui dans Outlook sur le web, sur les appareils mobiles et dans le nouvel Outlook sur Windows.

Partager via