Office.DelayDeliveryTime interface

Mit diesem DelayDeliveryTime Objekt können Sie das Datum und die Uhrzeit der verzögerten Zustellung einer Nachricht verwalten.

Hinweise

API-Satz: Mailbox 1.13

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose

Verwendet von

Methoden

getAsync(options, callback)	Ruft das Datum und die Uhrzeit der Zustellung einer Nachricht ab.
getAsync(callback)	Ruft das Datum und die Uhrzeit der Zustellung einer Nachricht ab.
setAsync(datetime, options, callback)	Legt das Übermittlungsdatum und die Übermittlungszeit einer Nachricht fest.
setAsync(datetime, callback)	Legt das Übermittlungsdatum und die Übermittlungszeit einer Nachricht fest.

getAsync(options, callback)

Ruft das Datum und die Uhrzeit der Zustellung einer Nachricht ab.

getAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<Date | 0>) => void): void;

Parameter

options: Office.AsyncContextOptions

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

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

Optional. Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter, , aufgerufen, asyncResultder ein Office.AsyncResult Objekt ist. Das Datum und die Uhrzeit der Zustellung einer Nachricht werden in der asyncResult.value Eigenschaft zurückgegeben. Wenn für eine Nachricht noch kein Zustelldatum festgelegt wurde, 0 wird stattdessen zurückgegeben.

Gibt zurück

void

Hinweise

API-Satz: Mailbox 1.13

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose

getAsync(callback)

Ruft das Datum und die Uhrzeit der Zustellung einer Nachricht ab.

getAsync(callback?: (asyncResult: Office.AsyncResult<Date | 0>) => void): void;

Parameter

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

Optional. Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter, , aufgerufen, asyncResultder ein Office.AsyncResult Objekt ist. Das Datum und die Uhrzeit der Zustellung einer Nachricht werden in der asyncResult.value Eigenschaft zurückgegeben. Wenn für eine Nachricht noch kein Zustelldatum festgelegt wurde, 0 wird stattdessen zurückgegeben.

Gibt zurück

void

Hinweise

API-Satz: Mailbox 1.13

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/delay-message-delivery.yaml

// This snippet gets the delivery date and time of a message.
Office.context.mailbox.item.delayDeliveryTime.getAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Failed) {
    console.log(asyncResult.error.message);
    return;
  }

  const deliveryDate = asyncResult.value;
  if (deliveryDate === 0) {
    console.log("Your message will be delivered immediately when you select Send.");
  } else {
    const date = new Date(deliveryDate);
    console.log(`Message delivery date and time: ${date.toString()}`);
  }
});

setAsync(datetime, options, callback)

Legt das Übermittlungsdatum und die Übermittlungszeit einer Nachricht fest.

setAsync(datetime: Date, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

datetime: Date

Das zukünftige Datum und die Uhrzeit, zu der die Nachricht gesendet werden soll.

options: Office.AsyncContextOptions

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

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

Optional. Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter, , aufgerufen, asyncResultder ein Office.AsyncResult Objekt ist. Alle aufgetretenen Fehler werden in der asyncResult.error-Eigenschaft bereitgestellt.

Gibt zurück

void

Hinweise

API-Satz: Mailbox 1.13

Mindestberechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Compose

Wichtig:

Wenn item.delayDeliveryTime.setAsync die Verzögerung verwendet wird, um die Zustellung einer Nachricht zu planen, wird sie auf dem Server verarbeitet. Dadurch kann die Nachricht auch dann gesendet werden, wenn der Outlook-Client nicht ausgeführt wird. Im klassischen Outlook unter Windows wird die Nachricht nicht im Ordner "Postausgang " angezeigt, sodass Sie die Nachricht nicht bearbeiten oder die Zustellung abbrechen können, nachdem Sie " Senden" ausgewählt haben. Sie können nur die Nachricht aus dem Ordner " Gesendete Objekte " überprüfen. In Outlook im Web, auf dem Mac und im neuen Outlook unter Windows wird die Nachricht bis zum geplanten Zustellzeitpunkt im Ordner "Entwürfe" angezeigt. Während sie sich im Ordner "Entwürfe " befindet, können Sie die Nachricht bearbeiten, bevor sie gesendet wird. Weitere Informationen finden Sie unter Verwalten von Übermittlungsdatum und -uhrzeit einer Nachricht.
Die setAsync Methode wird für eine Nachricht, die derzeit mit der loadItemByIdAsync Methode geladen wird, nicht unterstützt. Weitere Informationen finden Sie unter "Aktivieren Ihres Outlook-Add-Ins für mehrere Nachrichten".

Fehler:

InvalidFormatError - Das Format des angegebenen Datenobjekts ist ungültig.

setAsync(datetime, callback)

Legt das Übermittlungsdatum und die Übermittlungszeit einer Nachricht fest.

setAsync(datetime: Date, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

datetime: Date

Das zukünftige Datum und die Uhrzeit, zu der die Nachricht gesendet werden soll.

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

Optional. Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter, , aufgerufen, asyncResultder ein Office.AsyncResult Objekt ist. Alle aufgetretenen Fehler werden in der asyncResult.error-Eigenschaft bereitgestellt.

Gibt zurück

void

Hinweise

API-Satz: Mailbox 1.13

Mindestberechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Compose

Wichtig:

Wenn item.delayDeliveryTime.setAsync die Verzögerung verwendet wird, um die Zustellung einer Nachricht zu planen, wird sie auf dem Server verarbeitet. Dadurch kann die Nachricht auch dann gesendet werden, wenn der Outlook-Client nicht ausgeführt wird. Im klassischen Outlook unter Windows wird die Nachricht nicht im Ordner "Postausgang " angezeigt, sodass Sie die Nachricht nicht bearbeiten oder die Zustellung abbrechen können, nachdem Sie " Senden" ausgewählt haben. Sie können nur die Nachricht aus dem Ordner " Gesendete Objekte " überprüfen. In Outlook im Web, auf dem Mac und im neuen Outlook unter Windows wird die Nachricht bis zum geplanten Zustellzeitpunkt im Ordner "Entwürfe" angezeigt. Während sie sich im Ordner "Entwürfe " befindet, können Sie die Nachricht bearbeiten, bevor sie gesendet wird. Weitere Informationen finden Sie unter Verwalten von Übermittlungsdatum und -uhrzeit einer Nachricht.
Die setAsync Methode wird für eine Nachricht, die derzeit mit der loadItemByIdAsync Methode geladen wird, nicht unterstützt. Weitere Informationen finden Sie unter "Aktivieren Ihres Outlook-Add-Ins für mehrere Nachrichten".

Fehler:

InvalidFormatError - Das Format des angegebenen Datenobjekts ist ungültig.

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/delay-message-delivery.yaml

function setDeliveryDate(minutes) {
  // This snippet sets the delivery date and time of a message.
  const currentTime = new Date().getTime();
  const milliseconds = totalDelay * 60000;
  const timeDelay = new Date(currentTime + milliseconds);
  Office.context.mailbox.item.delayDeliveryTime.setAsync(timeDelay, (asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Failed) {
      console.log(asyncResult.error.message);
      return;
    }

    if (minutes === 1440) {
      console.log(`Delayed delivery by an additional one day.`);
    } else {
      console.log(`Delayed delivery by an additional ${minutes} minutes.`);
    }
  });
}

Hinweise

Verwendet von

Methoden

Details zur Methode

getAsync(options, callback)

Parameter

Gibt zurück

Hinweise

getAsync(callback)

Parameter

Gibt zurück

Hinweise

Beispiele

setAsync(datetime, options, callback)

Parameter

Gibt zurück

Hinweise

setAsync(datetime, callback)

Parameter

Gibt zurück

Hinweise

Beispiele

Feedback