Compartir a través de


Usar un conector personalizado desde una aplicación lógica

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 una aplicación lógica básica que utiliza el conector personalizado que creó en un tema anterior. La aplicación lógica se activa cuando se agrega un elemento a una lista de SharePoint, luego la aplicación lógica 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 la aplicación lógica vuelve a escribir la puntuación en la lista. En la imagen siguiente se muestra la aplicación lógica finalizada:

Aplicación lógica de análisis de sentimiento terminada

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 la aplicación lógica 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".

Creación de una aplicación lógica

Ahora que tiene una lista con la que trabajar, cree una aplicación lógica en Azure Portal.

  1. Inicie sesión en Azure Portal con las credenciales de su cuenta de Azure.

  2. En el menú principal de Azure, elija Nuevo > Integración empresarial > Aplicación lógica

    Crear aplicación lógica

  3. Bajo Crear aplicación lógica, proporcione detalles sobre su aplicación lógica como se muestra aquí. Cuando esté listo, elija Anclar al panel > Crear.

    Proporcione detalles de la aplicación lógica

    Configuración valor Descripción
    Nombre SentimentAnalysis El nombre de la aplicación lógica
    Suscripción <your-Azure-subscription-name> El nombre de su suscripción a Azure
    Grupo de recursos My-First-LA-RG El nombre del grupo de recursos de Azure utilizado para organizar recursos relacionados
    Ubicación Este de EE. UU. 2 La región donde almacenar la información de su aplicación lógica

    Nota: Su aplicación lógica y conector personalizado deben existir en la misma región.

    Log Analytics Desactivado Mantenga la opción Apagado para el registro de diagnóstico.
  4. Después de que Azure implemente su aplicación, Logic Apps Designer se abre y muestra una página con un vídeo introductorio y desencadenadores de uso común. En Plantillas, elija Aplicación lógica en blanco.

    Elija la plantilla de aplicación lógica en blanco

Agregue el desencadenador y el conector personalizado

Con la aplicación lógica creada, agregue un desencadenador que se activa cuando se agrega un elemento a la lista de SharePoint. Después, agregue una acción para realizar en función del elemento agregado.

  1. En Logic Apps Designer, busque o seleccione SharePoint y luego el desencadenador SharePoint - cuando se crea un artículo.

    Desencadenador de SharePoint para crear un artículo

  2. Si se le solicita, inicie sesión con sus credenciales de SharePoint.

  3. Introduzca valores para el desencadenador de SharePoint.

    Parámetros del desencadenador de SharePoint para crear un artículo

    Parámetro valor
    Dirección del sitio <your-SharePoint-site-address>
    Nombre de la lista Críticas de cine
    Intervalo 10
    Frecuencia Segundo
  4. Elija +Nuevo paso y después seleccione Agregar una acción.

  5. Busque el conector personalizado SentimentDemo 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.

  6. Escriba un nombre para la conexión y la clave de API.

    Nombre de conexión y clave de API

    Parámetro valor
    Nombre de la conexión Un nombre como SentimentDemoConnection.
    Clave API La clave de API para la API Text Analytics. Para obtener más información, vaya a Obtención de una clave de API.
  7. Escriba valores para todos los campos.

    Parámetros del conector

    Parámetro valor
    Idioma en
    Identificador 1
    Texto 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, enviamos un documento de cada vez. En una aplicación lógica, los valores Language e ID pueden provenir de una lista u otro origen de datos.

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

  9. 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 <your-SharePoint-site-address>
    Nombre de la lista Críticas de cine
    Id. El campo Id. de SharePoint
    Puesto El campo Título de SharePoint
    Revisión 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 Logic Apps agrega un contenedor For each, porque reconoce que el conector personalizado acepta varios documentos. Su conector solo envía uno a la vez, pero es genial que la aplicación lógica coincida con las capacidades del conector.

    Aplicar a cada uno

    La aplicación lógica terminada debería parecerse a la de la imagen siguiente:

    Aplicación lógica de análisis de sentimiento terminada

  10. En la parte superior de Logic Apps Designer, elija Ejecutar.

Pruebe la aplicación lógica

Una vez que se ha completado la aplicación lógica, para probarla hay que agregar revisiones a la lista de SharePoint y ver cómo responde la aplicación lógica.

  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. De vuelta en el portal de Azure, elija Descripción general para ver el historial de ejecución de esta aplicación lógica. Debe ver dos ejecuciones: una por cada revisión que haya agregado a la lista. Para ahorrar recursos de Azure una vez que haya terminado con esta aplicación lógica, elija Deshabilitar.

    Historial de ejecución

  4. De vuelta en la página de lista de SharePoint, actualice el navegador para ver las puntuaciones que agregó la aplicación lógica.

    Puntuaciones agregadas desde la aplicación lógica

Ya está todo listo. Esta es una aplicación lógica sencilla, 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.