Microsoft Power Pages facilita mucho a cualquier usuario interactuar con los datos de nuestra organización. En una página web de Power Pages podemos mostrar un formulario de edición para nuestros usuarios, en el que puedan editar por ejemplo su información de contacto directamente desde la Power Page.
Sin embargo, ¿Qué ocurre con los registros relacionados? En este artículo vamos a tratar este tema. Haremos un paso a paso de como configurar nuestro formulario de Contacto de Power Pages para poder modificar nuestra información y poder mostrar registros relacionados. Posteriormente crearemos la configuración necesaria para poder crearlos, editarlos e incluso, eliminarlos.
Para nuestro ejemplo, la entidad principal será “Contacto”. De esta manera como el usuario que haya iniciado sesión en la Power Page corresponde a un Contacto, vamos a modificar los registros relacionados con el usuario autenticado en la Power Page.
Para este ejemplo, usaremos un modelo de datos de 2 tablas. La tabla del estándar “Contacto” y una tabla customizada llamada “Mascota”. Vamos a trabajar dentro de una solución. Nuestra solución en este ejemplo se llamará “Demo Subgrid Forms”.
Paso 1.1.
Añadimos la tabla de contacto a la solución. Para ello pulsamos en agregar existente, tabla y buscamos nuestra tabla en el buscador.
Esta tabla es del estándar, por lo tanto, simplemente tendríamos que añadirla a nuestra solución.
Paso 1.2.
Creamos la tabla de Mascotas en la solución. Pulsamos en Nuevo > Tabla > Tablas y creamos nuestra tabla. Nuestra columna principal será “Nombre”.
Agregamos varios atributos más a nuestra tabla.
Vamos a agregar una columna de tipo Busqueda llamada “Contacto Asignado”. En el apartado “Tabla relacionada” seleccionaremos la tabla de Contacto.
Agregamos una columna de tipo texto llamada “Raza”.
Paso 1.3.
Creamos la vista de mascotas. Esta vista es la que posteriormente usaremos en la subcuadrícula para visualizar nuestras mascotas.
Vamos a la tabla de Mascotas, pulsamos en vistas, pulsamos en “Nueva vista” le ponemos un nombre y la creamos.
Añadimos los campos que queramos a la vista, para nuestro ejemplo seleccionaremos los campos “Raza” y “Contacto Asignado”.
Paso 1.4.
Creamos el formulario principal de contacto para la Power Page.
Pulsamos en contacto > formularios > nuevo formulario > formulario principal.
Aquí vamos a crear nuestro formulario de contacto para la Power Page. Introducimos los campos que queramos sobre nuestro contacto y le cambiamos el nombre para mostrar. En nuestro caso hemos eliminado todas las secciones por defecto menos la principal, y en ella hemos dejado 4 campos.
Añadimos la subcuadrícula al formulario de contacto, eligiendo la tabla de Mascotas, la vista del paso 1.3 y “mostrar registros relacionados”.
Una vez que añadimos nuestra subcuadrícula al formulario de contacto, pulsamos en ella y modificamos el texto de la etiqueta y del nombre, para posteriormente poder identificarlo con mayor facilidad.
Paso 1.5.
Creamos Formulario Básico Contacto y lo configuramos.
Para este paso, tenemos que ir a la Administración de Power Pages de nuestra Power Page.
Desde make.powerpages.com localizamos nuestra Power Page, pulsamos en los 3 puntos y pulsamos en la opción “Administración de Power Pages”.
En nuestra barra lateral buscamos “Formularios básicos”. Pulsamos en New.
Ahora configuraremos nuestro formulario básico para nuestro propósito.
Ponemos de nombre “Formulario contacto basico”.
Elegimos la tabla “Contacto”.
En nombre de formulario seleccionamos el creado en el paso 1.4.
En el nombre de pestaña seleccionamos la pestaña de nuestro formulario de contacto creado en el paso 4 qué queremos que se muestre en nuestra Power Page. La vamos a identificar gracias a la etiqueta de nuestra pestaña. En nuestro caso la etiqueta es la etiqueta por defecto “Resumen”. En esta imagen podemos ver dónde se encuentra:
El modo lo habilitamos en modo “Edición”, ya que nuestro formulario será para editar nuestros datos de Contacto.
El tipo de origen de registro lo ponemos en “Usuario actual del portal”. De esta forma el formulario de contacto que se mostrará será del contacto con el que hayamos iniciado sesión en nuestra Power Page.
Seleccionamos nuestro sitio web.
Habilitamos los permisos de tabla. Esto veremos para qué lo hemos habilitado en los siguientes pasos.
Nuestra configuración del formulario se ve así:
Paso 1.6.
Añadimos el formulario a una Página Web desde el editor de Power Pages. Para ello, volvemos a nuestra página principal de make.powerpages.com, localizamos nuestra Power Page y pulsamos en “Editar”.
Si ya tenemos una página web donde vayamos a insertar nuestro formulario,
podemos insertarlo en esa página. En caso de no tener ninguna página, vamos a
crear una. En nuestro caso crearemos una.
Pulsamos en Páginas > “+ Página”, ponemos un nombre para nuestra página Web, marcamos la casilla de “Agregar a navegación principal”, elegimos “diseño estándar” y “Empezar desde 0” y pulsamos en “Agregar”.
Una vez creada nuestra página web, en el editor de Power Pages, dentro de la sección donde queramos añadir el formulario de Contacto, nos fijamos en el apartado “Elija un componente para agregarlo a esta sección” y pulsamos en “Formulario”.
A continuación en la sección “O elegir un formulario existente” elegimos el formulario básico creado en el paso 1.5.
Una vez hecho esto, desde el editor de Power Pages, si pulsamos en vista previa y seleccionamos “Escritorio” se nos abrirá una nueva pestaña en el navegador.
En ella veremos nuestra Power Page. Iniciamos sesión con nuestro usuario pulsando en iniciar sesión. En nuestro caso vamos a iniciar sesión con Microsoft Entra ID.
Si nosotros ahora vamos a la página “Nuestras Mascotas” donde previamente introducimos nuestro formulario, nos debe aparecer el siguiente mensaje:
Esto se debe a que aún no hemos habilitado los permisos de tabla necesarios para poder visualizar el formulario. Para que se pueda mostrar el formulario de contacto en la Página web, debemos habilitar los permisos de tabla correspondientes.
Paso 1.7.
Previamente a esto vamos a ajustar los permisos de página. Queremos que la página “Nuestras Mascotas” sólo sea accesible para los usuarios autenticados. Para ello, vamos al editor de Power Pages, pulsamos en Seguridad, vamos al apartado “Permisos de página” y buscamos nuestra página web. Nosotros queremos que nuestra página sólo sea visible para los usuarios autenticados, por lo tanto pulsamos en los 3 puntos y pulsamos en “Edit Permissions”.
En ¿Quién puede ver esta página? marcamos “Quiero elegir” y seleccionamos usuarios autenticados.
Paso 1.8.
Una vez comprobados los permisos de página, vamos con los permisos de tabla para poder visualizar nuestro formulario de contacto.
Vamos al editor de Power Pages, pulsamos en “Seguridad”, vamos a la sección “Permisos de Tabla”, pulsamos en “nuevo permiso”, y configuramos nuestro permiso.
Le ponemos un nombre, cualquiera nos sirve.
Seleccionamos la tabla correspondiente, en este caso la tabla “Contacto”.
En “tipo de acceso” seleccionamos acceso autónomo. Esto permite que el usuario de la Power Page acceda y gestione su propio registro de contacto, es decir, el registro vinculado a su cuenta de usuario en Power Pages.
Una vez tenemos esta configuración, volvemos a la vista previa de nuestra Power Page y si estamos sin iniciar sesión, podemos ver que la página “Nuestras Mascotas” no aparece en la barra de navegación. Esto es gracias a los permisos de página que hemos configurado en el paso 1.7.
Si iniciamos sesión y nos dirigimos a la página “Nuestra Mascotas” podemos ver que se muestra nuestro formulario de contacto, y la subcuadrícula de Mascotas también se muestra, sin embargo los registros de la misma no se visualizan.
Paso 1.9.
Esto se soluciona añadiendo los permisos de tabla correspondientes. Vamos al editor de Power Pages, pulsamos en Seguridad, en permisos de tabla, localizamos el permiso de tabla para nuestra tabla “Contacto”, pulsamos en los 3 puntos y seleccionamos la opción “Agregar permiso secundario”.
A continuación configuramos el permiso secundario de tabla. Este permiso secundario se aplica a los registros de Mascota que tengan asociado directamente el registro de contacto vinculado con la cuenta de usuario que ha iniciado sesión en la Power Page. Tienen que tener una relación entre ellos. Relación la cuál se crea cuando creamos la columna “Contacto Asignado” en el paso 1.2.
Como nombre pondremos “Contacto -> Mascota”.
En tabla elegimos la tabla “Mascota”.
Seleccionamos la relación correspondiente.
En permisos elegimos los permisos que vayamos a necesitar.
Una vez hecho esto, si volvemos a nuestra Power Page, a la página “Nuestras mascotas” veremos que ya se visualiza la subcuadrícula. Como podemos ver, nos aparece un mensaje que dice “No hay registros para mostrar”. Esto se debe a que no hemos creado ningún registro de Mascota que cumpla las condiciones para aparecer aquí.
Lo que haremos a continuación será crear la configuración necesaria para poder crear, editar o eliminar estos registros de Mascota relacionados con el contacto vinculado a la cuenta de usuario que ha iniciado sesión en la Power Page. Para ello:
Paso 2.1.
Creamos los formularios de creación y edición de Mascotas en la solución. Vamos a nuestra solución, a la tabla Mascota, pulsamos en “Formularios” y creamos un nuevo formulario principal.
Personalizamos el formulario con los datos que sean necesarios. Este primer formulario será el formulario que utilizaremos para crear los registros de la subcuadrícula. El nombre de este formulario será:
“Crear Mascota – Formulario de Subcuadrícula”.
Es importante ponerle nombre a la pestaña general del formulario para posteriormente localizarla más fácilmente.
Pulsamos en “Guardar y publicar”. Una vez esté creado nuestro formulario, crearemos un nuevo formulario siguiendo estos mismos pasos, pero esta vez será para el formulario de edición. En este formulario de edición sólo queremos que se pueda editar el nombre de la mascota, por lo tanto será el único campo que agregaremos al formulario.
En nuestra solución debe aparecer así:
Paso 2.2.
Creamos Formulario Básico Crear Mascotas. Para ello, vamos a la administración de Power Pages. En formularios básicos, vamos a crear uno nuevo.
Como nombre pondremos “Formulario Crear Mascota Subcuadrícula”.
Elegimos la tabla de Mascota.
En nombre de formulario elegimos el formulario para crear registros de mascotas creado previamente en nuestra solución.
El nombre de pestaña será “general”.
Modo inserción.
Elegimos nuestro sitio web.
Habilitamos los permisos de tabla.
Nuestra configuración debe verse algo así:
Paso 2.3.
Creamos Formulario Básico Editar Mascotas. Para ello, vamos a la administración de Power Pages. En formularios básicos, vamos a crear uno nuevo
Como nombre pondremos “Formulario Editar Mascota Subcuadrícula”.
Elegimos la tabla de Mascota.
En nombre de formulario elegimos el formulario para editar registros de mascotas creado previamente en nuestra solución.
El nombre de pestaña será “general”.
Modo edición.
El tipo de origen de registro seleccionamos “Cadena de consulta” , y como nombre de parámetro pondremos “id”.
Elegimos nuestro sitio web.
Habilitamos los permisos de tabla.
Nuestra configuración debe verse de la siguiente manera:
Paso 2.4.
Creamos Metadatos de Formulario Básico de subcuadrícula en el Formulario básico de Contacto. Para esta parte, vamos a “Administración de Power Pages” y buscamos el formulario básico creado en el paso 1.5, llamado “Formulario contacto basico”.
Vamos al apartado “Metadatos de formulario básico” y pulsamos en “Nuevo metadatos de formulario”.
Vamos a configurar el metadato de formulario:
Elegimos tipo subcuadrícula.
En Nombre de subcuadrícula tenemos que elegir el nombre que le hemos puesto a la subcuadrícula de mascotas en el paso 1.4.
Añadimos la acción de vista “crear”.
En tipo de destino seleccionamos “Formulario básico”.
En formulario básico elegimos el formulario básico creado previamente en el paso 2.2.
Añadimos la acción de elemento “editar”.
En tipo de destino seleccionamos “Formulario básico”.
En formulario básico elegimos el formulario básico creado previamente en el paso 2.3.
Por último, añadimos la acción de elemento “eliminar”.
Hay muchos tipos de metadatos y cada uno tiene objetivos diferentes, pero en este caso no tenemos que utilizar más.
Una vez hecho esto, ya tendremos nuestra subcuadrícula de la tabla “Mascota” en el formulario de Contacto habilitada en nuestra Power Page para insertar, editar o eliminar registros relacionados. Adjunto unas imágenes de cómo se debe visualizar:
Espero que os haya ayudado esta guía paso a paso de cómo crear, editar o eliminar registros relacionados de una entidad desde Power Pages.
