Ir para o conteúdo

Atividade Microsoft Teams Chat no Jitterbit Studio

Introdução

Uma atividade Chat do Microsoft Teams, usando sua conexão Microsoft Teams, recupera um chat existente ou cria um novo chat no Microsoft Teams e é destinada a ser usada como destino para consumir dados em uma operação.

Criar uma atividade Microsoft Teams Chat

Uma instância de uma atividade Chat do Microsoft Teams é criada a partir de uma conexão Microsoft Teams usando seu tipo de atividade Chat.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade Chat do Microsoft Teams existente pode ser editada a partir destes locais:

Configurar uma atividade Microsoft Teams Chat

Siga estas etapas para configurar uma atividade Chat do Microsoft Teams:

Etapa 1: Insira um nome e especifique as configurações

Nesta etapa, forneça um nome para a atividade e especifique se deseja selecionar um chat existente ou criar um novo chat. Cada elemento da interface do usuário desta etapa é descrito abaixo.

A interface usada nesta etapa da configuração de uma atividade Chat do Microsoft Teams depende das opções Chat Selection e Create New Chat selecionadas:

Selecionar chat existente

  • Menu de endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint selecionado.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade Chat do Microsoft Teams e não deve conter barras / ou dois-pontos :.

  • Chat Selection: Escolha uma das duas formas de identificar o chat que você está procurando, Select Existent Chat ou Provide Chat ID Manually. Se deseja criar um novo chat, role para baixo além da lista de chats existentes e clique em Create New Chat.

  • Select a Chat: Esta seção exibe os chats disponíveis no endpoint do Microsoft Teams.

    • Selected Chat: Após um chat ser selecionado, seu tipo e identificador são listados aqui.

    • Search: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de chats. A pesquisa não diferencia maiúsculas de minúsculas. Se os chats já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada digitação. Para recarregar chats do endpoint ao pesquisar, insira os critérios de pesquisa e depois atualize, conforme descrito abaixo.

  • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para recarregar os chats do endpoint do Microsoft Teams. Isso pode ser útil se chats foram adicionados ao Microsoft Teams. Esta ação atualiza todos os metadados usados para construir a tabela de chats exibida na configuração.

  • Selecionando um Chat: Na tabela, clique em qualquer lugar de uma linha para selecionar um chat. Apenas um chat pode ser selecionado. As informações disponíveis para cada chat são obtidas do endpoint do Microsoft Teams:

    • Tipo de Chat: O tipo do chat (como Grupo ou Um-para-Um) e o identificador do chat.

    • Descrição: A descrição do chat, consistindo no tópico do chat e uma lista de membros do chat.

Dica

Se a tabela não for preenchida com os teams disponíveis, a conexão do Microsoft Teams pode não ter sido bem-sucedida. Certifique-se de que está conectado reabrindo a conexão e testando novamente as credenciais.

  • Criar Novo Chat: Por padrão, isso não está selecionado e a atividade permite a seleção de um chat existente.

  • Salvar e Sair: Se habilitado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Fornecer ID do chat manualmente

  • Nome: Digite um nome para identificar a atividade. O nome deve ser único para cada atividade Chat do Microsoft Teams e não deve conter barras / ou dois-pontos :.

  • Seleção de Chat: Escolha uma das duas formas de identificar o chat que você está procurando, seja Selecionar Chat Existente ou Fornecer ID do Chat Manualmente. Se você deseja criar um novo chat, role para baixo passando pelo próximo campo e clique em Criar Novo Chat.

  • ID do Chat: Digite o identificador do chat.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete de abertura [ no campo ou clique no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Criar Novo Chat: Por padrão, isso não está selecionado e a atividade permite a seleção de um chat existente.

  • Salvar e Sair: Se habilitado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Criar um novo chat

  • Nome: Digite um nome para identificar a atividade. O nome deve ser único para cada atividade Chat do Microsoft Teams e não deve conter barras / ou dois-pontos :.

  • Criar Novo Chat: Por padrão, isso não está selecionado e a atividade permite a seleção de um chat existente. Selecione isso para criar um novo chat. Se selecionado, as opções a seguir ficarão disponíveis.

  • Tipo de Chat: Selecione entre Um-para-Um e Grupo como o tipo de chat a ser criado.

    • Tópico: Se um chat Grupo foi selecionado, um tópico pode ser inserido para o chat.

  • Fornecer Email e Função: Forneça emails para membros do chat, seja como uma lista separada por vírgulas ou como uma tabela:

    • Se usar Fornecer Emails Separados por Vírgula Usando Campo de Texto:
      • Email: Digite uma lista separada por vírgulas de endereços de email dos membros a serem incluídos no canal.
      • Função de Proprietário: Se selecionado, todos os membros adicionados ao canal receberão a função de proprietário. Está selecionado por padrão. Se funções diferentes para membros diferentes forem necessárias, use o método de entrada em tabela.

  • Se estiver usando Fornecer Emails Usando Tabela, use os controles para adicionar e remover entradas da tabela.

    • Email do Usuário: Digite um endereço de email de um membro a ser incluído no canal.
    • Função do Usuário: Digite uma função para o membro. Por padrão, todos os membros adicionados ao canal receberão a função proprietário.

    Dica

    Campos com um ícone de variável permitem usar variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete de abertura [ no campo ou clique no ícone de variável para exibir um menu com as variáveis existentes disponíveis.

    Importante

    Campos na tabela Emails exibem o ícone de variável apenas no modo de edição. Para que os valores das variáveis desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.

    Campos na tabela Emails não permitem usar variáveis para passar JSON bruto. Se seu caso de uso não permitir definir JSON bruto diretamente nos campos, escape o conteúdo JSON antes de passá-lo com uma variável. Por exemplo, escapar {"success": "true"}; resulta em {\"success\": \"true\"};.

  • Salvar e Sair: Se habilitado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

Todos os esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo. Os esquemas de dados de solicitação e resposta exibidos dependem se você especificou selecionar um chat existente ou Criar Novo Chat na etapa 1.

Se você especificou selecionar um chat existente, estes esquemas de dados são exibidos:

Se você especificou criar um novo chat, estes esquemas de dados são exibidos:

  • Esquemas de Dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

    Nota

    Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

    O conector do Microsoft Teams usa a API REST do Microsoft Graph v1.0. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

  • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para regenerar esquemas a partir do endpoint do Microsoft Teams. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Editar: Clique no ícone de edição acima de cada esquema de dados para entrar no editor desse esquema de dados. O editor permite adicionar, excluir e reorganizar nós e campos e alterar seus tipos de dados. Todos os nós e campos recém-adicionados são definidos como [0, 1] cardinalidade. As alterações feitas nos esquemas de dados devem ser aceitáveis para o endpoint e devem ser feitas apenas após consultar qualquer documentação disponível para o endpoint. Após fazer edições no esquema, uma data de última edição é exibida na parte superior do esquema aplicável para indicar que o esquema teve edições manuais. Atualizar os esquemas os redefinirá para suas estruturas padrão.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Chat do Microsoft Teams, conclua a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as definições da operação, que incluem a capacidade de encadear operações que estão no mesmo fluxo de trabalho ou em fluxos de trabalho diferentes.

As ações de menu de uma atividade são acessíveis no painel do projeto e na tela de design. Para obter detalhes, consulte Menu de ações da atividade em Noções básicas do conector.

As atividades Chat do Microsoft Teams podem ser usadas como destino com estes padrões de operação:

Para usar a atividade com funções de script, escreva os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.