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:
Pré-requisitos
Uma assinatura do Office 365 Business Premium ou inscreva-se em uma avaliação gratuita
Experiência básica de criação de aplicativos lógicos. Para mais informações, veja Criar seu primeiro fluxo de trabalho de aplicativo lógico.
O conector personalizado que você criou em um destes tópicos:
Se o seu conector personalizado acessar recursos locais usando o gateway de dados local, você precisará configurar a instalação do gateway para permitir o acesso aos endereços IP de saída dos conectores predefinidos correspondentes. Todos os aplicativos lógicos na mesma região usam os mesmos intervalos de endereços IP. Para mais informações, consulte Instalar o gateway de dados local para Aplicativos Lógicos do Azure - Verifique ou ajuste as configurações de comunicação.
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.
No seu site do SharePoint Online, escolha Novo, então Lista.
Insira o nome "Críticas de Filme" e escolha Criar.
A lista é criada com o campo Título padrão.
Escolha
e, em seguida, Linha única de texto.
Insira o nome "Crítica" e escolha Salvar.
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.
Entre no portal do Azure com as credenciais da sua conta do Azure.
No menu principal do Azure, escolha Novo > Enterprise Integration > Aplicativo Lógico.
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.
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. 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.
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.
No Designer de Aplicativos Lógicos, procure ou selecione SharePoint, então o gatilho SharePoint - quando um item é criado.
Se solicitado, entre com suas credenciais no SharePoint.
Digite valores para o gatilho do SharePoint.
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 Escolha Nova etapa e selecione Adicionar uma ação.
Procure o conector personalizado SentimentDemo que você criou e escolha a ação associada a esse conector.
O nome e a descrição da ação vêm das informações fornecidas quando você criou o conector.
Insira um nome para a conexão e a 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. Insira os valores em todos os campos.
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.
Escolha Nova etapa e selecione Adicionar uma ação.
Adicione a ação SharePoint - Atualizar item e insira valores em todos os campos.
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.
O aplicativo lógico terminado deve ser semelhante a imagem a seguir:
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.
Na sua lista do SharePoint Online, escolha Edição Rápida.
Adicione duas revisões à lista (um negativa e um positiva) e escolha Concluído.
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 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.
De volta à página de lista do SharePoint, atualize o navegador para ver as pontuações adicionadas pelo 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.