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:

Fluxo de análise de sentimentos concluído

Pré-requisitos

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.

    Criar nova lista do SharePoint

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

    Especificar o nome da nova lista

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

    Lista Pedidos de Projeto

  3. Escolha ícone de Novo item e em seguida Uma linha de texto.

    Adicionar o campo 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.

    Criar um fluxo

  2. No painel da direita, escolha Mostrar mais.

    Mostrar mais fluxos

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

    Ação personalizada para SharePoint

    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.

    Permissões do conector SharePoint

  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.

    Confirmar site e lista

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.

    Escolher a ação SentimentDemo

    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âmetros do conector

    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.

    Ação Atualizar item da lista

    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.

    Aplicar a cada

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

    Fluxo de análise de sentimentos concluído

  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.

    Edição rápida da lista do SharePoint

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

    Edição rápida concluída

    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.

    Escolher novo fluxo

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

    Histórico de execuções

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

    Classificações adicionadas a partir do fluxo

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:

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.