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:
Requisitos previos
- Una suscripción a Office 365 Business Premium o regístrese para una prueba gratis
- Experiencia básica en la creación de flujos. Para más información, consulte Crear un flujo desde cero.
- El conector personalizado que creó en uno de estos temas:
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.
En el sitio SharePoint Online, elija Nuevo y Lista.
Escriba el nombre Movie Reviews y, luego, elija Crear.
Se crea la lista Project Requests con el campo predeterminado Title.
Elija el
y , después, Línea de texto única.
Escriba el nombre Review y elija Guardar.
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.
En la lista de SharePoint, elija Flujo y Crear un flujo.
En el panel derecho, elija Mostrar más.
Elija la plantilla Cuando se agrega un nuevo elemento en SharePoint, se completa una acción personalizada.
La acción personalizada en este caso es llamar a la API a través del conector personalizado.
Asegúrese de haber iniciado sesión en SharePoint con la cuenta correcta y luego elija Continuar.
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.
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.
Elija +Nuevo paso y después seleccione Agregar una acción.
Busque el conector que creó y luego elija la acción asociada con ese conector.
El nombre y la descripción de la acción provienen de la información que proporcionó cuando creó el conector.
Escriba valores para todos los campos.
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.
Elija Nuevo paso y después seleccione Agregar una acción.
Agregue la acción SharePoint - Actualizar elemento e introduzca valores para todos los campos.
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.
El flujo terminado debería parecerse al de la imagen siguiente:
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.
En la lista de SharePoint Online, elija Edición rapida.
Agregue dos comentarios a la lista (uno negativo y uno positivo) y luego elija Hecho.
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" En flow.microsoft.com, elija Mis flujos y luego elija el flujo que creó.
Examine el HISTORIAL DE EJECUCIONES y verá dos ejecuciones, una por cada revisión que haya agregado a la lista.
De vuelta en la página de lista de SharePoint, actualice el navegador para ver las puntuaciones que agregó 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.