Créer une page de suppression

Vous pouvez étendre et améliorer l’expérience utilisateur en prenant en charge les options de suppression et de modification dans votre application. Teams permet aux utilisateurs de renommer ou de supprimer un canal ou un onglet de groupe, et vous pouvez autoriser les utilisateurs à reconfigurer votre onglet après l’installation. En outre, l’expérience de suppression d’onglets offre aux utilisateurs des options de post-suppression permettant de supprimer ou d’archiver du contenu.

Activer la reconfiguration de votre onglet après l’installation

Votre manifest.json définit les fonctionnalités et fonctionnalités de votre onglet. La propriété d’instance canUpdateConfiguration tab prend une valeur booléenne qui indique si un utilisateur peut modifier ou reconfigurer l’onglet après sa création. Le tableau suivant fournit les détails de la propriété :

Lorsque votre onglet est chargé dans une conversation de canal ou de groupe, Teams ajoute un menu déroulant contextuel pour votre onglet. Les options disponibles sont déterminées par le canUpdateConfiguration paramètre . Le tableau suivant fournit les détails du paramètre :

Créer une page de suppression d’onglet pour votre application

La page de suppression facultative est une page HTML que vous hébergez et qui s’affiche lorsque l’onglet est supprimé. L’URL de la page de suppression est désignée par la setConfig() méthode (ou setSettings() avant TeamsJS v.2.0.0) dans votre page de configuration. Comme pour toutes les pages de votre application, la page de suppression doit respecter conditions préalables de l’onglet Teams.

Inscrire un gestionnaire de suppression

Si vous le souhaitez, dans votre logique de suppression de page, vous pouvez appeler le registerOnRemoveHandler((RemoveEvent) => {} gestionnaire d’événements lorsque l’utilisateur supprime une configuration d’onglet existante. La méthode accepte l’interface RemoveEvent et exécute le code dans le gestionnaire lorsqu’un utilisateur tente de supprimer du contenu. La méthode est utilisée pour effectuer des opérations de nettoyage telles que la suppression de la ressource sous-jacente qui alimente le contenu de l’onglet. À la fois, le gestionnaire de suppression peut être inscrit.

L’interface RemoveEvent décrit un objet avec deux méthodes :

• La fonction notifySuccess() est requise. Il indique que la suppression de la ressource sous-jacente a réussi et que son contenu peut être supprimé.

• La fonction notifyFailure(string) est facultative. Cela indique que la suppression de la ressource sous-jacente a échoué et que son contenu ne peut pas être supprimé. Le paramètre de chaîne facultatif spécifie une raison de l’échec. Si elle est fournie, cette chaîne s’affiche pour l’utilisateur ; sinon, une erreur générique s’affiche.

Utiliser la fonction getConfig()

Vous pouvez utiliser getConfig() (anciennement getSettings()) pour affecter le contenu de l’onglet à supprimer. La getConfig() fonction retourne une promesse qui se résout avec l’objet Config et fournit les valeurs de propriété de paramètres valides qui peuvent être récupérées.

Utiliser la fonction getContext()

Vous pouvez utiliser getContext() pour obtenir le contexte actuel dans lequel le frame s’exécute. La getContext() fonction retourne une promesse qui se résout avec l’objet Context. L’objet Context fournit des valeurs de propriété valides Context que vous pouvez utiliser dans votre logique de suppression de page pour déterminer le contenu à afficher dans la page de suppression.

Inclure l’authentification

L’authentification est requise avant de permettre à un utilisateur de supprimer le contenu de l’onglet. Les informations de contexte peuvent être utilisées pour aider à construire des demandes d’authentification et des URL de page d’autorisation. Consultez flux d’authentification Microsoft Teams pour les onglets. Assurez-vous que tous les domaines utilisés dans vos pages d’onglet sont répertoriés dans le validDomains tableau du manifeste de votre application.

L’exemple suivant est un exemple de bloc de code de suppression de tabulation :

<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>

Lorsqu’un utilisateur sélectionne Supprimer dans le menu déroulant de l’onglet, Teams charge la page facultative removeUrl affectée dans votre page de configuration, dans un iFrame. L’utilisateur voit s’afficher un bouton chargé avec la onClick() fonction qui appelle pages.config.setValidityState(true) et active le bouton Supprimer affiché en bas de l’iFrame de la page de suppression.

Une fois le gestionnaire de suppression exécuté, removeEvent.notifySuccess() ou removeEvent.notifyFailure() informe Teams du résultat de la suppression du contenu.

Étape suivante

Voir aussi

• Créer des onglets pour Teams
• Schéma du manifeste d’application pour Teams
• Interface RemoveEvent
• Obtenir un contexte Teams pour votre onglet
• Créer un onglet personnel
• Créer un onglet de canal ou un onglet de groupe