Módulos de tarefas
Os módulos de tarefas permitem que você crie experiências pop-up modais em seu aplicativo Teams. No pop-up, você pode:
- Execute seu próprio código HTML ou JavaScript personalizado.
- Mostrar um
<iframe>widget baseado em como um vídeo do YouTube ou Microsoft Stream. - Exibir um cartão adaptável.
Os módulos de tarefa são úteis para iniciar e concluir tarefas ou exibir informações avançadas, como vídeos ou painéis do Power Business Intelligence (BI). Uma experiência pop-up geralmente é mais natural para os usuários iniciarem e concluirem tarefas em comparação com uma guia ou uma experiência de bot baseada em conversa.
Os módulos de tarefa são baseados nas guias do Microsoft Teams. Eles são essencialmente uma guia dentro de uma janela pop-up. Eles usam a mesma biblioteca de clientes JavaScript do Microsoft Teams (TeamsJS), portanto, se você criou uma guia, já está familiarizado com a criação de um módulo de tarefa.
Módulos de tarefa podem ser invocados de três maneiras:
- Guias de canal ou pessoais: usando a biblioteca do TeamsJS, você pode invocar módulos de tarefa de botões, links ou menus em sua guia. Para obter mais informações, confira usando módulos de tarefa em guias.
- Bots: usando botões em cartões enviados do bot. Isso é útil quando você não exige que todos em um canal vejam o que estão fazendo com um bot. Por exemplo, ao fazer com que os usuários respondam a uma pesquisa em um canal, não é útil ver um registro dessa pesquisa sendo criada. Para obter mais informações, confira usando módulos de tarefa de bots do Teams.
- Fora do Teams de um link profundo: você também pode criar URLs para invocar um módulo de tarefa de qualquer lugar. Para obter mais informações, confira Sintaxe de link profundo do módulo de tarefa.
Componentes de um módulo de tarefa
Veja como é um módulo de tarefa quando invocado de um bot:
Um módulo de tarefa inclui o seguinte, conforme mostrado na imagem anterior:
Ícone do
coloraplicativo.O nome do
shortaplicativo.O título do módulo de tarefa especificado na
titlepropriedade do objeto TaskInfo.O botão fechar ou cancelar do módulo de tarefa. Se o usuário selecionar esse botão, seu aplicativo receberá um
errevento. Para obter mais informações, confira exemplo para enviar o resultado de um módulo de tarefa.Observação
No momento, não é possível detectar o
errevento quando um módulo de tarefa é invocado de um bot.O retângulo azul é onde sua página da Web aparece se você estiver carregando sua própria página da Web usando a
urlpropriedade do objeto TaskInfo. Para obter mais informações, consulte dimensionamento do módulo de tarefas.Se você estiver exibindo um Cartão Adaptável usando a
cardpropriedade do objeto TaskInfo , o preenchimento será adicionado para você. Para obter mais informações, confira Módulo de tarefa CSS para módulos de tarefa HTML ou JavaScript.Os botões de Cartão Adaptável são renderizados depois de selecionar Inscrever-se. Ao usar sua própria página, crie seus próprios botões. Por design, o estilo de botão primário (sólido) é aplicado à última ação raiz em um Cartão Adaptável. Para todas as outras ações, o estilo de botão padrão é aplicado.