Office.DecryptedMessageAttachment interface
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Representa un archivo adjunto en un mensaje descifrado.
Comentarios
[ Conjunto de API: versión preliminar del buzón ]
Nivel mínimo de permiso: elemento de lectura y escritura
Modo de Outlook aplicable: Lectura de mensajes
Para obtener información sobre cómo desarrollar un complemento de cifrado en Outlook, consulte Creación de un complemento de Cifrado de Outlook.
Ejemplos
// 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" }
}
);
}
Propiedades
| attachment |
Especifica el tipo de datos adjuntos. |
| content | Especifica el contenido codificado en Base64 de los datos adjuntos. |
| content |
Especifica el identificador de contenido de los datos adjuntos insertados. La |
| is |
Si es true, especifica que los datos adjuntos descifrados aparecen como una imagen en el cuerpo del mensaje en lugar de en la lista de datos adjuntos. Si no se especifica la |
| name | Especifica el nombre de los datos adjuntos. |
| path | Especifica la ruta de acceso de referencia de dirección URL de los datos adjuntos si su tipo es |
Detalles de las propiedades
attachmentType
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Especifica el tipo de datos adjuntos.
attachmentType: MailboxEnums.AttachmentType;Valor de propiedad
Comentarios
[ Conjunto de API: versión preliminar del buzón ]
Nivel mínimo de permiso: elemento de lectura y escritura
Modo de Outlook aplicable: Lectura de mensajes
content
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Especifica el contenido codificado en Base64 de los datos adjuntos.
content: string;Valor de propiedad
string
Comentarios
[ Conjunto de API: versión preliminar del buzón ]
Nivel mínimo de permiso: elemento de lectura y escritura
Modo de Outlook aplicable: Lectura de mensajes
Importante: La content propiedad no es compatible con los datos adjuntos de tipo MailboxEnums.AttachmentType.Cloud.
contentId
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Especifica el identificador de contenido de los datos adjuntos insertados.
La contentId propiedad debe especificarse si isInline está establecida en true.
contentId?: string;Valor de propiedad
string
Comentarios
[ Conjunto de API: versión preliminar del buzón ]
Nivel mínimo de permiso: elemento de lectura y escritura
Modo de Outlook aplicable: Lectura de mensajes
Importante: Cuando se agregan imágenes a un mensaje como datos adjuntos insertados, se les asigna automáticamente un identificador de contenido. En el cuerpo de un mensaje, se especifica el identificador de contenido de los datos adjuntos insertados en el src atributo del <img> elemento (por ejemplo, <img width=96 height=96 id="Picture_1" src="cid:image001.png@01DC1E6F.FC7C7410">). Para identificar y proporcionar fácilmente estos datos adjuntos insertados durante el descifrado, se recomienda guardar los identificadores de contenido de los datos adjuntos insertados en el encabezado del mensaje durante el cifrado. Llame Office.context.mailbox.item.getAttachmentsAsync a para obtener el identificador de contenido de los datos adjuntos insertados. A continuación, llame Office.context.mailbox.item.internetHeaders.setAsync a para guardar el identificador en el encabezado del mensaje.
isInline
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Si es true, especifica que los datos adjuntos descifrados aparecen como una imagen en el cuerpo del mensaje en lugar de en la lista de datos adjuntos. Si no se especifica la isInline propiedad , su valor se establece en false.
isInline?: boolean;Valor de propiedad
boolean
Comentarios
[ Conjunto de API: versión preliminar del buzón ]
Nivel mínimo de permiso: elemento de lectura y escritura
Modo de Outlook aplicable: Lectura de mensajes
name
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Especifica el nombre de los datos adjuntos.
name: string;Valor de propiedad
string
Comentarios
[ Conjunto de API: versión preliminar del buzón ]
Nivel mínimo de permiso: elemento de lectura y escritura
Modo de Outlook aplicable: Lectura de mensajes
path
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Especifica la ruta de acceso de referencia de dirección URL de los datos adjuntos si su tipo es MailboxEnums.AttachmentType.Cloud. La path propiedad debe especificarse para los datos adjuntos de tipo MailboxEnums.AttachmentType.Cloud.
path?: string;Valor de propiedad
string
Comentarios
[ Conjunto de API: versión preliminar del buzón ]
Nivel mínimo de permiso: elemento de lectura y escritura
Modo de Outlook aplicable: Lectura de mensajes