Configuración de la aplicación persistente en EWS en Exchange
Obtenga información sobre las distintas opciones que puede usar la API administrada de EWS o la aplicación EWS para crear una configuración de aplicación personalizada persistente en Exchange.
La manera más fácil de mantener sincronizadas las configuraciones de cliente personalizadas para un buzón de correo, o carpetas y elementos de un buzón, es almacenar la configuración de la aplicación en un servidor exchange. Puede asegurarse de que esa configuración persiste para un buzón de correo mediante una de las siguientes opciones:
Objetos de configuración de usuario
Propiedades extendidas
Elementos personalizados
¿Cuáles son mis opciones para crear la configuración persistente de la aplicación?
Los objetos de configuración de usuario son la mejor opción para almacenar las opciones de configuración de las aplicaciones cliente de EWS. También puede usar propiedades de extensión o elementos personalizados, o una combinación de los tres. Elija la opción según el ámbito de la configuración y si la configuración debe estar disponible para otras aplicaciones.
Tabla 1. Opciones recomendadas para crear una configuración de aplicación persistente basada en el ámbito
| Establecer ámbito | Use… | A la que se accede mediante |
|---|---|---|
| Elemento |
Propiedad extendida en un elemento existente. |
Cualquier aplicación de EWS. Solo los clientes de EWS que conocen el identificador de propiedad pueden acceder a una propiedad extendida. |
| Folder |
Objeto de configuración de usuario en la carpeta de destino. Esta es una buena manera de guardar la configuración de vista de una carpeta. |
Cualquier aplicación de EWS. |
| Mailbox |
Objeto de configuración de usuario en la carpeta msgrootfolder predeterminada. |
Cualquier aplicación de EWS. |
Objetos de configuración de usuario
Los objetos de configuración de usuario son elementos especiales asociados a carpetas de un buzón. Los objetos de configuración de usuario, también conocidos como elementos asociados a carpetas, suelen ser la mejor opción para conservar la configuración de la aplicación, especialmente si la información de configuración está asociada a una carpeta o un buzón. Normalmente no se exponen a los usuarios finales. Dado que pueden almacenar de forma nativa flujos de datos y diccionarios de datos, son ideales para almacenar información de configuración. La mejor manera de usar objetos de configuración de usuario es almacenar un conjunto de configuraciones en un documento XML y, a continuación, guardar esa información en una de las propiedades del flujo de configuración de usuario.
Se obtiene acceso a los objetos de configuración de usuario de forma diferente a los demás tipos de elementos almacenados en un buzón de correo. Puede usar el método Folder.FindItems EWS Managed API o la operación EWS FindItem para buscar todos los elementos, pero debe usar la opción Recorrido transversal de búsqueda asociada para buscar objetos de configuración de usuario. El recorrido de búsqueda asociado indica que los resultados de la búsqueda deben contener solo objetos de configuración de usuario. EWS incluye un conjunto de operaciones específicas de los objetos de configuración de usuario.
Tabla 1. Operaciones de EWS y métodos de API administrada de EWS para trabajar con objetos de configuración de usuario
| Para | Uso de esta operación de EWS | Uso de este método de API administrada de EWS |
|---|---|---|
| Creación de un objeto de configuración de usuario |
Operación CreateUserConfiguration |
UserConfiguration.Save |
| Obtención de un objeto de configuración de usuario |
Operación GetUserConfiguration |
UserConfiguration.Bind UserConfiguration.Load |
| Actualización de un objeto de configuración de usuario |
Operación UpdateUserConfiguration |
UserConfiguration.Update |
| Eliminación de un objeto de configuración de usuario |
Operación DeleteUserConfiguration |
UserConfiguration.Delete |
Nota:
Los objetos de configuración de usuario creados mediante EWS tienen un prefijo ItemClass que comienza por "IPM. Configuration.". ItemClass de un objeto de configuración de usuario es el prefijo de objeto de configuración de usuario y el nombre del objeto de configuración de usuario. Puede usar la propiedad Api administrada de EWS Item.ItemClass o el elemento EWS ItemClass para buscar objetos de configuración de usuario que haya definido.
Propiedades extendidas
Use las propiedades extendidas si desea almacenar información de configuración en los elementos. EWS, a diferencia de MAPI, no devuelve un contenedor de propiedades para los elementos. Esto significa que un cliente de EWS debe conocer el identificador de propiedad extendido para buscar y acceder a la propiedad extendida. Si necesita almacenar información de configuración en elementos que no sean objetos de configuración de usuario, el uso de propiedades extendidas para crear propiedades personalizadas podría ser la solución para usted. Las propiedades extendidas permiten acceder a información sobre las propiedades que no forman parte del conjunto de propiedades estándar de un elemento y almacenarla.
Importante
El esquema de base de datos de Exchange tiene un número finito de propiedades. El número máximo de identificadores de propiedad de una base de datos de Exchange es de 32 767. Si usa propiedades extendidas para almacenar muchas configuraciones, se recomienda usar una única propiedad extendida para almacenar esa configuración de modo que no supere este máximo.
Puede usar el método De API administrada de EWS Item.Update o la operación EWS UpdateItem para establecer propiedades extendidas en objetos de configuración de usuario.
Elementos personalizados
Los elementos personalizados también se pueden usar para almacenar información. Las propiedades de elemento existentes se pueden reutilizar para contener información de configuración. O bien, puede usar propiedades extendidas para definir sus propias propiedades para la aplicación. El uso de elementos personalizados para almacenar la configuración proporciona las siguientes ventajas:
Funcionan para todas las versiones de Exchange que admiten EWS.
Si no usa propiedades extendidas en el elemento, no se cobrará el presupuesto de las propiedades de Exchange.
¿Dónde debo almacenar la configuración de la aplicación?
Las carpetas de buzón de correo y los elementos dentro de ellos se encuentran en la carpeta del mensaje raíz. Esta carpeta se identifica mediante el valor WellKnownFolderName.msgfolderroot de la API administrada de EWS. En términos MAPI, este es el equivalente del subárbol IPM de un buzón. Los objetos de configuración de usuario se usan a menudo para crear configuraciones basadas en la interfaz de usuario, de modo que una aplicación pueda representar la configuración de vista en función de la carpeta a la que accede un usuario. La configuración de vista basada en carpetas normalmente se establece en un objeto de configuración de usuario asociado a la carpeta. Pero a veces, es posible que quiera que la configuración sea global para la aplicación. En este caso, puede almacenar la configuración en la carpeta de mensajes raíz.
La mayoría de los usuarios no conocen y normalmente no tienen acceso a la carpeta del buzón raíz. Esta carpeta se identifica mediante el valor WellKnownFolderName.root de la API administrada de EWS. En términos MAPI, este es el equivalente del subárbol que no es IPM de un buzón de correo. La información a la que los usuarios finales no acceden directamente se almacena en la carpeta del buzón raíz. Es posible que quiera almacenar la configuración de la aplicación en esta carpeta porque las aplicaciones cliente no suelen acceder a ella.
Diferencias de versión
Los objetos de configuración de usuario están disponibles en Exchange Online, Exchange Online como parte de Office 365 y versiones de Exchange a partir de Exchange 2010.