Versions de schéma EWS dans ExchangeEWS schema versions in Exchange

Découvrez le EWS schéma et la conception de votre application pour fonctionner avec elle, ainsi que les fonctionnalités disponibles avec chaque version de schéma et comment le schéma est lié à la version du service Exchange.Learn about the EWS schema and how to design your application to work with it, as well as the features that are available with each schema version, and how the schema relates to the Exchange service version.

Le schéma EWS définit les structures de données pouvant être envoyés à et renvoyées par Exchange.The EWS schema defines the data structures that can be sent to and returned by Exchange. Chaque nouvelle version d’Exchange qui contient une modification significative de fonctionnalité EWS contiendra un nouveau schéma.Each new version of Exchange that contains a significant change to EWS functionality will contain a new schema. EWS et le schéma EWS sont en arrière et dans certains cas, une compatibilité ascendante - applications conçues avec des versions antérieures de EWS fonctionne, dans la plupart des cas, avec les versions ultérieures de EWS, et les applications qui ciblent les versions ultérieures de EWS ne fonctionneront pas si les mêmes la fonctionnalité a été incluse dans une version antérieure.EWS and the EWS schema are both backward, and in some cases, forward compatible - applications designed against earlier versions of EWS will work, in most cases, with later versions of EWS, and applications that target later versions of EWS will work if the same functionality was included in an earlier version. Cet article vous aideront à comprendre le rôle du schéma EWS, le fonctionnement de la gestion des versions de schéma, la relation entre la version du schéma et la version du service et la conception de votre application pour fonctionner avec le schéma EWS.This article will help you understand the role of the EWS schema, how schema versioning works, the relationship between the schema version and the service version, and how to design your application to work with the EWS schema.

Rôle du schéma EWSRole of the EWS schema

Le schéma EWS effectue les opérations suivantes :The EWS schema does the following:

  • Définit le jeu de fonctionnalités qui est disponible pour un client.Defines the feature set that is available to a client. Un client peut obtenir la liste des versions prises en charge de schéma à l’aide du service de découverte automatiquede SOAP.A client can get the list of the supported schema versions by using the SOAP Autodiscover service. Le client peut alors déterminer les fonctionnalités accessibles, étant donné que chaque version de schéma représente un ensemble de fonctionnalités EWS.The client can then determine which features it can access, because each schema version represents an EWS feature set. Chaque nouveau schéma publié pour EWS contient des entités de schéma à partir de la version précédente ainsi que les définitions de schéma pour les nouvelles fonctionnalités.Each new schema released for EWS contains of the schema entities from the previous version plus the schema definitions for any new functionality. De cette manière, EWS prend en charge les applications qui ciblent une version antérieure de EWS.This way, EWS supports applications that target an earlier version of EWS.

  • Fournit une description générale du marché API.Provides a general description of the API contract. Vous pouvez utiliser ce contrat pour déterminer les structures de données pouvant être envoyés à et reçus à partir d’Exchange.You can use this contract to determine the data structures that can be sent to and received from Exchange.

  • Fournit un mécanisme de contrôle de version pour l’envoi de demandes.Provides a versioning mechanism for sending requests. Le serveur Exchange contient toutes les versions prises en charge EWS schéma dans le répertoire virtuel.The Exchange server contains all the supported EWS schema versions in its virtual directory.

Conception de votre application avec la version de schéma à l’espritDesigning your application with schema version in mind

Gardez les points suivants à l’esprit lorsque vous concevez votre application pour fonctionner avec différentes versions du schéma EWS :Keep the following points in mind as you design your application to work with different versions of the EWS schema:

  • Activer/désactiver la fonctionnalité en fonction de la version du schéma.Turn on/off functionality based on the schema version. Vous souhaiterez mapper les fonctionnalités du client pour la version du schéma et, dans certains cas, la version du service.You'll want to map client functionality to the schema version and, in some cases, to the version of the service. L’exemple suivant renverra qu'une PropertySet en fonction de la version du schéma et du service.The following example will return a PropertySet based on the version of the schema and service.

    private static PropertySet InitPropertySetByVersion(ExchangeService service)
    {
        PropertySet props;
        // The schema version to target to access the NormalizedBody property 
        // is Exchange2013 or later. The server version to target to access the 
        // NormalizedBody property on an email is 15 or later, which 
        // equates to Exchange 2013.
        if (service.RequestedServerVersion >= ExchangeVersion.Exchange2013 &&
            service.ServerInfo.MajorVersion >= 15)
        {
            props = new PropertySet(EmailMessageSchema.NormalizedBody);
        }
        else
        {
            props = new PropertySet(EmailMessageSchema.Body);
        }
        return props;
    }
    
  • Version vos requêtes avec la version la plus ancienne du schéma EWS qui prend en charge les fonctionnalités que vous souhaitez utiliser.Version your requests with the earliest version of the EWS schema that supports the functionality you want to use. Cela permettra votre client applicable à un plus grand nombre de serveurs Exchange potentiels.This will make your client applicable to a larger number of potential Exchange servers. Il est moins importante si vous développez une application métier de cibler uniquement les serveurs de votre organisation, mais il est très important si vous créez une application pour une audience plus large de Exchange.This is less important if you're developing a line-of-business application to target your organization's servers only, but is very important if you're building an application for a wider Exchange audience.

Fonctionnalités par version de schémaFeatures by schema version

Les versions de schéma qui sont disponibles pour un client sont identifiées dans le type simple ExchangeVersionType situé dans le schéma types.xsd.The schema versions that are available to a client are identified in the ExchangeVersionType simple type located in the types.xsd schema. ExchangeVersionType est implémentée par l’élément RequestServerVersion .The ExchangeVersionType is implemented by the RequestServerVersion element. L’élément RequestServerVersion est envoyé dans toutes les demandes EWS pour indiquer au serveur de la version du schéma les cibles de client.The RequestServerVersion element is sent in all EWS requests to indicate to the server which version of the schema the client targets. À son tour identifie le jeu de fonctionnalités qui est disponible pour le client.This in turn identifies the feature set that is available to the client.

Tableau 1 : Les fonctionnalités EWS par version de produit et de schémaTable 1: EWS features by product and schema version

Version du produitProduct version Version de schéma associéAssociated schema version FonctionnalitésFeatures
Exchange OnlineExchange Online La dernière version de schéma.The latest schema version. Inclut toutes les fonctionnalités dans la version actuelle d’Exchange, en plus de ces nouvelles fonctionnalités sont ajoutées pour les clients en ligne.Includes all the features in the current version of Exchange in addition to any new features that are added for online clients.
Exchange 2013 SP1Exchange 2013 SP1 Exchange2013_SP1Exchange2013_SP1 Inclut toutes les fonctionnalités d’Exchange 2013.Includes all the features in Exchange 2013.

Les fonctionnalités suivantes ont été introduites dans Exchange 2013 SP1 :The following features were introduced in Exchange 2013 SP1:
Exchange 2013Exchange 2013 Exchange2013Exchange2013 Inclut toutes les fonctionnalités introduites dans Exchange 2007 et Exchange 2010.Includes all features introduced in Exchange 2007 and Exchange 2010.

Les fonctionnalités suivantes ont été introduites dans Exchange 2013 :The following features were introduced in Exchange 2013:
  • L’archivageArchiving
  • eDiscoveryeDiscovery
  • PersonnagePersonas
  • Stratégies de rétentionRetention policies
  • Magasin de contacts unifiéUnified Contact Store
  • Photos de l’utilisateurUser photos
Exchange 2010 SP2Exchange 2010 SP2 Exchange2010_SP2Exchange2010_SP2 Inclut toutes les fonctionnalités introduites dans Exchange 2010 SP1.Includes all the features introduced in Exchange 2010 SP1.

Les fonctionnalités suivantes ont été introduites dans Exchange 2010 SP2 :The following features were introduced in Exchange 2010 SP2:
  • Obtenir l’Expiration du mot de passeGet Password Expiration
  • Précision DateTimeDateTime precision
  • Identificateurs de propriété mis à jour pour les contactsUpdated property identifiers for contacts
  • Nouveaux scénarios de l’emprunt d’identitéNew impersonation scenarios
Exchange 2010 SP1Exchange 2010 SP1 Exchange2010_SP1Exchange2010_SP1 Inclut toutes les fonctionnalités introduites dans Exchange 2010.Includes all the features introduced in Exchange 2010.

Les fonctionnalités suivantes ont été introduites dans Exchange 2010 SP1 :The following features were introduced in Exchange 2010 SP1:
  • Créer, récupérer et modifier des règles de boîte de réceptionCreate, retrieve and modify Inbox rules
  • Accès par programme aux boîtes aux lettres d’ArchiveProgrammatic access to Archive Mailbox
  • Actions de conversationsConversations actions
  • Le parcours des notifications de pare-feuFirewall traversing notifications
  • Fonctionnalités d’administration amélioréeImproved administration features
  • Amélioration de la prise en charge de la version mixteImproved mixed version support
  • Limitation de la prise en charge de la protectionThrottling protection support
  • Contrôle d’accès application EWSControl of application access to EWS
  • Prise en charge de l’authentification de certificat clientClient certificate authentication support
Exchange 2010Exchange 2010 Exchange2010Exchange2010 Inclut toutes les fonctionnalités introduites dans Exchange 2007 SP1.Includes all features introduced in Exchange 2007 SP1.

Les fonctionnalités suivantes ont été introduites dans la version initiale d’Exchange 2010 :The following features were introduced in the initial release version of Exchange 2010:
  • Liste de Distribution privée complèteFull Private Distribution List
  • Objets de Configuration utilisateurUser Configuration Objects
  • Dossier des éléments associésFolder Associated Items
  • Suivi des messagesMessage tracking
  • Messagerie unifiéeUnified Messaging
  • Découverte automatique SOAPSOAP Autodiscover
  • Prise en charge améliorée de fuseau horaireEnhanced Time Zone support
  • Informations de disponibilité de ressources de salleRoom resource availability information
  • Recherche indexésIndexed search
  • Accès benneDumpster access
  • Partage des informationsMailTips information
Exchange 2007 SP1Exchange 2007 SP1 Exchange2007_SP1Exchange2007_SP1 Inclut toutes les fonctionnalités introduites dans Exchange 2007.Includes all the features introduced in Exchange 2007.

Les fonctionnalités suivantes ont été introduites dans Exchange 2007 SP1 :The following features were introduced in Exchange 2007 SP1:
  • Gestion des déléguésDelegate management
  • Autorisations de dossierFolder permissions
  • Dossiers publicsPublic folders
  • Publier des élémentsPost items
  • Conversion de l’IDID conversion
Exchange 2007Exchange 2007 Exchange2007Exchange2007 Les fonctionnalités suivantes ont été introduites dans la version initiale d’Exchange 2007 :The following features were introduced in the initial release version of Exchange 2007:
  • Accès total aux éléments, dossiers et pièces jointes (créer, obtenir, mettre à jour, supprimer)Full access to items, folders, and attachments (Create, Get, Update, Delete)
  • DisponibilitéAvailability
  • En dehors des paramètres OfficeOut of Office settings
  • NotificationsNotifications
  • SynchronisationSynchronization
  • Résolution de nomsName resolution
  • Extension de la distribution (liste)Distribution list (DL) expansion
  • SearchSearch

Relation entre le schéma EWS et la version du serviceRelationship between the EWS schema and the service version

La version du schéma EWS est liée à la version du service EWS que le serveur est en cours d’exécution.The EWS schema version is related to the version of the EWS service that the server is running. Le modèle d’affectation de noms pour le schéma EWS est lié aux versions d’Exchange sur site.The naming pattern for the EWS schema is related to the on-premises versions of Exchange. Par exemple, la version initiale d’Exchange 2013 a une version de service de 15.00.0516.032 et le nom de schéma Exchange2013.For example, the initial release of Exchange 2013 has a service version of 15.00.0516.032 and the schema name Exchange2013. Étant donné que le schéma a été mis à jour pour Exchange 2013, Exchange 2013 et Exchange Online avec une version de service de 15.00.0516.032 et versions ultérieures ont le même nom de version du schéma le plus récent.Because the schema was updated for Exchange 2013, both Exchange 2013 and Exchange Online with a service version of 15.00.0516.032 and later have the same version name for the latest schema. Dans les versions antérieures d’Exchange, le schéma EWS n’a été pas mis à jour avec les mises à jour cumulatives (anciennement appelé cumulatifs).In earlier versions of Exchange, the EWS schema was not updated with cumulative updates (formerly called rollups). Mais Exchange est plus souvent mis à jour pour prendre en charge Exchange Online, mises à jour cumulatives contiennent désormais des mises à jour de schéma pour EWS.But because Exchange is updated more frequently to support Exchange Online, cumulative updates now contain schema updates for EWS. Les noms de fichier de schéma et le nom de version de schéma associé, sont uniquement mis à jour avec les service packs ou les versions majeures de Exchange sur site.The schema file names, and the associated schema version name, are only updated with service packs or major releases of Exchange on-premises.

Pendant que le schéma EWS définit le contrat, dans certains scénarios, la version du service est le seul moyen pour un client déterminer la façon dont il est supposé pour interagir avec le service.While the EWS schema defines the contract, in some scenarios, the service version is the only way for a client to determine how it is supposed to interact with the service. Changements de comportement de service qui ne figurent pas dans le schéma ne peuvent pas être déterminées par la version de service renvoyée dans toutes les réponses EWS.Service behavior changes that aren't reflected in the schema can only be determined by the service version returned in all EWS responses. Par exemple, lorsque les dossiers publics ont été repensées dans Exchange 2013, les opérations qui permettent de déplacer et copier des dossiers publics est modifiées.For example, when public folders were redesigned in Exchange 2013, the operations that are used to move and copy public folders changed. Si vous avez créé un client pour copier les dossiers publics dans Exchange 2010, vous devez mettre à jour pour les différentes opérations permet d’obtenir le même résultat dans Exchange 2013.If you designed a client to copy public folders in Exchange 2010, you would need to update it to use different operations to get the same result in Exchange 2013.

Comment le schéma EWS est mis à jourHow the EWS schema is updated

Les serveurs exécutant des versions d’Exchange commençant par Exchange 2007 incluent le schéma EWS dans le répertoire virtuel qui héberge le service EWS.Exchange servers running versions of Exchange starting with Exchange 2007 include the EWS schema in the virtual directory that hosts the EWS service. La version du schéma actuel est toujours représentée par les fichiers types.xsd et messages.xsd.The current schema version is always represented by the types.xsd and messages.xsd files. La figure 1 illustre la façon dont le schéma messages.xsd est redirigé lorsqu’une nouvelle version du schéma est développée.Figure 1 shows how the messages.xsd schema is forked when a new version of the schema is developed. Avant d’ajouter de nouvelles fonctionnalités, une copie du schéma messages.xsd d’origine est incluse et renommée pour représenter la version précédente du schéma.Before new functionality is added, a copy of the original messages.xsd schema is included and renamed to represent the previous version of the schema. Le fichier messages.xsd est alors mis à jour avec la description de service pour la nouvelle version.The messages.xsd file is then updated with the service description for the new version.

La figure 1. Comment le schéma EWS est mis à jourFigure 1. How the EWS schema is updated

Illustration de la mise à jour du schéma EWS. La dernière version du schéma est divisée et renommée afin de représenter la version précédente et le dernier nom de fichier représente la version actuelle.

Avant le schéma EWS est mis à jour d’une nouvelle version, la version actuelle du schéma est redirigée et renommées à l’aide de la convention suivante :Before the EWS schema is updated for a new version, the current version of the schema is forked and renamed using the following convention:

<schemaname>-<majorserverversion><servicepack>.xsd

Le nom du fichier d’origine puis représente le schéma le plus récent.The original file name then represents the latest schema. Toutes les nouvelles fonctionnalités sont ajoutées au schéma le plus récent, à l’exception des mises à jour et des correctifs pour les versions antérieures du schéma.All new features are added to the latest schema, with the exception of updates and fixes to the earlier versions of the schema.

Voir aussiSee also