Erstellen einer Seite zum Entfernen

Sie können die Benutzererfahrung erweitern und verbessern, indem Sie Die Entfernungs- und Änderungsoptionen in Ihrer App unterstützen. Teams ermöglicht Benutzern das Umbenennen oder Entfernen eines Kanals oder einer Gruppenregisterkarte, und Sie können Benutzern erlauben, Ihre Registerkarte nach der Installation neu zu konfigurieren. Darüber hinaus bietet die Registerkartenentfernung den Benutzern Optionen zum Löschen oder Archivieren von Inhalten nach dem Entfernen.

Aktivieren der Neukonfiguration Ihrer Registerkarte nach der Installation

Ihre manifest.json definiert die Features und Funktionen Ihrer Registerkarte. Die Eigenschaft der Registerkarteninstanz canUpdateConfiguration akzeptiert einen booleschen Wert, der angibt, ob ein Benutzer die Registerkarte ändern oder neu konfigurieren kann, nachdem sie erstellt wurde. Die folgende Tabelle enthält die Eigenschaftendetails:

Wenn Ihre Registerkarte in einen Kanal oder Gruppenchat hochgeladen wird, fügt Teams ein Dropdownmenü mit der rechten Maustaste für Ihre Registerkarte hinzu. Die verfügbaren Optionen werden durch die canUpdateConfiguration Einstellung bestimmt. Die folgende Tabelle enthält die Einstellungsdetails:

Erstellen einer Registerkartenentfernungsseite für Ihre Anwendung

Die optionale Seite zum Entfernen ist eine HTML-Seite, die Sie hosten und angezeigt wird, wenn die Registerkarte entfernt wird. Die URL der Entfernungsseite wird von der setConfig() -Methode (oder setSettings() vor TeamsJS v.2.0.0) auf Ihrer Konfigurationsseite angegeben. Wie bei allen Seiten in Ihrer App muss die Seite zum Entfernen die Voraussetzungen für die Registerkarte "Teams" erfüllen.

Registrieren eines Remove-Handlers

Optional können Sie innerhalb der Logik der Entfernungsseite den registerOnRemoveHandler((RemoveEvent) => {} Ereignishandler aufrufen, wenn der Benutzer eine vorhandene Registerkartenkonfiguration entfernt. Die -Methode akzeptiert die RemoveEvent -Schnittstelle und führt den Code im Handler aus, wenn ein Benutzer versucht, Inhalte zu entfernen. Die -Methode wird verwendet, um Bereinigungsvorgänge auszuführen, z. B. das Entfernen der zugrunde liegenden Ressource, die den Registerkarteninhalt mit Energie versorgt. Es kann jeweils nur ein Handler zum Entfernen registriert werden.

Die RemoveEvent -Schnittstelle beschreibt ein -Objekt mit zwei Methoden:

• Die notifySuccess() Funktion ist erforderlich. Es gibt an, dass die entfernung der zugrunde liegenden Ressource erfolgreich war und ihr Inhalt entfernt werden kann.

• Die notifyFailure(string) Funktion ist optional. Dies weist darauf hin, dass beim Entfernen der zugrunde liegenden Ressource ein Fehler aufgetreten ist und deren Inhalt nicht entfernt werden kann. Der optionale Zeichenfolgenparameter gibt einen Grund für den Fehler an. Falls angegeben, wird diese Zeichenfolge dem Benutzer angezeigt. andernfalls wird ein generischer Fehler angezeigt.

Verwenden der getConfig() Funktion

Sie können (früher getSettings()) verwenden getConfig() , um den zu entfernenden Registerkarteninhalt zuzuweisen. Die getConfig() Funktion gibt eine Zusage zurück, die mit dem Config-Objekt aufgelöst wird, und stellt die gültigen Einstellungseigenschaftswerte bereit, die abgerufen werden können.

Verwenden der getContext() Funktion

Sie können verwenden getContext() , um den aktuellen Kontext abzurufen, in dem der Frame ausgeführt wird. Die getContext() Funktion gibt eine Zusage zurück, die mit dem Context-Objekt aufgelöst wird. Das Context-Objekt stellt gültige Context Eigenschaftswerte bereit, die Sie in der Logik der Entfernungsseite verwenden können, um den Inhalt zu bestimmen, der auf der Entfernungsseite angezeigt werden soll.

Einschließen der Authentifizierung

Eine Authentifizierung ist erforderlich, bevor ein Benutzer den Inhalt der Registerkarte löschen kann. Kontextinformationen können verwendet werden, um Authentifizierungsanforderungen und Autorisierungsseiten-URLs zu erstellen. Registerkarten finden Sie unter Microsoft Teams-Authentifizierungsflow. Stellen Sie sicher, dass alle Domänen, die validDomains auf Ihren Registerkartenseiten verwendet werden, im Array Ihres App-Manifests aufgeführt sind.

Das folgende Beispiel ist ein Beispiel für den Codeblock zum Entfernen von Registerkarten:

<body>
  <button onclick="onClick()">Delete this tab and all underlying data?</button>
  <script>
    await microsoftTeams.app.initialize();
    pages.config.registerOnRemoveHandler((removeEvent) => {
      // Here you can designate the tab content to be removed and/or archived.
        const configPromise = pages.getConfig();
        configPromise.
            then((configuration) => {
                configuration.contentUrl = "...";
                removeEvent.notifySuccess()}).
            catch((error) => {removeEvent.notifyFailure("failure message")});
    });

    const onClick() => {
        pages.config.setValidityState(true);
    }
  </script>
</body>

<body>
  <button onclick="onClick()">Delete this tab and all underlying data?</button>
  <script>
    microsoftTeams.initialize();
    microsoftTeams.settings.registerOnRemoveHandler((removeEvent) => {
      // Here you can designate the tab content to be removed and/or archived.
        microsoftTeams.settings.getSettings((settings) => {
        settings.contentUrl = "..."
        });
        removeEvent.notifySuccess();
    });

    const onClick() => {
        microsoftTeams.settings.setValidityState(true);
    }
  </script>
</body>

Wenn ein Benutzer im Dropdownmenü der Registerkarte Entfernen auswählt, lädt Teams die optionale removeUrl Seite, die Ihrer Konfigurationsseite zugewiesen ist, in einen iFrame. Dem Benutzer wird eine Schaltfläche angezeigt, die mit der onClick() Funktion geladen ist, die die Schaltfläche Entfernen aufruft pages.config.setValidityState(true) und aktiviert, die unten auf der Entfernungsseite iFrame angezeigt wird.

Nachdem der Entfernungshandler ausgeführt wurde, removeEvent.notifySuccess() oder removeEvent.notifyFailure() benachrichtigt Teams über das Ergebnis der Inhaltsentfernung.

Nächster Schritt

Siehe auch

• Erstellen von Registerkarten für Teams
• App-Manifestschema für Teams
• RemoveEvent-Schnittstelle
• Kontext für Ihre Registerkarte erhalten
• Erstellen einer persönlichen Registerkarte
• Erstellen einer Kanalregisterkarte oder Gruppenregisterkarte