Office.DecryptedMessageAttachment interface

Stellt eine Anlage in einer entschlüsselten Nachricht dar.

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Nachricht lesen

Informationen zum Entwickeln eines Verschlüsselungs-Add-Ins in Outlook finden Sie unter Erstellen eines Verschlüsselungs-Add-Ins für Outlook.

Verwendet von

Beispiele

// 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" }
        }
    );
}

Eigenschaften

attachmentType

Gibt den Typ der Anlage an.

content

Gibt den Base64-codierten Inhalt der Anlage an.

contentId

Gibt den Inhaltsbezeichner einer Inline-Anlage an.

Die Eigenschaft muss angegeben werden, wenn isInline sie contentId auf truefestgelegt ist.

isInline

Bei "true" wird angegeben, dass die entschlüsselte Anlage als Bild im Nachrichtentext und nicht in der Anlagenliste angezeigt wird. Wenn die isInline Eigenschaft nicht angegeben ist, wird ihr Wert auf "false" festgelegt.

name

Gibt den Namen der Anlage an.

path

Gibt den URL-Referenzpfad der Anlage an, wenn ihr Typ ist MailboxEnums.AttachmentType.Cloud. Die path Eigenschaft muss für Anlagen des Typs angegeben MailboxEnums.AttachmentType.Cloudwerden.

Details zur Eigenschaft

attachmentType

Gibt den Typ der Anlage an.

attachmentType: MailboxEnums.AttachmentType;

Eigenschaftswert

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Nachricht lesen

Wichtig: Anlagen dieses Typs MailboxEnums.AttachmentType.Item werden derzeit in der Produktion nicht unterstützt. Sie können jedoch eine Vorschau der Unterstützung für diesen MailboxEnums.AttachmentType.Item Typ in Outlook im Web und unter Windows (neu und klassisch) anzeigen. Für das klassische Outlook unter Windows müssen Sie Version 2606 (Build 20114.15110) oder höher installieren. Treten Sie dann dem Microsoft 365 Insider-Programm bei, und wählen Sie die Option "Betakanal " aus, um auf Office-Betabuilds zuzugreifen.

content

Gibt den Base64-codierten Inhalt der Anlage an.

content: string;

Eigenschaftswert

string

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Nachricht lesen

Wichtig: Die content Eigenschaft wird von Anlagen des Typs .MailboxEnums.AttachmentType.Cloud

contentId

Gibt den Inhaltsbezeichner einer Inline-Anlage an.

Die Eigenschaft muss angegeben werden, wenn isInline sie contentId auf truefestgelegt ist.

contentId?: string;

Eigenschaftswert

string

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Nachricht lesen

Wichtig: Wenn Bilder als Inline-Anlagen zu einer Nachricht hinzugefügt werden, wird ihnen automatisch eine Inhalts-ID zugewiesen. Im Nachrichtentext wird die Inhalts-ID einer Inline-Anlage im src Attribut des <img> Elements angegeben (z. B <img width=96 height=96 id="Picture_1" src="cid:image001.png@01DC1E6F.FC7C7410">. ). Um diese Inlineanhänge während der Entschlüsselung einfach identifizieren und bereitstellen zu können, empfiehlt es sich, die Inhalts-IDs von Inlineanlagen während der Verschlüsselung im Nachrichtenkopf zu speichern. Rufen Sie an Office.context.mailbox.item.getAttachmentsAsync , um die Inhalts-ID einer Inline-Anlage abzurufen. Rufen Sie Office.context.mailbox.item.internetHeaders.setAsync dann an, um die ID im Header der Nachricht zu speichern.

isInline

Bei "true" wird angegeben, dass die entschlüsselte Anlage als Bild im Nachrichtentext und nicht in der Anlagenliste angezeigt wird. Wenn die isInline Eigenschaft nicht angegeben ist, wird ihr Wert auf "false" festgelegt.

isInline?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Nachricht lesen

name

Gibt den Namen der Anlage an.

name: string;

Eigenschaftswert

string

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Nachricht lesen

path

Gibt den URL-Referenzpfad der Anlage an, wenn ihr Typ ist MailboxEnums.AttachmentType.Cloud. Die path Eigenschaft muss für Anlagen des Typs angegeben MailboxEnums.AttachmentType.Cloudwerden.

path?: string;

Eigenschaftswert

string

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Nachricht lesen