Accéder aux dossiers publics avec EWS dans Exchange
Découvrez comment utiliser EWS et l’API managée EWS pour accéder aux dossiers publics et acheminer les demandes de dossiers publics dans Exchange.
Les dossiers publics fournissent un référentiel partagé d’éléments auxquels les utilisateurs de votre organisation peuvent accéder. Office 365, Exchange Online et les versions locales d’Exchange à compter d’Exchange 2013 introduisent une nouvelle architecture pour les dossiers publics. Les dossiers publics dans Exchange utilisent une conception de boîte aux lettres spécialisée (au lieu d’une base de données de dossiers publics) pour stocker la hiérarchie des dossiers publics et le contenu des dossiers publics. Les autorisations de dossier public sont gérées via le contrôle d’accès en fonction du rôle (RBAC).
Les technologies d’accès au client, telles que les services web Exchange (EWS) et l’API managée EWS, fournissent un accès par programme à la fois à la hiérarchie des dossiers publics et aux éléments de contenu dans une base de données de dossiers publics. Cet article fournit des informations sur la façon dont vous pouvez utiliser EWS et l’API managée EWS pour accéder aux dossiers publics, aux dossiers publics et aux données de dossiers publics.
Opérations EWS et méthodes d’API managée EWS pour l’accès aux dossiers publics
La plupart des opérations EWS de base prennent en charge l’accès aux dossiers publics. Vous pouvez utiliser les opérations de dossier et d’élément et les méthodes d’API managée EWS répertoriées dans le tableau suivant pour travailler avec des dossiers publics.
Pour plus d’informations sur les méthodes d’API managée EWS, consultez Espaces de noms d’API managées EWS.
| Opération EWS | Méthode d'API managée EWS |
|---|---|
|
Opération CreateFolder |
Folder.Save() |
|
Opération UpdateFolder |
Folder.Update() |
|
Opération DeleteFolder |
Folder.Delete() |
|
Opération MoveFolder1 |
Folder.Move() |
|
Opération CopyFolder2 |
Folder.Copy() |
|
Opération GetFolder |
Folder.Bind() |
|
Opération EmptyFolder3 |
Folder.Empty() |
|
Opération FindFolder |
ExchangeService.FindFolders() Folder.FindFolders() |
|
Opération CreateItem |
Item.Save() |
|
Opération MoveItem |
Item.Move() |
|
Opération CopyItem |
Item.Copy() |
|
Opération UpdateItem |
Item.Update() |
|
Opération DeleteItem |
Item.Delete() |
|
Opération FindItem4 |
ExchangeService.FindItems() Folder.FindItems() |
|
Opération GetItem |
Item.Bind() |
|
Opération ConvertId5 |
ExchangeService.ConvertId() ExchangeService.ConvertIds() |
1 Le déplacement de dossiers entre un dossier public et un dossier privé n’est pas disponible dans les versions d’Exchange à partir d’Exchange 2013.
2 Cette opération s’applique uniquement aux dossiers publics dans Exchange Server 2007 et Exchange Server 2010.
3 Cette opération s’applique uniquement aux dossiers publics dans Exchange 2010.
4 La recherche indexée en texte intégral dans un dossier public unique au moyen de l’option de recherche QueryString est prise en charge dans les versions d’Exchange à compter d’Exchange 2013.
5 L’opération ConvertId ne convertit pas correctement les identificateurs de dossier public de l’identificateur EWS en identificateur de magasin. Vous pouvez mettre à jour manuellement l’identificateur retourné comme solution de contournement.
Les opérations suivantes ne sont pas prises en charge ou sont partiellement prises en charge pour les dossiers publics dans les versions d’Exchange à compter d’Exchange 2013 :
CopyFolder (non pris en charge). Vous pouvez utiliser CreateFolder avec l’opération CopyItems pour implémenter la fonctionnalité d’opération CopyFolder .
EmptyFolder (non pris en charge). Vous pouvez utiliser FindItem avec l’opération DeleteItem pour implémenter la fonctionnalité d’opération EmptyFolder .
MoveFolder (partiellement pris en charge). Vous ne pouvez pas déplacer de dossiers entre des dossiers privés et publics. Vous pouvez déplacer des dossiers entre des dossiers privés et publics dans Exchange 2007 et Exchange 2010. Vous pouvez déplacer des dossiers dans un dossier public dans toutes les versions d’Exchange.
EWS et l’API managée EWS ne prennent pas en charge les fonctionnalités suivantes pour les dossiers publics :
Utilisation de SyncFolderHierarchy. Utilisez les opérations FindFolder, GetFolder, FindItem et GetItem pour synchroniser des éléments et des dossiers dans une boîte aux lettres de dossiers publics.
Recherches approfondies d’une hiérarchie de dossiers publics. Utilisez des appels d’opération FindFolder récursifs pour parcourir la hiérarchie de dossiers publics.
Utilisation de l’opération CreateFolderPath pour créer une hiérarchie de dossiers pour les dossiers publics. Vous devez utiliser l’opération CreateFolder pour chaque niveau de dossier dans une hiérarchie de dossiers distincte lorsque vous ciblez une boîte aux lettres de dossiers publics.
Utilisation de l’opération CreateItem pour enregistrer des copies des messages électroniques envoyés. Utilisez plutôt l’opération MoveItem pour déplacer une copie du message dans un dossier public.
Scénarios d’utilisation d’EWS et de l’API managée EWS pour travailler avec des dossiers publics
Les dossiers publics permettent de nombreux scénarios importants pour les utilisateurs de boîtes aux lettres Exchange. Vous pouvez donner aux utilisateurs les moyens d’utiliser EWS et l’API managée EWS pour implémenter des solutions personnalisées pour accéder et utiliser des dossiers publics et leur contenu.
Accéder par programmation aux messages électroniques qui ont été envoyés à des listes de distribution
Les utilisateurs de boîtes aux lettres Exchange peuvent utiliser des dossiers publics pour stocker les messages électroniques envoyés aux listes de distribution. Il s’agit d’un moyen pratique d’enregistrer l’historique des listes de distribution. Vous pouvez utiliser l’opération FindItem dans EWS ou les méthodes ExchangeService.FindItems() et Folder.FindItems() dans l’API managée EWS pour accéder aux messages électroniques de liste de distribution stockées.
Partager des messages électroniques importants et d’autres éléments de boîte aux lettres
Les utilisateurs de boîte aux lettres peuvent utiliser des dossiers publics comme référentiel partagé pour les éléments de boîte aux lettres. Différents utilisateurs d’une organisation peuvent partager des messages électroniques ou des contacts importants à l’aide de dossiers publics. EWS peut fournir l’accès à ces éléments de boîte aux lettres partagés. Vous pouvez utiliser l’opération MoveItem dans EWS ou la méthode Item.Move() dans l’API managée EWS pour déplacer des messages électroniques, des contacts et d’autres éléments de boîte aux lettres vers et hors d’un dossier public.
Discussions publiques avec éléments de publication
Les dossiers publics sont un conteneur pratique pour les éléments de publication. Les éléments de publication permettent d’utiliser des conversations à fil sans avoir à envoyer des e-mails entre les utilisateurs. Les utilisateurs peuvent utiliser des dossiers publics et des éléments de publication pour héberger et gérer des conversations avec des threads entre différents utilisateurs de boîte aux lettres dans une organisation. De cette façon, les utilisateurs de boîte aux lettres peuvent accéder à l’historique partagé d’une conversation qui utilise des éléments de publication même s’ils ne faisaient pas partie de la conversation. Vous pouvez utiliser l’opération CreateItem dans EWS ou la méthode Item.Save() dans l’API managée EWS pour créer et répondre aux éléments de publication stockés dans un dossier public.
Routage des demandes de dossiers publics
Le contenu des dossiers publics peut être stocké sur plusieurs serveurs de boîtes aux lettres. La hiérarchie de dossiers publics peut être stockée sur une boîte aux lettres, tandis que le contenu du dossier public est stocké sur une autre. Et chacun de ces serveurs peut être différent du serveur de boîtes aux lettres pour l’utilisateur qui demande les informations. Dans ces situations, il est important d’inclure les en-têtes X-AnchorMailbox et X-PublicFolderMailbox supplémentaires dans vos demandes de dossiers publics pour recevoir des informations précises sur les dossiers publics.
La valeur de X-AnchorMailbox et X-PublicFolderMailbox peut varier selon que vous effectuez une requête liée à la hiérarchie des dossiers ou au contenu du dossier. Le tableau suivant identifie la procédure à suivre pour chaque méthode d’API managée EWS ou opération EWS.
Méthodes d’API managée EWS et opérations EWS pour le routage des demandes de dossiers publics
| Lors de l’appel de ces méthodes | Lors de l’appel de ces opérations | Utiliser cette procédure |
|---|---|---|
|
Folder.FindFolders Folder.Delete Folder.Update Folder.Move |
CreateFolder FindFolder DeleteFolder UpdateFolder MoveFolder |
Routage des demandes de hiérarchie de dossiers publics |
|
Item.Bind Item.Update Item.Copy Item.Move Item.Delete Folder.Bind Folder.FindItems |
CreateItem GetItem UpdateItem CopyItem MoveItem DeleteItem GetFolder FindItem |
Routage des demandes de contenu de dossier public |
Différences entre les versions
Dans Exchange 2007 et Exchange 2010, l’opération ConvertId fonctionne comme prévu lors de la conversion des identificateurs de dossier public de l’identificateur EWS en identificateur de magasin.