Freigeben über

Automatisches Öffnen eines Aufgabenbereichs bei der Installation eines Add-Ins

  • Artikel

Sie können den Aufgabenbereich Ihres Add-Ins so konfigurieren, dass er sofort nach der Installation gestartet wird. Dieses Feature erhöht die Nutzung.

Aufgabenbereich-Add-Ins, die keineAdd-In-Befehle enthalten, öffnen den Aufgabenbereich standardmäßig sofort nach der Installation. Wenn ein Add-In jedoch über einen oder mehrere Add-In-Befehle verfügt, wird der Benutzer über das neue Add-In benachrichtigt, aber das Add-In wird nicht automatisch gestartet. Dieses bisherige Standardverhalten ändert sich, sodass Add-Ins, die über Add-In-Befehle verfügen, in einigen Situationen automatisch gestartet werden. Wenn das Add-In über mehrere Aufgabenbereichsseiten verfügt, können Sie außerdem steuern, ob das Add-In bei der Installation gestartet wird und welche Seite im Aufgabenbereich geöffnet wird.

Hinweis

  • Dieses Feature gilt nur für Add-Ins, die von einem Endbenutzer installiert werden, nicht für zentral bereitgestellte Add-Ins.
  • Dieses Feature gilt nicht für Inhalts-Add-Ins oder Mail-Add-Ins (Outlook).
  • Dieses Feature gilt nur für Add-Ins, die über mindestens einen Add-In-Befehl vom Typ "Aufgabenbereichbefehl" verfügen.

Neues Verhalten

Das neue Verhalten sieht wie folgt aus:

  • Wenn das Add-In nur einen Aufgabenbereichsbefehl enthält, wird die Menübandregisterkarte des Add-Ins ausgewählt, und der Aufgabenbereich wird nach der Installation automatisch geöffnet. Sie müssen nichts konfigurieren.
  • Wenn das Add-In über mehrere Aufgabenbereichbefehle verfügt und einer als Standard konfiguriert ist (siehe Konfigurieren des Standardaufgabenbereichs), wird die Menübandregisterkarte des Add-Ins ausgewählt, und der Standardaufgabenbereich wird nach der Installation automatisch geöffnet.
  • Wenn das Add-In über mehrere Aufgabenbereichbefehle verfügt, aber keiner als Standard konfiguriert ist, wird die Menübandregisterkarte des Add-Ins bei der Installation automatisch ausgewählt, und in der Nähe wird eine Legende angezeigt, die den Benutzer über das neue Add-In informiert, aber kein Aufgabenbereich geöffnet wird. Dies ist dasselbe wie das Standardverhalten in der Verlaufsversion.

Hinweis

Wenn der Add-In-Befehl, der den Aufgabenbereich startet, aus irgendeinem Grund nicht manuell von einem Benutzer beim Start ausgewählt werden kann, z. B. wenn er so konfiguriert ist, dass er beim Start deaktiviert wird , wird er unabhängig von der Konfiguration nicht automatisch geöffnet.

Konfigurieren des Standardaufgabenbereichs im Manifest

Der Prozess zum Angeben des Standardaufgabenbereichs hängt vom Typ des Manifests ab, das das Add-In verwendet.

Hinweis

Das einheitliche Manifest für Microsoft 365 kann in Outlook-Produktions-Add-Ins verwendet werden. Es ist nur als Vorschau für Excel-, PowerPoint- und Word-Add-Ins verfügbar.

Um den Standardaufgabenbereich anzugeben, suchen Sie das Laufzeitobjekt im Array "runtimes", dessen Eigenschaft "code.page" auf die URL der Seite festgelegt ist, die als Standard festgelegt werden soll. Stellen Sie sicher, dass das Array "actions" in diesem Laufzeitobjekt mindestens eine Aktion enthält, deren "type"-Wert "openPage" ist. Fügen Sie diesem Aktionsobjekt eine View-Eigenschaft hinzu, und legen Sie sie auf "Office.AutoShowTaskpaneWithDocument" fest. Sie können diesen Wert nur für ein Aktionsobjekt festlegen, und es muss sich um eine Aktion vom Typ "openPage" handeln. Wenn Sie diesen Wert für mehrere Aktionen festlegen, wird das erste Vorkommen des Werts als Standard erkannt, und die anderen werden ignoriert.

Das folgende Beispiel zeigt einen "view"-Wert, der auf "Office.AutoShowTaskpaneWithDocument" festgelegt ist.

"runtimes": [
    {
        ...
        "code": {
            "page": "https://contoso.com/taskpane.html"
        },
        "actions": [
            {
                "id": "ShowTaskPane",
                "type": "openPage",
                "view": "Office.AutoShowTaskpaneWithDocument"
            }
        ]
    }
]

Tipp

Wenn Das Add-In automatisch gestartet werden soll, wenn der Benutzer das Dokument erneut öffnet, müssen Sie weitere Konfigurationsschritte ausführen. Ausführliche Informationen und Hinweise zur Verwendung dieses Features finden Sie unter Automatisches Öffnen eines Aufgabenbereichs mit einem Dokument.

Siehe auch