Utilizar formularios para interactuar con datos de Dataverse

15 minutos

Los formularios aportan la posibilidad de que las páginas web interactúen con las filas de una tabla específica, utilizando la definición de formulario basado en modelo como plantilla de diseño. Como ocurre con las listas, los formularios son configuraciones basadas en datos que permiten a los usuarios agregar un formulario para recopilar o mostrar datos en el sitio web sin necesidad de que un desarrollador cree un formulario personalizado. Puede definir formularios usando formularios basados en modelos, y puede colocarlos en páginas web dentro del sitio web.

Los formularios pueden mostrar la mayoría de los tipos de columnas y subcuadrículas, un tipo de columna de opciones (consulte Configurar una columna de opciones para Power Pages) y componentes de código (consulte Usar componentes de código en Power Pages).

Usos comunes

En la siguiente tabla se explican los escenarios comunes en los que se pueden usar formularios.

Escenario	Descripción
Diseño	Configure y use formularios en modo de solo lectura como mecanismo de diseño. Considere los formularios como páginas informativas sobre empleados, productos o cualquier otra tabla de Microsoft Dataverse. Por ejemplo, podría tener una tabla personalizada en su instancia de Dataverse que describa los puestos vacantes disponibles en su organización. En lugar de crear una plantilla especial para representar la página, puede crear un formulario basado en modelo independiente para la tabla, crear una página web nueva con el estudio de diseño de Power Pages y, luego, agregar un componente de formulario en la página. Todos los cambios publicados en un diseño de formulario en una aplicación basada en modelo se aplicarán automáticamente a la página web.
Captura de información	Use los formularios en el sitio web para capturar datos de usuarios anónimos o autenticados. Por ejemplo, se puede representar un sencillo formulario de clientes potenciales en una página Contacto para registrar solicitudes anónimas como clientes potenciales en Dynamics 365 Sales. Para los usuarios autenticados, un sitio web puede usar una página de encuesta para recopilar comentarios de los clientes sobre los productos en una tabla personalizada de comentarios sobre productos.
Administración de registros	Los formularios permiten distintas combinaciones de operaciones CRUD (crear, recuperar, actualizar y eliminar) en una tabla que se definirá dentro de un conjunto de páginas web relacionadas. Por ejemplo, los clientes pueden recuperar y leer sus propios casos y crear otros nuevos, los partners pueden editar los perfiles de su empresa y los empleados pueden ver la lista de activos que la empresa les asigna.
Aplicaciones web	Al usar formularios con listas y subcuadrículas, y con la funcionalidad ampliada mediante JavaScript, los desarrolladores pueden crear aplicaciones web completas.

Crear un formulario

Al crear un nuevo formulario, su primer paso es decidir cuál será la Tabla y el Formulario que va a representar. Aunque es posible reutilizar formularios que son parte de una aplicación basada en modelo, lo más habitual es diseñar formularios basados en modelo y específicos para Power Pages (pueden estar o no incluidos en las aplicaciones basadas en modelos).

Los formularios de Power Pages son más concisos y presentan menos información, sobre todo con el público externo.
Los procesos de Power Pages son independientes del uso interno de una aplicación basada en modelo orientada al personal (incluidas las aplicaciones Dynamics 365). Los formularios específicos son más fáciles de mantener, ya que los cambios en las aplicaciones basadas en modelo se deben aplicar manualmente en los formularios de Power Pages, por lo que permiten revisar los requisitos y evaluar aspectos relacionados con la facilidad de uso.
La representación de formularios y columnas tiene algunas limitaciones. Para obtener más información, consulte Acerca de los formularios.
Las reglas de negocio y JavaScript del lado del cliente, que son partes esenciales de los formularios basados en modelos, no se ejecutarán en el sitio web de Power Pages. Es fácil olvidarse de esto, pero puede tener consecuencias no deseadas.
Deben tenerse en cuenta consideraciones especiales al representar filas, notas y escalas de tiempo relacionadas, puesto que no todos los aspectos funcionales son compatibles (u obligatorios) en el sitio web.

Modo

Puede seleccionar el modo de formulario en la pestaña Datos del cuadro de diálogo de propiedades del formulario. El modo de formulario define si el formulario se utiliza para generar un diseño, capturar los datos o proporcionar funcionalidades de edición completas para las filas de Dataverse. El modo de formulario puede estar vinculado a cualquiera de las siguientes opciones.

Solo lectura: el estudio de diseño de Power Pages hace referencia a esta opción como es de solo lectura.
Insertar: el estudio de diseño se refiere a esta opción como Crear un nuevo registro.
Editar: el estudio de diseño se refiere a esta opción como Actualizar un registro existente.

Nota

Un formulario que está en modo Editar se representará como de Solo lectura si el usuario no tiene privilegios de escritura para la fila.

Si el modo es Insertar, no se requiere información adicional. Para los modos de Solo lectura y Editar, el formulario necesitará "saber" cuál es la fila de tabla que debe mostrarse y actualizarse. La configuración Tipo de origen de registro define cómo se transmite esta información al formulario:

Cadena de consulta: esta configuración es la predeterminada al crear un formulario en el estudio de diseño. Cuando se muestra una página que contiene el formulario, se espera que el identificador de fila forme parte de la cadena de consulta, como https://contoso.powerappsportals.com/contacts/edit/?id=<contact guid>. Normalmente, esta configuración se realiza automáticamente cuando el formulario está vinculado a una lista. Esta es la configuración más habitual.
Usuario actual del portal: puede configurar esta opción dentro de la aplicación Administración de Power Pages. Cuando seleccione esta opción, el formulario cargará la información de la fila de usuario del sitio web actual sin utilizar información adicional de la URL de la página. Normalmente, esta opción se usa para representar un formulario de perfil de usuario. En ese caso, deberá configurar la columna Nombre de tabla como Contacto, ya que los usuarios del sitio web están representados por la tabla de contactos.
Registro asociado al usuario actual del portal: puede configurar esta opción dentro de la aplicación Administración de Power Pages. Al seleccionar esta opción, puede editar las filas asociadas, como los detalles de la cuenta primaria del usuario actual. Recuerde que debe especificar el Nombre de la relación para identificar la fila que se editará. El tipo de tabla que seleccione debe coincidir con la selección en la columna Nombre de tabla. Esta opción es útil en escenarios de partners en los que la organización de un partner tenga múltiples usuarios del sitio web. Podría autorizar a algunos de estos usuarios para editar la fila de la cuenta primaria.

Tabla, Formulario, Nombre y Modo son las propiedades necesarias para representar el formulario.

Configurar el formulario

En el estudio de diseño hay más opciones de configuración para controlar el aspecto y el comportamiento de los formularios.

Pestaña Formulario

En la pestaña Formulario, puede seleccionar una tabla, un formulario para esa tabla y el nombre del formulario (que no se puede cambiar después de haberlo creado).

Pestaña Datos

En la pestaña Datos, puede cambiar el modo del formulario.

Pestaña Al enviar

La configuración Al enviar determina las acciones que se ejecutan cuando un formulario se envía correctamente:

Mostrar un mensaje: muestra un mensaje cuando se envía el formulario.
Redirigir a página web: navega automáticamente a una página web si el envío del formulario se realiza correctamente.
Redirigir a dirección URL: redirige a una URL (sitio web o externa).

Pestaña CAPTCHA

La característica CAPTCHA determina si debería aparecer un captcha para usuarios anónimos o autenticados.

Pestaña Datos adjuntos

En la pestaña Datos adjuntos, puede seleccionar si un usuario puede cargar archivos, especificar el tamaño máximo de los archivos adjuntos y las restricciones sobre los tipos de archivos.

Otras configuraciones para formularios

Hay más opciones de configuración disponibles para formularios en la aplicación Administración de Power Pages. Para obtener acceso a un formulario en la aplicación Administración de Power Pages, siga estos pasos:

Seleccione el componente de formulario en la página dentro del estudio de diseño de Power Pages.
Seleccione el comando Editar formulario.
En el cuadro de diálogo Configuración del formulario, seleccione la pestaña Datos.
Seleccione Abrir aplicación Administración de Power Pages en la cabecera Configuraciones.

Los formularios pueden incluir Acciones para que el usuario interactúe con la fila. Hay configuraciones detalladas disponibles para cada elemento de formulario usando más filas de Metadatos de formularios.

Configuración

Las siguientes secciones describen diferentes métodos de configuración de formularios con la aplicación Administración de Power Pages.

Opciones de formularios

La mayoría de las opciones de formularios admiten la personalización de los elementos de hojas de estilo CSS (CSS) para cambiar el aspecto visual. Puede especificar elementos de texto, como etiquetas, mensajes e información sobre herramientas, en varios idiomas. Por ejemplo, el mensaje predeterminado tras el envío del formulario es "Guardado", pero se puede personalizar para cada uno de los idiomas activados en el sitio web.

Otra opción de formulario incluye Controlar comportamiento de validación, donde puede decidir, por ejemplo, si marcará todas las columnas como obligatorias, independientemente de la configuración del formulario.

Otras configuraciones

Hay más configuraciones para definir otros aspectos del comportamiento del formulario, como el estilo, la traducción de los elementos de la UI, etc.

Sugerencia

Algunas de las opciones de configuración están ocultas. Seleccione la casilla Configuración avanzada para mostrar todas las opciones disponibles.

Asociar usuario actual del portal al insertar: se puede usar esta opción para hacer un seguimiento de los contactos del sitio web que han creado o actualizado la fila. Esta configuración crea un sitio web equivalente a las columnas Autor y Autor de modificación en Dataverse. También puede establecer relaciones parentales en los casos pertinentes. Por ejemplo, si se crea una nueva fila de cuenta, es posible que desee establecer el contacto actual como contacto principal automáticamente.
Agregar Adjuntar archivo: hay muchas opciones disponibles para agregar un control de carga de archivos a su formulario. La configuración es flexible y admite múltiples archivos, opciones de almacenamiento, tipo MIME y restricciones de tamaño (por ejemplo, puede restringir las cargas a imágenes de hasta 2 MB de tamaño).
Geolocalización: puede configurar un formulario para mostrar un control de mapa que revele una ubicación existente, como una chincheta en un mapa, o que le dé a un usuario la capacidad de especificar una ubicación. El control de mapa del formulario necesita otras configuraciones para saber cuáles son las diversas columnas de ubicación, asignarles valores o recuperar valores en ellas. Para obtener más información, consulte Configuración de geolocalización para formularios.

Referencia de tabla asociada

La característica Referencia de tabla asociada ofrece una forma de asociar la fila actual que se está creando o actualizando con otra fila de destino. Esta característica es útil si tiene varios pasos con varios tipos de tabla y quiere relacionar las filas resultantes, o si la página se pasa en una cadena de consulta de un id. de fila que le gustaría asociar.

Por ejemplo, puede que tenga una página de evento que muestre información sobre un seminario web próximo. Le gustaría incluir un botón de registro que redirija a los visitantes a la página de registro donde se muestra el formulario de registro. Puede pasar un identificador de evento en una cadena de consulta y, cuando se envíe el formulario de registro, podrá vincular automáticamente la información de registro al evento.

Acciones

Puesto que un formulario gestiona una fila de tabla individual, puede ejecutar numerosas acciones sobre esa fila, como actualizar, eliminar, desactivar, etc. Para configurar esas acciones, que aparecen en runtime como botones de comando, seleccione Configuración adicional > Configuración de botón de acción.

Todos los comandos incluyen opciones para cambiar el nombre de los botones y modificar su ubicación en el formulario.

Metadatos del formulario

Las filas de Metadatos del formulario le permiten controlar la apariencia y el comportamiento de los elementos de formulario individuales, lo que incluye lo siguiente:

Apariencia de las columnas, secciones y pestañas. Además, puede definir los valores predeterminados y el comportamiento de validación de cada una de las columnas, así como otros elementos.
La configuración de subcuadrículas, que le permite definir acciones para filas relacionadas, como ocurre con las acciones de la lista de tablas.
El comportamiento de las secciones de notas y escala de tiempo, así como si desea agregar nuevas filas. Esta opción se usa habitualmente para permitir que los usuarios del sitio web introduzcan comentarios sobre la fila, por ejemplo, un caso en curso.

Agregar un formulario a un sitio web

Un formulario define el comportamiento requerido, pero no contiene información sobre cómo y en qué parte del sitio web se debe representar el formulario. Hay dos métodos para representar un formulario en un sitio web:

Especificar explícitamente el formulario como objetivo para una acción de lista, como crear, actualizar o editar. En este caso, el formulario se representa en una ventana emergente modal. Se aplican determinadas limitaciones cuando el formulario se muestra en una ventana emergente. Por ejemplo, la creación de filas relacionadas a partir de subcuadrículas no está disponible.
Agregar un componente de formulario a una página web en el estudio de diseño de Power Pages, como se haría para una lista. Esta acción coloca una etiqueta de Liquid en la copia de la página web para representar el formulario.
```
{% entityform name: '<<form name>>' %}
```

Dado que los formularios pueden enviar información de vuelta al servidor para procesarla, dispondrá de menos control sobre la representación de los formularios en comparación con las listas.