Excel.SensitivityLabelsCatalog class

Paket:

excel

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt Methoden bereit, um den Status des Katalogs der Vertraulichkeitsbezeichnungen in Excel zu überprüfen und alle verfügbaren Vertraulichkeitsbezeichnungen abzurufen, wenn der Katalog aktiviert ist.

Extends

OfficeExtension.ClientObject

Hinweise

API-Satz: ExcelApi BETA (NUR VORSCHAU)

Verwendet von

• Excel.RequestContext: sensitivityLabelsCatalog

Eigenschaften

context	Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.
getLabelingCapabilities	Ruft die Bezeichnungsfunktionen für Excel ab. Wird verwendet Array.includes , um festzustellen, ob eine Funktion verfügbar ist.
getLabelingCapability	Ruft ab, ob der Katalog der Vertraulichkeitsbezeichnungen in Excel aktiviert ist.

Methoden

getAttributes()	Ruft die Metadaten des attributbasierten Zugriffssteuerungs-Attributkatalogs (ABAC) für ABAC-fähige Etiketten ab. Überprüfen Sie, ob die Bezeichnungsfunktionen des Hosts enthalten sind attributeBasedAccessControlEnabled. Andernfalls schlägt diese Methode mit einem Fehler fehl.
getLabels()	Ruft Vertraulichkeitsbezeichnungen ab, die für den aktuellen Benutzer verfügbar sind.
load(options)	Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
load(propertyNames)	Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
load(propertyNamesAndPaths)	Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
toJSON()	Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON Methode des Objekts auf, das an sie übergeben wird.) Während das ursprüngliche Excel.SensitivityLabelsCatalog Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als Excel.Interfaces.SensitivityLabelsCatalogData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

Details zur Eigenschaft

context

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

context: RequestContext;

Eigenschaftswert

Excel.RequestContext

getLabelingCapabilities

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Ruft die Bezeichnungsfunktionen für Excel ab. Wird verwendet Array.includes , um festzustellen, ob eine Funktion verfügbar ist.

readonly getLabelingCapabilities: Excel.LabelingCapability[];

Eigenschaftswert

Excel.LabelingCapability[]

Hinweise

API-Satz: ExcelApi BETA (NUR VORSCHAU)

getLabelingCapability

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Ruft ab, ob der Katalog der Vertraulichkeitsbezeichnungen in Excel aktiviert ist.

readonly getLabelingCapability: Excel.LabelingCapability | "NoLicense" | "LabelingDisabled" | "LabelingPolicyNotFound" | "LabelingEnabled" | "AttributeBasedAccessControlEnabled";

Eigenschaftswert

Excel.LabelingCapability | "NoLicense" | "LabelingDisabled" | "LabelingPolicyNotFound" | "LabelingEnabled" | "AttributeBasedAccessControlEnabled"

Hinweise

API-Satz: ExcelApi BETA (NUR VORSCHAU)

Details zur Methode

getAttributes()

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Ruft die Metadaten des attributbasierten Zugriffssteuerungs-Attributkatalogs (ABAC) für ABAC-fähige Etiketten ab. Überprüfen Sie, ob die Bezeichnungsfunktionen des Hosts enthalten sind attributeBasedAccessControlEnabled. Andernfalls schlägt diese Methode mit einem Fehler fehl.

getAttributes(): OfficeExtension.ClientResult<SensitivityLabelAbacAttribute[]>;

Gibt zurück

OfficeExtension.ClientResult<Excel.SensitivityLabelAbacAttribute[]>

Die verfügbaren ABAC-Attribute für den aktuellen Benutzer.

Hinweise

API-Satz: ExcelApi BETA (NUR VORSCHAU)

getLabels()

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Ruft Vertraulichkeitsbezeichnungen ab, die für den aktuellen Benutzer verfügbar sind.

getLabels(): Excel.SensitivityLabelDetailsCollection;

Gibt zurück

Excel.SensitivityLabelDetailsCollection

Das aktuelle SensitivityLabelDetailsCollection Objekt.

Hinweise

API-Satz: ExcelApi BETA (NUR VORSCHAU)

load(options)

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(options?: Excel.Interfaces.SensitivityLabelsCatalogLoadOptions): Excel.SensitivityLabelsCatalog;

Parameter

options

Excel.Interfaces.SensitivityLabelsCatalogLoadOptions

Stellt Optionen für die zu ladenden Eigenschaften des Objekts bereit.

Gibt zurück

Excel.SensitivityLabelsCatalog

load(propertyNames)

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNames?: string | string[]): Excel.SensitivityLabelsCatalog;

Parameter

propertyNames

string | string[]

Eine durch Trennzeichen getrennte Zeichenfolge oder ein Array von Zeichenfolgen, die die zu ladenden Eigenschaften angeben.

Gibt zurück

Excel.SensitivityLabelsCatalog

load(propertyNamesAndPaths)

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.SensitivityLabelsCatalog;

Parameter

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select ist eine durch Kommas getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und propertyNamesAndPaths.expand eine durch Kommas getrennte Zeichenfolge, die die zu ladenden Navigationseigenschaften angibt.

Gibt zurück

Excel.SensitivityLabelsCatalog

toJSON()

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON Methode des Objekts auf, das an sie übergeben wird.) Während das ursprüngliche Excel.SensitivityLabelsCatalog Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als Excel.Interfaces.SensitivityLabelsCatalogData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

toJSON(): Excel.Interfaces.SensitivityLabelsCatalogData;

Gibt zurück

Excel.Interfaces.SensitivityLabelsCatalogData