Mensajes de informe MAPI
Hace referencia a: Outlook 2013 | Outlook 2016
Los mensajes de informe presentan información de estado sobre un mensaje a su remitente.
Hay dos tipos generales de mensajes de informe:
Leer informes de estado.
Informes de estado de entrega.
Informes de estado de lectura
Los proveedores de almacén de mensajes inician los informes de estado de lectura mediante una llamada al método IMAPISupport::ReadReceipt y se envían al destinatario representado por el identificador de entrada de la propiedad PR_REPORT_ENTRYID (PidTagReportEntryId). Los informes de estado de lectura no se generan automáticamente; las aplicaciones cliente que quieran recibirlas deben solicitarlas explícitamente.
Un informe de lectura indica que se ha establecido la marca de lectura de un mensaje, que puede producirse cuando se abre, imprime, mueve o copia el mensaje. Si un proveedor de almacén de mensajes genera o no un informe de lectura en respuesta a una operación de movimiento o copia depende de dónde vaya el mensaje. Si se mueve o copia en otro almacén de mensajes, lo más probable es que siempre se envíe un informe de lectura. Si se mueve o copia en el almacén de mensajes actual, es posible que se envíe o no un informe de lectura.
Un informe no leído indica que la marca de lectura de un mensaje no está establecida y que el mensaje no se abrió antes de colocarse en la carpeta Elementos eliminados o antes de la expiración de un límite de tiempo. Los clientes pueden llamar al método IMessage::SetReadFlag o IMAPIFolder::SetReadFlags para establecer o borrar la marca de lectura de un mensaje.
Informes de estado de entrega
El estado de entrega se refleja en un informe de entrega, que se envía cuando un mensaje ha llegado a su destinatario previsto, y en un informe no entrega, que se envía cuando un mensaje no pudo llegar a un destinatario. Los informes de estado de entrega se envían al destinatario representado por el identificador de entrada de la propiedad PR_REPORT_ENTRYID o al remitente si esta propiedad no está presente.
Los informes de entrega solo se envían por solicitud y no incluyen el mensaje original. Los informes nondelivery se envían automáticamente a menos que se realice una solicitud para suprimirlos. Los informes de no entrega incluyen el mensaje original como datos adjuntos para permitir que el destinatario del informe vuelva a enviar el mensaje en caso de que el bloqueo de la entrega deje de ser un problema. El mensaje adjunto es similar al original tal como existía cuando se llamó al método IMessage::SubmitMessage para enviarlo inicialmente.
Los proveedores de transporte generan uno o varios informes de estado de entrega cuando llaman al método IMAPISupport::StatusRecips . Los proveedores de transporte componen una lista de destinatarios para un mensaje. Si un destinatario recibe o no un informe y el tipo de informe que se genera depende de lo siguiente:
Los informes de entrega van a los destinatarios que establecen la propiedad PR_ORIGINATOR_DELIVERY_REPORT_REQUESTED (PidTagOriginatorDeliveryReportRequested) en TRUE antes de que el mensaje se colocara en el almacén de mensajes.
Los informes nondelivery van a destinatarios que no establecieron la propiedad PR_ORIGINATOR_NON_DELIVERY_REPORT_REQUESTED (PidTagOriginatorNonDeliveryReportRequested) en FALSE.
Casi toda la información necesaria para mostrar un informe de no entrega está contenida en la tabla de destinatarios del mensaje adjunto. Algunas propiedades son del propio informe. Para los informes de entrega, la información necesaria se encuentra en la tabla de destinatarios del informe y en algunas propiedades del informe.
Los informes son mensajes con clases de mensaje distintas, en función de la clase del mensaje enviado. La mayoría de los proveedores de servicios usan una convención de nomenclatura por la que la clase de mensaje se compone de varias partes separadas por puntos. La primera parte es "Informe" y la última parte es una constante que representa el tipo de informe. La parte central está reservada para la clase del mensaje enviado. Por ejemplo, dado que un informe de entrega usa la recuperación ante desastres constante, la clase de mensaje para un informe de entrega sobre un IPM. El mensaje de nota sería Report.IPM.Note.DR.
En la tabla siguiente se muestran las constantes que representan los tipos de informes.
| Tipo de informe | Constante usada en la clase de mensaje |
|---|---|
| Lectura |
IPNRN |
| No leído |
IPNNRN |
| Entrega |
Recuperación ante desastres |
| Nondelivery |
NDR |
Los clientes interactivos pueden mostrar mensajes de informe mediante formularios estándar proporcionados por MAPI o formularios personalizados que se han registrado con el administrador de formularios para la clase de mensaje del informe. Clientes que reciben un informe de no entrega para un IPM. El mensaje de nota, por ejemplo, puede mostrar el formulario MAPI estándar que presenta una lista de los destinatarios con errores y una razón sugerida para el error. El formulario también permite al usuario volver a enviar el mensaje, si lo desea.