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é des éléments auxquels les utilisateurs de votre organisation peuvent accéder. Office 365, Exchange Online et les versions locales d’Exchange à partir 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 de dossiers publics et le contenu des dossiers publics. Les autorisations de dossiers publics sont gérées via le contrôle d’accès basé sur un rôle (RBAC).
Les technologies d’accès client, telles que les services Web Exchange (EWS) et l’API managée EWS, fournissent un accès par programme à la hiérarchie de dossiers publics et aux éléments de contenu d’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 et aux dossiers publics et aux données de dossiers publics.
Opérations EWS et méthodes de l’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, ainsi que les méthodes de l’API managée EWS indiquées dans le tableau suivant, pour travailler avec des dossiers publics.
Pour plus d’informations sur les méthodes de l’API managée EWS, consultez la rubrique EWS Managed API Namespaces.
| 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 () |
| CopyFolder opération2 |
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 transfert de dossiers entre un dossier public et un dossier privé n’est pas disponible dans les versions d’Exchange commençant par Exchange 2013.
2 cette opération est uniquement applicable aux dossiers publics dans exchange Server 2007 et exchange Server 2010.
3 cette opération est uniquement applicable aux dossiers publics dans Exchange 2010.
4 la recherche avec indexation de texte intégral dans un seul dossier public par le biais de l’option de recherche QueryString est prise en charge dans les versions d’Exchange commençant par Exchange 2013.
5 l’opération ConvertId ne convertit pas correctement les identificateurs de dossier public de l’identificateur EWS vers l’identificateur de magasin. Vous pouvez mettre à jour manuellement l’identificateur renvoyé sous forme de 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 commençant par Exchange 2013 :
CopyFolder (non pris en charge). Vous pouvez utiliser CreateFolder avec l’opération CopyItems pour implémenter la fonctionnalité de l’opération CopyFolder .
EmptyFolder (non pris en charge). Vous pouvez utiliser FindItem avec l’opération DeleteItem pour implémenter la fonctionnalité de fonctionnement de EmptyFolder .
MoveFolder (partiellement pris en charge). Vous ne pouvez pas déplacer des 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 :
À l’aide de opérationsyncfolderhierarchy. Utilisez les opérations FindFolder, GetFolder et SyncFolderItems pour synchroniser les éléments et les dossiers d’une boîte aux lettres de dossiers publics.
Recherches en profondeur dans une hiérarchie de dossiers publics. Utiliser les appels de l’opération FindFolder récursive 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 devrez 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. À la place, utilisez 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 utiliser des dossiers publics
Les dossiers publics permettent de nombreux scénarios importants pour les utilisateurs de boîtes aux lettres Exchange. Vous pouvez aider les utilisateurs à l’aide d’EWS et de l’API managée EWS pour implémenter des solutions personnalisées permettant d’accéder à des dossiers publics et de les utiliser, ainsi que leur contenu.
Accès par programme 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 des messages électroniques qui sont envoyés à des 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ée.
Partager des messages électroniques importants et d’autres éléments de boîte aux lettres
Les utilisateurs de boîtes aux lettres peuvent utiliser des dossiers publics en tant que référentiel partagé pour les éléments de boîte aux lettres. Différents utilisateurs d’une organisation peuvent partager des messages électroniques importants ou des contacts à 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 à l’intérieur ou à l’extérieur d’un dossier public.
Discussions publiques avec des éléments de publication
Les dossiers publics constituent un conteneur pratique pour les éléments post. Les éléments post fournissent un moyen d’utiliser des conversations thématiques sans avoir à envoyer de messages électroniques entre les utilisateurs. Les utilisateurs peuvent utiliser des dossiers publics et publier des éléments pour héberger et gérer des conversations thématiques entre différents utilisateurs de boîtes aux lettres au sein d’une organisation. De cette façon, les utilisateurs de boîtes aux lettres peuvent accéder à l’historique partagé d’une conversation qui utilise des éléments post 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 dossier public
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 dans une boîte aux lettres, tandis que le contenu du dossier public est stocké sur une autre. Chacun de ces serveurs peut être différent du serveur de boîtes aux lettres de l’utilisateur qui demande les informations. Dans ce cas, 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 pour X-AnchorMailbox et X-PublicFolderMailbox peut varier selon que vous effectuez une demande liée à la hiérarchie de 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 de l’API managée EWS et opérations EWS pour le routage des demandes de dossier public
| Lors de l’appel de ces méthodes | Lors de l’appel de ces opérations | Utilisez 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 d’identificateurs de dossiers publics à partir de l’identificateur EWS vers l’identificateur de magasin.