Usar um conector personalizado de um fluxo

Neste tópico, você criará um fluxo básico que usa o conector personalizado criado em um tópico anterior. O fluxo é acionado quando um item é adicionado a uma lista do SharePoint. Em seguida, o fluxo utiliza o conector personalizado 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 fluxo grava a pontuação novamente na lista. A imagem a seguir mostra o fluxo terminado:

Pré-requisitos

• Uma assinatura Office 365 Business Premium ou inscreva-se para uma avaliação gratuita
• Experiência básica de criação de fluxos. Para obter mais informações, veja Criar um fluxo do zero.
• O conector personalizado que você criou em um destes tópicos:
  • Criar um conector personalizado de uma definição OpenAPI
  • Criar um conector personalizado do zero

Criar a lista de SharePoint

Primeiro, você cria uma lista simples de três colunas no SharePoint Online; essa lista armazena dados de críticas de filmes que o fluxo analisa em relação a sentimentos. Para obter mais informações sobre listas de SharePoint, consulte Introduction to lists in the SharePoint documentation.

1. Em seu site do SharePoint Online, escolha New e List.

   

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

   

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

   

3. Escolha , 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 de Número e o nome Pontuação.

Criar um fluxo com base na lista

SharePoint Online fornece a capacidade de criar fluxos diretamente de uma lista, portanto, usaremos essa abordagem. Você pode criar o mesmo fluxo a partir de flow.microsoft.com.

1. Na lista SharePoint, escolha FlowCriar um fluxo.

   

2. No painel direito, escolha Mostrar mais.

   

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

   ação

   A ação personalizada neste caso consiste em chamar a API por meio do conector personalizado.

4. Verifique se você está conectado para SharePoint com a conta correta e escolha Continue.

   

5. Em flow.microsoft.com, escolha Editar. Você deverá ver o site SharePoint e a lista do qual você iniciou o processo Criar um fluxo.

   

Adicionar o conector personalizado

Power Automate criou um fluxo básico com um gatilho que é acionado quando um item é adicionado à lista de SharePoint. Agora, você adiciona ações a serem executadas com base no item adicionado.

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

2. Procure o conector 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.

3. Insira os valores em todos os campos.

   

   Parâmetro	Valor
   Language	"en"
   ID	"1"
   Texto	O campo SharePoint Review (da caixa de diálogo Dynamic content)

   A ID é necessária porque o conector pode lidar com vários documentos. Nesses exemplos, você enviou um documento por vez. Em um fluxo de produção, os valores Idiomae ID podem vir de uma lista ou de outra fonte de dados.

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

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

   

   Parâmetro	Valor
   Endereço do Site	O endereço do site SharePoint Online do qual você iniciou o processo Criar um fluxo
   Nome da lista	A lista da qual você iniciou o processo Criar um fluxo
   ID	O campo SharePoint ID
   Título	O campo SharePoint Title
   Revisar	O campo SharePoint Review
   Pontuação	O campo pontuação do conector personalizado

   Ao adicionar o conteúdo dinâmico para o campo Score, observe que Power Automate adiciona um Apply a cada contêiner porque reconhece que o conector personalizado aceita vários documentos. Seu fluxo envia apenas um de cada vez, mas é interessante que ele corresponda aos recursos do conector.

   

   O fluxo terminado deve ser semelhante a imagem a seguir:

   

6. Insira um nome para o fluxo, como Análise de Sentimento, em seguida, escolha Criar fluxo e Concluído.

Testar o fluxo

Agora que o fluxo está concluído, é hora de testá-lo adicionando revisões à lista de SharePoint e vendo como o fluxo responde.

1. Em sua lista SharePoint Online, escolha Quick Edit.

   

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. Em flow.microsoft.com, escolha Meus fluxos e escolha o fluxo que você criou.

   

4. Consulte HISTÓRICO DE EXECUÇÕES, e você verá duas execuções, uma para cada revisão que você adicionou à lista.

   

5. De volta à página de lista do SharePoint, atualize o navegador para ver as pontuações adicionadas pelo fluxo.

   

Você terminou! É um fluxo 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 o conector certificado para que as pessoas fora de sua organização possam usá-lo:

• Compartilhar seu conector
• Certificar seu conector

Faça 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.