Ler em inglês

Partilhar via


Ter uma conversa sobre os seus dados de negócio numa aplicação Teams

Aplicações em Microsoft Teams levam à colaboração permitindo que os utilizadores trabalhem onde comunicam e colaboram. Uma forma de tornar as suas apps colaborativas é adicionando a capacidade de ter uma conversa sobre a sua app ou os dados na sua app. O Teams são o seu sítio para ter essas conversas.

Por exemplo, no modelo da aplicação de amostra Profile+ para Teams quando selecionar um ou mais cartões de perfil na aplicação, pode iniciar um chat com as pessoas selecionadas diretamente no Teams.

Também pode querer utilizar esta capacidade para as suas apps. Por exemplo, se estiver a construir um localizador de oportunidades de venda para o gestor de vendas rever as próximas ofertas, talvez queira adicionar um botão para o utilizador conversar com o vendedor sobre a oportunidade.

Desta forma, Power Apps no Teams pode usar uma integração profunda com outras capacidades do Team para tornar as aplicações colaborativas. Neste artigo vamos aprender como integrar Power Apps com Teams para facilitar conversas.

Veja este vídeo para aprender a configurar conversações sobre dados de negócios na aplicação Teams:

Pré-requisitos

Para completar esta lição, precisamos da capacidade de criar aplicações dentro de Teams que estarão disponíveis como parte de subscrições selecionadas do Microsoft 365.

Iniciar sessão em Teams

Inicie sessão no Teams utilizando a app Desktop ou a aplicação web

Criar uma nova Equipa

Nesta secção, vamos criar uma nova equipa de Teams e depois criar uma aplicação dentro dessa equipa. Ignore esta secção se já tiver uma equipa que pretende utilizar.

  1. Para criar uma nova equipa, selecione o separador Equipas e, em seguida, selecione Juntar-se ou criar uma equipa na parte inferior esquerda do ecrã.

  2. Selecione Criar Equipa > Do nada > Público, dê à equipa um nome como "Integração de Chamadas e Reuniões", e selecione Criar.

  3. (Opcional) Se tiver algum membro na sua organização que gostaria de adicionar à equipa para efeitos de teste, selecione-os e adicione-os no popup para adicionar membros.

  4. Selecione Fechar.

A nova equipa é criada e está listada no separador Equipas.

Criar uma nova aplicação

Criaremos uma aplicação onde o utilizador pode iniciar uma conversação para uma determinada equipa e canal, selecionando um botão e digitando numa mensagem numa caixa de texto. O utilizador pode então selecionar o botão Enviar para publicar a mensagem na equipa e no canal particular no Teams, para que outro utilizador se possa juntar à conversação.

  1. Abrir Equipas.

  2. Selecionar Power Apps a partir do painel esquerdo.

  3. Selecione + Nova aplicação em aplicações recentes.

  4. Selecione a equipa criada anteriormente e, em seguida, selecione Criar.

    A aplicação é criada e Power Apps Studio abre-se para permitir a edição da app.

  5. Introduza um nome para a aplicação, como "App conversação", e selecione Guardar.

    A aplicação é criada com uma galeria padrão no Ecrã 1.

Adicionar Equipas como conector

Precisamos de adicionar o Teams como conector à app, uma vez que queremos poder aceder às equipas e canais a partir da conta do utilizador.

  1. Selecione Dados no painel esquerdo.
  2. Selecione + Adicionar dados, e depois selecione Conectores.
  3. Desloque-se para baixo e selecione Ver todos os conectores.
  4. Procure e selecione o conector Teams.

Adicione uma nova tabela para capturar o registo da empresa

Precisamos de adicionar uma tabela para manter uma lista de empresas que usaremos como registo da empresa, e começar uma conversa sobre isso.

  1. Selecione Dados no painel esquerdo.

  2. Selecione + Adicionar dados e, em seguida, crie uma nova tabela com o nome "Empresa", e nome plural como "Empresas".

  3. Adicione alguns nomes da empresa à tabela e, em seguida, selecione Fechar.

Adicione um novo ecrã para selecionar o cliente

Em seguida, vamos adicionar um ecrã à aplicação para que os utilizadores possam selecionar o cliente sobre o qual querem ter a conversa.

  1. Na vista de árvore, selecione + Novo ecrã > selecione o separador cenários > selecione Lista.

    Um novo ecrã é adicionado com uma lista de galerias.

  2. Atualizar o título da galeria para "Lista de Empresas".

  3. Selecione Empresas como origem de dados para a galeria.

    A lista de empresas adicionadas aparece na galeria TemplateGalleryList1.

  4. Elimine o Ecrã1 da vista de árvore e mude o nome do novo ecrã para Screen1.

Adicione uma nova tabela para capturar os detalhes da conversa

Precisamos de adicionar outra tabela para capturar os detalhes, como o ID de conversação do Teams, equipa e canal relacionado com uma conversa iniciada na app.

  1. Selecione Dados > + Adicionar dados > Criar nova tabela.

  2. Insira o nome da tabela como Conversa e nome plural como Conversas.

  3. Altere o nome predefinido da coluna para ID.

  4. Adicione as seguintes colunas à tabela de conversação:

    Coluna Tipo
    Equipa Texto
    Canal Teams Texto
    Nome da Equipa Texto
    Nome do Canal Texto
    Empresa Procura, tabela relacionada= Empresa
  5. Guardar e fechar a tabela.

Adicionar um novo ecrã para iniciar ou juntar-se a uma conversa

Agora, vamos adicionar um novo ecrã onde o utilizador da aplicação pode iniciar ou juntar-se a uma conversa.

  1. Na vista da árvore, selecione + Novo ecrã > Esquema em branco.

  2. Atualize a propriedade Preencher do ecrã para algo diferente da cor branca.

    No nosso exemplo, definimos a propriedade Preencher do ecrã para RGBA(224, 224, 237, 1).

  3. Selecione + (Inserir) > Introduzir > botão.

  4. Atualize as propriedades seguintes do botão.

    Propriedade Value
    Nome startaconversation_Button
    Texto "Iniciar uma conversação"
    Width 200
    Altura 32
    Tamanho do tipo de letra 12
    X Parent.Width/2 - startaconversation_Button.Width/2
    Y 100
    OnSelect Set(enterMessage,true)
  5. Selecione + (Inserir) > Introduzir > Caixa de combinação.

  6. Atualize as propriedades seguintes da Caixa de combinação.

    Propriedade Value
    Nome team_Combobox
    Artigos MicrosoftTeams.GetAllTeams().value
    Width 320
    Altura 32
    X Parent.Width/2 - team_ComboBox.Width/2
    Y 200
    Texto "Equipa"
    Descrição "Equipa"
    Visível enterMessage
  7. Adicionar outra caixa de combinação e atualizar as seguintes propriedades.

    Propriedade Value
    Nome channel_Combobox
    Artigos If(!IsBlank(team_ComboBox.Selected.id),MicrosoftTeams.GetChannelsForGroup(team_ComboBox.Selected.id).value)
    Width 320
    Altura 32
    X Parent.Width/2 - channel_ComboBox.Width/2
    Y 200
    Texto "Canal"
    Descrição "Canal"
    Visível enterMessage
  8. Selecione + (Inserir) > Introduzir > Caixa de texto.

  9. Atualize as propriedades seguintes da caixa de texto.

    Propriedade Value
    Nome message_TextBox
    Value ""
    Width 500
    Altura 180
    X Parent.Width/2 - message_TextBox.Width/2
    Y 400
    Marcador de Posição Escreva a mensagem aqui
    Visível enterMessage
  10. Selecione + (Inserir) > Introduzir > botão.

  11. Atualize as propriedades seguintes do botão.

    Propriedade Value
    Nome submit_Button
    Value "Submeter"
    Width 96
    Altura 32
    Tamanho do tipo de letra 12
    X Parent.Width/2 - submit_Button.Width/2
    Y 500
    Visível enterMessage
  12. Copiar a seguinte fórmula no evento OnSelect do botão.

    Power Fx
    Patch(Conversations,Defaults(Conversations),{ID:MicrosoftTeams.PostMessageToChannelV3(team_ComboBox.Selected.id,channel_ComboBox.Selected.id,{content:message_TextBox.Value,contentType: "text"},{subject:"New conversation"}).id,Team:team_ComboBox.Selected.id,'Team Channel':channel_ComboBox.Selected.id, 'Team Name':team_ComboBox.Selected.displayName,'Channel Name':channel_ComboBox.Selected.displayName, Company: TemplateGalleryList1.Selected}); Set(enterMessage,false); Reset(team_ComboBox);Reset(channel_ComboBox);Reset(message_TextBox)
    

    Nota

    • Na fórmula acima, estamos a usar a função Patch para criar uma linha na tabela Conversas para capturar o ID de conversação juntamente com a equipa, nome da equipa, canal e nome de canal. Ao mesmo tempo, também estamos a publicar uma mensagem na equipa e canal apropriados usando a função PostMessageToChannelV3. Em seguida definimos a variável enterMessage de volta para "falso" para esconder alguns dos campos e botões cuja visibilidade depende desta variável.
    • O assunto é codificado para "Nova conversa" para manter a app simples, e não adicionar outro controlo de caixa de texto para capturar. Mas uma caixa de texto pode ser adicionada para sujeito do ecrã e pode ser capturada pelo utilizador. Esta fórmula terá de ser ajustada em conformidade para fazer referência a esse controlo. A função Repor não funciona para o controlo Caixa de combinação UI fluente. Isto é necessário para não ter nenhuma equipa ou canal selecionado uma vez que uma mensagem é publicada.
  13. Selecione + (Inserir) > Introduzir > botão.

  14. Atualize as propriedades seguintes do botão.

    Propriedade Value
    Nome joinconversation_Button
    Texto "Juntar-se à conversa"
    Width 200
    Altura 32
    Tamanho do tipo de letra 12
    X Parent.Width/2 - submit_Button.Width/2
    Y 500
    Visível enterMessage
  15. Copiar a seguinte fórmula no evento OnSelect do botão.

    Power Fx
    Launch(Concatenate("msteams://teams.microsoft.com/l/message/",Last(Sort(Conversations, 'Created On', Ascending)).'Team Channel',"/",Gallery1.Selected.etag,"?tenantId=",Param("tenandId"),"&groupId=",Last(Sort(Conversations, 'Created On', Ascending)).Team,"&parentMessageId=",LookUp(MicrosoftTeams.GetMessagesFromChannel(Last(Sort(Conversations, 'Created On', Ascending)).Team,Last(Sort(Conversations, 'Created On', Ascending)).'Team Channel').value,id = Last(Sort(Conversations, 'Created On', Ascending)).Team).etag,"&teamName=",Last(Sort(Conversations, 'Created  On', Ascending)).'Team Name',"&channelName=",Last(Sort(Conversations, 'Created On', Ascending)).'Channel Name'),{},LaunchTarget.New)
    

    Nota

    • Na fórmula acima, estamos a usar a função de Lançamento para lançar Teams utilizando a equipa e os parâmetros de canal do último registo que foi criado na tabela Conversas. Estamos a fazer isto para que quando um utilizador inicie uma conversação e envie uma mensagem para publicar num canal, o utilizador possa então selecionar o botão Juntar-se à conversa para ir diretamente à publicação de Teams.
    • Estamos a usar a última função para a manter simples. Se antecipar a utilização desta app de forma mais extensiva e antecipar ter várias conversas, poderá ser criativo usando uma galeria de conversas e permitindo ao utilizador selecionar qual a conversa em que gostaria de participar.*

Em seguida, atualizaremos a propriedade OnSelect da galeria da empresa para que quando um utilizador selecione uma empresa da lista, a aplicação irá para o segundo ecrã.

  1. Selecione Screen1 da vista de árvore para abrir a galeria Empresas.

  2. Defina a propriedade OnSelect do item da galeria para Navigate(Screen2).

Guarde e publique a aplicação

  1. Selecione Guardar no topo direito para guardar a aplicação.

  2. Selecione Publicar no topo direito para publicar a aplicação.

  3. Selecione Seguinte.

  4. Em Adicionar ao Canal, certifique-se de que o canal sob o qual a aplicação deve ser mostrada está listado e mostra como "1 separador(es) ativo(s)" e não "0 separador(es) ativo(s)".

  5. Selecione Guardar e Fechar para concluir a publicação da aplicação.

Testar a aplicação

Execute a aplicação em modo de pré-visualização ou vá para a equipa na qual a aplicação é criada.

  1. A galeria Empresas deve aparecer como o primeiro ecrã.

  2. Selecione uma das empresas.

  3. Só deverá ver dois botões: Iniciar uma conversa e juntar-se a uma conversa.

  4. Selecione Iniciar uma conversação associada.

  5. Os campos adicionais devem aparecer:

    • Equipa (menu suspenso com uma lista de equipas)
    • Canal (menu suspenso de canais da equipa selecionada)
    • Caixa de mensagens (caixa de texto para escrever a mensagem a enviar para a equipa)
    • Botão enviar (para enviar a mensagem)
  6. Selecionar uma equipa.

  7. Selecione um canal dentro da equipa.

  8. Introduzir mensagem.

  9. Selecione Submeter. Todos os campos/controlos adicionais são escondidos.

  10. Selecione Juntar-se à conversa para ser levado para a equipa e para o chat do canal para onde a última mensagem foi enviada.

    Testar a aplicação

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).