Actualiser les informations de configuration à l’aide de la découverte automatiqueRefresh configuration information by using Autodiscover

Découvrez comment et quand actualiser les informations de configuration pour votre connexion Exchange à l’aide de la découverte automatique.Learn how and when to refresh configuration information for your Exchange connection by using Autodiscover.

Lorsque votre application EWS s’exécute pour la première fois, la découverte automatique vous offre un excellent moyen de collecter les informations dont vous avez besoin pour vous connecter à la boîte aux lettres Exchange de votre utilisateur.When your EWS application runs for the first time, Autodiscover provides a great way for you to collect the information you need in order to connect to your user's Exchange mailbox. Toutefois, la découverte automatique n’est pas destinée à être utilisée pour la première fois.But Autodiscover isn't just for first time use. L’utilisation régulière de la découverte automatique permet de maintenir votre application connectée en lui permettant de répondre aux modifications apportées au déploiement d’Exchange.Using Autodiscover on a regular basis can help keep your application connected by enabling it to respond to changes in the Exchange deployment.

Mettre en cache le point de terminaison de découverte automatique et les paramètres EWSCache Autodiscover endpoint and EWS settings

Bien que nous vous recommandons d’utiliser la découverte automatique régulièrement, l’utilisation régulière de celle-ci nécessite une attention particulière.While we recommend that you use Autodiscover regularly, how regularly you use it requires some consideration. Idéalement, vous pouvez équilibrer le temps de réponse aux modifications apportées à l’environnement contre la génération d’un trafic réseau superflu.Ideally you can balance responding quickly to changes in the environment against generating too much unnecessary network traffic. Lorsque votre application obtient une réponse de découverte automatique 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.When your application gets a successful Autodiscover response for the first time, you should save the following information so that you do not have to repeat the Autodiscover process every time you send an EWS request.

Tableau 1. Informations à mettre en cache pour les demandes de découverte automatiqueTable 1. Information to cache for Autodiscover requests

Définition à mettre en cacheSetting to cache Valide pour...Valid for… DétailsDetails
Point de terminaison de découverte automatiqueAutodiscover endpoint
Tant qu’elle fonctionneAs long as it works
Lorsque vous enregistrez le point de terminaison de découverte automatique qui a renvoyé une réponse réussie, il n’est pas nécessaire 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.When you save the Autodiscover endpoint that returned a successful response, you do not have to repeat the process of generating a list of Autodiscover endpoints and trying them until you get a successful response.

Remarque: l’API managée EWS ne prend pas en charge la mise en cache du point de terminaison de découverte automatique.NOTE: The EWS Managed API does not support caching the Autodiscover endpoint.
URL EWS et tous les autres paramètres récupérés à partir de la réponse de découverte automatiqueEWS URL and any other settings retrieved from the Autodiscover response
Une semaineOne week
En enregistrant l’URL EWS et d’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.By saving the EWS URL and other related settings, you do not have to send a new Autodiscover request for each EWS request or if your application restarts. Toutefois, même si une URL EWS fonctionne pour votre utilisateur, un serveur peut être disponible plus ou moins.However, even if an EWS URL works for your user, a server might be available that is more optimal.

Par exemple, la boîte aux lettres de l’utilisateur a peut-être été déplacée vers un nouveau serveur de boîtes aux lettres, ce qui se traduit par un nouveau point de terminaison EWS.For example, the user's mailbox might have moved to a new mailbox server, resulting in a new preferred EWS endpoint. Nous vous recommandons d’actualiser vos paramètres utilisateur en envoyant une nouvelle demande de découverte automatique après une semaine passée depuis votre dernière demande de découverte automatique.We recommend that you refresh your user settings by sending a new Autodiscover request after one week has passed since your last Autodiscover request. Cette durée peut être ajustée pour répondre aux exigences de votre application.This time can be adjusted to meet the requirements of your application.

Actualiser les informations de configuration mises en cacheRefresh cached configuration information

Maintenant que vous disposez des informations mises en cache, examinons comment vous pouvez conserver ce cache à jour.Now that you have the information cached, let's examine how you can keep that cache fresh. Nous vous recommandons d’actualiser vos informations mises en cache lorsque :We recommend that you refresh your cached information when:

  • La période de validité de l’information expire.The information's validity period expires.

  • Une erreur liée à la connexion se produit et les informations mises en cache ont été actualisées pour la dernière fois il y a une heure.A Connection-related error occurs AND your cached information was last refreshed over an hour ago.

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 :To refresh your cached information, send an Autodiscover request to a cached Autodiscover endpoint, and do the following:

  • Si la demande aboutit, comparez le point de terminaison EWS dans la réponse au point de terminaison EWS mis en cache et procédez comme suit :If the request succeeds, compare the EWS endpoint in the response with the cached EWS endpoint, and do the following:

    • S’ils sont différents, utilisez le nouveau point de terminaison EWS.If they are different, use the new EWS endpoint. Si vous effectuez une actualisation afin de récupérer suite à une erreur, renouvelez la demande ayant échoué avec le nouveau point de terminaison.If you're refreshing to recover from an error, retry the failed request with the new endpoint.

    • S’ils sont identiques, continuez à utiliser le point de terminaison EWS d’origine.If they are the same, continue to use the original EWS endpoint. Si vous effectuez une actualisation afin de récupérer suite à une erreur, gérez l’erreur comme il convient.If you're refreshing to recover from an error, handle the error as appropriate.

  • En cas d’échec de la demande, démarrez le processus de découverte automatique depuis le début.If the request fails, start the Autodiscover process from the beginning. Une fois que vous obtenez une réponse réussie, 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 continuer à utiliser le nouveau point de terminaison EWS.After you get a successful response, replace the cached Autodiscover endpoint with the Autodiscover endpoint that succeeded and continue to use the new EWS endpoint. Si vous ne recevez pas de réponse, continuez à utiliser le point de terminaison de découverte automatique d’origine et le point de terminaison EWS.If you do not get a successful response, continue to use the original Autodiscover endpoint and EWS endpoint. Si vous effectuez une actualisation afin de récupérer suite à une erreur, gérez l’erreur comme il convient.If you're refreshing to recover from an error, handle the error as appropriate.

La figure suivante fournit une représentation visuelle de ce processus.The following figure provides a visual representation of this process.

Figure 1. Processus d’actualisation des informations de configuration à l’aide de la découverte automatiqueFigure 1. Process for refreshing configuration information by using Autodiscover

Diagramme schématique indiquant comment la découverte automatique actualise les informations de configuration.

L’actualisation des informations de configuration mises en cache peut vous aider à résoudre certaines erreurs, mais pas toutes.Refreshing your cached configuration information can help with some errors, but not all.

Tableau 2. Erreurs à résoudre en actualisant votre cacheTable 2. Errors addressed by refreshing your cache

ErrorError Implémentation de l’API managée EWSEWS Managed API implementation RemarquesNotes
Erreurs de défaillance du réseau ou du DNSDNS or network failure errors

Exemple : le nom d’hôte est introuvable.Example: Host name could not be found.
ServiceRemoteExceptionServiceRemoteException
Toute erreur indiquant que le serveur est introuvable ou inaccessible peut être résolue en tentant la découverte automatique.Any error that indicates that the server could not be found or could not be reached might be resolved by trying Autodiscover.

Le point de terminaison EWS mis en cache n’est peut-être plus valide et la découverte automatique peut vous faire pointer vers le nouveau serveur.Your cached EWS endpoint might no longer be valid, and Autodiscover might be able to point you to the new server.
Erreurs d’état HTTPHTTP status errors

Exemple : service 503 indisponibleExample: 503 Service Unavailable
ServiceRemoteExceptionServiceRemoteException
Des erreurs d’état HTTP peuvent se produire pour de nombreuses raisons.HTTP status errors can happen for many different reasons.

Toutefois, il est recommandé d’essayer la découverte automatique pour voir si un nouveau point de terminaison EWS est disponible pour l’utilisateur.However, it's a good idea to try Autodiscover to see if a new EWS endpoint is available for the user.
Codes d’erreur EWSEWS error codes

Exemple : ErrorConnectionFailedExample: ErrorConnectionFailed
ResponseCodeTypeResponseCodeType
La plupart des codes d’erreur EWS ne justifient pas l’actualisation de vos informations de configuration.Most EWS error codes don't warrant refreshing your configuration information.

Toutefois, les éléments suivants indiquent spécifiquement que les informations de configuration doivent être mises à jour :However, the following specifically indicate that the configuration information needs to be updated:
- ErrorConnectionFailed- ErrorConnectionFailed
- ErrorMailboxMoveInProgress- ErrorMailboxMoveInProgress

Voir aussiSee also