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
| attachment |
Especifica o tipo de anexo. |
| content | Especifica o conteúdo codificado em Base64 do anexo. |
| content |
Especifica o identificador de conteúdo de um anexo inline. A |
| is |
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 |
| name | Especifica o nome do anexo. |
| path | Especifica o caminho de referência do URL do anexo se o respetivo tipo for |
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