Freigeben über

Aktivieren Ihres Outlook-Add-Ins ohne aktivierten Lesebereich oder ohne ausgewählte Nachricht

  • Artikel

Mit einer einfachen Manifestkonfiguration können Sie Outlook-Add-Ins für die Nachrichtenleseoberfläche erstellen, die einen Aufgabenbereich aktivieren, ohne dass der Lesebereich aktiviert ist oder eine Nachricht zuerst aus dem Postfach ausgewählt wurde. Dieses Feature wird als "kein Elementkontext" bezeichnet. Befolgen Sie die exemplarische Vorgehensweise, um mehr zu erfahren und zusätzliche Funktionen für Ihr Add-In freizuschalten. Beispielsweise können Sie Benutzern den Zugriff auf Inhalte aus verschiedenen Datenquellen wie OneDrive oder einem CRM-System (Customer Relationship Management) direkt über ihren Outlook-Client ermöglichen.

Hinweis

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

Obwohl Outlook im Web und das neue Outlook unter Windows den Anforderungssatz 1.13 unterstützen, wird ein Add-In nicht aktiviert, wenn der Lesebereich ausgeblendet oder eine Nachricht nicht ausgewählt ist. Weitere Informationen finden Sie unter Featureunterstützung in Outlook im Web und neuen Outlook unter Windows.

Einrichten der Umgebung

Schließen Sie den Outlook-Schnellstart ab , in dem Sie ein Outlook-Add-In mit dem Yeoman-Generator für Office-Add-Ins erstellen.

Informationen zum Aktivieren dieses Features in einem bereits vorhandenen Add-In-Projekt finden Sie unter Konfigurieren des Manifests.

Konfigurieren des Manifests

Die Schritte zum Konfigurieren des Manifests variieren je nachdem, welche Art von Manifest ihr Add-In verwendet.

  1. Öffnen Sie in Ihrem bevorzugten Code-Editor das Outlook-Schnellstartprojekt , das Sie erstellt haben.

  2. Öffnen Sie die manifest.json Datei, die sich im Stammverzeichnis des Projekts befindet.

  3. Gehen Sie im ersten Objekt im Array "extensions.runtimes" wie folgt vor:

    1. Ändern Sie "requirements.capabilities.minVersion" in "1.13".
    2. Fügen Sie dem Objekt im Array "actions" eine "supportsNoItemContext"-Eigenschaft hinzu, und legen Sie den Wert auf fest true.
    3. Fügen Sie demselben Objekt eine Multiselect-Eigenschaft hinzu, und legen Sie sie auf fest true.
    4. Ändern Sie die Eigenschaft "pinnable" im selben Objekt in true.

    Wenn Sie fertig sind, sollte es wie folgt aussehen.

    "runtimes": [
    {
        "requirements": {
            "capabilities": [
                {
                    "name": "Mailbox",
                    "minVersion": "1.13"
                }
            ]
        },
        "id": "TaskPaneRuntime",
        "type": "general",
        "code": {
            "page": "https://localhost:3000/taskpane.html"
        },
        "lifetime": "short",
        "actions": [
            {
                "id": "TaskPaneRuntimeShow",
                "type": "openPage",
                "view": "dashboard",
                "pinnable": true,
                "supportsNoItemContext": true,
                "multiselect": true
            }
        ]
    }
]

  4. Löschen Sie das zweite Objekt im Array "extensions.runtimes", dessen "id" "CommandsRuntime" ist.

  5. Das Array "extensions.ribbons.tabs.groups.controls" verfügt über zwei Objekte. Löschen Sie die zweite, deren "id" "ActionButton" ist.

Konfigurieren des Aufgabenbereichs

  1. Navigieren Sie in Ihrem Projekt zum Ordner taskpane , und öffnen Sie danntaskpane.html.

  2. Ersetzen Sie das gesamte <Body-Element> durch das folgende Markup.

    <body class="ms-font-m ms-welcome ms-Fabric">
    <header class="ms-welcome__header ms-bgColor-neutralLighter">
        <img width="90" height="90" src="../../assets/logo-filled.png" alt="logo" title="Add-in logo" />
        <h1 class="ms-font-su">Activate your add-in without enabling the Reading Pane or selecting a message</h1>
    </header>
    <section id="sideload-msg" class="ms-welcome__main">
        <h2 class="ms-font-xl">Please <a target="_blank" href="https://learn.microsoft.com/office/dev/add-ins/testing/test-debug-office-add-ins#sideload-an-office-add-in-for-testing">sideload</a> your add-in to see app body.</h2>
    </section>
    <main id="app-body" class="ms-welcome__main" style="display: none;">
        <ul class="ms-List ms-welcome__features">
            <li class="ms-ListItem">
                <i class="ms-Icon ms-Icon--CheckList ms-font-xl"></i>
                <span class="ms-font-m">Item multi-select is automatically enabled when the <b>SupportsNoItemContext</b> manifest element is set to <code>true</code>. You can test this by selecting multiple messages in Outlook, then choosing <b>Show Taskpane</b> from the ribbon.</span>
            </li>
            <li class="ms-ListItem">
                <i class="ms-Icon ms-Icon--Pin ms-font-xl"></i>
                <span class="ms-font-m">Support to pin the task pane is also automatically enabled. You can test this by selecting the <b>pin</b> icon from the top right corner of the task pane.</span>
            </li>
            <li class="ms-ListItem">
                <i class="ms-Icon ms-Icon--DockRight ms-font-xl"></i>
                <span class="ms-font-m">This feature can only be implemented with a task pane.</span>
            </li>
            <li class="ms-ListItem">
                <i class="ms-Icon ms-Icon--Design ms-font-xl"></i>
                <span class="ms-font-m">Implement your scenario using this feature today! For example, enable your users to access content from different data sources, such as OneDrive or your customer relationship management (CRM) system, without first selecting a message.</span>
            </li>
        </ul>
    </main>
</body>

  3. Speichern Sie Ihre Änderungen.

Aktualisieren der JavaScript-Datei im Aufgabenbereich

  1. Öffnen Sie im Ordner taskpanetaskpane.js.

  2. Navigieren Sie zur Office.onReady Funktion, und ersetzen Sie deren Inhalt durch den folgenden Code.

    if (info.host === Office.HostType.Outlook) {
    document.getElementById("sideload-msg").style.display = "none";
    document.getElementById("app-body").style.display = "flex";
}

  3. Speichern Sie Ihre Änderungen.

Probieren Sie es aus

  1. Führen Sie in einem Terminal den folgenden Code im Stammverzeichnis Ihres Projekts aus. Dadurch wird der lokale Webserver gestartet und das Add-In querladen.

    npm start

    Tipp

    Wenn Ihr Add-In nicht automatisch querladen wird, befolgen Sie die Anweisungen unter Querladen von Outlook-Add-Ins zum Testen , um es manuell in Outlook querzuladen.

  2. Navigieren Sie zu Ihrem Posteingang, und führen Sie eine der folgenden Aktionen aus:

  3. Wählen Sie im Menüband Aufgabenbereich anzeigen aus.

  4. Erkunden und testen Sie die im Aufgabenbereich aufgeführten Vorschläge.

  5. Wenn Sie den lokalen Webserver beenden und das Add-In deinstallieren möchten, befolgen Sie die entsprechenden Anweisungen:

    • Führen Sie den folgenden Befehl aus, um den Server zu beenden. Wenn Sie verwendet haben npm start, sollte auch der folgende Befehl das Add-In deinstallieren.

      npm stop

    • Wenn Sie das Add-In manuell quergeladen haben, lesen Sie Entfernen eines quergeladenen Add-Ins.

Unterstützung für die Features für mehrfache Auswahl und anheftbare Aufgabenbereiche von Elementen

Die Aktivierung der Unterstützung für keinen Elementkontext im Manifest ermöglicht automatisch die Unterstützung für Mehrfachauswahl- und anheftbare Aufgabenbereichsfeatures für Elemente, auch wenn diese Features nicht explizit im Manifest konfiguriert sind.

Featureunterstützung in Outlook im Web und neuen Outlook unter Windows

In Outlook im Web und neuen Outlook unter Windows werden Add-Ins, die keinen Elementkontext implementieren, nicht aktiviert, wenn der Lesebereich ausgeblendet oder eine Nachricht nicht ausgewählt ist. Dies liegt daran, dass Add-In-Befehle in Outlook im Web nicht im Menüband angezeigt werden. Um ein Add-In über die Nachrichtenleseoberfläche zu aktivieren, müssen Sie zuerst eine Nachricht und dann auf der Nachrichtenaktionsleiste den Add-In-Befehl auswählen.

Da das Aktivieren von keinem Elementkontext automatisch die Mehrfachauswahlfunktion für Elemente aktiviert, können Sie Ihr Add-In in Outlook im Web und neuen Outlook unter Windows für mehrere E-Mail-Elemente aktivieren.

Siehe auch