Documentación AEM as a Cloud Service Guía del usuario

Conectar un formulario adaptable con Microsoft® Power Automate connect-adaptive-form-with-power-automate

Last update: Fri Mar 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Puede configurar un formulario adaptable para ejecutar un flujo de nube de Microsoft® Power Automate en el envío. El formulario adaptable configurado envía los datos capturados, los archivos adjuntos y el documento de registro al flujo de nube de Power Automate para su procesamiento. Le ayuda a crear una experiencia de captura de datos personalizada mientras aprovecha el poder de Microsoft® Power Automate para crear lógicas empresariales en torno a los datos capturados y automatizar los flujos de trabajo de los clientes.

El editor de formularios adaptables ofrece la acción de envío Invocar un flujo de Microsoft® Power Automate para enviar datos de formularios adaptables, archivos adjuntos y documentos de registro al flujo de nube de Power Automate.

AEM as a Cloud Service ofrece varias acciones de envío predeterminadas para gestionar los envíos de formularios. Puede obtener más información sobre estas opciones en el artículo Acción de envío del formulario adaptable.

Ventajas

A continuación se muestran algunos ejemplos de lo que puede hacer después de integrar un formulario adaptable con Microsoft® Power Automate:

Usar datos de formularios adaptables en procesos empresariales de Power Automate
Utilice Power Automate para enviar datos capturados a más de 500 fuentes de datos o a cualquier API disponible públicamente
Realizar cálculos complejos en los datos capturados
Guardar datos de formularios adaptables en sistemas de almacenamiento con una programación predefinida

Requisitos previos

Para conectar un formulario adaptable con Microsoft® Power Automate, es necesario lo siguiente:

Licencia de Microsoft® Power Automate Premium.
Flujo de Microsoft® Power Automatecon el activador When an HTTP request is received para aceptar los datos de envío del formulario adaptable.
Un usuario de Experience Manager con privilegios de autor de formularios y administrador de formularios
La cuenta utilizada para conectarse a Microsoft® Power Automate es la propietaria del flujo de Power Automate configurada para recibir datos del formulario adaptable

Conectar su instancia de Forms as a Cloud Service con Microsoft® Power Automate connect-forms-server-with-power-automate

Realice las siguientes acciones para conectar su instancia de Forms as a Cloud Service con Microsoft® Power Automate:

Crear un Microsoft
Crear Microsoft
Crear Microsoft
Publicar Microsoft

Crear una aplicación de Microsoft® Azure Active Directory ms-power-automate-application

Iniciar sesión en Azure Portal.
Seleccione Azure Active Directory en el panel de navegación izquierdo.
En la página de directorio predeterminada, seleccione Registros de aplicaciones en el panel izquierdo.
En la página Registros de aplicaciones, haga clic en Nuevos registros.

Especifique el nombre, tipos de cuenta compatibles y URI de redireccionamiento en la página. En el URI de redireccionamiento, especifique lo siguiente y haga clic en Guardar.

https://[Forms as a Cloud Service Server]/libs/fd/powerautomate/content/dataverse/config.html
https://[Forms as a Cloud Service Server]/libs/fd/powerautomate/content/flowservice/config.html

Registrar una aplicación de Azure Active Directory

note note
NOTE
También puede especificar los URI de redireccionamiento adicionales, si es necesario, desde la página Autenticación. Para los tipos de cuenta compatibles, seleccione un inquilino o varios o una cuenta personal de Microsoft®, según su caso de uso

En la página Autenticación, habilite las siguientes opciones y haga clic en Guardar.
- Tokens de acceso (utilizados para flujos implícitos)
- Tokens de ID (utilizados para flujos implícitos e híbridos)
En la página Permisos de API, haga clic en Añadir un permiso.
En las API de Microsoft®, seleccione el servicio de flujo y los siguientes permisos.
- Flows.Manage.All
- Flows.Read.All
Haga clic en Añadir permisos para guardar los permisos.
En la página Permisos de API, haga clic en Añadir un permiso. Seleccione las API que utiliza mi organización y busque DataVerse.
Habilite user_impersonation y haga clic en Añadir permisos.
(Opcional) En la página Certificados y secretos, haga clic en Nuevo secreto de cliente. En la pantalla Añadir un secreto de cliente, aporte una descripción y un período de tiempo para que el secreto caduque y haga clic en Añadir. Se genera una cadena secreta.
Tenga en cuenta la URL del entorno de Dynamics específica de su organización.

Crear la configuración de nube de Microsoft® Power Automate Dataverse microsoft-power-automate-dataverse-cloud-configuration

En la instancia de autor de AEM Forms, vaya a Herramientas > General > Explorador de configuración.
En la página Explorador de configuración, seleccione Crear.
En el cuadro de diálogo Crear configuración, especifique un Título para la configuración, habilite Configuraciones de nube y seleccione Crear. Crea un contenedor de configuración para almacenar servicios en la nube. Asegúrese de que el nombre de la carpeta no contenga ningún espacio.

Vaya a Herramientas > Cloud Services > Microsoft® Power Automate Dataverse y abra el contenedor de configuración que creó en el paso anterior.

note note
NOTE
Cuando cree un formulario adaptable, especifique el nombre del contenedor en el campo Contenedor de configuración.

En la página de configuración, seleccione Crear para crear una configuración de Microsoft®®® Power Automate Flow Service en AEM Forms.
En la página Configurar el servicio Dataverse para Microsoft® Power Automate, especifique el ID del cliente (también denominado ID de aplicación), el Secreto del cliente, la URL de OAuth y la URL del entorno de Dynamics. Utilice el ID del cliente, el secreto del cliente, la URL de OAuth y la URL del entorno de Dynamics de la Aplicación de Microsoft® Azure Active Directory creada en la sección anterior. Utilice la opción Puntos finales en la interfaz de usuario de la aplicación de Microsoft® Azure Active Directory para encontrar la URL de OAuth
Seleccione Conectar. Si se le solicita, inicie sesión en su cuenta de Microsoft® Azure. Seleccione Guardar.

Crear la configuración de nube de Microsoft® Power Automate Flow Service. create-microsoft-power-automate-flow-cloud-configuration

Vaya a Herramientas > Cloud Services > Microsoft® Power Automate Flow Service y abra el contenedor de configuración que creó en la sección anterior.

note note
NOTE
Cuando cree un formulario adaptable, especifique el nombre del contenedor en el campo Contenedor de configuración.

En la página de configuración, seleccione Crear para crear una configuración de Microsoft® Power Automate Flow Service en AEM Forms.
En la página Configurar Dataverse para Microsoft® Power Automate, especifique el ID del cliente (también denominado ID de aplicación), el secreto del cliente, la URL de OAuth y la URL del entorno de Dynamics. Utilice el ID del cliente, el secreto del cliente, la URL de OAuth y el ID del entorno de Dynamics. Utilice la opción Puntos finales en la interfaz de usuario de la aplicación de Microsoft® Azure Active Directory para encontrar la URL de OAuth. Abra el vínculo Mis flujos y seleccione Mis flujos para usar el ID indicado en la URL como ID del entorno de Dynamics.
Seleccione Conectar. Si se le solicita, inicie sesión en su cuenta de Microsoft® Azure. Seleccione Guardar.

Publicar las configuraciones de nube de Microsoft® Power Automate Dataverse y Microsoft® Power Automate Flow Service publish-microsoft-power-automate-dataverse-cloud-configuration

Vaya a Herramientas > Cloud Services > Microsoft® Power Automate Dataverse y abra el contenedor de configuración que creó en la sección Crear la configuración de nube de Microsoft® Power Automate Dataverse anterior.
Seleccione la configuración de dataverse y seleccione Publicar.
En la página Publicar, seleccione Todas las configuraciones y seleccione Publicar. Publicar las configuraciones de nube de Power Automate Dataverse y Power Automate Flow Service.

Su instancia de Forms as a Cloud Service ahora está conectada con Microsoft® Power Automate. Ahora puede enviar datos de formularios adaptables a un flujo de Power Automate.

Utilizar la acción de envío Invocar un flujo de Microsoft® Power Automate para enviar datos a un flujo de Power Automate use-the-invoke-microsoft-power-automate-flow-submit-action

Tras conectar su instancia de Forms as a Cloud Service con Microsoft® Power Automate, realice la siguiente acción para configurar el formulario adaptable y enviar los datos capturados a un flujo de Microsoft® al enviar el formulario.

Inicie sesión en la instancia de autor, seleccione su formulario adaptable y haga clic en Propiedades.
En el contenedor de configuración, examine y seleccione el contenedor creado en la sección Crear la configuración de nube de Microsoft® Power Automate Dataverse y seleccione Guardar y cerrar.
Abra el formulario adaptable para editarlo y vaya a la sección Envío de las propiedades del contenedor del formulario adaptable.
En el contenedor de propiedades, para las Acciones de envío seleccione la opción Invocar un flujo de Power Automate y un Flujo de Power Automate. Seleccione el flujo necesario y los datos de formularios adaptables se envían en el momento del envío.

NOTE

Antes de enviar el formulario adaptable, asegúrese de que se añada el activador When an HTTP Request is received con el esquema JSON a continuación a su flujo de Power Automate.

        {
            "type": "object",
            "properties": {
                "attachments": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "filename": {
                                "type": "string"
                            },
                            "data": {
                                "type": "string"
                            },
                            "contentType": {
                                "type": "string"
                            },
                            "size": {
                                "type": "integer"
                            }
                        },
                        "required": [
                            "filename",
                            "data",
                            "contentType",
                            "size"
                        ]
                    }
                },
                "templateId": {
                    "type": "string"
                },
                "templateType": {
                    "type": "string"
                },
                "data": {
                    "type": "string"
                },
                "document": {
                    "type": "object",
                    "properties": {
                        "filename": {
                            "type": "string"
                        },
                        "data": {
                            "type": "string"
                        },
                        "contentType": {
                            "type": "string"
                        },
                        "size": {
                            "type": "integer"
                        }
                    }
                }
            }
        }