Office.SensitivityLabelsCatalog interface
Stellt Methoden zum Überprüfen des Status des Katalogs von Vertraulichkeitsbezeichnungen in Outlook und zum Abrufen aller verfügbaren Vertraulichkeitsbezeichnungen bereit, wenn der Katalog aktiviert ist.
Hinweise
Mindestberechtigungsstufe: Element lesen/schreiben
Anwendbarer Outlook-Modus: Compose
Wichtig: Um das Feature für Vertraulichkeitsbezeichnungen in Ihrem Add-In verwenden zu können, müssen Sie über ein Microsoft 365 E5 Abonnement verfügen.
Weitere Informationen zum Verwalten von Vertraulichkeitsbezeichnungen in Ihrem Add-In finden Sie unter Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Kompositionsmodus.
Verwendet von
Methoden
| get |
Ruft alle in Outlook aktivierten Vertraulichkeitsbezeichnungen ab. |
| get |
Ruft alle in Outlook aktivierten Vertraulichkeitsbezeichnungen ab. |
| 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 in Outlook aktivierten Vertraulichkeitsbezeichnungen ab.
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, auf das sie zugreifen möchten, in der Rückruffunktion bereitstellen.
- callback
-
(asyncResult: Office.AsyncResult<Office.SensitivityLabelDetails[]>) => void
Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter, , aufgerufen, asyncResultder 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
Mindestberechtigungsstufe: Element lesen/schreiben
Anwendbarer Outlook-Modus: Compose
Wichtig: Um das Feature für Vertraulichkeitsbezeichnungen in Ihrem Add-In verwenden zu können, müssen Sie über ein Microsoft 365 E5 Abonnement verfügen.
Empfohlen: Um festzustellen, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist, rufen Sie vor der Verwendung getAsyncangetIsEnabledAsync.
Weitere Informationen zum Verwalten von Vertraulichkeitsbezeichnungen in Ihrem Add-In finden Sie unter Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Kompositionsmodus.
getAsync(callback)
Ruft alle in Outlook aktivierten Vertraulichkeitsbezeichnungen ab.
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, asyncResultder 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
Mindestberechtigungsstufe: Element lesen/schreiben
Anwendbarer Outlook-Modus: Compose
Wichtig: Um das Feature für Vertraulichkeitsbezeichnungen in Ihrem Add-In verwenden zu können, müssen Sie über ein Microsoft 365 E5 Abonnement verfügen.
Empfohlen: Um festzustellen, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist, rufen Sie vor der Verwendung getAsyncangetIsEnabledAsync.
Weitere Informationen zum Verwalten von Vertraulichkeitsbezeichnungen in Ihrem Add-In finden Sie unter Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Kompositionsmodus.
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, auf das sie zugreifen möchten, in der Rückruffunktion bereitstellen.
- callback
-
(asyncResult: Office.AsyncResult<boolean>) => void
Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter, , aufgerufen, asyncResultder ein Office.AsyncResult Objekt ist. Der Status des Katalogs der Vertraulichkeitsbezeichnungen wird in der asyncResult.value Eigenschaft zurückgegeben.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen/schreiben
Anwendbarer Outlook-Modus: Compose
Wichtig: Der Katalog der Vertraulichkeitsbezeichnungen wird vom Administrator einer organization konfiguriert. Weitere Informationen finden Sie unter Erste Schritte mit Vertraulichkeitsbezeichnungen.
Wichtig: Um das Feature für Vertraulichkeitsbezeichnungen in Ihrem Add-In verwenden zu können, müssen Sie über ein Microsoft 365 E5 Abonnement verfügen.
Weitere Informationen zum Verwalten von Vertraulichkeitsbezeichnungen in Ihrem Add-In finden Sie unter Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Kompositionsmodus.
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, asyncResultder ein Office.AsyncResult Objekt ist. Der Status des Katalogs der Vertraulichkeitsbezeichnungen wird in der asyncResult.value Eigenschaft zurückgegeben.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen/schreiben
Anwendbarer Outlook-Modus: Compose
Wichtig: Der Katalog der Vertraulichkeitsbezeichnungen wird vom Administrator einer organization konfiguriert. Weitere Informationen finden Sie unter Erste Schritte mit Vertraulichkeitsbezeichnungen.
Wichtig: Um das Feature für Vertraulichkeitsbezeichnungen in Ihrem Add-In verwenden zu können, müssen Sie über ein Microsoft 365 E5 Abonnement verfügen.
Weitere Informationen zum Verwalten von Vertraulichkeitsbezeichnungen in Ihrem Add-In finden Sie unter Verwalten der Vertraulichkeitsbezeichnung Ihrer Nachricht oder Ihres Termins im Kompositionsmodus.
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);
}
});