Share via


Office.SensitivityLabelsCatalog interface

Stellt Methoden bereit, um die status des Katalogs von Vertraulichkeitsbezeichnungen in Outlook zu überprüfen und alle verfügbaren Vertraulichkeitsbezeichnungen abzurufen, wenn der Katalog aktiviert ist.

Hinweise

[ API-Satz: Postfach 1.13 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Wichtig: Um die Vertraulichkeitsbezeichnungsfunktion in Ihrem Add-In verwenden zu können, benötigen Sie ein Microsoft 365 E5-Abonnement.

Weitere Informationen zum Verwalten von Vertraulichkeitsbezeichnungen in Ihrem Add-In finden Sie unter Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Verfassenmodus.

Methoden

getAsync(options, callback)

Ruft alle Vertraulichkeitsbezeichnungen ab, die in Outlook aktiviert sind.

getAsync(callback)

Ruft alle Vertraulichkeitsbezeichnungen ab, die in Outlook aktiviert sind.

getIsEnabledAsync(options, callback)

Überprüft, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist.

getIsEnabledAsync(callback)

Überprüft, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist.

Details zur Methode

getAsync(options, callback)

Ruft alle Vertraulichkeitsbezeichnungen ab, die in Outlook aktiviert sind.

getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<SensitivityLabelDetails[]>) => 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.SensitivityLabelDetails[]>) => void

Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter aufgerufen, asyncResult, der ein Office.AsyncResult -Objekt ist. Die verfügbaren Vertraulichkeitsbezeichnungen und ihre Eigenschaften werden in der asyncResult.value -Eigenschaft zurückgegeben.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.13 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Wichtig: Um die Vertraulichkeitsbezeichnungsfunktion in Ihrem Add-In verwenden zu können, benötigen Sie ein Microsoft 365 E5-Abonnement.

Empfohlen: Um zu bestimmen, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist, rufen Sie auf getIsEnabledAsync , bevor Sie verwenden getAsync.

Weitere Informationen zum Verwalten von Vertraulichkeitsbezeichnungen in Ihrem Add-In finden Sie unter Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Verfassenmodus.

getAsync(callback)

Ruft alle Vertraulichkeitsbezeichnungen ab, die in Outlook aktiviert sind.

getAsync(callback: (asyncResult: Office.AsyncResult<SensitivityLabelDetails[]>) => void): void;

Parameter

callback

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

Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter aufgerufen, asyncResult, der ein Office.AsyncResult -Objekt ist. Die verfügbaren Vertraulichkeitsbezeichnungen und ihre Eigenschaften werden in der asyncResult.value -Eigenschaft zurückgegeben.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.13 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Wichtig: Um die Vertraulichkeitsbezeichnungsfunktion in Ihrem Add-In verwenden zu können, benötigen Sie ein Microsoft 365 E5-Abonnement.

Empfohlen: Um zu bestimmen, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist, rufen Sie auf getIsEnabledAsync , bevor Sie verwenden getAsync.

Weitere Informationen zum Verwalten von Vertraulichkeitsbezeichnungen in Ihrem Add-In finden Sie unter Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Verfassenmodus.

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/60-sensitivity-label/sensitivity-labels-catalog.yaml

// This snippet gets all available sensitivity labels from the catalog.
Office.context.sensitivityLabelsCatalog.getIsEnabledAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded && asyncResult.value == true) {
    Office.context.sensitivityLabelsCatalog.getAsync((asyncResult) => {
      if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
        const catalog = asyncResult.value;
        console.log("Sensitivity Labels Catalog:");
        console.log(JSON.stringify(catalog));
      } else {
        console.log("Action failed with error: " + asyncResult.error.message);
      }
    });
  } else {
    console.log("Action failed with error: " + asyncResult.error.message);
  }
});

getIsEnabledAsync(options, callback)

Überprüft, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist.

getIsEnabledAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<boolean>) => 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<boolean>) => void

Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter aufgerufen, asyncResult, der ein Office.AsyncResult -Objekt ist. Die status des Katalogs der Vertraulichkeitsbezeichnungen wird in der asyncResult.value -Eigenschaft zurückgegeben.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.13 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Wichtig: Der Katalog der Vertraulichkeitsbezeichnungen wird vom Administrator eines organization konfiguriert. Weitere Informationen finden Sie unter Erste Schritte mit Vertraulichkeitsbezeichnungen.

Wichtig: Um die Vertraulichkeitsbezeichnungsfunktion in Ihrem Add-In verwenden zu können, benötigen Sie ein Microsoft 365 E5-Abonnement.

Weitere Informationen zum Verwalten von Vertraulichkeitsbezeichnungen in Ihrem Add-In finden Sie unter Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Verfassenmodus.

getIsEnabledAsync(callback)

Überprüft, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist.

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

Parameter

callback

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

Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter aufgerufen, asyncResult, der ein Office.AsyncResult -Objekt ist. Die status des Katalogs der Vertraulichkeitsbezeichnungen wird in der asyncResult.value -Eigenschaft zurückgegeben.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.13 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Wichtig: Der Katalog der Vertraulichkeitsbezeichnungen wird vom Administrator eines organization konfiguriert. Weitere Informationen finden Sie unter Erste Schritte mit Vertraulichkeitsbezeichnungen.

Wichtig: Um die Vertraulichkeitsbezeichnungsfunktion in Ihrem Add-In verwenden zu können, benötigen Sie ein Microsoft 365 E5-Abonnement.

Weitere Informationen zum Verwalten von Vertraulichkeitsbezeichnungen in Ihrem Add-In finden Sie unter Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Verfassenmodus.

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/60-sensitivity-label/sensitivity-labels-catalog.yaml

// This snippet determines if the sensitivity labels catalog is enabled on the current mailbox.
Office.context.sensitivityLabelsCatalog.getIsEnabledAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log(asyncResult.value);
  } else {
    console.log("Action failed with error: " + asyncResult.error.message);
  }
});