Office.DecryptedMessageAttachment interface

Représente une pièce jointe dans un message déchiffré.

Remarques

Jeu d’API : Boîte aux lettres 1.16

Niveau d’autorisation minimal : lecture/écriture d’élément

Mode Outlook applicable : Message lu

Pour plus d’informations sur le développement d’un complément de chiffrement dans Outlook, voir Créer un complément de chiffrement Outlook.

Utilisateur

Exemples

// This sample handles the OnMessageDecrypt event to decrypt the body and attachments of a message.
function onMessageDecryptHandler(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 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.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" }
        }
    );
}

Propriétés

attachmentType

Spécifie le type de pièce jointe.

content

Spécifie le contenu codé en Base64 de la pièce jointe.

contentId

Spécifie l’identificateur de contenu d’une pièce jointe incorporée.

La contentId propriété doit être spécifiée si isInline est défini sur true.

isInline

Si la valeur est true, spécifie que la pièce jointe déchiffrée apparaît sous la forme d’une image dans le corps du message plutôt que dans la liste des pièces jointes. Si la isInline propriété n’est pas spécifiée, sa valeur est définie sur false.

name

Spécifie le nom de la pièce jointe.

path

Spécifie le chemin de référence d’URL de la pièce jointe si son type est MailboxEnums.AttachmentType.Cloud. La path propriété doit être spécifiée pour les pièces jointes de type MailboxEnums.AttachmentType.Cloud.

Détails de la propriété

attachmentType

Spécifie le type de pièce jointe.

attachmentType: MailboxEnums.AttachmentType;

Valeur de propriété

Remarques

Jeu d’API : Boîte aux lettres 1.16

Niveau d’autorisation minimal : lecture/écriture d’élément

Mode Outlook applicable : Message lu

Important : les pièces jointes de ce type MailboxEnums.AttachmentType.Item ne sont actuellement pas prises en charge en production. Toutefois, vous pouvez afficher un aperçu de la prise en charge de ce MailboxEnums.AttachmentType.Item type dans Outlook sur le web et sur Windows (nouveau et classique). Pour Outlook classique sur Windows, vous devez installer la version 2606 (Build 20114.15110) ou ultérieure. Rejoignez ensuite le programme Microsoft 365 Insider et sélectionnez l’option Canal bêta pour accéder aux builds bêta d’Office.

content

Spécifie le contenu codé en Base64 de la pièce jointe.

content: string;

Valeur de propriété

string

Remarques

Jeu d’API : Boîte aux lettres 1.16

Niveau d’autorisation minimal : lecture/écriture d’élément

Mode Outlook applicable : Message lu

Important : la content propriété n’est pas prise en charge par les pièces jointes de type MailboxEnums.AttachmentType.Cloud.

contentId

Spécifie l’identificateur de contenu d’une pièce jointe incorporée.

La contentId propriété doit être spécifiée si isInline est défini sur true.

contentId?: string;

Valeur de propriété

string

Remarques

Jeu d’API : Boîte aux lettres 1.16

Niveau d’autorisation minimal : lecture/écriture d’élément

Mode Outlook applicable : Message lu

Important : Lorsque des images sont ajoutées à un message en tant que pièces jointes, un ID de contenu leur est automatiquement attribué. Dans le corps d’un message, l’ID de contenu d’une pièce jointe incorporée est spécifié dans l’attribut src de l’élément <img> (par exemple, <img width=96 height=96 id="Picture_1" src="cid:image001.png@01DC1E6F.FC7C7410">). Pour identifier et fournir facilement ces pièces jointes incorporées pendant le déchiffrement, nous vous recommandons d’enregistrer les ID de contenu des pièces jointes incorporées dans l’en-tête du message pendant le chiffrement. Appelez Office.context.mailbox.item.getAttachmentsAsync pour obtenir l’ID de contenu d’une pièce jointe incorporée. Ensuite, appelez Office.context.mailbox.item.internetHeaders.setAsync pour enregistrer l’ID dans l’en-tête du message.

isInline

Si la valeur est true, spécifie que la pièce jointe déchiffrée apparaît sous la forme d’une image dans le corps du message plutôt que dans la liste des pièces jointes. Si la isInline propriété n’est pas spécifiée, sa valeur est définie sur false.

isInline?: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : Boîte aux lettres 1.16

Niveau d’autorisation minimal : lecture/écriture d’élément

Mode Outlook applicable : Message lu

name

Spécifie le nom de la pièce jointe.

name: string;

Valeur de propriété

string

Remarques

Jeu d’API : Boîte aux lettres 1.16

Niveau d’autorisation minimal : lecture/écriture d’élément

Mode Outlook applicable : Message lu

path

Spécifie le chemin de référence d’URL de la pièce jointe si son type est MailboxEnums.AttachmentType.Cloud. La path propriété doit être spécifiée pour les pièces jointes de type MailboxEnums.AttachmentType.Cloud.

path?: string;

Valeur de propriété

string

Remarques

Jeu d’API : Boîte aux lettres 1.16

Niveau d’autorisation minimal : lecture/écriture d’élément

Mode Outlook applicable : Message lu