Mensagens de relatório MAPI
Aplica-se a: Outlook 2013 | Outlook 2016
Mensagens de relatório apresentam status informações sobre uma mensagem para seu remetente.
Há dois tipos gerais de mensagens de relatório:
Leia status relatórios.
Entrega status relatórios.
Ler relatórios de status
Ler status relatórios são iniciados por provedores de armazenamento de mensagens por meio de uma chamada para o método IMAPISupport::ReadReceipt e são enviados para o destinatário representado pelo identificador de entrada na propriedade PR_REPORT_ENTRYID (PidTagReportEntryId). Ler status relatórios não são gerados automaticamente; os aplicativos cliente que desejam recebê-los devem solicitá-los explicitamente.
Um relatório de leitura indica que o sinalizador de leitura de uma mensagem foi definido, o que pode ocorrer quando a mensagem é aberta, impressa, movida ou copiada. Se um provedor de armazenamento de mensagens gera ou não um relatório de leitura em resposta a uma operação de movimentação ou cópia depende de onde a mensagem está indo. Se ele estiver sendo movido ou copiado para outro repositório de mensagens, um relatório de leitura provavelmente sempre será enviado. Se ele estiver sendo movido ou copiado no repositório de mensagens atual, um relatório de leitura poderá ou não ser enviado.
Um relatório não lido indica que o sinalizador de leitura de uma mensagem não está definido e que a mensagem não foi aberta antes de ser colocada na pasta Itens Excluídos ou antes da expiração de um limite de tempo. Os clientes podem chamar o método IMessage::SetReadFlag ou IMAPIFolder::SetReadFlags para definir ou limpar o sinalizador de leitura de uma mensagem.
Relatórios de status de entrega
O status de entrega é refletido em um relatório de entrega, que é enviado quando uma mensagem chega ao destinatário pretendido e em um relatório não detalhado, que é enviado quando uma mensagem não pode chegar a um destinatário. Os relatórios status de entrega são enviados ao destinatário representado pelo identificador de entrada na propriedade PR_REPORT_ENTRYID ou ao remetente se essa propriedade não estiver presente.
Os relatórios de entrega são enviados somente por solicitação e não incluem a mensagem original. Os relatórios nondelivery são enviados automaticamente, a menos que uma solicitação seja feita para suprimi-los. Os relatórios não detalhados incluem a mensagem original como um anexo para permitir que o destinatário do relatório reenviar a mensagem caso o que bloqueou a entrega não seja mais um problema. A mensagem anexada se assemelha ao original como existia quando o método IMessage::SubmitMessage foi chamado para enviá-lo inicialmente.
Um ou mais relatórios de entrega status são gerados por provedores de transporte quando eles chamam o método IMAPISupport::StatusRecips. Os provedores de transporte compõem uma lista de destinatários para uma mensagem. Se um destinatário recebe ou não um relatório e o tipo de relatório gerado depende do seguinte:
Os relatórios de entrega vão para destinatários que definem a propriedade PR_ORIGINATOR_DELIVERY_REPORT_REQUESTED (PidTagOriginatorDeliveryReportRequested) como TRUE antes da mensagem ser colocada no repositório de mensagens.
Os relatórios nondelivery vão para destinatários que não definiram a propriedade PR_ORIGINATOR_NON_DELIVERY_REPORT_REQUESTED (PidTagOriginatorNonDeliveryReportRequested) como FALSE.
Quase todas as informações necessárias para exibir um relatório não detalhado estão contidas na tabela de destinatário da mensagem anexada. Algumas propriedades são do próprio relatório. Para relatórios de entrega, as informações necessárias estão contidas na tabela de destinatário do relatório e em algumas propriedades do relatório.
Os relatórios são mensagens com classes de mensagem distintas, com base na classe da mensagem enviada. A maioria dos provedores de serviços usa uma convenção de nomenclatura na qual a classe de mensagem é composta por várias partes separadas por períodos. A primeira parte é "Relatório" e a última parte é uma constante que representa o tipo de relatório. A parte intermediária é reservada para a classe da mensagem enviada. Por exemplo, como um relatório de entrega usa a DR constante, a classe de mensagem para um relatório de entrega sobre um IPM. A mensagem de observação seria Report.IPM.Note.DR.
A tabela a seguir mostra as constantes que representam os tipos de relatórios.
| Tipo de relatório | Constante usada na classe de mensagem |
|---|---|
| Leitura |
IPNRN |
| Não lido |
IPNNRN |
| Entrega |
DR |
| Nondelivery |
NDR |
Clientes interativos podem exibir mensagens de relatório usando formulários padrão fornecidos pelo MAPI ou formulários personalizados que foram registrados com o gerenciador de formulários para a classe de mensagens do relatório. Clientes que recebem um relatório não detalhado de um IPM. A mensagem de observação, por exemplo, pode exibir o formulário MAPI padrão que apresenta uma lista dos destinatários com falha e um motivo sugerido para a falha. O formulário também permite que o usuário reenvia a mensagem, se desejar.