Compilar guias para o Teams

Os separadores são páginas Web com deteção de cliente incorporadas no Microsoft Teams, Outlook e Microsoft 365. Elas são marcas de <iframe/> HTML simples que apontam para domínios declarados no manifesto do aplicativo e podem ser adicionadas como parte de um canal dentro de uma equipe, chat em grupo ou aplicativo pessoal para um usuário individual. Você pode incluir guias personalizadas com seu aplicativo para inserir seu próprio conteúdo da Web no Teams ou adicionar funcionalidades específicas do Teams ao conteúdo da Web. Para obter mais informações, veja Biblioteca de cliente JavaScript do Teams.

Existem dois tipos de separadores, separadores estáticos e configuráveis. Estes separadores podem ser utilizados em três âmbitos distintos: personal, groupchate teams. Os separadores pessoais (estáticos), juntamente com bots de âmbito pessoal, fazem parte das aplicações pessoais que estão confinadas a um único utilizador e afixadas à barra de navegação à esquerda para facilitar o acesso. Os separadores pessoais (estáticos) no âmbito pessoal continuam a funcionar da mesma forma. No entanto, agora pode expandir separadores estáticos para conversas de grupo, canais ou reuniões com uma experiência personalizável.

Os separadores em conversas, canais ou reuniões comportam-se mais como aplicações, uma vez que só pode afixar um separador por aplicação. Por exemplo, só pode afixar um único separador de aplicação do YouTube numa reunião. Os separadores estáticos nas reuniões também podem ser pré-incluídos em reuniões por Administradores de TI.

As imagens seguintes mostram separadores adicionados a diferentes contextos no Teams:

Seguem-se algumas vantagens dos separadores estáticos em conversas, canais e reuniões:

• Afixável e instantâneo: pode afixar aplicações com separadores estáticos a partir do ícone adicionar um separador + em conversas, canais e reuniões. Estes separadores podem ser removidos e não têm a caixa de diálogo de configuração obrigatória, o que lhe permite criar separadores que funcionam mais como aplicações.

• Unificado: pode criar um separador estático que funcione em âmbitos pessoais e de grupo, como o chat, o canal e os separadores de reunião.

• Configuração opcional: pode alterar o URL predefinido na sua instância de separador ao alterar a contentUrl propriedade da sua aplicação depois de ser afixada no Teams.

Os separadores de canal ou grupo também conhecidos como separadores configuráveis, entregam conteúdos a canais e conversas de grupo e são uma forma de criar espaços de colaboração em torno de conteúdos dedicados baseados na Web.

A tabela seguinte ajuda-o a determinar a melhor opção para a sua aplicação:

Pode criar uma página de conteúdo como parte de um separador estático pessoal, separador de canal ou grupo ou caixa de diálogo (referido como módulo de tarefas no TeamsJS v1.x). Pode criar uma página de configuração que permite aos utilizadores configurar a aplicação Microsoft Teams e utilizá-la para configurar um separador de chat pessoal, de canal ou de grupo, uma extensão de mensagens ou um cartão de conector para Grupos do Microsoft 365. Você pode permitir que os usuários reconfigurem sua guia após a instalação e criar uma página de remoção de guia para seu aplicativo. Ao criar um aplicativo do Teams que inclui uma guia, você deve testar como seu guia nos clientes do Teams para Android e iOS. Sua guia deve ter contexto por meio de informações básicas, informações de localidade e tema e entityId ou subEntityId que identifica o que está na guia.

Recursos da guia

Os recursos da guia são os seguintes:

• Se uma guia for adicionada a um aplicativo que também tem um bot, o bot também será adicionado à equipe.
• Deteção do ID do Microsoft Entra do utilizador atual.
• Reconhecimento de localidade para o usuário indicar o idioma en-us.
• Funcionalidade de SSO (logon único), se houver suporte.
• Capacidade de utilizar bots ou notificações de aplicações para ligar profundamente ao separador ou a uma subentidade no serviço, por exemplo, um item de trabalho individual.
• A capacidade de abrir uma caixa de diálogo modal a partir de ligações num separador.
• Reutilização de Web Parts do SharePoint na guia.

Guias de cenários de usuário

Cenário: Traga um recurso web existente para o Teams. Exemplo: Pode criar um separador estático na sua aplicação Teams que apresenta um site empresarial informativo aos utilizadores.

Cenário: Adicione páginas de suporte a um bot ou extensão de mensagens do Teams. Exemplo: Pode criar separadores estáticos que fornecem eajudam os conteúdos da página Web aos utilizadores.

Cenário: Forneça acesso aos itens com os quais os usuários interagem regularmente para diálogo cooperativo e colaboração. Exemplo: Você cria uma guia de canal ou grupo com vinculação profunda a itens individuais.

Entender como as guias funcionam

Você pode usar um dos seguintes métodos para criar guias:

• Declarar guias personalizadas no manifesto do aplicativo
• Use o Cartão Adaptativo para construir guias

Declarar guia personalizada no manifesto do aplicativo

Uma guia personalizada é declarada no manifesto do aplicativo do pacote do aplicativo. Para cada página da web que você deseja incluir como uma guia em seu aplicativo, defina uma URL e um escopo. Além disso, pode adicionar a biblioteca de cliente JavaScript do Teams à sua página e chamar microsoftTeams.initialize() após o carregamento da sua página. O Teams exibe sua página e fornece acesso a informações específicas do Teams, por exemplo, o cliente do Teams está executando o tema escuro.

Quer opte por expor o separador no canal, grupo ou âmbito pessoal, tem de apresentar uma <página de conteúdo HTML iframe> no seu separador. Para separadores estáticos, o URL do conteúdo é definido diretamente no manifesto da aplicação Teams pela contentUrl propriedade na staticTabs matriz. O conteúdo da guia é o mesmo para todos os usuários.

Para guias de canal ou grupo, você também pode criar uma página de configuração extra. Esta página permite configurar a URL da página de conteúdo, normalmente usando parâmetros de cadeia de caracteres de consulta de URL para carregar o conteúdo apropriado para esse contexto. Isso ocorre porque seu canal ou guia de grupo pode ser adicionado a várias equipes ou chats em grupo. Em cada instalação subsequente, os usuários podem configurar a guia, permitindo que você personalize a experiência conforme necessário. Quando os usuários adicionam ou configuram uma guia, uma URL é associada à guia apresentada na interface do usuário do Teams. A configuração de uma guia simplesmente adiciona mais parâmetros a essa URL. Por exemplo, quando você adiciona a guia Azure Boards, a página de configuração permite que você escolha qual placa a guia carrega. O URL da página de configuração é especificado pela configurationUrl propriedade na configurableTabs matriz no manifesto da aplicação.

Para separadores estáticos, pode afixar um contentUrl separador de conversa, canal ou reunião. Isto permite-lhe ignorar a caixa de diálogo de configuração obrigatória e fazer com que os seus utilizadores utilizem a aplicação mais rapidamente. Também pode alterar o contentUrl no runtime. Isto permite-lhe criar um objeto de separador que funciona em todas as áreas de superfície do Teams. Para obter mais informações, veja Migrar o separador configurável para o separador estático.

Pode ter vários canais ou separadores de grupo e até 16 separadores estáticos por aplicação.

Ferramentas para criar guias

• Kit de ferramentas do Teams para Visual Studio Code
• Kit de ferramentas do Teams para Visual Studio

Próxima etapa

Confira também

• Projete sua guia para o Microsoft Teams
• Funcionalidades de dispositivo
• Guias em dispositivos móveis
• Funcionalidades do aplicativo mapeados para recursos
• Instrumenting for Teams app specific analytics (Instrumenting for Teams app specific analytics)
• Expandir a aplicação de separador com permissões e âmbitos do Microsoft Graph
• Atualização do Microsoft Teams
• Conceder permissão de dispositivo de separador no Teams