Compartilhar via


Usar um conector personalizado de um aplicativo lógico

Observação

Esse tópico faz parte de uma série de tutoriais sobre a criação e o uso de conectores personalizados nos Aplicativos Lógicos do Azure, no Power Automate e no Power Apps. Certifique-se de ler a Visão geral do conector personalizado para entender o processo.

Neste tópico, você criará um aplicativo lógico básico que usa o conector personalizado criado em um tópico anterior. O aplicativo lógico é acionado quando um item é adicionado a uma lista do SharePoint, o aplicativo lógico usa o conector customizado para chamar a API de Análise de Texto dos Serviços Cognitivos. O conector retorna a pontuação de sentimento (0 a 1) para o texto no item da lista e o aplicativo lógico grava a pontuação novamente na lista. A imagem a seguir mostra o aplicativo lógico terminado:

Aplicativo lógico de análise de sentimento terminado

Pré-requisitos

Criar a lista SharePoint

Primeiro, você cria uma lista simples de três colunas no SharePoint Online; essa lista armazena dados de revisão de filmes que o aplicativo lógico analisa em relação a sentimentos. Para obter mais informações sobre listas do SharePoint, consulte Introdução a listas na documentação do SharePoint.

  1. No seu site do SharePoint Online, escolha Novo, então Lista.

    Criar nova lista do SharePoint

  2. Insira o nome "Críticas de Filme" e escolha Criar.

    Especificar um nome para a nova lista

    A lista é criada com o campo Título padrão.

    Lista Project Requests

  3. Escolha ícone de Novo item e, em seguida, Linha única de texto.

    Adicionar campo de texto com uma linha

  4. Insira o nome "Crítica" e escolha Salvar.

  5. Repita as etapas 3. e 4. para adicionar outra coluna à lista: use um tipo de dados Número e o nome "Pontuação".

Criar um aplicativo lógico

Agora que você tem uma lista para trabalhar, crie um aplicativo lógico no portal do Azure.

  1. Entre no portal do Azure com as credenciais da sua conta do Azure.

  2. No menu principal do Azure, escolha Novo > Enterprise Integration > Aplicativo Lógico.

    Criar aplicativo lógico

  3. Em Criar aplicativo lógico, forneça detalhes sobre seu aplicativo lógico, como mostrado aqui. Quando tiver concluído, escolha Fixar no painel > Criar.

    Forneça detalhes lógicos do aplicativo

    Configuração Valor Descrição
    Nome SentimentAnalysis O nome do seu aplicativo lógico
    Subscrição <nome-da-sua-assinatura-do-Azure> O nome da sua assinatura do Azure
    Grupo de recursos My-First-LA-RG O nome do grupo de recursos do Azure usado para organizar recursos relacionados
    Localização Leste dos EUA 2 A região onde são armazenadas as informações do aplicativo lógico

    Observação: seu aplicativo lógico e conector personalizado devem existir na mesma região.

    Log Analytics Desativado(a) Mantenha a configuração Desativado para log de diagnóstico.
  4. Depois que o Azure implantar seu aplicativo, o Designer de Aplicativos Lógicos é aberto e mostra uma página com um vídeo de introdução e os gatilhos mais usados. Em Modelos, escolha Aplicativo Lógico em Branco.

    Escolher modelo de aplicativo lógico em branco

Adicionar o gatilho e o conector personalizado

Com o aplicativo lógico criado, você adiciona um gatilho que é acionado quando um item é adicionado à lista do SharePoint. Em seguida, você adiciona uma ação a ser executada com base no item adicionado.

  1. No Designer de Aplicativos Lógicos, procure ou selecione SharePoint, então o gatilho SharePoint - quando um item é criado.

    O SharePoint cria um gatilho de item

  2. Se solicitado, entre com suas credenciais no SharePoint.

  3. Digite valores para o gatilho do SharePoint.

    O SharePoint cria parâmetros de gatilho de item

    Parâmetro Valor
    Endereço do Site <endereço-do-seu-site-do-SharePoint>
    Nome da Lista Críticas de Filmes
    Intervalo 10
    Frequência Segundo
  4. Escolha Nova etapa e selecione Adicionar uma ação.

  5. Procure o conector personalizado SentimentDemo que você criou e escolha a ação associada a esse conector.

    Escolher a ação SentimentDemo

    O nome e a descrição da ação vêm das informações fornecidas quando você criou o conector.

  6. Insira um nome para a conexão e a chave de API.

    Nome da conexão e chave de API

    Parâmetro Valor
    Nome da Conexão Um nome como SentimentDemoConnection.
    Chave API A chave da API de Análise de Texto. Para saber mais, vá até Obter uma chave de API.
  7. Insira os valores em todos os campos.

    Parâmetros do conector

    Parâmetro Valor
    Linguagem en
    ID 1
    Texto O campo Crítica do SharePoint (da caixa de diálogo Conteúdo dinâmico)

    A ID é necessária porque o conector pode lidar com vários documentos; em nossos exemplos, enviamos um documento por vez. Em um aplicativo lógico de produção, os valores Idiomae ID podem vir de uma lista ou de outra fonte de dados.

  8. Escolha Nova etapa e selecione Adicionar uma ação.

  9. Adicione a ação SharePoint - Atualizar item e insira valores em todos os campos.

    Ação Atualizar item de lista

    Parâmetro Valor
    Endereço do Site <endereço-do-seu-site-do-SharePoint>
    Nome da lista Críticas de Filmes
    ID O campo ID do SharePoint
    Tratamento O campo Título do SharePoint
    Revisar O campo Crítica do SharePoint
    Pontuação O campo pontuação do conector personalizado

    Quando você adicionar o conteúdo dinâmico ao campo pontuação, observe que os Aplicativos Lógicos adicionam um contêiner Para cada porque reconhece que o conector personalizado aceita vários documentos. Seu conector envia apenas um de cada vez, mas é interessante que o aplicativo lógico corresponda aos recursos do conector.

    Aplicar a cada

    O aplicativo lógico terminado deve ser semelhante a imagem a seguir:

    Aplicativo lógico de análise de sentimento terminado

  10. Na parte superior do Designer de Aplicativos Lógicos, escolha Executar.

Testar o aplicativo lógico

Agora que o aplicativo lógico está completo, é hora de testá-lo adicionando resenhas na lista do SharePoint e ver como o aplicativo lógico responde.

  1. Na sua lista do SharePoint Online, escolha Edição Rápida.

    Edição rápida de lista do SharePoint

  2. Adicione duas revisões à lista (um negativa e um positiva) e escolha Concluído.

    Edição rápida concluída

    Parâmetro Valor sugerido
    Título (positivo) Meu Filme Favorito
    Crítica (positiva) Gostei do novo filme depois de um longo dia
    Título (negativo) Algum Outro Filme
    Crítica (negativa) O pior filme que eu já vi em décadas
  3. De volta ao portal do Azure, escolha Visão geral para examinar o histórico de execução desse aplicativo lógico. Você deverá ver duas execuções—uma para cada resenha adicionada à lista. Para salvar os recursos do Azure depois de concluir esse aplicativo lógico, escolha Desabilitar.

    Histórico de execuções

  4. De volta à página de lista do SharePoint, atualize o navegador para ver as pontuações adicionadas pelo aplicativo lógico.

    Pontuações adicionadas do aplicativo lógico

Você está pronto! É um aplicativo lógico simples, mas obtém uma funcionalidade avançada com a capacidade de chamar os Serviços Cognitivos por meio de um conector personalizado.

Próximas etapas

Compartilhe o conector em sua organização e/ou obter a certificação do conector para que as pessoas fora de sua organização possam usá-lo:

Enviar comentários

Agradecemos muito os comentários sobre problemas com nossa plataforma de conectores ou novas ideias de recursos. Para fornecer comentários, acesseEnviar problemas ou obter ajuda com conectores e selecione o tipo de comentário.