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

Découvrez comment et quand pour actualiser les informations de configuration de votre connexion à Exchange à l’aide de 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, découverte automatique fournit un excellent moyen pour collecter les informations que nécessaires pour pouvoir se connecter à la boîte aux lettres Exchange de l’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. Mais la découverte automatique n’est pas seulement pour la première utilisation.But Autodiscover isn't just for first time use. À l’aide de la découverte automatique sur une base régulière peut aider votre application connectée en l’activant pour répondre aux modifications dans le 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.

Cache du point de terminaison de découverte automatique et paramètres EWSCache Autodiscover endpoint and EWS settings

Tout en nous conseillé d’utiliser la découverte automatique régulièrement, vous utilisez comment régulièrement il exige certains.While we recommend that you use Autodiscover regularly, how regularly you use it requires some consideration. Idéalement, vous pouvez équilibrer répondre rapidement aux modifications dans l’environnement par rapport à la génération de trop de trafic réseau inutile.Ideally you can balance responding quickly to changes in the environment against generating too much unnecessary network traffic. Lorsque votre application reçoit une réponse positive de découverte automatique pour la première fois, vous devez enregistrer les informations suivantes afin que vous n’êtes pas obligé de Répétez 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.

Le tableau 1. Informations de cache pour les demandes de découverte automatiqueTable 1. Information to cache for Autodiscover requests

Paramètre de cacheSetting to cache Valide pour...Valid for… DétailsDetails
Point de terminaison de découverte automatiqueAutodiscover endpoint
Dans la mesure où elle fonctionne.As long as it works
Lorsque vous enregistrez le point de terminaison de découverte automatique qui a renvoyé une réponse positive, vous n’êtes pas obligé de Répétez le processus de génération d’une liste de points de terminaison de découverte automatique et à les essayer jusqu'à ce que vous obtenez une réponse positive.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ées ne gère pas le point de terminaison de découverte automatique de la mise en cache.NOTE: The EWS Managed API does not support caching the Autodiscover endpoint.
URL EWS et tous les autres paramètres sont récupérées à partir de la réponse de découverte automatiqueEWS URL and any other settings retrieved from the Autodiscover response
24 heures24 hours
En enregistrant le URL EWS et autres des paramètres liés, vous ne disposez pas 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 vos utilisateurs, un serveur peut être disponible et plus efficace.However, even if an EWS URL works for your user, a server might be available that is more optimal.

Par exemple, boîte aux lettres de l’utilisateur a peut-être été déplacée vers un nouveau serveur de boîtes aux lettres, entraînant un nouveau point de terminaison EWS par défaut.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 de l’utilisateur en envoyant une nouvelle demande de découverte automatique après que 24 heures se sont écoulées depuis votre dernière demande de découverte automatique.We recommend that you refresh your user settings by sending a new Autodiscover request after 24 hours have passed since your last Autodiscover request. Ce temps peut être ajustée pour satisfaire les besoins 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 avez mis en cache, examinons comment vous pouvez conserver ce cache vierge.Now that you have the information cached, let's examine how you can keep that cache fresh. Nous vous recommandons d’actualiser vos informations de mise en cache lorsque :We recommend that you refresh your cached information when:

Pour actualiser vos informations de mise en cache, envoyez une demande de découverte automatique pour un point de terminaison de découverte automatique mis en cache et 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 réussit, comparer le point de terminaison EWS dans la réponse avec un 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:

    • Si elles sont différentes, utilisez le nouveau point de terminaison EWS.If they are different, use the new EWS endpoint. Si vous êtes l’actualisation pour récupérer d’une erreur, réessayez la demande a échoué avec le nouveau point de terminaison.If you're refreshing to recover from an error, retry the failed request with the new endpoint.

    • Si elles sont les mêmes, continuer à utiliser le point de terminaison EWS d’origine.If they are the same, continue to use the original EWS endpoint. Si vous êtes l’actualisation pour récupérer d’une erreur, gérer 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émarrer le processus de découverte automatique à partir du début.If the request fails, start the Autodiscover process from the beginning. Une fois que vous obtenez une réponse positive, 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 continue à 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 n’obtenez pas une réponse positive, continuer à 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 êtes l’actualisation pour récupérer d’une erreur, gérer l’erreur comme il convient.If you're refreshing to recover from an error, handle the error as appropriate.

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

La figure 1. Processus d’actualisation des informations de configuration à l’aide de 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 de vos informations de configuration de mise en cache peut aider avec des erreurs, mais pas toutes.Refreshing your cached configuration information can help with some errors, but not all.

Le tableau 2. Erreurs adressées par l’actualisation de votre cacheTable 2. Errors addressed by refreshing your cache

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

Exemple : Nom d’hôte est introuvable.Example: Host name could not be found.
ServiceRemoteExceptionServiceRemoteException
Une erreur indiquant que le serveur est introuvable ou ne peut pas être joint peut être résolue en essayant de 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.

Votre point de terminaison EWS mis en cache peut-être ne plus être valide, et la découverte automatique peut être en mesure de vous pointez 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 : 503 Service indisponibleExample: 503 Service Unavailable
ServiceRemoteExceptionServiceRemoteException
Erreurs d’état HTTP peuvent se produire pour différentes raisons.HTTP status errors can happen for many different reasons.

Toutefois, il est conseillé d’essayer de 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 l’actualisation de vos informations de configuration.Most EWS error codes don't warrant refreshing your configuration information.

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

Voir aussiSee also