Compartir a través de


Uso de un conector personalizado desde un flujo

Nota

Este tema forma parte de una serie de tutoriales sobre la creación y el uso de conectores personalizados en Azure Logic Apps, Power Automate y Power Apps. Asegúrese de leer la descripción general del conector personalizado para entender el proceso.

En este tema, crea un flujo básico que utiliza el conector personalizado que creó en un tema anterior. El flujo se activa cuando se agrega un elemento a una lista de SharePoint, luego el flujo usa el conector personalizado para llamar a la API Text Analytics de Cognitive Services. El conector devuelve la puntuación de opinión (0 a 1) para el texto en el elemento de la lista y el flujo vuelve a escribir la puntuación en la lista. En la imagen siguiente se muestra el flujo finalizado:

Flujo de análisis de sentimiento terminado

Requisitos previos

Creación de la lista SharePoint

Primero crea una lista simple de tres columnas en SharePoint Online; esta lista almacena datos de revisión de películas para las que el flujo analiza el sentimiento. Para obtener más información acerca de las listas de SharePoint, consulte Introducción a las listas en la documentación de SharePoint.

  1. En el sitio SharePoint Online, elija Nuevo y Lista.

    Crear una lista de SharePoint nueva

  2. Escriba el nombre Movie Reviews y, luego, elija Crear.

    Especificar un nombre para la lista nueva

    Se crea la lista Project Requests con el campo predeterminado Title.

    Lista de Project Requests

  3. Elija el icono de elemento nuevo y , después, Línea de texto única.

    Campo para agregar una línea de texto

  4. Escriba el nombre Review y elija Guardar.

  5. Repita los pasos 3. y 4. para agregar otra columna a la lista: use un tipo de datos Número y el nombre Score.

Crear un flujo a partir de la lista

SharePoint Online proporciona la capacidad de crear flujos directamente desde una lista, por lo que utilizaremos ese enfoque. Podría crear el mismo flujo desde flow.microsoft.com.

  1. En la lista de SharePoint, elija Flujo y Crear un flujo.

    Crear un flujo

  2. En el panel derecho, elija Mostrar más.

    Mostrar más flujos

  3. Elija la plantilla Cuando se agrega un nuevo elemento en SharePoint, se completa una acción personalizada.

    Acción personalizada para SharePoint

    La acción personalizada en este caso es llamar a la API a través del conector personalizado.

  4. Asegúrese de haber iniciado sesión en SharePoint con la cuenta correcta y luego elija Continuar.

    Permisos del conector de SharePoint

  5. En flow.microsoft.com, elija Editar. Debería ver el sitio de SharePoint y la lista desde la que se lanzó el proceso Crear un flujo.

    Confirmar el sitio y la lista

Agregar el conector personalizado

Power Automate ha creado un flujo básico con un desencadenador que se activa cuando se agrega un elemento a la lista de SharePoint. Ahora agrega acciones para realizar en función del elemento que se agrega.

  1. Elija +Nuevo paso y después seleccione Agregar una acción.

  2. Busque el conector que creó y luego elija la acción asociada con ese conector.

    Elija la acción SentimentDemo

    El nombre y la descripción de la acción provienen de la información que proporcionó cuando creó el conector.

  3. Escriba valores para todos los campos.

    Parámetros del conector

    Parámetro valor
    Lenguaje "en"
    Identificador "1"
    Text El campo de SharePoint Revisar (en el cuadro de diálogo Contenido dinámico)

    El parámetro ID es necesario porque el conector puede controlar varios documentos; en nuestros ejemplos, los documentos se envían de uno en uno. En un flujo de producción, los valores Language e ID pueden provenir de una lista u otro origen de datos.

  4. Elija Nuevo paso y después seleccione Agregar una acción.

  5. Agregue la acción SharePoint - Actualizar elemento e introduzca valores para todos los campos.

    Acción Actualizar elemento de lista

    Parámetro valor
    Dirección del sitio La dirección del sitio de SharePoint Online desde la que se lanzó el proceso Crear un flujo
    Nombre de la lista La lista desde la que lanzó el proceso Crear un flujo
    Id. El campo Id. de SharePoint
    Nombre El campo Título de SharePoint
    Reseña El campo Revisar de SharePoint
    Puntuación El campo Puntuación del conector personalizado

    Al agregar el contenido dinámico para el campo Puntuación, tenga en cuenta que Power Automate agrega un contenedor Aplicar a cada uno, porque reconoce que el conector personalizado acepta varios documentos. Su flujo solo envía uno a la vez, pero es genial que el flujo coincida con las capacidades del conector.

    Aplicar a cada uno

    El flujo terminado debería parecerse al de la imagen siguiente:

    Flujo de análisis de sentimiento terminado

  6. Escriba un nombre para el flujo, como Sentiment Analysis, y luego elija Crear flujo y Listo.

Probar el flujo

Una vez que se ha completado el flujo, para probarlo hay que agregar revisiones a la lista de SharePoint y ver cómo responde el flujo.

  1. En la lista de SharePoint Online, elija Edición rapida.

    Edición rápida de la lista de SharePoint

  2. Agregue dos comentarios a la lista (uno negativo y uno positivo) y luego elija Hecho.

    Edición rápida hecha

    Parámetro Valor sugerido
    Título (positivo) Mi pelicula favorita
    Revisión (positivo) "Disfruté la nueva película después de un largo día"
    Título (negativo) Alguna otra pelicula
    Revisión (negativo) "La peor película que he visto en décadas"
  3. En flow.microsoft.com, elija Mis flujos y luego elija el flujo que creó.

    Elija un flujo nuevo

  4. Examine el HISTORIAL DE EJECUCIONES y verá dos ejecuciones, una por cada revisión que haya agregado a la lista.

    Historial de ejecución

  5. De vuelta en la página de lista de SharePoint, actualice el navegador para ver las puntuaciones que agregó el flujo.

    Puntuaciones agregadas desde el flujo

Ya está todo listo. Este es un flujo sencillo, pero cuenta con una funcionalidad eficaz porque puede llamar a Cognitive Services a través de un conector personalizado.

Pasos siguientes

Comparta el conector dentro de su organización o certifique el conector para que los usuarios ajenos a su organización puedan utilizarlo:

Proporcionar comentarios

Agradecemos enormemente los comentarios sobre problemas con nuestra plataforma de conectores o nuevas ideas de características. Para enviar comentarios, vaya a Enviar problemas u obtener ayuda con los conectores y seleccione el tipo de comentario.