Compartilhar via


Office.DecryptedMessageAttachment interface

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Representa um anexo numa mensagem desencriptada.

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Leitura da Mensagem

Para saber como desenvolver um suplemento de encriptação no Outlook, consulte Criar um suplemento do Outlook de encriptação.

Exemplos

// This sample handles the OnMessageRead event to decrypt the body and attachments of a message.
function onMessageReadHandler(event) {
    // Your code to decrypt the contents of a message would appear here.
    ...

    // Use the results from your decryption process to display the decrypted contents of the message body and attachments.
    const decryptedBodyContent = "<p>Please find attached the recent report and its supporting documentation.</p>";
    const decryptedBody = {
        coercionType: Office.CoercionType.Html,
        content: decryptedBodyContent
    };

    // Decrypted content and properties of a file attachment.
    const decryptedPdfFile = "JVBERi0xLjQKJeLjz9MKNCAwIG9i...";
    const pdfFileName = "Fabrikam_Report_202509";

    // Decrypted content and properties of a mail item.
    const decryptedEmailFile = "VGhpcyBpcyBhIHRleHQgZmlsZS4=...";
    const emailFileName = "Fabrikam_Report_202508.eml";

    // Decrypted properties of a cloud attachment.
    const cloudFilePath = "https://contosostorage.com/reports/weekly_forecast.xlsx";
    const cloudFileName = "weekly_forecast.xlsx";

    // Decrypted content and properties of an inline image.
    const decryptedImageFile = "iVBORw0KGgoAAAANSUhEUgAA...";
    const imageFileName = "banner.png";
    const imageContentId = "image001.png@01DC1DD9.1A4AA300";

    const decryptedAttachments = [
        {
            attachmentType: Office.MailboxEnums.AttachmentType.File,
            content: decryptedPdfFile,
            isInline: false,
            name: pdfFileName
        },
        {
            attachmentType: Office.MailboxEnums.AttachmentType.Item,
            content: decryptedEmailFile,
            isInline: false,
            name: emailFileName
        },
        {
            attachmentType: Office.MailboxEnums.AttachmentType.Cloud,
            isInline: false,
            name: cloudFileName,
            path: cloudFilePath
        },
        {
            attachmentType: Office.MailboxEnums.AttachmentType.File,
            content: decryptedImageFile,
            contentId: imageContentId,
            isInline: true,
            name: imageFileName
        }
    ];

    event.completed(
        {
            allowEvent: true,
            emailBody: decryptedBody,
            attachments: decryptedAttachments,
            contextData: { messageType: "ReplyFromDecryptedMessage" }
        }
    );
}

Propriedades

attachmentType

Especifica o tipo de anexo.

content

Especifica o conteúdo codificado em Base64 do anexo.

contentId

Especifica o identificador de conteúdo de um anexo inline.

A contentId propriedade tem de ser especificada se isInline estiver definida como true.

isInline

Se for verdadeiro, especifica que o anexo desencriptado aparece como uma imagem no corpo da mensagem em vez de na lista de anexos. Se a propriedade não for especificada, o isInline respetivo valor é definido como falso.

name

Especifica o nome do anexo.

path

Especifica o caminho de referência do URL do anexo se o respetivo tipo for MailboxEnums.AttachmentType.Cloud. A path propriedade tem de ser especificada para anexos do tipo MailboxEnums.AttachmentType.Cloud.

Detalhes da propriedade

attachmentType

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Especifica o tipo de anexo.

attachmentType: MailboxEnums.AttachmentType;

Valor da propriedade

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Leitura da Mensagem

content

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Especifica o conteúdo codificado em Base64 do anexo.

content: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Leitura da Mensagem

Importante: a content propriedade não é suportada por anexos do tipo MailboxEnums.AttachmentType.Cloud.

contentId

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Especifica o identificador de conteúdo de um anexo inline.

A contentId propriedade tem de ser especificada se isInline estiver definida como true.

contentId?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Leitura da Mensagem

Importante: quando as imagens são adicionadas a uma mensagem como anexos inline, é-lhes atribuído automaticamente um ID de conteúdo. No corpo de uma mensagem, o ID de conteúdo de um anexo inline é especificado no src atributo do <img> elemento (por exemplo, <img width=96 height=96 id="Picture_1" src="cid:image001.png@01DC1E6F.FC7C7410">). Para identificar e fornecer facilmente estes anexos inline durante a desencriptação, recomendamos que guarde os IDs de conteúdo dos anexos inline no cabeçalho da mensagem durante a encriptação. Chame Office.context.mailbox.item.getAttachmentsAsync para obter o ID de conteúdo de um anexo inline. Em seguida, chame Office.context.mailbox.item.internetHeaders.setAsync para guardar o ID no cabeçalho da mensagem.

isInline

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Se for verdadeiro, especifica que o anexo desencriptado aparece como uma imagem no corpo da mensagem em vez de na lista de anexos. Se a propriedade não for especificada, o isInline respetivo valor é definido como falso.

isInline?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Leitura da Mensagem

name

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Especifica o nome do anexo.

name: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Leitura da Mensagem

path

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Especifica o caminho de referência do URL do anexo se o respetivo tipo for MailboxEnums.AttachmentType.Cloud. A path propriedade tem de ser especificada para anexos do tipo MailboxEnums.AttachmentType.Cloud.

path?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Leitura da Mensagem