Partager via

Cartes

  • Article

Une carte est un conteneur d’interface utilisateur (IU) pour des informations courtes ou connexes. Les cartes peuvent avoir plusieurs propriétés et pièces jointes et inclure des boutons qui déclenchent des actions de carte. L’utilisation de cartes vous permet d’organiser des informations en groupes et de permettre aux utilisateurs d’interagir avec des parties spécifiques de celles-ci.

Les bots pour Microsoft Teams prennent en charge les types de cartes suivants :

  • Carte adaptative
  • Carte Hero
  • Carte de liste
  • Carte de connecteur pour Groupes Microsoft 365
  • Carte de réception
  • Carte de connexion
  • Carte miniature
  • Collections de cartes
  • Menu Dépassement de capacité sur les cartes adaptatives

Vous pouvez ajouter une mise en forme de texte enrichi à vos cartes à l’aide de Markdown ou HTML, suivant le type de carte. Cartes utilisées par les bots et les extensions de message dans Teams, ajoutez et répondez à ces actions carte, openUrl, messageBackimBack, invokeet signin.

Teams utilise des cartes dans trois endroits différents :

  • Connecteurs
  • Bots
  • Extensions de messages

Cartes dans les connecteurs

Les cartes ont d’abord été définies dans le cadre d’Outlook et de Microsoft 365 et sont maintenant utilisées dans le cadre de connecteurs pour Groupes Microsoft 365. Comme de nombreuses applications Microsoft 365, Teams prend en charge les connecteurs. Pour plus d’informations, consultez Créer des connecteurs pour Groupes Microsoft 365. Vous trouverez la spécification des cartes dans les connecteurs dans la référence de carte de message actionnable.

Cartes dans les bots

Microsoft Bot Framework étend la spécification des cartes en ajoutant un ensemble de cartes prédéfinies que les bots peuvent utiliser dans le cadre des messages de bot. Teams prend en charge les bots en utilisant Bot Framework, mais l’application prend en charge un autre jeu de ces cartes. Des informations générales sur les cartes dans Bot Framework sont disponibles dans Ajout de pièces jointes de carte enrichie aux messages. Ces cartes sont appelées cartes simples dans Teams.

Les bots dans Teams peuvent utiliser des cartes simples, des cartes de connecteur ou des Cartes adaptatives. Les types de cartes fournissent des informations sur les cartes et sont pris en charge par les bots dans Teams.

Cartes dans les extensions de message

Les extensions de messagerie peuvent également renvoyer une carte. Les extensions de messagerie peuvent utiliser des cartes simples, des cartes de connecteur ou des Cartes adaptatives. Vous trouverez ces cartes dans les types de cartes.

Types de cartes

Toutes les cartes utilisées par Teams sont répertoriées dans les types de cartes. Cette référence décrit également les différences entre les cartes Bot Framework et les cartes dans Teams.

Cartes adaptatives

Les Cartes adaptatives sont une nouvelle spécification inter-produits pour les cartes des produits Microsoft, notamment les bots, Cortana, Outlook et Windows. Elles constituent le type de carte recommandé pour les nouveaux développements Teams. Pour obtenir des informations générales sur l’équipe des Cartes adaptatives, voir Vue d’ensemble du format Cartes adaptatives. Vous pouvez utiliser des cartes adaptatives partout où vous utilisez des cartes de héros, des cartes Microsoft 365 et des cartes miniatures existantes.

Outre les Cartes adaptatives, Teams prend en charge deux autres types de cartes :

  • Cartes de connecteur : utilisées dans le cadre de connecteurs pour Groupes Microsoft 365.
  • Cartes simples : utilisées à partir de Bot Framework, telles que les cartes miniatures et Hero.

Sélecteur de personnes dans les Cartes adaptatives

Le Sélecteur de personnes ajouté en tant que contrôle d’entrée dans les Cartes adaptatives permet la recherche et la sélection de personnes. Vous pouvez l’utiliser dans des conversations, des canaux, des dialogues (appelés modules de tâche dans TeamsJS v1.x) et des onglets. Les clients mobiles et de bureau prennent en charge le Sélecteur de personnes, offrant une expérience de saisie inline.

icône Personnes dans une carte adaptative

Personnes icône dans une carte adaptative permet aux utilisateurs d’afficher les images des utilisateurs dans la carte adaptative dans Teams. Vous pouvez afficher l’image d’un ou de plusieurs utilisateurs. Personnes icône est prise en charge dans les clients mobiles et de bureau Teams.

Recherche en saisie semi-automatique dans les Cartes adaptatives

La recherche de typeahead ajoutée en tant que contrôle d’entrée dans cartes adaptatives permet une expérience de recherche dynamique à partir d’un jeu de données chargé dynamiquement. Il permet également aux utilisateurs d’effectuer une recherche statique de typeahead dans une liste avec un nombre limité de choix. Les clients mobiles et de bureau prennent en charge l’expérience de recherche dynamique de typeahead.

Entrées dépendantes dans les cartes adaptatives

Vous pouvez concevoir des cartes adaptatives dans Teams où la valeur d’une entrée dépend de la valeur d’une autre. Par exemple, considérez une carte adaptative avec deux Input.ChoiceSet listes déroulantes : une pour sélectionner un pays et une autre pour sélectionner une ville spécifique dans ce pays. La première liste déroulante doit filtrer les villes affichées dans la deuxième liste déroulante. Pour ce faire, vous pouvez créer une Input.ChoiceSet liste déroulante avec une recherche dynamique de typehead qui dépend d’une ou plusieurs autres entrées dans le carte. Pour plus d’informations, consultez Entrées dépendantes.

Éléments multimédias dans les cartes adaptatives

Les éléments multimédias de la carte adaptative offrent une expérience multimédia améliorée et augmentent l’engagement avec la carte adaptative. Vous pouvez ajouter des fichiers multimédias tels que des clips audio ou vidéo, des vidéos YouTube, Vimeo ou Dailymotion à votre carte adaptative. Pour plus d’informations, consultez Éléments multimédias dans la carte adaptative.

Cartes adaptatives et Webhooks entrants

Remarque

Les Cartes adaptatives avec Webhooks entrants vous permettent d’utiliser les fonctionnalités enrichies et flexibles des Cartes adaptatives. Elles envoient des données à l’aide des Webhooks entrants dans Teams à partir de leur service web.

CodeBlock dans les cartes adaptatives

Partagez des extraits de code sous forme de cartes adaptatives au format enrichi dans des conversations, des canaux et des réunions Teams avec l’élément CodeBlock . Les cartes adaptatives avec l’élément CodeBlock facilitent la lecture de l’extrait de code, car la mise en retrait, la numérotation et la mise en surbrillance de la syntaxe correspondent au langage de programmation. Pour plus d’informations, consultez CodeBlock dans les cartes adaptatives.

Disposition réactive de carte adaptative

Vous devez concevoir vos cartes adaptatives pour qu’elles s’affichent sur n’importe quel appareil afin de fournir une expérience utilisateur améliorée sur les conversations, les canaux et les conversations de réunion. La disposition réactive de carte adaptative vous permet de concevoir des cartes avec différentes dispositions qui ciblent des largeurs de carte différentes. Pour plus d’informations, consultez Disposition réactive de carte adaptative.

Bordures et angles arrondis

Vous pouvez ajouter des bordures aux Containeréléments , ColumnSet, Columnet Table dans les cartes adaptatives pour délimiter différentes sections du carte. Vous pouvez ajouter des angles arrondis aux Containeréléments , ColumnSet, Column, Tableet Image dans cartes adaptatives pour rendre la conception carte moderne et visuellement attrayante. Pour plus d’informations, consultez Bordures et angles arrondis dans cartes adaptatives.

Conteneurs à défilement

Un conteneur avec de nombreux éléments peut entraîner une longue carte illisible. Utilisez la maxHeight propriété pour définir la hauteur maximale du conteneur. Lorsque le conteneur a une hauteur maximale et que son contenu dépasse cette hauteur, une barre de défilement verticale s’affiche. Pour plus d’informations, consultez Conteneurs à défilement dans les cartes adaptatives.

Bouton composé

Le bouton composé est un type spécial de bouton avec une icône, un titre et une description. Vous pouvez ajouter un bouton Composé à l’aide de l’élément CompoundButton . Cet élément vous permet de répliquer l’apparence d’une invite de démarrage dans une carte adaptative. Pour plus d’informations, consultez Bouton composé dans les cartes adaptatives.

Icônes Fluent

Les cartes adaptatives prennent en charge l’ajout d’icônes à partir de la bibliothèque d’icônes Fluent à l’aide de l’élément Icon . Pour plus d’informations, consultez icônes dans carte adaptative.

Étoiles

Vous pouvez ajouter une entrée d’évaluation star à votre carte adaptative à l’aide de l’élément Input.Rating . Vous pouvez également inclure une évaluation star en lecture seule à l’aide de l’élément Rating . Pour plus d’informations, consultez Évaluations dans cartes adaptatives.

Activation conditionnelle des boutons d’action

Vous pouvez utiliser la conditionallyEnabled propriété pour désactiver les boutons d’action jusqu’à ce que l’utilisateur modifie la valeur d’au moins une des entrées requises. Cette propriété ne peut être utilisée qu’avec Action.Submit les actions et Action.Execute . Pour plus d’informations, consultez Activation conditionnelle des boutons d’action.

Menu Dépassement de capacité sur les cartes adaptatives

La carte adaptative dans Teams prend en charge le menu de dépassement. Vous pouvez remplir un menu de dépassement pour toutes les actions secondaires dans une carte adaptative.

Prise en charge de l’ID d’objet Microsoft Entra et de l’UPN dans les mention de l’utilisateur

Les bots avec cartes adaptatives prennent en charge les ID mention utilisateur, tels que l’ID d’objet Microsoft Entra et le nom d’utilisateur principal (UPN) en plus des ID existants. Les webhooks entrants commencent à prendre en charge les mention utilisateur dans la carte adaptative avec l’ID d’objet Microsoft Entra et l’UPN.

Graphiques dans les cartes adaptatives

Les bots prennent en charge les ID de mention utilisateur, tels que l’ID d’objet Microsoft Entra et le nom d’utilisateur principal (UPN) en plus des ID existants. Les webhooks entrants commencent à prendre en charge les mention utilisateur dans la carte adaptative avec l’ID d’objet Microsoft Entra et l’UPN.

Dispositions de conteneur dans les cartes adaptatives

Vous pouvez concevoir des conteneurs réactifs pour différentes largeurs de carte adaptative avec les Layout.Stackdispositions , Layout.Flowet Layout.AreaGrid . Pour plus d’informations, consultez Dispositions de conteneur.

Étape suivante

Types de cartes

Voir aussi