Partage via

Composants de Loop basés sur une carte adaptative

  • Article

Remarque

Les composants de Loop basés sur une carte adaptative ne sont pas disponibles dans Microsoft Teams et Microsoft Outlook sur les clients macOS et mobiles.

Les composants de Loop basés sur une carte adaptative vous permettent de créer des expériences collaboratives dans vos extensions de message Teams qui fonctionnent dans Microsoft 365. Les composants de Loop basés sur une carte adaptative ont un contenu actionnable qui permet aux utilisateurs d’effectuer des mises à jour actives sans avoir à changer de contexte entre les applications Microsoft 365, telles que Teams et Outlook.

Voici un exemple de composant Loop basé sur une carte adaptative :

Capture d’écran montrant un composant Loop basé sur une carte adaptative.

Créer un composant de Loop basé sur une carte adaptative

Pour créer un composant Loop basé sur une carte adaptative, procédez comme suit :

  1. Créez une extension de message avec une commande de recherche.

  2. Ajoutez un déploiement de lien à l’extension de message.

  3. Utilisez les actions universelles pour les cartes adaptatives et définissez la refresh propriété pour vous assurer que le carte est toujours à jour. Pour plus d’informations, consultez cartes à jour.

  4. Étendez votre extension de message dans Microsoft 365. Cette étape comprend les actions suivantes :

    1. Mettez à jour le manifeste de votre application vers la version 1.13 ou ultérieure.
    2. Ajoutez le canal Microsoft 365 pour votre bot.
    3. Mettez à jour l’inscription de l’application Microsoft Entra pour l’authentification unique (SSO).

  5. Ajoutez l’URL qui identifie de façon unique le carte dans la propriété metadata.webUrl. La metadata.webUrl propriété prend en charge la portabilité via le bouton Copier le composant présent dans l’en-tête du composant Loop.

  6. Ajoutez votre extension de message à Teams et affichez un aperçu de votre extension de message dans Outlook. Vous pouvez également déboguer votre application dans le Portail des développeurs pour Teams à l’aide du bouton Aperçu dans Teams de la page Vue d’ensemble .

    Capture d’écran de la page de vue d’ensemble du portail des développeurs avec le bouton Aperçu dans Teams mis en évidence en rouge.

Remarque

Assurez-vous que le composant Loop basé sur une carte adaptative respecte les instructions de conception pour créer une expérience basée sur une carte adaptative exploitable et cohérente pour vos utilisateurs.

Exemple

La charge utile JSON suivante est un exemple de composant Loop basé sur une carte adaptative avec les metadata propriétés et webUrl :

{
  "type": "AdaptiveCard",
  "version": "1.6",
  "metadata": {
    "webUrl": "https://contoso.com/tab"
  },
  "refresh": {
    "action": {
      "type": "Action.Execute",
      "title": "Submit",
      "verb": "personalDetailsCardRefresh"
    },
    "userIds": []
  },
  "body": [
    {
      ....
    },
  ]
  }

Schéma

Propriété Type Description
metadata Métadonnées Définit diverses propriétés de métadonnées généralement non utilisées pour le rendu de l’carte.
webUrl String URL qui identifie de manière unique le carte et sert de secours de navigateur qui peut être utilisé par certains hôtes.

Remarque

  • Lorsque vous copiez un composant Loop basé sur une carte adaptative, l’URL du composant Loop est copiée. Lorsque vous collez l’URL dans une conversation Teams ou l’application Loop, le lien se déploie dans le composant Loop basé sur une carte adaptative.
  • Les composants de Loop basés sur une carte adaptative utilisent le même mécanisme d’actualisation que les cartes adaptatives standard. Le contenu d’un composant Loop basé sur une carte adaptative est actualisé uniquement lorsqu’un utilisateur ouvre le composant Loop.

Exemple de code

Exemple de nom Description Node.js .NET Manifeste
Extension de message avec composant Loop basé sur une carte adaptative Cet exemple montre comment créer une extension de message avec un composant Loop basé sur une carte adaptative. View View View

Voir aussi