Office.NotificationMessages interface

Referenz

Paket:: outlook

Das NotificationMessages-Objekt wird als notificationMessages-Eigenschaft eines Elements zurückgegeben.

Hinweise

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Methoden

addAsync(key, JSONmessage, options, callback)	Fügt eine Benachrichtigung zu einem Element hinzu. Es werden maximal 5 Benachrichtigungen pro Nachricht. Eine höhere Einstellung gibt einen `NumberOfNotificationMessagesExceeded`-Fehler zurück.
addAsync(key, JSONmessage, callback)	Fügt eine Benachrichtigung zu einem Element hinzu. Es werden maximal 5 Benachrichtigungen pro Nachricht. Eine höhere Einstellung gibt einen `NumberOfNotificationMessagesExceeded`-Fehler zurück.
getAllAsync(options, callback)	Gibt alle Schlüssel und Nachrichten für ein Element zurück.
getAllAsync(callback)	Gibt alle Schlüssel und Nachrichten für ein Element zurück.
removeAsync(key, options, callback)	Entfernt eine Benachrichtigung für ein Element.
removeAsync(key, callback)	Entfernt eine Benachrichtigung für ein Element.
replaceAsync(key, JSONmessage, options, callback)	Ersetzt eine Benachrichtigung, die über einen bestimmten Schlüssel mit einer anderen Nachricht verfügt. Wenn keine Benachrichtigung mit dem angegebenen Schlüssel vorhanden ist, fügt `replaceAsync` die Benachrichtigung hinzu.
replaceAsync(key, JSONmessage, callback)	Ersetzt eine Benachrichtigung, die über einen bestimmten Schlüssel mit einer anderen Nachricht verfügt. Wenn keine Benachrichtigung mit dem angegebenen Schlüssel vorhanden ist, fügt `replaceAsync` die Benachrichtigung hinzu.

Details zur Methode

addAsync(key, JSONmessage, options, callback)

Fügt eine Benachrichtigung zu einem Element hinzu.

Es werden maximal 5 Benachrichtigungen pro Nachricht. Eine höhere Einstellung gibt einen NumberOfNotificationMessagesExceeded-Fehler zurück.

addAsync(key: string, JSONmessage: NotificationMessageDetails, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

key: string

Ein vom Entwickler spezifizierter Schlüssel für einen Verweis auf diese Benachrichtigung. Entwickler können diese Zeichenfolge verwenden, um später die Nachricht zu ändern. Sie darf nicht länger als 32 Zeichen sein.

JSONmessage: Office.NotificationMessageDetails

Ein JSON-Objekt, das enthält die Benachrichtigung enthält, die dem Element hinzugefügt werden soll. Sie enthält ein NotificationMessageDetails -Objekt.

options: Office.AsyncContextOptions

Ein Objektliteral, das eine oder mehrere der folgenden Eigenschaften enthält: asyncContextEntwickler können jedes Objekt bereitstellen, auf das sie in der Rückruffunktion zugreifen möchten.

callback: (asyncResult: Office.AsyncResult<void>) => void

Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.3 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Wichtig:

Pro Add-In ist nur eine Benachrichtigung vom Typ InsightMessage zulässig. Der Versuch, weitere hinzuzufügen, löst einen Fehler aus.
Im modernen Outlook im Web und im neuen Outlook unter Windows können Sie eine InsightMessage Benachrichtigung nur im Verfassenmodus hinzufügen.
Nur der InformationalMessage Typ wird in Outlook unter Android und unter iOS unterstützt.

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/35-notifications/add-getall-remove.yaml

// Adds a progress indicator to the mail item.
const id = $("#notificationId").val().toString();
const details =
  {
    type: Office.MailboxEnums.ItemNotificationMessageType.ProgressIndicator,
    message: "Progress indicator with id = " + id
  };
Office.context.mailbox.item.notificationMessages.addAsync(id, details, handleResult);

...

// Adds an informational notification to the mail item.
const id = $("#notificationId").val().toString();
const details =
  {
    type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
    message: "Non-persistent informational notification message with id = " + id,
    icon: "icon1",
    persistent: false
  };
Office.context.mailbox.item.notificationMessages.addAsync(id, details, handleResult);

...

// Adds a persistent information notification to the mail item.
const id = $("#notificationId").val().toString();
const details =
  {
    type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
    message: "Persistent informational notification message with id = " + id,
    icon: "icon1",
    persistent: true
  };
Office.context.mailbox.item.notificationMessages.addAsync(id, details, handleResult);

...

// Adds an error notification to the mail item.
const id = $("#notificationId").val().toString();
const details =
  {
    type: Office.MailboxEnums.ItemNotificationMessageType.ErrorMessage,
    message: "Error notification message with id = " + id
  };
Office.context.mailbox.item.notificationMessages.addAsync(id, details, handleResult);

addAsync(key, JSONmessage, callback)

Fügt eine Benachrichtigung zu einem Element hinzu.

Es werden maximal 5 Benachrichtigungen pro Nachricht. Eine höhere Einstellung gibt einen NumberOfNotificationMessagesExceeded-Fehler zurück.

addAsync(key: string, JSONmessage: NotificationMessageDetails, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

key: string

JSONmessage: Office.NotificationMessageDetails

Ein JSON-Objekt, das enthält die Benachrichtigung enthält, die dem Element hinzugefügt werden soll. Sie enthält ein NotificationMessageDetails -Objekt.

callback: (asyncResult: Office.AsyncResult<void>) => void

Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.3 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Wichtig:

Pro Add-In ist nur eine Benachrichtigung vom Typ InsightMessage zulässig. Der Versuch, weitere hinzuzufügen, löst einen Fehler aus.
Im modernen Outlook im Web und im neuen Outlook unter Windows können Sie eine InsightMessage Benachrichtigung nur im Verfassenmodus hinzufügen.
Nur der InformationalMessage Typ wird in Outlook unter Android und unter iOS unterstützt.

getAllAsync(options, callback)

Gibt alle Schlüssel und Nachrichten für ein Element zurück.

getAllAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<NotificationMessageDetails[]>) => void): void;

Parameter

options: Office.AsyncContextOptions

Ein Objektliteral, das eine oder mehrere der folgenden Eigenschaften enthält: asyncContextEntwickler können jedes Objekt bereitstellen, auf das sie in der Rückruffunktion zugreifen möchten.

callback: (asyncResult: Office.AsyncResult<Office.NotificationMessageDetails[]>) => void

Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Die value -Eigenschaft des Ergebnisses ist ein Array von NotificationMessageDetails -Objekten.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.3 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/35-notifications/add-getall-remove.yaml

// Gets all the notification messages and their keys for the current mail item.
Office.context.mailbox.item.notificationMessages.getAllAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Failed) {
    console.log(asyncResult.error.message);
    return;
  }

  console.log(asyncResult.value);
});

getAllAsync(callback)

Gibt alle Schlüssel und Nachrichten für ein Element zurück.

getAllAsync(callback?: (asyncResult: Office.AsyncResult<NotificationMessageDetails[]>) => void): void;

Parameter

callback: (asyncResult: Office.AsyncResult<Office.NotificationMessageDetails[]>) => void

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.3 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

removeAsync(key, options, callback)

Entfernt eine Benachrichtigung für ein Element.

removeAsync(key: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

key: string

Der für die Benachrichtigung zu entfernende Schlüssel.

options: Office.AsyncContextOptions

Ein Objektliteral, das eine oder mehrere der folgenden Eigenschaften enthält: asyncContextEntwickler können jedes Objekt bereitstellen, auf das sie in der Rückruffunktion zugreifen möchten.

callback: (asyncResult: Office.AsyncResult<void>) => void

Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.3 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/35-notifications/add-getall-remove.yaml

// Removes a notification message from the current mail item.
const id = $("#notificationId").val().toString();
Office.context.mailbox.item.notificationMessages.removeAsync(id, handleResult);

removeAsync(key, callback)

Entfernt eine Benachrichtigung für ein Element.

removeAsync(key: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

key: string

Der für die Benachrichtigung zu entfernende Schlüssel.

callback: (asyncResult: Office.AsyncResult<void>) => void

Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.3 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

replaceAsync(key, JSONmessage, options, callback)

Ersetzt eine Benachrichtigung, die über einen bestimmten Schlüssel mit einer anderen Nachricht verfügt.

Wenn keine Benachrichtigung mit dem angegebenen Schlüssel vorhanden ist, fügt replaceAsync die Benachrichtigung hinzu.

replaceAsync(key: string, JSONmessage: NotificationMessageDetails, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

key: string

Der für die Benachrichtigung zu ersetzende Schlüssel. Er darf höchstens 32 Zeichen lang sein.

JSONmessage: Office.NotificationMessageDetails

Ein JSON-Objekt, das die neue Benachrichtigung zum Ersetzen der vorhandenen Benachrichtigung enthält. Sie enthält ein NotificationMessageDetails -Objekt.

options: Office.AsyncContextOptions

Ein Objektliteral, das eine oder mehrere der folgenden Eigenschaften enthält: asyncContextEntwickler können jedes Objekt bereitstellen, auf das sie in der Rückruffunktion zugreifen möchten.

callback: (asyncResult: Office.AsyncResult<void>) => void

Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.3 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/35-notifications/add-getall-remove.yaml

// Replaces a notification message of a given key with another message.
const id = $("#notificationId").val().toString();
Office.context.mailbox.item.notificationMessages.replaceAsync(
  id,
  {
    type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
    message: "Notification message with id = " + id + " has been replaced with an informational message.",
    icon: "icon2",
    persistent: false
  },
  handleResult);

replaceAsync(key, JSONmessage, callback)

Ersetzt eine Benachrichtigung, die über einen bestimmten Schlüssel mit einer anderen Nachricht verfügt.

Wenn keine Benachrichtigung mit dem angegebenen Schlüssel vorhanden ist, fügt replaceAsync die Benachrichtigung hinzu.

replaceAsync(key: string, JSONmessage: NotificationMessageDetails, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

key: string

Der für die Benachrichtigung zu ersetzende Schlüssel. Er darf höchstens 32 Zeichen lang sein.

JSONmessage: Office.NotificationMessageDetails

Ein JSON-Objekt, das die neue Benachrichtigung zum Ersetzen der vorhandenen Benachrichtigung enthält. Sie enthält ein NotificationMessageDetails -Objekt.

callback: (asyncResult: Office.AsyncResult<void>) => void

Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.3 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Freigeben über

Office.NotificationMessages interface

Hinweise

Methoden

Details zur Methode

addAsync(key, JSONmessage, options, callback)

Parameter

Gibt zurück

Hinweise

Beispiele

addAsync(key, JSONmessage, callback)

Parameter

Gibt zurück

Hinweise

getAllAsync(options, callback)

Parameter

Gibt zurück

Hinweise

Beispiele

getAllAsync(callback)

Parameter

Gibt zurück

Hinweise

removeAsync(key, options, callback)

Parameter

Gibt zurück

Hinweise

Beispiele

removeAsync(key, callback)

Parameter

Gibt zurück

Hinweise

replaceAsync(key, JSONmessage, options, callback)

Parameter

Gibt zurück

Hinweise

Beispiele

replaceAsync(key, JSONmessage, callback)

Parameter

Gibt zurück

Hinweise

Zusätzliche Ressourcen