Travailler avec les dossiers sur le serveur Exchange
Répertorier tous les dossiers du serveur
L’API Aspose.Email offre la capacité de se connecter au serveur Exchange et de répertorier tous les dossiers et sous‑dossiers. Vous pouvez également récupérer tous les sous‑dossiers de chaque dossier de façon récursive. Elle permet également d’énumérer les dossiers avec pagination depuis le client Exchange en utilisant Exchange Web Service (EWS). Cet article montre comment récupérer tous les sous‑dossiers du serveur Exchange et récupérer les dossiers avec pagination.
L’extrait de code suivant vous montre comment répertorier les dossiers d’un serveur Exchange.
Obtenir les informations du type de dossier via EWS
Le ExchangeFolderType énumérateur fourni par ExchangeFolderInfo classe pouvant être utilisée pour obtenir des informations sur le type du dossier. Cela est illustré dans l’exemple de code ci‑dessous.
Énumération des dossiers avec prise en charge de la pagination via EWS
Le fragment de code suivant vous montre comment utiliser la prise en charge de la pagination avec EWS.
Accès aux dossiers personnalisés ou sous‑dossiers de la boîte aux lettres
IEWSClient permet aux développeurs d’accéder à n’importe quel dossier ou sous‑dossier personnalisé de la boîte aux lettres. Le FolderExists() méthode de IEWSClient renvoie l’URI d’un dossier personnalisé/dossier secondaire spécifié, qui peut ensuite être utilisé pour accéder au dossier cible. Dans l’exemple suivant, un dossier personnalisé nommé "TestInbox", créé sous INBOX, est accédé et tous les messages de ce dossier personnalisé sont affichés. Pour réaliser cette tâche, les étapes suivantes sont effectuées :
- Initialisez le IEWSClient objet en fournissant des informations d’identification valides.
- Accédez à la boîte aux lettres par défaut.
- Accédez au dossier parent, qui est INBOX dans cet exemple. Ce dossier parent peut également être un dossier personnalisé.
- Utiliser FolderExists() méthode pour rechercher le sous‑dossier personnalisé spécifié, par exemple, "TestInbox". Elle renverra l’URI de "TestInbox".
- Utilisez cet URI pour accéder à tous les messages de ce dossier personnalisé.
L’extrait de code suivant montre comment accéder aux dossiers personnalisés ou sous‑dossiers de la boîte aux lettres avec EWS.
Liste des dossiers publics
Microsoft Exchange Server permet aux utilisateurs de créer des dossiers publics et d’y publier des messages. Pour le faire via votre application, utilisez le EWSClient classe pour se connecter à Exchange Server et lire et télécharger les messages et les publications des dossiers publics. Le fragment de code suivant vous montre comment lire tous les dossiers publics et sous‑dossiers, et lister et télécharger les messages trouvés dans ces dossiers. Cet exemple ne fonctionne qu’avec Microsoft Exchange Server 2007 ou supérieur, car seuls ceux‑ci supportent EWS.
Synchronisation des éléments de dossier
API Aspose.Email IEWSClient offre la fonctionnalité de synchronisation du contenu d’un dossier Exchange. Le SyncFolder méthode exposée par le IEWSClient classe pouvant être utilisée pour synchroniser les informations de dossier sur un dossier spécifié. Le fragment de code suivant vous montre comment synchroniser les informations des dossiers Exchange.
Récupération des autorisations pour les dossiers Exchange
Des autorisations sont attribuées aux utilisateurs pour les dossiers publics sur Exchange Server, ce qui limite/détermine le niveau d’accès d’un utilisateur à ces dossiers. La classe ExchangeFolderPermission fournit un ensemble de propriétés d’autorisation pour les dossiers Exchange telles que le niveau d’autorisation, la possibilité de créer des éléments, de les supprimer, et d’effectuer d’autres tâches spécifiées par les propriétés d’autorisation. Les autorisations peuvent être récupérées en utilisant le GetFolderPermissions() méthode de IEWSClient. Cet article montre comment récupérer les autorisations appliquées à un dossier public pour tous les utilisateurs qui ont accès aux dossiers partagés.
Pour effectuer cette tâche :
- Initialisez le IEWSClient.
- Utilisez le ListPublicFolders pour obtenir la liste de tous les dossiers publics
- Récupérer les autorisations associées à un dossier en utilisant le GetFolderPermissions() méthode
L’extrait de code suivant montre comment utiliser le IEWSClient classe pour récupérer les autorisations appliquées à un dossier.
Création de dossiers et sous-dossiers
L’API Aspose.Email offre la capacité de créer des dossiers dans une boîte aux lettres Exchange. Le CreateFolder méthode de IEWSClient peut être utilisé à cette fin. Pour créer un dossier dans la boîte aux lettres du serveur Exchange, les étapes suivantes peuvent être suivies.
- Créez une instance de IEWSClient.
- Définissez le set_UseSlashAsFolderSeparator propriété selon les besoins. Si elle est définie sur true, l’application considérera le « Slash » comme séparateur de dossier et le sous-dossier sera créé après le slash.
- Utilisez le CreateFolder méthode pour créer le dossier.
L’extrait de code suivant montre comment créer des dossiers et des sous‑dossiers.
Sauvegarder les dossiers Exchange vers PST
Il arrive souvent que les utilisateurs souhaitent effectuer une sauvegarde de tous ou de certains dossiers de boîte aux lettres. Aspose.Email offre la capacité de sauvegarder tous les dossiers de boîte aux lettres Exchange ou des dossiers spécifiés dans un fichier PST. Pour sauvegarder les dossiers du serveur Exchange, les étapes suivantes peuvent être suivies.
- Créez une instance de IEWSClient.
- Ajouter les informations du dossier requis à ExchangeFolderInfoCollection
- Utiliser IESClient->Backup méthode pour exporter le contenu du dossier vers PST
L’extrait de code suivant montre comment sauvegarder les dossiers Exchange vers un PST.