Abrufen und Festlegen von Kategorien

In Outlook kann ein Benutzer Kategorien auf Nachrichten und Termine anwenden, um seine Postfachdaten zu organisieren. Der Benutzer definiert die master Liste der farbcodierten Kategorien für sein Postfach und kann dann eine oder mehrere dieser Kategorien auf ein beliebiges Nachrichten- oder Terminelement anwenden. Jede Kategorie in der master Liste wird durch den Namen und die Farbe dargestellt, die der Benutzer angibt. Sie können die Office JavaScript-API verwenden, um die Kategorien master Liste für das Postfach und die Auf ein Element angewendeten Kategorien zu verwalten.

Hinweis

Die Unterstützung für dieses Feature wurde in Anforderungssatz 1.8 eingeführt. Siehe Clients und Plattformen, die diese Anforderungsgruppe unterstützen.

Verwalten von Kategorien in der master-Liste

Es sind nur Kategorien in der master Liste Ihres Postfachs verfügbar, die Sie auf eine Nachricht oder einen Termin anwenden können. Sie können die API verwenden, um master Kategorien hinzuzufügen, abzurufen und zu entfernen.

Wichtig

Damit das Add-In die Kategorien master Liste verwalten kann, muss es die Lese-/Schreibberechtigung des Postfachs im Manifest anfordern. Das Markup variiert je nach Art des Manifests.

• Nur Add-In-Manifest: Legen Sie das <Permissions-Element> auf ReadWriteMailbox fest.
• Einheitliches Manifest für Microsoft 365: Legen Sie die "name" -Eigenschaft eines Objekts im "authorization.permissions.resourceSpecific" Array auf fest "Mailbox.ReadWrite.User".

Hinzufügen master Kategorien

Das folgende Beispiel zeigt, wie Sie der liste master eine Kategorie mit dem Namen "Urgent!" hinzufügen, indem Sie addAsync für mailbox.masterCategories aufrufen.

const masterCategoriesToAdd = [
    {
        "displayName": "Urgent!",
        "color": Office.MailboxEnums.CategoryColor.Preset0
    }
];

Office.context.mailbox.masterCategories.addAsync(masterCategoriesToAdd, function (asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
        console.log("Successfully added categories to master list");
    } else {
        console.log("masterCategories.addAsync call failed with error: " + asyncResult.error.message);
    }
});

Abrufen master Kategorien

Im folgenden Beispiel wird gezeigt, wie Sie die Liste der Kategorien abrufen, indem Sie getAsync fürmailbox.masterCategories aufrufen.

Office.context.mailbox.masterCategories.getAsync(function (asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Failed) {
        console.log("Action failed with error: " + asyncResult.error.message);
    } else {
        const masterCategories = asyncResult.value;
        console.log("Master categories:");
        masterCategories.forEach(function (item) {
            console.log("-- " + JSON.stringify(item));
        });
    }
});

Entfernen master Kategorien

Das folgende Beispiel zeigt, wie Sie die Kategorie "Urgent!" aus der liste master entfernen, indem Sie removeAsync für mailbox.masterCategories aufrufen.

const masterCategoriesToRemove = ["Urgent!"];

Office.context.mailbox.masterCategories.removeAsync(masterCategoriesToRemove, function (asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
        console.log("Successfully removed categories from master list");
    } else {
        console.log("masterCategories.removeAsync call failed with error: " + asyncResult.error.message);
    }
});

Verwalten von Kategorien für eine Nachricht oder einen Termin

Sie können die API verwenden, um Kategorien für eine Nachricht oder ein Terminelement hinzuzufügen, abzurufen und zu entfernen.

Wichtig

Es sind nur Kategorien in der master Liste Ihres Postfachs verfügbar, die Sie auf eine Nachricht oder einen Termin anwenden können. Weitere Informationen finden Sie im vorherigen Abschnitt Verwalten von Kategorien in der liste master.

In Outlook im Web oder neuen Outlook unter Windows können Sie die API nicht verwenden, um Kategorien für eine Nachricht im Compose Modus zu verwalten.

Hinzufügen von Kategorien zu einem Element

Das folgende Beispiel zeigt, wie die Kategorie "Urgent!" auf das aktuelle Element angewendet wird, indem addAsync für aufgerufen wird item.categories.

const categoriesToAdd = ["Urgent!"];

Office.context.mailbox.item.categories.addAsync(categoriesToAdd, function (asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
        console.log("Successfully added categories");
    } else {
        console.log("categories.addAsync call failed with error: " + asyncResult.error.message);
    }
});

Abrufen der Kategorien eines Elements

Das folgende Beispiel zeigt, wie Sie die Kategorien abrufen, die auf das aktuelle Element angewendet werden, indem Sie getAsync für item.categoriesaufrufen.

Office.context.mailbox.item.categories.getAsync(function (asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Failed) {
        console.log("Action failed with error: " + asyncResult.error.message);
    } else {
        const categories = asyncResult.value;
        console.log("Categories:");
        categories.forEach(function (item) {
            console.log("-- " + JSON.stringify(item));
        });
    }
});

Entfernen von Kategorien aus einem Element

Im folgenden Beispiel wird gezeigt, wie Sie die Kategorie "Urgent!" aus dem aktuellen Element entfernen, indem Sie removeAsync für item.categoriesaufrufen.

const categoriesToRemove = ["Urgent!"];

Office.context.mailbox.item.categories.removeAsync(categoriesToRemove, function (asyncResult) {
    if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
        console.log("Successfully removed categories");
    } else {
        console.log("categories.removeAsync call failed with error: " + asyncResult.error.message);
    }
});

Siehe auch

• Outlook-Berechtigungen