Carpetas y elementos de EWS en Exchange
Obtenga información sobre las carpetas y los elementos de buzón y cómo los representa la API administrada de EWS o el cliente de EWS.
Las carpetas son el elemento organizador de un buzón de Exchange. Las carpetas pueden contener elementos de buzón, como mensajes de correo electrónico, contactos, citas, reuniones y tareas, o pueden contener otras carpetas. Exchange incluye diferentes tipos de carpetas, pero los tipos de carpeta son similares entre sí. La principal diferencia entre ellos es el tipo de elemento que contienen.
Sin embargo, los elementos tienen tipos únicos. Cada tipo de elemento tiene un conjunto diferente de propiedades o esquema para definirlo. En este artículo, trataremos los tipos de carpetas y elementos que están disponibles y las diferencias entre ellos.
Folders
Todas las carpetas se derivan de la misma clase base o tipo base, la clase Folder en la API administrada de EWS o el tipo folder en EWS. En la ilustración siguiente se muestran las clases de API administrada de EWS y los tipos de EWS.
Figura 1. Clases de carpeta de API administrada de EWS y tipos de carpeta de EWS
La principal diferencia entre cada una de las clases de carpeta y los tipos de carpeta es que solo puede crear un determinado tipo de elemento en cada tipo de carpeta. Otra diferencia es cómo el cliente muestra información en una carpeta. Por ejemplo, Exchange permite crear citas en la carpeta Calendario. Puede mover otros tipos de elementos a la carpeta Calendario después de crearlos, pero Outlook no los mostrará. Outlook solo muestra elementos de calendario como citas y reuniones en la carpeta Calendario, incluso si existe otro tipo de elemento en la carpeta.
Tabla 1. Clases de carpeta de API administrada de EWS y tipos de carpeta de EWS
Clase de API administrada de EWS | Tipo EWS | Valor de FolderClass | Contains | Notas |
---|---|---|---|---|
Folder |
Folder |
Ipf. Nota |
Email mensajes o carpetas. |
Se trata de la clase o el tipo de carpeta genérica para las siguientes carpetas WellKnownFolderName de api administrada de EWS y carpetas DistinguishedFolderId de EWS:
|
CalendarFolder |
CalendarFolder |
Ipf. Cita |
Citas y reuniones. |
Cuando un usuario responde a una convocatoria de reunión, la cita se agrega a la API administrada de EWS WellKnownFolderName.Calendar o solo a EWS DistinguishedFolderId.CalendarFolder . Estas son las únicas carpetas que admiten la interacción automática con las solicitudes y respuestas de reunión. Esta clase de carpeta o tipo de carpeta admite el uso de vistas de calendario para devolver citas y reuniones basadas en una fecha de inicio y una fecha de finalización mediante el método Folder.FindItem de la API administrada de EWS y la clase CalendarView , o la operación FindItem de EWS y el elemento CalendarView . |
ContactsFolder |
ContactsFolder |
Ipf. Contacto |
Contactos y listas de distribución. |
Ninguno. |
SearchFolder |
SearchFolder |
Ipf. Nota |
El contenido viene determinado por una restricción o filtro. Las carpetas de búsqueda no tienen subcarpetas. |
Los elementos que cumplen los criterios de búsqueda no están realmente contenidos en la carpeta de búsqueda; en su lugar, se encuentran en otro lugar del buzón. Para asegurarse de que las carpetas de búsqueda están disponibles en Outlook, créelas en la carpeta Finder. |
TasksFolder |
TasksFolder |
Ipf. Tarea |
Contiene elementos de trabajo que se van a completar. |
Ninguno. |
Estructura de carpetas
Las carpetas proporcionan una estructura de buzón de correo. Esto incluye el subárbol ipm, conocido como el almacén de información superior en EWS, donde la mayoría de los usuarios interactúan con su buzón de correo, así como carpetas del sistema que la mayoría de los usuarios nunca ven, que están en el subárbol no IPM o raíz en EWS. En la ilustración siguiente se muestra la estructura de carpetas de un usuario e indica qué carpetas son para los elementos del usuario y cuáles son carpetas del sistema.
Figura 2. Carpetas de elementos y del sistema en un buzón
Carpetas conocidas
De las carpetas de un buzón de correo, algunas son carpetas especiales. Esto equivale a carpetas conocidas en la API administrada de EWS o carpetas distinguidas en EWS. Algunas de estas carpetas tienen restricciones en el nombre de la carpeta, donde se encuentran en la estructura de carpetas y si se pueden eliminar. Otras carpetas "genéricas" (no especiales) no tienen las mismas restricciones. Es importante que esté familiarizado con las siguientes carpetas conocidas o distinguidas, ya que son el sistema raíz, el usuario y las carpetas de búsqueda, y son aplicables a la mayoría de las implementaciones.
Tabla 2. Carpetas principales conocidas y distinguidas
Nombre descriptivo | Valores de WellKnownFolderName de la API administrada de EWS | Valores de EWS DistinguishedFolderId | Descripción |
---|---|---|---|
Raíz (subárbol que no es IPM) |
WellKnownFolderName.Root |
DistinguishedFolderId.root |
Contiene la carpeta raíz de un buzón de correo, también conocida como subárbol que no es IPM. Esta carpeta no tiene ningún elemento primario y no se puede mover, copiar, cambiar el nombre ni eliminarla. Cada almacén de mensajes contiene solo una carpeta raíz. |
Parte superior del almacén de información (subárbol IPM) |
WellKnownFolderName.MsgFolderRoot |
DistinguishedFolderId.msgfolderroot |
Contiene la Bandeja de entrada y otras carpetas de usuario. |
Finder (buscar carpetas) |
WellKnownFolderName.SearchFolders |
DistinguishedFolderId.searchfolders. |
Contiene carpetas de búsqueda que están visibles en Outlook. |
Para obtener una lista completa de los valores de propiedad WellKnownFolderName de la API administrada de EWS, vea la enumeración WellKnownFolderName . Para obtener una lista completa de los valores de EWS DistinguishedFolderId , vea DistinguishedFolderId.
Propiedades de carpeta
En la API administrada de EWS, las propiedades de carpeta se derivan de la clase Folder base. Y en EWS, todas las carpetas usan los elementos de carpeta que están disponibles en el tipo Folder . La mayoría de los elementos y propiedades relacionados con carpetas son sencillos (identificador de carpeta principal, nombre para mostrar, etc.), pero algunos requieren un poco más de explicación.
Las siguientes advertencias se aplican a la propiedad Folder.FolderClass de la API administrada de EWS o al elemento FolderClass de EWS:
Si se establece, el valor de la propiedad o elemento debe estar de acuerdo con la clase derivada o el tipo de la carpeta. Por ejemplo, la propiedad FolderClass o el elemento no pueden indicar que la carpeta es una carpeta Contacts, mientras que la clase o el tipo de la carpeta indican que la carpeta es una carpeta Calendar.
Puede crear carpetas de un tipo específico sin establecer la propiedad FolderClass o el elemento , o bien puede crear una carpeta con el tipo de carpeta genérico y especificar la propiedad FolderClass o el elemento . Ambas opciones crean el mismo resultado.
Después de establecer el valor FolderClass creando un tipo específico de carpeta o estableciendo la propiedad FolderClass o el propio elemento, no se puede cambiar. Por ejemplo, no se puede cambiar un IPF. Anote la carpeta en un IPF. Carpeta de contactos. Sin embargo, puede cambiarlo a un IPF. Carpeta Note.Contoso.
Cualquier valor folderclass que no use uno de los prefijos predefinidos se trata como un IPF. Carpeta de nota. Por ejemplo, un valor FolderClass de IAmAFolderClass se trata como un IPF. Carpeta de nota.
El valor de la clase de carpeta es extensible. Esto significa que los valores predeterminados de FolderClass enumerados en la tabla 1 se tratan como prefijos y puede agregar valores personalizados. Por ejemplo, puede crear una carpeta con un valor FolderClass de IPF. Contact.Contoso y se trata como una carpeta Contactos.
Puede determinar qué permisos tiene el cliente en las carpetas, como eliminar, leer y modificar, mediante la propiedad Folder.EffectiveRights de la API administrada de EWS o el elemento EWS EffectiveRights .
Carpetas públicas
Las carpetas públicas están diseñadas para un acceso compartido y ofrecen una manera fácil y efectiva de obtener, organizar y compartir información con otras personas de su grupo de trabajo u organización. También puede usar carpetas públicas para archivar el contenido del grupo de distribución. Para obtener información detallada sobre las carpetas públicas, vea Acceso a carpetas públicas con EWS en Exchange.
Carpetas ocultas
Todas las carpetas que Exchange crea en la raíz del buzón están ocultas y puede usar la API administrada de EWS o EWS para ocultar carpetas adicionales en la parte superior del almacén de información. Para obtener más información sobre las carpetas ocultas, vea Trabajar con carpetas ocultas mediante EWS en Exchange.
Carpetas de búsqueda
Las carpetas de búsqueda son igual que las carpetas normales, salvo que tienen una propiedad o un elemento que define el filtro de búsqueda. Puede crear carpetas de búsqueda en cualquier carpeta de un buzón de Exchange y crearlas de la misma manera que crea cualquier otra carpeta. Sin embargo, para que una carpeta de búsqueda aparezca en Outlook, Outlook Web App o Outlook Live, los objetos SearchFolder que cree mediante la API administrada de EWS deben encontrarse en la carpeta WellKnownFolderName.SearchFolders y los tipos SearchFolder que cree mediante EWS deben encontrarse en la carpeta DistinguishedFolderId.SearchFolders. Si la carpeta de búsqueda se crea en una ubicación diferente, sigue estando disponible y puede verla en aplicaciones cliente personalizadas.
Elementos
EWS en Exchange usa Elementos para representar mensajes de correo electrónico individuales, citas, reuniones, contactos, listas de distribución, tareas, publicaciones y otros elementos, en un buzón. Los elementos están fuertemente tipados, lo que significa que tienen una clase o esquema asociados específicos, o no fuertemente tipados, también conocidos como elementos genéricos. Los elementos genéricos son objetos Item en la API administrada de EWS y tipos item en EWS. Los elementos comunes, como mensajes de correo electrónico, contactos, listas de distribución, publicaciones y tareas, están fuertemente tipados y puede establecer propiedades o elementos específicos esquematizados en ellos.
Tabla 3. Elementos fuertemente tipados
Tipo de elemento de API administrada de EWS | Elemento EWS |
---|---|
Appointment |
CalendarItem |
Contact |
Contact |
ContactGroup |
DistributionList |
EmailMessage |
Message |
PostItem |
PostItem |
Tarea |
Tarea |
Los elementos fuertemente tipados de la API administrada de EWS derivan de la clase item base. Sin embargo, normalmente se trabaja con uno de los tipos derivados enumerados en la tabla 3 y no con la clase Item directamente. Sin embargo, al trabajar con la clase ItemCollection , es posible que trabaje directamente con instancias de la clase Item . En ese caso, debe implementar una lógica que determine el tipo de elemento en el almacén que representa la instancia de la clase Item . Para trabajar con ese elemento, debe enlazar al elemento mediante una instancia de la clase que representa el elemento.
Elementos en carpetas
Algunas carpetas tienen restricciones sobre los tipos de elementos que pueden contener. Se trata de restricciones que la base de datos de buzones de Exchange aplica a las carpetas, no a las limitaciones de la vista de cliente.
Tabla 4. Restricciones de elementos para carpetas
Clase carpeta de API administrada de EWS | Tipo de carpeta EWS | Restriction |
---|---|---|
Clase Carpeta base |
Folder |
Solo puede crear nuevos objetos EmailMessage de api administrada de EWS y objetos PostItem , o tipos de mensajes EWS o tipos PostItem , en las carpetas genéricas. Puede mover otros tipos de elementos a carpetas genéricas, pero es posible que el cliente no los muestre. |
CalendarFolder |
CalendarFolder |
Solo puede crear nuevos objetos appointment de API administrada de EWS y tipos EWS CalendarItem en la carpeta Calendario. Puede mover otros tipos de elementos a la carpeta Calendario, pero es posible que el cliente no los muestre. |
ContactsFolder |
ContactsFolder |
Solo puede crear nuevos objetos Contact y ContactGroup de la API administrada de EWS, o tipos de contacto de EWS o tipos DistributionList en la carpeta Contactos. Puede mover otros tipos de elementos a la carpeta Contactos, pero es posible que el cliente no los muestre. |
SearchFolder |
SearchFolder |
Sin restricciones. Los elementos no se encuentran realmente en la carpeta Buscar; se encuentran en otro lugar del buzón. |
TasksFolder |
TasksFolder |
Solo puede crear nuevos objetos de tarea de API administrada de EWS o tipos de tareas de EWS en la carpeta Tareas. Puede mover otros tipos de elementos a la carpeta Tareas, pero es posible que el cliente no los muestre. |
Actualización desde versiones anteriores del producto
Las carpetas se han mantenido sin cambios en la mayoría de las versiones anteriores y actuales del producto. Tenga en cuenta, sin embargo, que las versiones anteriores de Exchange usan carpetas administradas para realizar la administración de registros de mensajería (MRM). Exchange Online, Exchange Online como parte de Office 365 y versiones de Exchange a partir de Exchange 2013 usan directivas de retención para MRM. Puede actualizar carpetas administradas para usar directivas de retención.
Los elementos no han cambiado en las versiones anteriores y actuales del producto.
En esta sección
Trabajar con elementos de buzón de Exchange mediante EWS en Exchange
Exportación e importación de elementos mediante EWS en Exchange