Dossiers et éléments dans EWS dans ExchangeFolders and items in EWS in Exchange

Découvrez les dossiers et les éléments de boîte aux lettres, ainsi que la façon dont votre API managée EWS ou votre client EWS les désigne.Learn about folders and mailbox items and how your EWS Managed API or EWS client represents them.

Les dossiers sont l’élément d’organisation d’une boîte aux lettres Exchange.Folders are the organizing element of an Exchange mailbox. Les dossiers peuvent contenir des éléments de boîte aux lettres, tels que des messages électroniques, des contacts, des rendez-vous, des réunions et des tâches, ou ils peuvent contenir d’autres dossiers.Folders can contain mailbox items, such as email messages, contacts, appointments, meetings, and tasks, or they can contain other folders. Exchange comprend différents types de dossiers, mais les types de dossiers sont similaires.Exchange includes different types of folders, but the folder types are similar to each other. La principale différence entre elles est le type d’élément qu’elles contiennent.The main difference between them is the type of item they contain.

Toutefois, les éléments ont des types uniques.Items, however, have unique types. Chaque type d’élément dispose d’un ensemble de propriétés ou de schéma différent pour le définir.Each item type has a different set of properties or schema to define it. Dans cet article, nous allons étudier les types de dossiers et d’éléments disponibles, ainsi que les différences qui existent entre eux.In this article, we'll discuss the types of folders and items that are available and the differences between them.

FoldersFolders

Les dossiers dérivent tous de la même classe de base ou du même type de base, de la classe de dossier dans l’API managée EWS ou du type de dossier dans EWS.Folders all derive from the same base class or base type, the Folder class in the EWS Managed API, or the Folder type in EWS. La figure suivante illustre les classes de l’API managée EWS et les types EWS.The following figure shows the EWS Managed API classes and EWS types.

Figure 1. Classes de dossier d’API managée EWS et types de dossiers EWSFigure 1. EWS Managed API folder classes and EWS folder types

Illustration présentant les classes qui dérivent de la classe de dossier de l’API managée EWS, ainsi que les types qui dérivent du type de dossier EWS, qui sont nommés CalendarFolder, ContactsFolder, SearchFolder et TasksFolder.

La principale différence entre les classes de dossiers et les types de dossiers réside dans le fait que vous ne pouvez créer qu’un certain type d’élément dans chaque type de dossier.The primary difference between each of the folder classes and folder types is that you can only create a certain type of item in each type of folder. Une autre différence réside dans la façon dont le client affiche les informations dans un dossier.One other difference is in how the client displays information in a folder. Par exemple, Exchange vous permet de créer des rendez-vous dans le dossier calendrier.For example, Exchange allows you to create appointments in the Calendar folder. Vous pouvez déplacer d’autres types d’éléments dans le dossier calendrier après les avoir créés, mais Outlook ne les affiche pas.You can move other types of items into the Calendar folder after you create them, but Outlook won't display them. Outlook affiche uniquement les éléments de calendrier tels que les rendez-vous et les réunions dans le dossier calendrier, même si un autre type d’élément existe dans le dossier.Outlook only displays calendar items such as appointments and meetings in the Calendar folder, even if another type of item exists in the folder.

Tableau 1. Classes de dossier d’API managée EWS et types de dossiers EWSTable 1. EWS Managed API folder classes and EWS folder types

Classe d’API managée EWSEWS Managed API class Type EWSEWS type Valeur FolderClassFolderClass value ContainsContains RemarquesNotes
FolderFolder
FolderFolder
Page. NoteIPF.Note
Messages électroniques ou dossiers.Email messages or folders.
Il s’agit de la classe ou du type de dossier générique pour les dossiers WellKnownFolderName d’API managée EWS et les dossiers EWS DistinguishedFolderId suivants :This is the generic folder class or type for the following EWS Managed API WellKnownFolderName folders and EWS DistinguishedFolderId folders:
  • Racine (sous-arborescence IPM)Root (IPM subtree)
  • NonIpmSubtreeNonIpmSubtree
  • Boîte de réceptionInbox
  • Éléments supprimésDeleted Items
  • BrouillonsDrafts
  • JournalJournal
  • NotesNotes
  • Boîte d'envoiOutbox
  • Éléments envoyésSent Items
  • Dossier de messagesMessage Folder
  • Courrier indésirableJunk Email
  • Messagerie vocaleVoice Mail
CalendarFolderCalendarFolder
CalendarFolderCalendarFolder
Page. Rendez-vousIPF.Appointment
Rendez-vous et réunions.Appointments and meetings.
Lorsqu’un utilisateur répond à une demande de réunion, le rendez-vous est ajouté à l’API managée EWS WellKnownFolderName. Calendar ou au EWS DistinguishedFolderId. CalendarFolder uniquement.When a user responds to a meeting request, the appointment is added to the EWS Managed API WellKnownFolderName.Calendar or the EWS DistinguishedFolderId.CalendarFolder only. Il s’agit des seuls dossiers qui prennent en charge l’interaction automatique avec les demandes de réunion et les réponses.These are the only folders that support automatic interaction with meeting requests and responses.

Ce type de classe de dossier ou de dossier prend en charge l’utilisation des affichages de calendrier pour renvoyer des rendez-vous et des réunions en fonction d’une date de début et d’une date de fin à l’aide de la méthode Folder. FindItem et de la classe CalendarView , ou de l’opération EWS FindItem et de l’élément CalendarView .This folder class or folder type supports the use of calendar views to return appointments and meetings based on a start date and an end date by using the EWS Managed API Folder.FindItem method and the CalendarView class, or the EWS FindItem operation and the CalendarView element.
ContactsFolderContactsFolder
ContactsFolderContactsFolder
Page. PrenezIPF.Contact
Contacts et listes de distribution.Contacts and distribution lists.
Aucun.None.
SearchFolderSearchFolder
SearchFolderSearchFolder
Page. NoteIPF.Note
Le contenu est déterminé par une restriction ou un filtre.Contents are determined by a restriction or filter. Les dossiers de recherche n’ont pas de sous-dossiers.Search folders do not have subfolders.
Les éléments qui répondent aux critères de recherche ne sont pas réellement contenus dans le dossier de recherche ; au lieu de cela, ils se trouvent ailleurs dans la boîte aux lettres.The items that meet the search criteria are not actually contained in the search folder; instead, they are located elsewhere in the mailbox.
Pour vous assurer que les dossiers de recherche sont disponibles dans Outlook, créez-les dans le dossier Finder.To ensure that Search folders are available in Outlook, create them in the Finder folder.
TasksFolderTasksFolder
TasksFolderTasksFolder
Page. TâcheIPF.Task
Contient les éléments de travail à terminer.Contains work items to complete.
Aucun.None.

Structure de dossiersFolder structure

Les dossiers fournissent une structure de boîte aux lettres.Folders provide a mailbox structure. Cela inclut la sous-arborescence IPM, appelée la partie supérieure de la Banque d’informations dans EWS, dans laquelle la plupart des utilisateurs interagissent avec leur boîte aux lettres, ainsi que les dossiers système que la plupart des utilisateurs ne voient pas, qui se trouvent dans la sous-arborescence non IPM ou dans EWS.This includes the IPM Subtree, known as the Top of Information Store in EWS, where most users interact with their mailbox, as well as system folders that most users never see, which are in the Non-IPM Subtree or Root in EWS. La figure suivante illustre la structure de dossiers d’un utilisateur et indique les dossiers qui concernent les éléments de l’utilisateur et ceux qui sont des dossiers système.The following figure shows the folder structure for a user and indicates which folders are for the user's items and which are system folders.

Figure 2. Dossiers d’éléments et système dans une boîte aux lettresFigure 2. Item and system folders in a mailbox

Illustration présentant les dossiers système à la racine, ce qui comprend les favoris, l’outil de recherche, les données de disponibilité, la partie supérieure de la banque d’informations et bien plus encore. La partie supérieure de la banque d’informations contient les dossiers des utilisateurs, dont leurs calendriers, leurs contacts, etc.

Dossiers bien connusWell-known folders

Parmi les dossiers d’une boîte aux lettres, certains sont des dossiers spéciaux.Of the folders in a mailbox, some are special folders. Elles correspondent à des dossiers connus dans l’API managée EWS ou des dossiers uniques dans EWS.These equate to well-known folders in the EWS Managed API, or distinguished folders in EWS. Certains de ces dossiers ont des restrictions sur le nom du dossier, où ils se trouvent dans la structure de dossiers, et s’ils peuvent être supprimés.Some of these folders have restrictions on the folder name, where they are located in the folder structure, and whether they can be deleted. Les autres dossiers « génériques » (non spéciaux) n’ont pas les mêmes restrictions.Other "generic" (non-special) folders do not have the same restrictions. Il est important de vous familiariser avec les dossiers connus ou distingués suivants, car il s’agit des dossiers système, utilisateur et de recherche racine, et s’appliquent à la plupart des implémentations.It is important for you to be familiar with the following well-known or distinguished folders because they are the root system, user, and search folders, and are applicable to most implementations.

Tableau 2. Dossiers principaux connus et uniquesTable 2. Primary well-known and distinguished folders

Nom convivialFriendly name Valeurs WellKnownFolderName de l’API MANAGÉe EWSEWS Managed API WellKnownFolderName values Valeurs DISTINGUISHEDFOLDERID EWSEWS DistinguishedFolderId values DescriptionDescription
Root (sous-arborescence non IPM)Root (Non-IPM Subtree)
WellKnownFolderName. rootWellKnownFolderName.Root
DistinguishedFolderId. rootDistinguishedFolderId.root
Contient le dossier racine d’une boîte aux lettres, également appelé sous-arborescence non IPM.Contains the root folder of a mailbox, also known as the Non-IPM Subtree. Ce dossier n’a pas de parent et vous ne pouvez pas le déplacer, le copier, le renommer ou le supprimer.This folder has no parent, and you cannot move, copy, rename, or delete it. Chaque magasin de messages contient un seul dossier racine.Each message store contains only one root folder.
Partie supérieure de la Banque d’informations (sous-arborescence IPM)Top of Information Store (IPM Subtree)
WellKnownFolderName.MsgFolderRootWellKnownFolderName.MsgFolderRoot
DistinguishedFolderId.msgfolderrootDistinguishedFolderId.msgfolderroot
Contient la boîte de réception et les autres dossiers utilisateur.Contains the Inbox and other user folders.
Finder (dossiers de recherche)Finder (Search folders)
WellKnownFolderName. SearchFoldersWellKnownFolderName.SearchFolders
DistinguishedFolderId. SearchFolders.DistinguishedFolderId.searchfolders.
Contient les dossiers de recherche visibles dans Outlook.Contains search folders that are visible in Outlook.

Pour obtenir la liste complète des valeurs de propriété WellKnownFolderName de l’API managée EWS, voir l’énumération WellKnownFolderName .For a complete list of the EWS Managed API WellKnownFolderName property values, see the WellKnownFolderName enumeration. Pour obtenir la liste complète des valeurs DISTINGUISHEDFOLDERID EWS, voir DistinguishedFolderId.For a complete list of the EWS DistinguishedFolderId values, see DistinguishedFolderId.

Propriétés des dossiersFolder properties

Dans l’API managée EWS, les Propriétés de dossier sont toutes dérivées de la classe de dossier de base.In the EWS Managed API, the folder properties are all derived from the base Folder class. Et dans EWS, tous les dossiers utilisent les éléments de dossier qui sont disponibles sur le type de dossier .And in EWS, all folders use the folder elements that are available on the Folder type. La plupart des propriétés et des éléments liés aux dossiers sont simples (ID de dossier parent, nom d’affichage, etc.), mais quelques explications supplémentaires sont nécessaires.Most of the folder-related properties and elements are straightforward (parent folder ID, display name, and so on), but a few require a little more explanation.

Les avertissements suivants s’appliquent à la propriété de l’API managée EWS . FolderClass ou à l’élément FolderClass EWS :The following caveats apply to the EWS Managed API Folder.FolderClass property or the EWS FolderClass element:

  • Si ce paramètre est défini, la valeur de la propriété ou de l’élément doit être conforme à la classe dérivée ou au type du dossier.If set, the value of the property or element must agree with the derived class or type of the folder. Par exemple, la propriété ou l’élément FolderClass ne peut pas indiquer que le dossier est un dossier de contacts tandis que la classe ou le type du dossier indique que le dossier est un dossier de calendrier.For example, the FolderClass property or element can't indicate that the folder is a Contacts folder while the class or type of the folder indicates the folder is a Calendar folder.

  • Vous pouvez créer des dossiers d’un type spécifique sans définir la propriété ou l’élément FolderClass , ou vous pouvez créer un dossier avec le type de dossier générique et spécifier la propriété ou l’élément FolderClass .You can either create folders of a specific type without setting the FolderClass property or element, or you can create a folder with the generic folder type and specify the FolderClass property or element. Les deux options créent le même résultat.Both options create the same result.

  • Après avoir défini la valeur FolderClass en créant un type spécifique de dossier ou en définissant la propriété FolderClass ou l’élément lui-même, vous ne pouvez pas la modifier.After you set the FolderClass value by creating a specific type of folder or by setting the FolderClass property or element itself, you cannot change it. Par exemple, vous ne pouvez pas modifier un IPF. Note dossier en une erreur de page non valide. Dossier de contacts.For example, you cannot change an IPF.Note folder to an IPF.Contact folder. Toutefois, vous pouvez le remplacer par un IPF. Dossier note. contoso.You can, however, change it to an IPF.Note.Contoso folder.

  • Toute valeur FolderClass qui n’utilise pas l’un des préfixes prédéfinis est traitée comme une erreur de page non valide. Dossier de notes.Any FolderClass value that does not use one of the predefined prefixes is treated as an IPF.Note folder. Par exemple, une valeur FolderClass de IAmAFolderClass est traitée comme une erreur de page non valide. Dossier de notes.For example, a FolderClass value of IAmAFolderClass is treated as an IPF.Note folder.

La valeur de la classe Folder est extensible.The folder class value is extensible. Cela signifie que les valeurs FolderClass par défaut répertoriées dans le tableau 1 sont traitées comme des préfixes et que vous pouvez ajouter des valeurs personnalisées.This means that the default FolderClass values listed in Table 1 are treated as prefixes and you can add custom values. Par exemple, vous pouvez créer un dossier avec une valeur FolderClass de IPF. Contact. contoso et il est traité comme un dossier de contacts.For example, you can create a folder with a FolderClass value of IPF.Contact.Contoso, and it is treated as a Contacts folder.

Vous pouvez déterminer les autorisations dont dispose le client sur les dossiers, telles que supprimer, lire et modifier, à l’aide de la propriété Folder. EffectiveRights de l’API managée EWS ou de l’élément EffectiveRights EWS.You can determine what permissions the client has on the folders, such as delete, read, and modify, by using the EWS Managed API Folder.EffectiveRights property or the EWS EffectiveRights element.

Dossiers publicsPublic folders

Les dossiers publics sont conçus pour assurer un accès partagé et offrir une manière simple et efficace de collecter, d’organiser et de partager des informations avec d’autres personnes dans votre groupe de travail ou votre organisation.Public folders are designed for shared access and provide an easy and effective way to collect, organize, and share information with other people in your workgroup or organization. Vous pouvez également utiliser des dossiers publics pour archiver le contenu du groupe de distribution.You can also use public folders to archive distribution group content. Pour obtenir des informations détaillées sur les dossiers publics, consultez la rubrique Public Folder Access with EWS in Exchange.For in-depth information about public folders, see Public folder access with EWS in Exchange.

Dossiers cachésHidden folders

Tous les dossiers créés par Exchange à la racine de la boîte aux lettres sont masqués et vous pouvez utiliser l’API managée EWS ou EWS pour masquer les autres dossiers sous la Banque d’informations.All the folders that Exchange creates at the root of the mailbox are hidden, and you can use the EWS Managed API or EWS to hide additional folders under the Top of Information Store. Pour plus d’informations sur les dossiers masqués, consultez la rubrique utilisation de dossiers masqués à l’aide d’EWS dans Exchange.For more information about hidden folders, see Work with hidden folders by using EWS in Exchange.

Dossiers de rechercheSearch folders

Les dossiers de recherche sont identiques aux dossiers ordinaires, à la seule différence qu’ils ont une propriété ou un élément qui définit le filtre de recherche.Search folders are just like regular folders, except that they have a property or element that defines the search filter. Vous pouvez créer des dossiers de recherche dans n’importe quel dossier d’une boîte aux lettres Exchange et les créer de la même manière que vous créez un autre dossier.You can create search folders in any folder in an Exchange mailbox, and you create them in the same way that you create any other folder. Toutefois, pour qu’un dossier de recherche apparaisse dans Outlook, Outlook Web App ou Outlook Live, les objets SearchFolder que vous créez à l’aide de l’API managée EWS doivent se trouver dans le dossier WellKnownFolderName. SearchFolders , et les types SearchFolder que vous créez à l’aide d’EWS doivent se trouver dans le dossier DistinguishedFolderId. SearchFolders .However, for a search folder to appear in Outlook, Outlook Web App, or Outlook Live, SearchFolder objects that you create by using the EWS Managed API must be located in the WellKnownFolderName.SearchFolders folder, and SearchFolder types that you create by using EWS must be located in the DistinguishedFolderId.SearchFolders folder. Si le dossier de recherche est créé à un autre emplacement, il est toujours disponible et vous pouvez l’afficher dans les applications clientes personnalisées.If the search folder is created in a different location, it is still available and you can view it in custom client applications.

ÉlémentsItems

EWS dans Exchange utilise des éléments pour représenter des messages électroniques individuels, des rendez-vous, des réunions, des contacts, des listes de distribution, des tâches, des publications et d’autres éléments, dans une boîte aux lettres.EWS in Exchange uses Items to represent individual email messages, appointments, meetings, contacts, distribution lists, tasks, posts, and other items, in a mailbox. Les éléments sont fortement typés, ce qui signifie qu’ils ont une classe ou un schéma associé spécifique, ou ne sont pas fortement typés, également appelés éléments génériques.Items are either strongly typed, which means that they have a specific associated class or schema, or not strongly typed, also known as generic items. Les éléments génériques sont des objets Item dans l’API managée EWS et les types d' éléments dans EWS.Generic items are Item objects in the EWS Managed API and Item types in EWS. Les éléments communs, tels que les messages électroniques, les contacts, les listes de distribution, les publications et les tâches, sont fortement typés, et vous pouvez définir des propriétés schématisées spécifiques ou des éléments sur ceux-ci.Common items like email messages, contacts, distribution lists, posts, and tasks are strongly typed, and you can set specific schematized properties or elements on them.

Tableau 3. Éléments fortement typésTable 3. Strongly typed items

Type d’élément d’API managée EWSEWS Managed API item type Élément d’élément EWSEWS item element
Rendez-vousAppointment
CalendarItemCalendarItem
ContactContact
ContactContact
ContactGroupContactGroup
DistributionListDistributionList
EmailMessageEmailMessage
MessageMessage
PostItemPostItem
PostItemPostItem
TaskTask
TaskTask

API managée EWS les éléments fortement typés dérivent de la classe d' élément de base.EWS Managed API strongly typed items derive from the base Item class. Toutefois, vous utilisez généralement l’un des types dérivés figurant dans le tableau 3, et non directement avec la classe d' élément .However, you usually work with one of the derived types listed in Table 3, and not with the Item class directly. Toutefois, lorsque vous utilisez la classe ItemCollection , vous pouvez travailler directement avec des instances de la classe d' élément .When you work with the ItemCollection class, however, you might work directly with instances of the Item class. Dans ce cas, vous devez implémenter une logique qui détermine le type d’élément dans le magasin représenté par l’instance de la classe d' élément .In that case, you should implement logic that determines the type of item in the store that the instance of the Item class represents. Pour utiliser cet élément, vous devez effectuer une liaison à l’élément à l’aide d’une instance de la classe qui représente l’élément.To work with that item, you should bind to the item by using an instance of the class that represents the item.

Éléments dans des dossiersItems in folders

Certains dossiers ont des restrictions quant aux types d’éléments qu’ils peuvent contenir.Some folders have restrictions about the types of items that they can contain. Il s’agit de restrictions que la base de données de boîtes aux lettres Exchange applique aux dossiers, et non aux limitations d’affichage client.These are restrictions that the Exchange mailbox database applies to folders, not client view limitations.

Tableau 4. Restrictions des éléments pour les dossiersTable 4. Item restrictions for folders

Classe de dossier de l’API managée EWSEWS Managed API Folder class Type de dossier EWSEWS Folder type RestrictionRestriction
Classe de dossier de baseBase Folder class
FolderFolder
Vous pouvez uniquement créer de nouveaux objets EmailMessage de l’API managée EWS et des objets PostItem , ou des types de message EWS ou des types de PostItem , dans les dossiers génériques.You can only create new EWS Managed API EmailMessage objects and PostItem objects, or EWS Message types or PostItem types, in the generic folders. Vous pouvez déplacer d’autres types d’éléments dans des dossiers génériques, mais il se peut que le client ne les affiche pas.You can move other item types into generic folders, but the client might not display them.
CalendarFolderCalendarFolder
CalendarFolderCalendarFolder
Vous pouvez uniquement créer des objets de rendez- vous de l’API managée EWS et des types CalendarItem EWS dans le dossier de calendrier.You can only create new EWS Managed API Appointment objects and EWS CalendarItem types in the Calendar folder. Vous pouvez déplacer d’autres types d’éléments dans le dossier calendrier, mais il se peut que le client ne les affiche pas.You can move other item types into the Calendar folder, but the client might not display them.
ContactsFolderContactsFolder
ContactsFolderContactsFolder
Vous pouvez uniquement créer de nouveaux objets de contact et d’API managée EWS, ou des types de contacts EWS ou des types DistributionList dans le dossier contacts.You can only create new EWS Managed API Contact and ContactGroup objects, or EWS Contact types or DistributionList types in the Contacts folder. Vous pouvez déplacer d’autres types d’éléments dans le dossier contacts, mais il se peut que le client ne les affiche pas.You can move other item types into the Contacts folder, but the client might not display them
SearchFolderSearchFolder
SearchFolderSearchFolder
Aucune restriction.No restrictions. Les éléments ne se trouvent pas réellement dans le dossier de recherche ; ils se trouvent ailleurs dans la boîte aux lettres.Items are not actually located in the Search folder; they are located elsewhere in the mailbox.
TasksFolderTasksFolder
TasksFolderTasksFolder
Vous pouvez uniquement créer des objets de tâche de l’API managée EWS ou des types de tâches EWS dans le dossier tâches.You can only create new EWS Managed API Task objects or EWS Task types in the Tasks folder. Vous pouvez déplacer d’autres types d’éléments dans le dossier tâches, mais il se peut que le client ne les affiche pas.You can move other item types into the Tasks folder, but the client might not display them

Mise à niveau à partir de versions antérieures du produitUpgrading from earlier product versions

Les dossiers sont en grande partie restés inchangés dans les versions antérieures et actuelles du produit.Folders have for the most part remained unchanged in earlier and current product versions. Notez toutefois que les versions antérieures d’Exchange utilisent des dossiers gérés pour effectuer la gestion des enregistrements de messagerie (MRM).Note, however, that earlier versions of Exchange use managed folders to perform messaging records management (MRM). Exchange Online, Exchange Online dans le cadre d’Office 365 et les versions d’Exchange à partir d’Exchange 2013 utilisent des stratégies de rétention pour MRM.Exchange Online, Exchange Online as part of Office 365, and versions of Exchange starting with Exchange 2013 use retention policies for MRM. Vous pouvez mettre à niveau les dossiers gérés pour utiliser des stratégies de rétention.You can upgrade managed folders to use retention policies.

Les éléments n’ont pas été modifiés dans les versions antérieures et actuelles du produit.Items have not changed in earlier and current product versions.

Contenu de cette sectionIn this section

Voir aussiSee also