Paramètres de l'application persistant dans EWS dans Exchange
Découvrez les différentes options que votre API managée EWS ou votre application EWS peut utiliser pour créer des paramètres d’application personnalisés persistants dans Exchange.
Le moyen le plus simple de conserver les configurations clientes personnalisées synchronisées pour une boîte aux lettres, ou les dossiers et les éléments d’une boîte aux lettres, consiste à stocker les paramètres d’application sur un serveur Exchange. Vous pouvez vous assurer que ces paramètres sont conservés pour une boîte aux lettres en utilisant l’un des éléments suivants :
Objets de configuration utilisateur
Propriétés étendues
Éléments personnalisés
Quelles sont mes options pour créer des paramètres d’application persistants ?
Les objets de configuration utilisateur sont votre meilleure option pour stocker les paramètres de configuration de vos applications clientes EWS. Vous pouvez également utiliser des propriétés d’extension ou des éléments personnalisés, ou une combinaison des trois. Choisissez votre option en fonction de l’étendue de vos paramètres et si vos paramètres doivent être disponibles pour d’autres applications.
Tableau 1. Options recommandées pour la création de paramètres d’application persistants en fonction de l’étendue
| Définition de l’étendue | Utiliser... | Accessible par |
|---|---|---|
| Élément |
Propriété étendue sur un élément existant. |
N’importe quelle application EWS. Seuls les clients EWS qui connaissent l’identificateur de propriété peuvent accéder à une propriété étendue. |
| Folder |
Objet de configuration utilisateur sur le dossier cible. Il s’agit d’un bon moyen d’enregistrer les paramètres d’affichage d’un dossier. |
N’importe quelle application EWS. |
| Boîte aux lettres |
Objet de configuration utilisateur sur le dossier msgrootfolder par défaut. |
N’importe quelle application EWS. |
Objets de configuration utilisateur
Les objets de configuration utilisateur sont des éléments spéciaux associés à des dossiers dans une boîte aux lettres. Les objets de configuration utilisateur, également appelés éléments associés au dossier, sont généralement la meilleure option pour conserver les paramètres d’application, en particulier si les informations de configuration sont associées à un dossier ou à une boîte aux lettres. Elles ne sont généralement pas exposées aux utilisateurs finaux. Étant donné qu’ils peuvent stocker en mode natif des flux de données et des dictionnaires de données, ils sont idéaux pour stocker les informations de configuration. La meilleure façon d’utiliser des objets de configuration utilisateur consiste à stocker un ensemble de configurations dans un document XML, puis à enregistrer ces informations dans l’une des propriétés du flux de configuration utilisateur.
Les objets de configuration utilisateur sont accessibles différemment des autres types d’éléments stockés dans une boîte aux lettres. Vous pouvez utiliser la méthode d’API managée EWS Folder.FindItems ou l’opération FindItem EWS pour rechercher tous les éléments, mais vous devez utiliser l’option Parcours de recherche associé pour rechercher des objets de configuration utilisateur. La traversée de recherche associée indique que les résultats de la recherche doivent contenir uniquement des objets de configuration utilisateur. EWS inclut un ensemble d’opérations spécifiques aux objets de configuration utilisateur.
Tableau 1. Opérations EWS et méthodes d’API managée EWS pour travailler avec des objets de configuration utilisateur
| Afin de... | Utiliser cette opération EWS | Utiliser cette méthode d’API managée EWS |
|---|---|---|
| Créer un objet de configuration utilisateur |
Opération CreateUserConfiguration |
UserConfiguration.Save |
| Obtenir un objet de configuration utilisateur |
Opération GetUserConfiguration |
UserConfiguration.Bind UserConfiguration.Load |
| Mettre à jour un objet de configuration utilisateur |
Opération UpdateUserConfiguration |
UserConfiguration.Update |
| Supprimer un objet de configuration utilisateur |
Opération DeleteUserConfiguration |
UserConfiguration.Delete |
Remarque
Les objets de configuration utilisateur créés à l’aide d’EWS ont un préfixe ItemClass qui commence par « IPM. Configuration. » ItemClass d’un objet de configuration utilisateur est le préfixe de l’objet de configuration utilisateur et le nom de votre objet de configuration utilisateur. Vous pouvez utiliser la propriété API managée Item.ItemClass EWS ou l’élément ItemClass EWS pour rechercher des objets de configuration utilisateur que vous avez définis.
Propriétés étendues
Utilisez les propriétés étendues si vous souhaitez stocker des informations de configuration sur des éléments. EWS, contrairement à MAPI, ne retourne pas de conteneur de propriétés pour les articles. Cela signifie qu’un client EWS doit connaître l’identificateur de propriété étendue pour rechercher la propriété étendue et y accéder. Si vous avez besoin de stocker des informations de configuration sur des éléments autres que des objets de configuration utilisateur, l’utilisation de propriétés étendues pour créer des propriétés personnalisées peut être la solution pour vous. Les propriétés étendues vous permettent d’accéder aux propriétés qui ne font pas partie du jeu de propriétés standard d’un élément et de les stocker.
Importante
Le schéma de base de données Exchange a un nombre fini de propriétés. Le nombre maximal d’identificateurs de propriété pour une base de données Exchange est de 32 767. Si vous utilisez des propriétés étendues pour stocker de nombreux paramètres, nous vous suggérons d’utiliser une seule propriété étendue pour stocker ces paramètres afin de ne pas dépasser ce maximum.
Vous pouvez utiliser la méthode d’API managée Item.Update EWS ou l’opération UpdateItem EWS pour définir des propriétés étendues sur les objets de configuration utilisateur.
Éléments personnalisés
Les éléments personnalisés peuvent également être utilisés pour stocker des informations. Les propriétés d’élément existantes peuvent être réaffectées pour contenir des informations de configuration. Vous pouvez également utiliser des propriétés étendues pour définir vos propres propriétés pour votre application. L’utilisation d’éléments personnalisés pour stocker la configuration offre les avantages suivants :
Ils fonctionnent pour toutes les versions d’Exchange qui prennent en charge EWS.
Si vous n’utilisez pas de propriétés étendues sur l’élément, le budget des propriétés Exchange n’est pas facturé.
Où dois-je stocker les paramètres de mon application ?
Les dossiers de boîte aux lettres et les éléments qu’ils contiennent se trouvent dans le dossier de message racine. Ce dossier est identifié par la valeur WellKnownFolderName.msgfolderroot dans l’API managée EWS. En termes MAPI, il s’agit de l’équivalent de la sous-arborescence IPM d’une boîte aux lettres. Les objets de configuration utilisateur sont souvent utilisés pour créer des paramètres basés sur l’interface utilisateur, afin qu’une application puisse afficher les paramètres d’affichage en fonction du dossier auquel un utilisateur accède. Les paramètres d’affichage basés sur un dossier sont généralement définis sur un objet de configuration utilisateur associé au dossier. Mais parfois, vous souhaiterez peut-être que vos paramètres soient globaux pour votre application. Dans ce cas, vous pouvez stocker vos paramètres dans le dossier de message racine.
La plupart des utilisateurs ne sont pas au courant et n’accèdent généralement pas au dossier de boîte aux lettres racine. Ce dossier est identifié par la valeur WellKnownFolderName.root dans l’API managée EWS. En termes MAPI, il s’agit de l’équivalent de la sous-arborescence non IPM d’une boîte aux lettres. Les informations auxquelles les utilisateurs finaux n’accèdent pas directement sont stockées dans le dossier de boîte aux lettres racine. Vous pouvez stocker votre paramètre d’application dans ce dossier, car les applications clientes n’y accèdent généralement pas.
Différences entre les versions
Les objets de configuration utilisateur sont disponibles sur Exchange Online, Exchange Online dans le cadre de Office 365 et les versions d’Exchange à partir d’Exchange 2010.