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
| attachment |
Gibt den Typ der Anlage an. |
| content | Gibt den Base64-codierten Inhalt der Anlage an. |
| content |
Gibt den Inhaltsbezeichner einer Inlineanlage an. Die |
| is |
Wenn true, gibt an, dass die entschlüsselte Anlage als Bild im Nachrichtentext und nicht in der Anlagenliste angezeigt wird. Wenn die |
| name | Gibt den Namen der Anlage an. |
| path | Gibt den URL-Verweispfad der Anlage an, wenn ihr Typ ist |
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