Utilizar um conector personalizado a partir de um fluxo

Nota

Este tópico faz parte de uma série de tutoriais sobre a criação e a utilização de conectores personalizados no Azure Logic Apps, Power Automate e Power Apps. Certifique-se de que leu a descrição geral do conector personalizado para compreender o processo.

Neste tópico, vai criar um fluxo básico que utiliza o conector personalizado criado num tópico anterior. O fluxo é acionado quando um item é adicionado a uma lista do SharePoint e, em seguida, o fluxo utiliza o conector personalizado para chamar a API Análise de Texto dos Serviços Cognitivos. O conector devolve a classificação de sentimento (0 a 1) para o texto no item da lista e o fluxo escreve a classificação para a lista. A imagem seguinte mostra o fluxo concluído:

Pré-requisitos

• Uma Subscrição do Office 365 - Versão Premium ou subscreva uma avaliação gratuita
• Experiência básica na criação de fluxos. Para mais informações, consulte Criar um fluxo de raiz.
• O conector personalizado que criou num destes tópicos:
  • Criar um conector personalizado a partir de uma definição de OpenAPI
  • Criar um conector personalizado do zero

Criar a lista do SharePoint

Primeiro, crie uma lista de três colunas simples no SharePoint Online. Esta lista armazena os dados de críticas de filmes onde o fluxo analisa o sentimento. Para mais informações sobre as listas do SharePoint, consulte Introdução às listas na documentação do SharePoint.

1. No site do SharePoint Online, escolha Novo e, em seguida, Lista.

   

2. Introduza o nome Críticas de Filmes e, em seguida, escolha Criar.

   

   A lista é criada com o campo predefinido Título.

   

3. Escolha e em seguida Uma linha de texto.

   

4. Introduza o nome Crítica e, em seguida, escolha Guardar.

5. Repita os passos 3. e 4. para adicionar outra coluna à lista: utilize um tipo de dados Número e o nome Classificação.

Criar um fluxo a partir da lista

O SharePoint Online fornece a capacidade para criar fluxos diretamente a partir de uma lista, pelo que usaremos essa abordagem. Poderá criar o mesmo fluxo a partir de flow.microsoft.com.

1. Na lista do SharePoint, escolha Fluxo e, em seguida, Criar um fluxo.

   

2. No painel da direita, escolha Mostrar mais.

   

3. Escolha o modelo Quando um novo item for adicionado ao SharePoint, concluir uma ação personalizada.

   

   A ação personalizada neste caso é chamar a API através do conector personalizado.

4. Certifique-se de que tem sessão iniciada no SharePoint com a conta correta e escolha Continuar.

   

5. Em flow.microsoft.com, escolha Editar. Deve ver a lista e o site do SharePoint a partir do qual iniciou o processo Criar um fluxo.

   

Adicionar o conector personalizado

O Power Automate criou um fluxo básico com um acionador que é acionado quando é adicionado um item à lista do SharePoint. Em seguida, adicione as ações a executar com base no item que é adicionado.

1. Selecione Novo passo e, em seguida, Adicionar uma ação.

2. Procure o conector que criou e, em seguida, escolha a ação associada a esse conector.

   

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

3. Introduza os valores para todos os campos fornecidos.

   

   Parâmetro	valor
   Idioma	"en"
   ID	"1"
   Texto	O campo Críticas do SharePoint (a partir da caixa de diálogo Conteúdo dinâmico)

   O ID é necessário porque o conector pode processar vários documentos; nestes exemplos, envia um documento de cada vez. Num fluxo de produção, os valores Idioma e ID poderão ter origem numa lista ou noutra origem de dados.

4. Selecione Novo passo e, em seguida, Adicionar uma ação.

5. Adicione a ação SharePoint - Atualizar item e introduza valores para todos os campos.

   

   Parâmetro	valor
   Endereço do Site	O endereço do site do SharePoint Online a partir do qual iniciou o processo Criar um fluxo
   Nome da lista	A lista a partir da qual iniciou o processo Criar um fluxo
   ID	O campo ID do SharePoint
   Cargo	O campo Título do SharePoint
   Crítica	O campo Crítica do SharePoint
   Pontuação	O campo classificação do conector personalizado

   Repare que, quando adiciona o conteúdo dinâmico ao campo Classificação, o Power Automate adiciona um contentor Aplicar a cada, porque reconhece que o conector personalizado aceita vários documentos. O seu fluxo envia apenas um de cada vez, mas é prático que o fluxo corresponda às capacidades do conector.

   

   O fluxo acabado deverá agora ser semelhante à imagem seguinte:

   

6. Introduza um nome para o fluxo, como Análise de Sentimentos e escolha Criar fluxo e Concluído.

Testar o fluxo

Agora que o fluxo está concluído, é altura de o testar ao adicionar críticas à lista do SharePoint e ver como responde.

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

   

2. Adicione duas críticas à lista (uma negativa e uma positiva) e, em seguida, escolha Concluído.

   

   Parâmetro	Valor sugerido
   Título (positivo)	O Meu Filme Favorito
   Crítica (positiva)	"Gostei do novo filme após um dia longo"
   Título (negativo)	Um Outro Filme
   Crítica (negativa)	"O pior filme que vi em décadas"

3. Em flow.microsoft.com, escolha Os meus fluxos e, em seguida, escolha o fluxo que criou.

   

4. Veja HISTÓRICO DE EXECUÇÕES, onde deverá encontrar duas execuções—, uma para cada crítica que adicionou à lista.

   

5. De volta à página da lista do SharePoint, atualize o browser para ver as classificações que o fluxo adicionou.

   

Concluiu! Este é um fluxo simples, mas ganha funcionalidade poderosa por ser capaz de chamar os Serviços Cognitivos através de um conector personalizado.

Passos seguintes

Partilhe o conector dentro da sua organização e/ou certifique-o, para que possa ser utilizado por pessoas externas à sua organização:

• Partilhar o conector
• Certificar o conector

Enviar comentários

Apreciamos os comentários sobre problemas com a nossa plataforma de conectores ou novas ideias de funcionalidades. Para enviar comentários, aceda a Submeter problemas ou obter ajuda com conectores e selecione o tipo de comentários.