Tutorial: Crear un flujo de trabajo de contenido de reconocimiento de Logic Apps

Azure Logic Apps es una plataforma basada en la nube que automatiza los flujos de trabajo sin escribir código. Cuando se combina con Azure Content Understanding en Foundry Tools, Logic Apps puede procesar automáticamente documentos, extraer campos estructurados de facturas, recibos, contratos y otros tipos de documentos.

En este tutorial, creará un flujo de trabajo de Logic Apps que:

  • Detecta cuándo se agrega un documento a una carpeta OneDrive.
  • Procesa el documento con el analizador de comprensión de contenido prebuilt-invoice.
  • Envía los datos de factura extraídos a una dirección de correo electrónico especificada.

Prerequisites

Para completar este tutorial, necesita los siguientes recursos:

  • Una suscripción a Azure. Puede crear una suscripción de Azure gratuita.

  • Una cuenta gratuita de almacenamiento en la nube OneDrive o OneDrive para la Empresa.

    Nota:

    • OneDrive está pensado para el almacenamiento personal y requiere una cuenta de Microsoft o Outlook.com.
    • OneDrive para la Empresa forma parte de Microsoft 365 y está diseñado para organizaciones.

  • Una cuenta de correo electrónico gratuita Outlook en línea o Office 365.

  • Una factura de ejemplo para probar la aplicación lógica. Puede descargar la factura de ejemplo desde el repositorio de ejemplos de Content Understanding.

  • Un recurso de Microsoft Foundry con Content Understanding configurado. Consulte Crear un recurso de Microsoft Foundry para obtener instrucciones de configuración. Puede usar el plan de tarifa gratis (F0) para probar el servicio y, a continuación, actualizar a un nivel de pago para producción.

    Sugerencia

    Una vez implementado el recurso, seleccione Ir al recurso. En Administración de recursos, seleccione Claves y punto de conexión y copie los valores de clave y punto de conexión en una ubicación temporal. Necesita estos valores para conectar la aplicación lógica a Content Understanding.

Creación de una carpeta OneDrive

Antes de crear la aplicación lógica, configure una carpeta de OneDrive para usarla como origen del desencadenador de documentos.

  1. Inicie sesión en la página principal de OneDrive o OneDrive para la Empresa.
  2. Seleccione el ➕ botón Agregar nuevo en la barra lateral superior izquierda y seleccione Carpeta.
  3. Escriba un nombre para la nueva carpeta y seleccione Crear.
  4. Confirme que la nueva carpeta aparece en la lista de archivos. Ya has terminado con OneDrive por ahora.

Creación de un recurso de aplicación lógica

  1. Acceda a Azure Portal.

  2. Seleccione ➕ Crear un recurso en la página principal de Azure.

  3. Busque y seleccione Aplicación lógica y, a continuación, seleccione Crear.

  4. Rellene el formulario Crear aplicación lógica con los siguientes valores:

    • Suscripción: Seleccione su suscripción actual.
    • Resource group: seleccione el mismo grupo de recursos que el recurso de Microsoft Foundry.
    • Tipo: seleccione Consumo. Este tipo se ejecuta en Azure Logic Apps global y multi-inquilino y utiliza el modelo de facturación por consumo.
    • Nombre de aplicación lógica: escriba un nombre descriptivo.
    • Región: seleccione la región.
    • Habilitación de Log Analytics: seleccione No para este tutorial.

  5. Selecciona Revisar + crear. Una vez completada la validación, seleccione Crear.

  6. Cuando finalice la implementación, seleccione Ir al recurso.

  7. En la página de Logic Apps Designer, seleccione Aplicación lógica en blanco de la sección Plantillas para abrir el lienzo de flujo de trabajo.

Creación de un flujo de automatización

  1. En el Diseñador de Logic Apps, busque OneDrive o OneDrive para la Empresa en la barra de búsqueda de conectores. Seleccione el desencadenador Cuando se crea un archivo.

    Sugerencia

    Si usa un cuenta de Office 365, use el conector OneDrive para la Empresa. El conector OneDrive requiere una cuenta personal Microsoft o Outlook.com.

  2. Cuando se le solicite, inicie sesión en su cuenta de OneDrive.

  3. Después de conectarse, seleccione la carpeta que creó anteriormente. Deje los demás valores predeterminados en su lugar.

    Nota:

    El desencadenador Cuando se crea un archivo usa el sondeo para detectar nuevos archivos. El intervalo de sondeo predeterminado es de 3 minutos, por lo que puede haber un retraso de hasta 3 minutos entre la carga de un archivo y el inicio del flujo de trabajo. Puede cambiar el intervalo en la configuración del desencadenador.

  4. Seleccione el ➕ botón Nuevo paso para agregar el paso siguiente.

  5. En la barra de búsqueda Elegir una operación , escriba Content Understanding. Seleccione Analizar contenido en los resultados.

    Nota:

    Es posible que el conector aparezca como Azure Content Understanding en los resultados de búsqueda.

  6. En el cuadro de diálogo de conexión, escriba los valores siguientes y seleccione Crear:

    • Nombre de conexión: escriba un nombre memorable para esta conexión.
    • Endpoint URL: pegue la dirección URL del punto de conexión del recurso Microsoft Foundry.
    • API Key: pegue la clave de API del recurso Microsoft Foundry.

    Nota:

    Si ya ha iniciado sesión con credenciales guardadas, este paso se omite automáticamente.

  7. En los parámetros de acción Analizar contenido , complete los campos siguientes:

    • Identificador del analizador: escriba prebuilt-invoice (o uno de los otros analizadores creados previamente) para usar el analizador de facturas integrado.
    • Contenido del archivo: seleccione este campo. En el elemento emergente de contenido dinámico que aparece, elija Contenido de archivo. Esto envía el archivo OneDrive al analizador de Content Understanding para su procesamiento. Cuando aparezca la insignia Contenido del archivo en el campo, este paso estará completo.
    • URL del archivo de entrada: deje este campo vacío, ya que va a proporcionar el contenido del archivo directamente desde OneDrive.

  8. Seleccione ➕ Nuevo paso para agregar otra acción.

  9. En la barra de búsqueda Elegir una operación , escriba Control y seleccione el icono Control .

  10. Seleccione Para cada uno de ellos en la lista Acción de control.

  11. En el campo Para cada paso, seleccione el campo Seleccionar una salida de los pasos anteriores . En el menú emergente de contenido dinámico, elija contenido. Esto recorre en iteración cada documento analizado en la respuesta.

  12. Seleccione Agregar una acción dentro del paso Para cada.

  13. Busque Outlook y seleccione Outlook.com (personal) o Office 365 Outlook (trabajo). En la lista de acciones, seleccione Enviar un correo electrónico (V2).

  14. Inicie sesión en la cuenta de Outlook cuando se le solicite.

  15. Complete los campos Enviar un correo electrónico (V2) como se indica a continuación. Para cada expresión, seleccione Agregar contenido dinámico, elija la pestaña Expresión y escriba la expresión en el cuadro fx . Para obtener una lista completa de los campos disponibles, consulte Analizadores creados previamente.

    1. En el campo Para, introduzca su dirección de correo electrónico.

    2. En el campo Asunto , escriba Invoice received from: y anexe la expresión siguiente:

      items('For_each')?['fields']?['VendorName']?['valueString']

    3. En el campo Cuerpo , agregue los siguientes detalles de factura:

      • Escriba Invoice ID: y anexe:

        items('For_each')?['fields']?['InvoiceId']?['valueString']

      • En una nueva línea, escriba Invoice due date: y anexe:

        items('For_each')?['fields']?['DueDate']?['valueDate']

      • Escriba Amount due: y anexe:

        items('For_each')?['fields']?['AmountDue']?['valueObject']?['Amount']?['valueNumber']

      • Escriba Amount due (confidence): y anexe:

        items('For_each')?['fields']?['AmountDue']?['valueObject']?['Amount']?['confidence']

  16. Seleccione Publicar en la esquina superior izquierda para guardar y publicar el flujo de trabajo.

Nota:

El bucle For each es necesario alrededor de la acción Enviar correo electrónico para admitir formatos de respuesta que podrían devolver más de un resultado del documento por archivo.

Prueba del flujo de automatización

Antes de realizar pruebas, revise lo que hace el flujo de trabajo:

  • Un trigger se activa cuando se crea un archivo en la carpeta OneDrive.
  • Una acción de comprensión del contenido analiza el archivo con el analizador prebuilt-invoice.
  • Una acción de Outlook envía por correo electrónico los datos de la factura extraídos a la dirección que especificaste.
  1. Abra una nueva pestaña del explorador y vaya a la carpeta OneDrive. Cargue el archivo sample invoice.
  2. Vuelva al diseñador de la Logic App y seleccione Ejecutar el desencadenador>Run.
  3. Una notificación en la esquina superior derecha confirma que el desencadenador se ejecutó correctamente.
  4. Vaya a la página de información general de la aplicación lógica seleccionando el vínculo nombre de la aplicación en la esquina superior izquierda.
  5. Compruebe el estado de ejecución para ver si la ejecución se realizó correctamente o no. Seleccione el indicador de estado para ver los detalles de cada paso.
  6. Si se produce un error en un paso, selecciónelo para revisar los detalles del error y comprobar las credenciales de conexión o los valores de expresión.
  7. Después de una ejecución satisfactoria, revise su bandeja de entrada. Recibirá un correo electrónico con los campos de factura que configuró.
  8. Cuando termine de probar, deshabilite o elimine la aplicación lógica para detener los cargos de uso.

Pasos siguientes

  • Last updated on