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:

  • Criar um conector personalizado de uma definição OpenAPI
  • Criar um conector personalizado de uma coleção Postman

• 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.

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

   

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

   

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

   

3. Escolha e, em seguida, Linha única de texto.

   

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.

   

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.

   

   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.

   

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.

   

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

3. 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

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.

   

   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.

   

   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â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.

   

   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:

   

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.

   

2. 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

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.

   

4. 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:

• Compartilhar seu conector
• Certificar seu conector

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.