Usar un conector personalizado a partir de una aplicación de Power Apps

  • Artículo

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 básica que utiliza el conector personalizado que creó en un tema anterior. La aplicación toma una entrada de texto, luego 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 y la aplicación lo muestra como un porcentaje. En la imagen siguiente se muestra la aplicación terminada:

Aplicación de análisis de sentimiento terminada

Requisitos previos

Cree la aplicación y agregue el conector personalizado

Lo primero que debe hacer es crear una aplicación en blanco, luego conectarse al conector personalizado que creó en un tema anterior.

  1. En make.powerapps.com, elija Iniciar desde cero > Icono de aplicación para teléfono (teléfono) > Crear esta aplicación.

    Iniciar desde cero

  2. En el lienzo de la aplicación, elija conectarse a los datos.

  3. En el panel Datos, elija la conexión que creó en un tema anterior (como "SentimentDemo").

  4. Guarde la aplicación con el nombre Sentiment Analysis.

Adición de controles a la aplicación

Ahora cree la interfaz de usuario para la aplicación, de modo que pueda ingresar texto, enviar ese texto a la API y obtener una respuesta.

  1. Agregue un icono de rectángulo como barra de título, luego agregue la etiqueta "Análisis de sentimiento".

    Agregar una barra de título

  2. Agregue la etiqueta "Escriba su texto, luego haga clic en Obtener puntuación" y luego agregue un control de entrada de texto.

    Agregar una etiqueta y entrada de texto

  3. Agregue un botón con el texto "Obtener puntuación".

    Agregar un botón

  4. Agregue la etiqueta "La puntuación de sentimiento es". En la siguiente sección, agregue una fórmula para completar esta etiqueta.

    Agregar una etiqueta

Agregar fórmulas para controlar el comportamiento

Una vez que tanto la conexión de datos como la interfaz de usuario están listas, agregue las fórmulas de Power Apps que controlan el comportamiento de la aplicación. Las fórmulas llaman a la API a través del conector personalizado, almacenan el resultado en una colección (una variable tabular), luego muestran el resultado formateado en la aplicación.

  1. Elija el botón que creó, luego configure la propiedad OnSelect del botón con el nombre del conector (incluido el punto).

    SentimentDemo.

    Power Apps ofrece la opción de autocompletar de DetectSentiment porque el conector personalizado lo permite.

  2. Ahora establezca la propiedad OnSelect del botón en la siguiente fórmula.

    ClearCollect(sentimentCollection, SentimentDemo.DetectSentiment(
    {id:"1", language:"en", text:TextInput1.Text}).documents.score)

    Esta fórmula obtiene la puntuación de sentimiento de la API y la almacena en una colección:

    1. La fórmula llama a la función DetectSentiment con los tres parámetros expuestos por el conector personalizado: id, language y text. Especificamos valores para los dos primeros en la fórmula y obtenemos el valor para Text desde el control de entrada de texto (también puede extraer los dos primeros valores de otro lugar de una aplicación).

    2. La función devuelve un score por cada documento que envíe; en nuestros ejemplos, enviamos un documento a la vez. La puntuación varía de 0 (negativo) a 1 (positivo).

    3. La fórmula luego llama a la función ClearCollect para eliminar cualquier valor existente de sentimentCollection y agregua el valor de score.

  3. Elija la etiqueta que creó, luego configure la propiedad Texto de la etiqueta con la siguiente fórmula.

    "The sentiment score is " & Round(First(sentimentCollection).score, 3) * 100 & "%"

    Esta fórmula obtiene la puntuación de sentimiento de la colección y la formatea y muestra:

    1. La función First() devuelve el primer registro (y único en este caso) de sentimentCollect y muestra el campo score (el único campo) asociado con ese registro.

    2. La función Round() redondea la puntuación 3 lugares; el resto de la fórmula formatea el resultado como un porcentaje y agrega información para el contexto.

Probar la aplicación

Ahora ejecute la aplicación completa para asegurarse de que funciona como se esperaba.

  1. Elegir Ejecute la aplicación en la parte superior derecha para ejecutar la aplicación.

  2. Ingrese una frase en el control de entrada de texto y elija Obtener puntuación. La puntuación de opinión debe mostrarse en unos pocos segundos.

La aplicación finalizada es similar a la de la imagen siguiente:

Aplicación de análisis de sentimiento terminada

Es una aplicación 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.