Datos adjuntos y EWS en Exchange
Obtenga información sobre los datos adjuntos y cómo los representa la API administrada de EWS o EWS en el cliente de Exchange.
Normalmente, los datos adjuntos están asociados a elementos de correo electrónico, pero de hecho, todos los elementos de EWS (mensajes de correo electrónico, elementos de calendario, contactos, tareas) pueden incluir datos adjuntos.
Tipos de datos adjuntos
EWS clasifica los datos adjuntos en dos grupos: datos adjuntos de archivos y datos adjuntos de elementos.
Datos adjuntos de elementos: Elementos EWS fuertemente tipados, como mensajes de correo electrónico y elementos de calendario, que están asociados a otro elemento EWS fuertemente tipado. Cualquier elemento fuertemente tipado que se pueda crear mediante la API administrada de EWS o EWS se puede usar como datos adjuntos de elementos. El contenido de los datos adjuntos de un elemento es el elemento fuertemente tipado, que proporciona un fácil acceso a todas sus propiedades. Los datos adjuntos de elementos pueden tener sus propios datos adjuntos de elementos, por lo que es posible una jerarquía de datos adjuntos de elementos (o anidamiento de datos adjuntos).
Archivos adjuntos: Cualquier archivo, como un .txt, .jpg, .zip, .pdf o incluso un archivo .msg. Los datos adjuntos de un archivo solo tienen algunas propiedades, una de las cuales es el contenido codificado en base 64 del archivo.
Datos adjuntos de referencia: Los datos adjuntos a los que hace referencia un proveedor de archivos, como un archivo ubicado en la nube. Los datos adjuntos pueden ser de varios proveedores.
Al agregar o recuperar datos adjuntos de un elemento, lo hará de forma diferente en función de si se trata de un archivo adjunto o de un elemento adjunto. Por ejemplo, para agregar un archivo adjunto a un elemento, solo tiene que pasar la ubicación del archivo. Para agregar un elemento existente como datos adjuntos de un elemento, realmente tiene que copiar las propiedades o el contenido MIME del elemento existente en un nuevo elemento adjunto; no se puede enlazar simplemente al elemento existente. Por lo tanto, es importante distinguir entre los dos tipos de datos adjuntos. En los artículos de esta sección se describen más detalles sobre las diferencias entre los datos adjuntos de elementos y los datos adjuntos de archivos.
¿Cómo se representan los datos adjuntos mediante programación?
Los datos adjuntos se almacenan en una colección en el elemento EWS. La colección de datos adjuntos se compone de datos adjuntos de archivos o datos adjuntos de elementos. Los metadatos sobre la colección de datos adjuntos están disponibles cuando se obtiene un elemento mediante el método Item.Bind de la API administrada de EWS o la operación GetItem de EWS, pero se requieren llamadas adicionales para recuperar realmente el contenido de los datos adjuntos.
Tabla 1. Metadatos de elementos sobre datos adjuntos
| Entidad de metadatos | Propiedad api administrada de EWS | Elemento EWS |
|---|---|---|
| Indicador de datos adjuntos (no marca los datos adjuntos insertados) |
Item.HasAttachments |
HasAttachments |
| Colección attachment |
Item.Attachments |
Adjuntos |
| Identificador de datos adjuntos |
Attachment.Id |
AttachmentId |
Tabla 2. Entidades de datos adjuntos
| Tipo de datos adjuntos | Clase de API administrada de EWS | Elemento EWS |
|---|---|---|
| Datos adjuntos de archivo |
FileAttachment |
FileAttachment |
| Datos adjuntos del elemento |
ItemAttachment ItemAttachment<TItem> |
ItemAttachment |
| Datos adjuntos de referencia |
ReferenceAttachmentType complexType (EWS) |
ReferenceAttachment |
Datos adjuntos insertados
Los datos adjuntos insertados son una raza especial de datos adjuntos. Tanto los datos adjuntos de archivo como los datos adjuntos de elementos pueden ser datos adjuntos insertados. Los datos adjuntos insertados aparecen como parte del contenido del cuerpo y conservan su posición con respecto al resto del contenido del elemento.
Los datos adjuntos son datos adjuntos insertados si la propiedad IsInline de la API administrada de EWS o el elemento IsInline de EWS se establece en true. Los datos adjuntos insertados usan las siguientes propiedades y elementos opcionales para identificar la ubicación de los datos adjuntos insertados:
API administrada de EWS: propiedades ContentId o ContentLocation .
EWS: elemento ContentId o ContentLocation .
Tenga en cuenta que la propiedad HasAttachments de la API administrada de EWS y el elemento HasAttachments de EWS no reflejan la existencia de datos adjuntos insertados y por eso los datos adjuntos insertados también se denominan datos adjuntos ocultos. Por lo tanto, si establece la propiedad IsInline de la API administrada de EWS o el elemento IsInline de EWS en true y el elemento no tiene otros datos adjuntos, HasAttachments se establecerá en false. Si el cliente usa HasAttachments para rellenar un indicador o icono de datos adjuntos en un correo electrónico, tenga en cuenta que el icono no aparecerá para los correos electrónicos con datos adjuntos insertados.