Mettre à jour C# package d’application dans App Studio

Conseil

Essayez le portail du développeur: App Studio a évolué. Configurez, distribuez et gérez vos applications Teams avec le nouveau portail du développeur.

App Studio est une application Teams que vous pouvez installer à partir du Teams store. Cela simplifie la création et l’inscription d’une application.

Pour mettre à jour le package d’application, vous suivrez les étapes suivantes :

  1. Pour installer App Studio dans Teams, sélectionnez l’icône Applications en bas de la barre de gauche, puis recherchez App Studio:

    Finding App Studio in the Store View
  2. Sélectionnez la vignette App Studio et choisissez Installer. App Studio est installé :

    Installing App Studio
  3. Pour créer le package d’application pour votre application Teams, sélectionnez l’onglet Éditeur de manifeste dans App Studio:

    App Studio

    L’exemple est livré avec son propre manifeste et est conçu pour créer un package d’application lorsque le projet est créé. Le fichier manifest.json peut se trouver dans Visual Studio manifeste sous Microsoft.Teams.Samples.HelloWorld.Web .

    Dans Visual Studio, le fichier manifest.json se trouve sous Manifeste dans Microsoft.Teams.Samples.HelloWorld.Web . Cette étape est décrite par l’image suivante :

    Build the app package on .NET with Visual Studio
  4. Maintenant, pour modifier ce package d’application, sélectionnez Importer une application existante dans l’éditeur de manifeste:

    Importing an existing app
  5. Sélectionnez la vignette Hello World pour votre application nouvellement importée :

    Newly imported app view

    L’image suivante montre le package d’application importé dans App Studio :

    Importing the app package

    Sur le côté gauche de l’éditeur de manifeste se trouve une liste d’étapes. Sur le côté droit se trouve une liste des propriétés qui doivent être remplies pour chaque étape. Lorsque vous avez commencé avec un exemple d’application, la plupart des informations sont déjà terminées. Les étapes suivantes vous permettent de mettre à jour les propriétés de l’application Hello World.

Détails de l’application

Sélectionnez les détails de l’application sous Détails. Sélectionnez le bouton Générer pour créer un ID d’application.

Votre nouvel ID d’application est similaire à 2322041b-72bf-459d-b107-f4f335bc35bd .

Dans le volet droit, vous allez voir les détails de l’application, y compris les informations sur le développeur et les détails de pertinence. Ces détails sont importants si vous écrivez une nouvelle application pour la distribution.

Onglets

Il est simple d’ajouter des onglets à une Teams application. L’exemple d’application prend déjà en charge plusieurs onglets et vous pouvez les activer.

Onglet Équipe

Votre application ne peut avoir qu’un seul onglet d’équipe :

Adding a Teams tab

Dans cet exemple, l’onglet Équipe est l’endroit où votre page de configuration s’affiche. Sélectionnez le symbole ... de l’URL de configuration de l’onglet et choisissez Modifier dans le menu déroulant. Remplacez l’URL par l’URL que vous avez utilisée lors de https://yourteamsapp.ngrok.io/configure yourteamsapp.ngrok.io l’hébergement de votre application.

Onglets personnels

Votre application peut avoir jusqu’à 16 onglets, y compris l’onglet Équipe.

Les onglets personnels sont différents de l’onglet Équipe. L’onglet Hello est déjà répertorié dans la liste des onglets personnels avec une valeur d’espace com.contoso.helloworld.hellotab réservé. Sélectionnez le symbole ... de l’URL de configuration de l’onglet et choisissez Modifier dans le menu déroulant. La boîte de dialogue suivante s’affiche :

Adding a personal tab dialog

Mettez à jour les zones suivantes avec l’URL de votre application :

  • Modifier la zone URL de contenu en https://yourteamsapp.ngrok.io/hello
  • Modifier la zone URL du site web en https://yourteamsapp.ngrok.io/hello

Remplacez yourteamsapp.ngrok.io par l’URL que vous avez utilisée lors de l’hébergement de votre application.

Bots

Il est facile d’ajouter la fonctionnalité bots à votre application. L’exemple d’application Hello World possède déjà un bot dans le cadre de l’exemple, mais vous devez l’inscrire auprès de Microsoft :

Adding a bot

Le bot qui a été importé à partir de l’exemple n’a pas d’ID d’application associé. Vous devez créer un bot pour qu’App Studio puisse créer un ID d’application et l’inscrire auprès de Microsoft.

Notes

L’ID d’application créé par App Studio pour le bot est différent de l’ID d’application créé pour l’application. Chaque bot d’une application nécessite son propre ID d’application.

Pour configurer votre bot, complétez les étapes suivantes :

  1. Sélectionnez Supprimer en face du bot importé dans la liste des bots. Il ne reste plus aucun bot à afficher.

  2. Sélectionnez Programme d’installation pour afficher la boîte de dialogue Configurer un bot.

    Adding a bot dialog
  3. Ajoutez un nom de bot Contoso bot et cochez les trois cases sous Étendue.

  4. Sélectionnez Enregistrer pour quitter la boîte de dialogue. App Studio enregistre votre bot auprès de Microsoft et affiche votre nouveau bot dans la liste des bots.

  5. À présent, ouvrez un fichier texte dans le bloc-notes et copiez-y votre nouvel ID de bot.

  6. Cliquez sur Générer un nouveau mot de passe et notez le mot de passe dans le même fichier texte que celui où vous avez noté votre ID d’application de bot.

  7. Mettez à jour l’adresse du point de terminaison du bot et remplacez-la par l’URL que vous avez https://yourteamsapp.ngrok.io/api/messages utilisée lors de yourteamsapp.ngrok.io l’hébergement de votre application.

  8. Enregistrez maintenant votre fichier texte, car vous devez ajouter les informations du fichier à votre application hébergée pour permettre une communication sécurisée avec votre bot.

Extensions de messagerie

Les extensions de messagerie permet aux utilisateurs de demander des informations à votre service et de publier ces informations. Les informations sont publiées sous forme de cartes dans la conversation de canal. Les extensions de messagerie apparaissent en bas de la zone de composition.

Pour configurer votre extension de messagerie, complétez les étapes suivantes :

  1. Sélectionnez les extensions de messagerie sous Fonctionnalités dans le volet gauche d’App Studio pour configurer l’extension de messagerie :

    Adding a messaging extension

    L’exemple d’extension de messagerie est répertorié dans le volet Extensions de messagerie.

  2. Sélectionnez Supprimer pour supprimer l’extension de messagerie, sélectionnez Configurer et suivez les mêmes étapes que pour les bots. La boîte de dialogue Extension de messagerie s’affiche.

  3. Sélectionnez l’onglet Utiliser le bot existant et sélectionnez l’un de mes bots existants.

  4. Sélectionnez le bot que vous avez créé dans le menu déroulant. Ajoutez un nom de bot et sélectionnez Enregistrer pour fermer la boîte de dialogue.

  5. Sous la section Commande, sélectionnez Ajouter. Pour ajouter une commande basée sur la recherche, sélectionnez l’option Autoriser les utilisateurs à interroger votre service pour obtenir des informations et insérez-la dans une option de message.

  6. Dans la boîte de dialogue Nouvelle commande, entrez les valeurs suivantes :

    Sous nouvelle commande:

    • ID de commande: entrer du texte aléatoire
    • Titre: entrer un titre aléatoire
    • Description: entrez une description aléatoire

    Sous paramètre:

    • Name: Entrez le nom du paramètre
    • Titre: entrez le titre de la carte
    • Description: entrez la description de la carte
  7. Après avoir entré les informations, sélectionnez Enregistrer pour fermer la boîte de dialogue.

Inscrire votre application dans Teams

Une fois que vous avez entré les détails de votre application, complétez les étapes suivantes pour inscrire votre application dans Teams :

  1. Utilisez Test et distribuez App Studio pour installer votre application dans Teams.

  2. Mettez à jour votre application hébergée avec l’ID d’application et le mot de passe de votre bot. Pour l’exemple d’application, utilisez les mêmes ID d’application et mot de passe pour le bot et l’extension de messagerie.

  3. Sélectionnez Test et distribuez-le sous Terminer dans le volet gauche d’App Studio :

    Testing your app
  4. Pour télécharger votre application sur Teams, sélectionnez le bouton Installer sous Tester et distribuer:

    Adding a messaging extension dialog

    Notes

    Si vous ne parvenez pas à charger une version de version de chargement de l’application, vérifiez si vous avez activé le téléchargement d’applications personnalisées.

  5. Sélectionnez la zone de recherche dans la section Ajouter à une équipe et sélectionnez une équipe pour ajouter l’exemple d’application. Vous pouvez configurer une équipe spéciale pour les tests.

  6. Sélectionnez le bouton Installer en bas de la boîte de dialogue.

    Votre application est désormais disponible dans Teams. Toutefois, le bot et l’extension de messagerie ne fonctionneront pas tant que vous n’aurez pas mis à jour l’environnement des applications hébergées avec les ID d’application et les mots de passe.

    The finished app

Inscrire votre application dans Teams

Une fois que vous avez entré les détails de votre application, complétez les étapes suivantes pour inscrire votre application dans Teams :

  1. Utilisez la prévisualisation du portail du développeur pour installer votre application dans Teams.

    Image montrant le bouton Aperçu

  2. Mettez à jour votre application hébergée avec l’ID d’application et le mot de passe de votre bot. Pour l’exemple d’application, utilisez les mêmes ID d’application et mot de passe pour le bot et l’extension de messagerie.

  3. Sélectionnez Publier pour le stocker sous Publier dans le volet gauche du Portail du développeur :

    Image montrant l’option Publier dans le volet gauche

    Notes

    Si vous ne parvenez pas à charger une version de version de chargement de l’application, vérifiez si vous avez activé le téléchargement d’applications personnalisées.

  4. Sélectionnez Ajouter pour installer l’application sur Teams.

    Votre application est désormais disponible dans Teams. Toutefois, le bot et l’extension de messagerie ne fonctionneront pas tant que vous n’aurez pas mis à jour l’environnement des applications hébergées avec les ID d’application et les mots de passe.

Mettre à jour les informations d’identification de votre application hébergée

L’exemple d’application nécessite que les variables d’environnement soient définies sur les valeurs que vous avez enregistrées dans le fichier texte.

  1. Ouvrez l’Explorateur de solutions.

    Exemple de repo pour l’application Teams c#

  2. Ouvrez le fichier appsettings.json.

    Image montrant le fichier appsettings.json

  3. Mettez à jour la valeur MicrosoftAppId avec votre ID de bot que vous avez enregistré dans le fichier texte.

  4. Mettez à jour MicrosoftAppPassword avec le mot de passe du bot que vous avez enregistré.

    Image montrant l’ajout de clés Azure

    Après avoir apporté ces modifications, resserez l’application. Si vous utilisez ngrok, vous pouvez exécuter l’application localement et, si vous l’avez hébergée dans Azure, redéployer l’application.

Testez les fonctionnalités de l’application dans Teams

Tester votre onglet

Après avoir installé l’application dans Teams, configurez-la pour afficher l’onglet que vous souhaitez que l’application charge.

Pour configurer l’onglet de l’application

  1. Go to a channel in the team where you installed the sample app, and select the '+' button to add a new tab.

  2. Sélectionnez Hello World dans la liste Ajouter un onglet. Une boîte de dialogue de configuration s’affiche pour vous permettre de sélectionner l’onglet à afficher dans ce canal.

  3. Sélectionnez Enregistrer. Hello WorldL’onglet est chargé avec l’onglet.

    Screenshot of configure

Testez votre bot dans Teams

Vous pouvez maintenant tester le bot dans Teams.

Pour tester votre bot

  • Sélectionnez un canal dans l’équipe où vous avez inscrit votre application et tapez @your-bot-name . Ce type de message est appelé @ mention. Le bot répond à tout message que vous envoyez.

    Bot responses

Tester votre extension de messagerie

Pour tester votre extension de messagerie

  1. Sélectionnez... sous la zone d’entrée dans l’affichage de votre conversation. Un menu avec l’application « Hello World » s’affiche.

  2. Sélectionnez le menu, un ensemble de textes aléatoires s’affiche. Vous pouvez sélectionner l’un des textes aléatoires insérés dans votre conversation.

    Messaging extension menu Messaging extension result
  3. Sélectionnez l’un des textes aléatoires. Une carte mise en forme et prête à envoyer votre propre message s’affiche.

    Messaging extension send
   
Back