Diálogos

As caixas de diálogo (referidas como módulos de tarefas no TeamsJS v1.x) permitem-lhe criar experiências de pop-up modais na sua aplicação Teams. No pop-up, pode:

  • Execute seu próprio código HTML ou JavaScript personalizado.
  • Mostrar um <iframe>widget baseado em, por exemplo, inquéritos, vídeo do YouTube ou vídeo do Microsoft Stream.
  • Apresentar um Cartão Ajustável.

As caixas de diálogo são úteis para iniciar e concluir tarefas ou apresentar informações avançadas, como vídeos ou dashboards do Power Business Intelligence (BI). Muitas vezes, uma experiência de pop-up é mais natural para os utilizadores que iniciam e completam tarefas em comparação com um separador ou uma experiência de bot baseada em conversações.

As caixas de diálogo baseiam-se na base dos separadores do Microsoft Teams. São essencialmente um separador dentro de uma janela de pop-up. Utilizam a mesma biblioteca de cliente JavaScript do Microsoft Teams (TeamsJS), pelo que, se tiver criado um separador, já está familiarizado com a criação de uma caixa de diálogo.

Pode invocar caixas de diálogo de três formas:

  • Separadores pessoais ou de canal: ao utilizar a biblioteca do TeamsJS, pode invocar caixas de diálogo a partir de botões, ligações ou menus no seu separador. Para obter mais informações, consulte Utilizar caixas de diálogo em separadores.
  • Bots: utilizar botões em cartões enviados a partir do bot. Isto é útil quando não precisa que todas as pessoas num canal vejam o que está a fazer com um bot. Por exemplo, quando os utilizadores respondem a um inquérito num canal, não é útil ver um registo da criação desse inquérito. Para obter mais informações, consulte utilizar caixas de diálogo de bots do Teams.
  • Fora do Teams a partir de uma ligação avançada: também pode criar URLs para invocar uma caixa de diálogo a partir de qualquer lugar. Para obter mais informações, veja a sintaxe de ligação avançada da caixa de diálogo.

Componentes de uma caixa de diálogo

Eis o aspeto de uma caixa de diálogo quando invocada a partir de um bot:

exemplo de caixa de diálogo

Uma caixa de diálogo inclui o seguinte, conforme mostrado na imagem anterior:

  1. O ícone da colorsua aplicação.

  2. O nome da shortsua aplicação.

  3. O título da caixa de diálogo especificado na title propriedade do objeto DialogInfo.

  4. A caixa de diálogo está a fechar ou a cancelar. Se o utilizador selecionar este botão, a sua aplicação receberá um err evento. Para obter mais informações, veja o exemplo para submeter o resultado de uma caixa de diálogo.

    Observação

    Não é possível detetar o err evento quando uma caixa de diálogo é invocada a partir de um bot.

  5. O retângulo azul é onde a sua página Web é apresentada se estiver a carregar a sua própria página Web com a url propriedade do objeto TaskInfo. Para obter mais informações, veja Invocar e dispensar caixas de diálogo.

  6. Se estiver a apresentar um Cartão Ajustável com a card propriedade do objeto TaskInfo, o preenchimento é adicionado automaticamente. Para obter mais informações, veja CSS para caixas de diálogo HTML ou JavaScript.

  7. Os botões do Cartão Ajustável são compostos depois de selecionar Inscrever-se. Ao utilizar a sua própria página, crie os seus próprios botões. Por predefinição, o estilo de botão principal (sólido) é aplicado à última ação de raiz num Cartão Ajustável. Para todas as outras ações, o estilo de botão predefinido é aplicado.

Próxima etapa

Confira também