Partager via

Configurer les options par défaut pour l’application Teams

  • Article

Il est courant qu’une application prend en charge plusieurs scénarios dans Teams, mais vous l’avez peut-être conçue avec une étendue et une fonctionnalité spécifiques à l’esprit. Par exemple, si votre application est principalement destinée à l’utilisation d’une équipe ou d’un canal, vous pouvez vous assurer que la première option d’installation que les utilisateurs voient dans le Microsoft Teams Store est Ajouter à une équipe.

Capture d’écran montrant l’option Ajouter à une équipe.

Si la fonctionnalité principale de votre application est un bot, vous pouvez également faire du bot la fonctionnalité par défaut lorsqu’un utilisateur installe votre application dans une équipe.

Configurer l’étendue d’installation par défaut de votre application

Configurez l’étendue d’installation par défaut pour votre application. Vous ne pouvez définir qu’une seule étendue à la fois. Pour plus d'informations, voir app manifest

Pour configurer l’étendue d’installation par défaut dans le manifeste de votre application :

  1. Ouvrez le manifeste de votre application et ajoutez la defaultInstallScope propriété .

  2. Définissez la valeur d’étendue d’installation par défaut comme , personalteam, groupchatou meetings.

    "defaultInstallScope": "meetings",

Configurer la fonctionnalité par défaut pour les étendues partagées

Configurez la fonctionnalité par défaut lorsque votre application est installée pour une équipe, une réunion ou une conversation de groupe. Pour plus d'informations, voir app manifest

Remarque

defaultGroupCapability fournit la fonctionnalité par défaut ajoutée à l’équipe, à la conversation de groupe ou à la réunion. Sélectionnez un onglet, un bot ou un connecteur comme fonctionnalité par défaut pour votre application, mais vous devez vérifier que vous avez fourni la fonctionnalité sélectionnée dans votre définition d’application.

Pour configurer les détails dans le manifeste de l’application :

  1. Ouvrez le manifeste de votre application et ajoutez-y la defaultGroupCapability propriété .

  2. Définissez la valeur team, groupchatou meetings.

  3. Pour la fonctionnalité de groupe sélectionnée, les fonctionnalités de groupe disponibles sont , bottabou connector.

    Remarque

    Vous ne pouvez sélectionner qu’une seule fonctionnalité par défaut, bot, tabou connector pour la fonctionnalité de groupe sélectionnée.

    "defaultGroupCapability": {
    "team": "bot",
    "groupchat": "bot",
    "meetings": "tab"
}

Configurer la fonctionnalité d’atterrissage par défaut de votre application

Vous pouvez configurer la fonctionnalité d’atterrissage par défaut pour une application qui prend en charge les fonctionnalités de bot et d’onglet dans l’étendue personnelle. En fonction de cette configuration, l’application s’ouvre sous la forme d’un bot ou d’un onglet par défaut.

Vous pouvez configurer l’une des options suivantes :

Bot comme fonctionnalité d’atterrissage par défaut

Configurez votre application pour qu’elle s’ouvre en tant que bot par défaut :

  1. Ouvrez le manifeste de votre application.

  2. Sous bots propriété, définissez scopes comme personal.

    "bots": [
    {
        "botId":"<botId>",
        "scopes": [
        "personal"
        ]

Remarque

Bot agit comme fonctionnalité d’atterrissage par défaut si son étendue est définie comme personnelle, même si vous ne spécifiez entityId pas comme conversations dans staticTabs la propriété.

L’exemple suivant montre comment ouvrir une application avec un bot comme fonctionnalité d’atterrissage par défaut et comment un utilisateur peut passer à un onglet :

Le graphique montre le processus d’ouverture d’une application avec un bot comme fonctionnalité d’atterrissage par défaut.

Tab comme fonctionnalité d’atterrissage par défaut

Configurez votre application pour qu’elle s’ouvre en tant qu’onglet par défaut :

  1. Ouvrez le manifeste de votre application.
  2. Sous staticTabs la propriété :
    1. Ajoutez les propriétés de l’onglet comme première entrée du tableau. Pour définir les propriétés de l’onglet, consultez manifeste de l’application.
    2. Ajoutez les propriétés suivantes :
      1. Définissez entityId comme conversations.
      2. Définissez scopes comme personal.

L’extrait de code suivant est un exemple de définition de tabulation comme fonctionnalité d’atterrissage par défaut :

"staticTabs": [
   {
       "entityId": "com.contoso.helloworld.hellotab",
       "name": "Hello Tab",
       "contentUrl": "https://p4p9bji0-7130.inc1.devtunnels.ms/hello",
       "scopes": [
           "personal"
       ]
   },
   {
       "entityId":"conversations",
        "scopes":[
           "personal"
        ]
   }
]

L’exemple suivant illustre l’ouverture d’une application avec tab comme fonctionnalité d’atterrissage par défaut et comment un utilisateur peut passer à un bot :

Le graphique montre le processus d’ouverture d’une application avec tabulation comme fonctionnalité d’atterrissage par défaut.

La staticTabs propriété est également utilisée pour épingler des onglets personnels et réorganiser les onglets. Pour plus d'informations, voir app manifest

Bloquer les applications par défaut pour les utilisateurs jusqu’à ce qu’un administrateur approuve

Pour améliorer l’expérience utilisateur d’une application Teams, parfois, les administrateurs informatiques doivent intervenir avant que les utilisateurs utilisent l’application. Par exemple, considérez une application de support technique créée par Contoso Electronics pour Teams. Pour garantir le bon fonctionnement de l’application, Contoso Electronics souhaite d’abord que les clients configurent des propriétés spécifiques de l’application.

Pour s’assurer que les administrateurs informatiques effectuent les tâches appropriées, les développeurs peuvent bloquer une application pour les utilisateurs jusqu’à ce qu’un administrateur autorise l’application. Pour bloquer l’application par défaut, définissez la defaultBlockUntilAdminAction propriété true sur dans le fichier manifeste de l’application. Lorsque la propriété a la valeur true, la status de l’application dans le Centre d’administration Teams est bloquée par l’éditeur dans la page Gérer les applications.

Capture d’écran montrant une application bloquée par l’éditeur.

Les administrateurs peuvent faire preuve de diligence à l’égard de votre application et lire la documentation de l’application que vous fournissez avant d’autoriser leurs utilisateurs à utiliser votre application. Par exemple, les administrateurs peuvent acheter les licences requises et les distribuer avant d’autoriser les utilisateurs à utiliser l’application. Pour autoriser l’application avec bloqué par l’éditeur status, un administrateur peut sélectionner Autoriser dans la page Gérer les applications du Centre d’administration Teams.

Capture d’écran montrant l’option Autoriser pour l’application bloquée par l’éditeur.

Si vous ne souhaitez pas que votre application soit bloquée par défaut, mettez à false jour le defaultBlockUntilAdminAction paramètre sur et envoyez votre application mise à jour pour publication. Une fois que nous avons publié la nouvelle version de votre application, elle est autorisée par défaut.

Remarque

Pour les applications personnalisées créées pour votre organisation, defaultBlockUntilAdminAction n’est pas pris en charge. Si vous chargez une application personnalisée conçue pour votre organization avec cette propriété, l’application n’est pas bloquée.

Exemple de code

Exemple de nom Description .NET Node.js Manifeste
Hello monde Cet exemple montre comment configurer la fonctionnalité d’atterrissage par défaut pour une application qui prend en charge les fonctionnalités de bot et d’onglet dans l’étendue personnelle. View View View

Étape suivante

Créer votre package d’application