Freigeben über


Office.DecryptedMessageAttachment interface

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt eine Anlage in einer entschlüsselten Nachricht dar.

Hinweise

[ API-Satz: Postfachvorschau ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Lesen von Nachrichten

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

Beispiele

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

Eigenschaften

attachmentType

Gibt den Typ der Anlage an.

content

Gibt den Base64-codierten Inhalt der Anlage an.

contentId

Gibt den Inhaltsbezeichner einer Inlineanlage an.

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

isInline

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

name

Gibt den Namen der Anlage an.

path

Gibt den URL-Verweispfad der Anlage an, wenn ihr Typ ist MailboxEnums.AttachmentType.Cloud. Die path -Eigenschaft muss für Anlagen vom Typ MailboxEnums.AttachmentType.Cloudangegeben werden.

Details zur Eigenschaft

attachmentType

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Gibt den Typ der Anlage an.

attachmentType: MailboxEnums.AttachmentType;

Eigenschaftswert

Hinweise

[ API-Satz: Postfachvorschau ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Lesen von Nachrichten

content

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Gibt den Base64-codierten Inhalt der Anlage an.

content: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: Postfachvorschau ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Lesen von Nachrichten

Wichtig: Die content Eigenschaft wird von Anlagen vom Typ MailboxEnums.AttachmentType.Cloudnicht unterstützt.

contentId

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Gibt den Inhaltsbezeichner einer Inlineanlage an.

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

contentId?: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: Postfachvorschau ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Lesen von Nachrichten

Wichtig: Wenn Bilder einer Nachricht als Inlineanlagen hinzugefügt werden, wird ihnen automatisch eine Inhalts-ID zugewiesen. Im Textkörper einer Nachricht wird die Inhalts-ID einer Inlineanlage 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 Inlineanlagen während der Entschlüsselung einfach zu identifizieren und bereitzustellen, empfehlen wir, die Inhalts-IDs von Inlineanlagen während der Verschlüsselung im Nachrichtenheader zu speichern. Rufen Sie auf Office.context.mailbox.item.getAttachmentsAsync , um die Inhalts-ID einer Inlineanlage abzurufen. Rufen Sie dann auf Office.context.mailbox.item.internetHeaders.setAsync , um die ID im Header der Nachricht zu speichern.

isInline

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

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

isInline?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: Postfachvorschau ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Lesen von Nachrichten

name

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Gibt den Namen der Anlage an.

name: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: Postfachvorschau ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Lesen von Nachrichten

path

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Gibt den URL-Verweispfad der Anlage an, wenn ihr Typ ist MailboxEnums.AttachmentType.Cloud. Die path -Eigenschaft muss für Anlagen vom Typ MailboxEnums.AttachmentType.Cloudangegeben werden.

path?: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: Postfachvorschau ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Lesen von Nachrichten