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
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
get |
Ruft alle Vertraulichkeitsbezeichnungen ab, die in Outlook aktiviert sind. |
get |
Ruft alle Vertraulichkeitsbezeichnungen ab, die in Outlook aktiviert sind. |
get |
Überprüft, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist. |
get |
Ü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: asyncContext
Entwickler 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
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
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: asyncContext
Entwickler 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
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
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);
}
});
Office Add-ins