Office.Categories interface

Referenz

Paket:: outlook

Stellt die Kategorien für ein Element dar.

In Outlook kann ein Benutzer Nachrichten und Termine markieren, indem er eine Kategorie verwendet, um sie farbig zu codieren. Der Benutzer definiert Kategorien in einer master Liste für sein Postfach. Anschließend können beliebig viele Kategorien auf ein Element angewendet werden.

Wichtig: In Outlook im Web und dem neuen Outlook unter Windows können Sie die API nicht verwenden, um Kategorien zu verwalten, die auf eine Nachricht im Compose Modus angewendet werden.

Hinweise

[ API-Satz: Postfach 1.8 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Methoden

addAsync(categories, options, callback)	Fügt einem Element Kategorien hinzu. Jede Kategorie muss sich in den Kategorien master Liste für dieses Postfach befinden und muss daher einen eindeutigen Namen haben, aber mehrere Kategorien können dieselbe Farbe verwenden.
addAsync(categories, callback)	Fügt einem Element Kategorien hinzu. Jede Kategorie muss sich in den Kategorien master Liste für dieses Postfach befinden und muss daher einen eindeutigen Namen haben, aber mehrere Kategorien können dieselbe Farbe verwenden.
getAsync(options, callback)	Ruft die Kategorien eines Elements ab. Wichtig: Wenn für das Element keine Kategorien vorhanden sind oder je nach Outlook-Version ein leeres Array zurückgegeben wird, stellen Sie sicher, `null` dass Sie beide Fälle behandeln. In Outlook im Web und dem neuen Outlook unter Windows können Sie die API nicht verwenden, um Kategorien zu verwalten, die auf eine Nachricht im Compose Modus angewendet werden.
getAsync(callback)	Ruft die Kategorien eines Elements ab. Wichtig: Wenn für das Element keine Kategorien vorhanden sind oder je nach Outlook-Version ein leeres Array zurückgegeben wird, stellen Sie sicher, `null` dass Sie beide Fälle behandeln. In Outlook im Web und dem neuen Outlook unter Windows können Sie die API nicht verwenden, um Kategorien zu verwalten, die auf eine Nachricht im Compose Modus angewendet werden.
removeAsync(categories, options, callback)	Entfernt Kategorien aus einem Element.
removeAsync(categories, callback)	Entfernt Kategorien aus einem Element.

Details zur Methode

addAsync(categories, options, callback)

Fügt einem Element Kategorien hinzu. Jede Kategorie muss sich in den Kategorien master Liste für dieses Postfach befinden und muss daher einen eindeutigen Namen haben, aber mehrere Kategorien können dieselbe Farbe verwenden.

addAsync(categories: string[], options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

categories: string[]

Die Kategorien, die dem Element hinzugefügt werden sollen.

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<void>) => void

Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.8 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Compose oder Lesen

Wichtig: In Outlook im Web und dem neuen Outlook unter Windows können Sie die API nicht verwenden, um Kategorien zu verwalten, die auf eine Nachricht oder ein Terminelement im Compose Modus angewendet werden.

Fehler:

InvalidCategory : Ungültige Kategorien wurden bereitgestellt.

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/45-categories/work-with-categories.yaml

// Note: In order for you to successfully add a category,
// it must be in the mailbox categories master list.

Office.context.mailbox.masterCategories.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const masterCategories = asyncResult.value;
    if (masterCategories && masterCategories.length > 0) {
      // Grab the first category from the master list.
      const categoryToAdd = [masterCategories[0].displayName];
      Office.context.mailbox.item.categories.addAsync(categoryToAdd, function(asyncResult) {
        if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
          console.log(`Successfully assigned category '${categoryToAdd}' to item.`);
        } else {
          console.log("categories.addAsync call failed with error: " + asyncResult.error.message);
        }
      });
    } else {
      console.log("There are no categories in the master list on this mailbox. You can add categories using Office.context.mailbox.masterCategories.addAsync.");
    }
  } else {
    console.error(asyncResult.error);
  }
});

addAsync(categories, callback)

addAsync(categories: string[], callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

categories: string[]

Die Kategorien, die dem Element hinzugefügt werden sollen.

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

Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.8 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Compose oder Lesen

Fehler:

InvalidCategory : Ungültige Kategorien wurden bereitgestellt.

getAsync(options, callback)

Ruft die Kategorien eines Elements ab.

Wichtig:

Wenn für das Element keine Kategorien vorhanden sind oder je nach Outlook-Version ein leeres Array zurückgegeben wird, stellen Sie sicher, null dass Sie beide Fälle behandeln.
In Outlook im Web und dem neuen Outlook unter Windows können Sie die API nicht verwenden, um Kategorien zu verwalten, die auf eine Nachricht im Compose Modus angewendet werden.

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

Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Wenn beim Abrufen von Kategorien ein Fehler auftritt, enthält die asyncResult.error Eigenschaft einen Fehlercode.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.8 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

getAsync(callback)

Ruft die Kategorien eines Elements ab.

Wichtig:

Wenn für das Element keine Kategorien vorhanden sind oder je nach Outlook-Version ein leeres Array zurückgegeben wird, stellen Sie sicher, null dass Sie beide Fälle behandeln.
In Outlook im Web und dem neuen Outlook unter Windows können Sie die API nicht verwenden, um Kategorien zu verwalten, die auf eine Nachricht im Compose Modus angewendet werden.

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

Parameter

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

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.8 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/45-categories/work-with-categories.yaml

Office.context.mailbox.item.categories.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const categories = asyncResult.value;
    if (categories && categories.length > 0) {
      console.log("Categories assigned to this item:");
      console.log(JSON.stringify(categories));
    } else {
      console.log("There are no categories assigned to this item.");
    }
  } else {
    console.error(asyncResult.error);
  }
});

removeAsync(categories, options, callback)

Entfernt Kategorien aus einem Element.

removeAsync(categories: string[], options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

categories: string[]

Die Kategorien, die aus dem Element entfernt werden sollen.

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<void>) => void

Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Wenn beim Entfernen von Kategorien ein Fehler auftritt, enthält die asyncResult.error Eigenschaft einen Fehlercode.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.8 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Compose oder Lesen

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/45-categories/work-with-categories.yaml

Office.context.mailbox.item.categories.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const categories = asyncResult.value;
    if (categories && categories.length > 0) {
      // Grab the first category assigned to this item.
      const categoryToRemove = [categories[0].displayName];
      Office.context.mailbox.item.categories.removeAsync(categoryToRemove, function(asyncResult) {
        if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
          console.log(`Successfully unassigned category '${categoryToRemove}' from this item.`);
        } else {
          console.log("categories.removeAsync call failed with error: " + asyncResult.error.message);
        }
      });
    } else {
      console.log("There are no categories assigned to this item.");
    }
  } else {
    console.error(asyncResult.error);
  }
});

removeAsync(categories, callback)

Entfernt Kategorien aus einem Element.

removeAsync(categories: string[], callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parameter

categories: string[]

Die Kategorien, die aus dem Element entfernt werden sollen.

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

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.8 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Compose oder Lesen

Freigeben über

Office.Categories interface

Hinweise

Methoden

Details zur Methode

addAsync(categories, options, callback)

Parameter

Gibt zurück

Hinweise

Beispiele

addAsync(categories, callback)

Parameter

Gibt zurück

Hinweise

getAsync(options, callback)

Parameter

Gibt zurück

Hinweise

getAsync(callback)

Parameter

Gibt zurück

Hinweise

Beispiele

removeAsync(categories, options, callback)

Parameter

Gibt zurück

Hinweise

Beispiele

removeAsync(categories, callback)

Parameter

Gibt zurück

Hinweise

Zusätzliche Ressourcen