Actualiser les informations de configuration à l’aide de la découverte automatique
Découvrez quand et comment actualiser les informations de configuration de votre connexion Exchange à l’aide de la découverte automatique.
Lorsque votre application EWS s’exécute pour la première fois, la découverte automatique vous permet de collecter les informations dont vous avez besoin pour vous connecter à la boîte aux lettres Exchange de votre utilisateur. Mais la découverte automatique n’est pas seulement destinée à une première utilisation. L’utilisation régulière de la découverte automatique peut vous aider à maintenir la connexion de votre application en lui permettant de répondre aux modifications apportées au déploiement Exchange.
Paramètres du point de terminaison de découverte automatique du cache et EWS
Bien que nous vous recommandons d’utiliser la découverte automatique régulièrement, la fréquence à laquelle vous l’utilisez nécessite une certaine considération. Dans l’idéal, vous pouvez trouver un équilibre entre répondre rapidement aux modifications de l’environnement et générer trop de trafic réseau inutile. Lorsque votre application obtient une réponse de découverte automatique réussie pour la première fois, vous devez enregistrer les informations suivantes afin de ne pas avoir à répéter le processus de découverte automatique chaque fois que vous envoyez une demande EWS.
Tableau 1. Informations à mettre en cache pour les demandes de découverte automatique
| Définition de la mise en cache | Valide pour... | Détails |
|---|---|---|
| Point de terminaison de découverte automatique |
Tant que cela fonctionne |
Lorsque vous enregistrez le point de terminaison de découverte automatique qui a retourné une réponse réussie, vous n’avez pas besoin de répéter le processus de génération d’une liste de points de terminaison de découverte automatique et de les essayer jusqu’à ce que vous obteniez une réponse réussie. REMARQUE : l’API managée EWS ne prend pas en charge la mise en cache du point de terminaison de découverte automatique. |
| URL EWS et tous les autres paramètres récupérés à partir de la réponse de découverte automatique |
Une semaine |
En enregistrant l’URL EWS et les autres paramètres associés, vous n’avez pas besoin d’envoyer une nouvelle demande de découverte automatique pour chaque demande EWS ou si votre application redémarre. Toutefois, même si une URL EWS fonctionne pour votre utilisateur, un serveur plus optimal peut être disponible. Par exemple, la boîte aux lettres de l’utilisateur peut avoir été déplacée vers un nouveau serveur de boîtes aux lettres, ce qui entraîne un nouveau point de terminaison EWS préféré. Nous vous recommandons d’actualiser vos paramètres utilisateur en envoyant une nouvelle demande de découverte automatique après une semaine écoulée depuis votre dernière demande de découverte automatique. Cette durée peut être ajustée pour répondre aux exigences de votre application. |
Actualiser les informations de configuration mises en cache
Maintenant que les informations sont mises en cache, voyons comment conserver ce cache à jour. Nous vous recommandons d’actualiser vos informations mises en cache dans les cas suivants :
La période de validité des informations expire.
Une erreur liée à la connexion se produit ET vos informations mises en cache ont été actualisées pour la dernière fois il y a plus d’une heure.
Pour actualiser vos informations mises en cache, envoyez une demande de découverte automatique à un point de terminaison de découverte automatique mis en cache, puis procédez comme suit :
Si la demande réussit, comparez le point de terminaison EWS dans la réponse avec le point de terminaison EWS mis en cache, puis procédez comme suit :
S’ils sont différents, utilisez le nouveau point de terminaison EWS. Si vous actualisez pour récupérer après une erreur, réessayez la demande ayant échoué avec le nouveau point de terminaison.
S’ils sont identiques, continuez à utiliser le point de terminaison EWS d’origine. Si vous actualisez pour récupérer après une erreur, gérez l’erreur comme il convient.
Si la demande échoue, démarrez le processus de découverte automatique à partir du début. Une fois que vous avez obtenu une réponse correcte, remplacez le point de terminaison de découverte automatique mis en cache par le point de terminaison de découverte automatique qui a réussi et continuez à utiliser le nouveau point de terminaison EWS. Si vous n’obtenez pas de réponse correcte, continuez à utiliser le point de terminaison de découverte automatique d’origine et le point de terminaison EWS. Si vous actualisez pour récupérer après une erreur, gérez l’erreur comme il convient.
La figure suivante fournit une représentation visuelle de ce processus.
Figure 1. Processus d’actualisation des informations de configuration à l’aide de la découverte automatique
Erreurs liées à la connexion
L’actualisation de vos informations de configuration mises en cache peut vous aider à résoudre certaines erreurs, mais pas toutes.
Tableau 2. Erreurs résolues par l’actualisation de votre cache
| Erreur | Implémentation de l’API managée EWS | Remarques |
|---|---|---|
| Erreurs de défaillance dns ou réseau Exemple : le nom d’hôte est introuvable. |
ServiceRemoteException |
Toute erreur indiquant que le serveur est introuvable ou inaccessible peut être résolue en essayant de découvrir automatiquement. Votre point de terminaison EWS mis en cache peut ne plus être valide et la découverte automatique peut être en mesure de vous diriger vers le nouveau serveur. |
| Erreurs d’état HTTP Exemple : Service 503 indisponible |
ServiceRemoteException |
Les erreurs d’état HTTP peuvent se produire pour de nombreuses raisons différentes. Toutefois, il est judicieux d’essayer la découverte automatique pour voir si un nouveau point de terminaison EWS est disponible pour l’utilisateur. |
| Codes d’erreur EWS Exemple : ErrorConnectionFailed |
ResponseCodeType |
La plupart des codes d’erreur EWS ne justifient pas l’actualisation de vos informations de configuration. Toutefois, les éléments suivants indiquent spécifiquement que les informations de configuration doivent être mises à jour : - ErrorConnectionFailed - ErrorMailboxMoveInProgress |