Crear o editar una aplicación basada en modelo

Objetivo

Construir una aplicación basada en modelo (una aplicación con nombre que agrupa un conjunto elegido de tablas, pantallas de Studio e informes del entorno en una navegación (mapa del sitio) con una página de inicio, lista para que un usuario la abra en el Shell de la plataforma) o cambiar el nombre, la navegación o la página de inicio de una aplicación existente.

Requisitos previos

• Ha iniciado sesión con un rol de creador (o de administrador de la plataforma).
• Las tablas que mostrará la aplicación ya existen en el entorno (consulte Crear una tabla), y también las pantallas de Studio (Dibujar una aplicación de Studio) o los informes (Crear un informe) que quiera incluir en su navegación.
• Conoce el prefijo del editor propietario (por ejemplo, par). El nombre lógico de la aplicación debe empezar por ese prefijo.

Pasos

1. En la barra lateral izquierda, elija el entorno en el que está trabajando y la solución a la que pertenece la aplicación con los selectores de entorno y de solución. El prefijo del editor propietario aparece debajo de ellos (por ejemplo, par_); la aplicación lleva ese espacio de nombres.
2. Abra Aplicaciones desde la navegación de la barra lateral. La página muestra las aplicaciones del entorno como una lista.
3. Seleccione Nuevo para crear una aplicación, o seleccione la fila de una aplicación existente y después Editar para cambiarla. En ambos casos se abre un panel a un lado de la pantalla con los detalles de la aplicación.
4. Escriba un nombre para mostrar (por ejemplo, Sales).
5. En una aplicación nueva, escriba un nombre lógico que empiece por el prefijo del editor, por ejemplo par_sales_app. Al editar una aplicación existente, el nombre lógico se muestra pero no se puede cambiar.
6. Si lo desea, escriba una descripción (que se muestra en el mosaico de inicio de la aplicación) y una clave de icono.
7. Construya la navegación de la aplicación. Cada grupo de navegación tiene un título y, bajo él, una fila de botones, uno por cada tipo de destino: Agregar tabla a la navegación, Agregar informe a la navegación y Agregar pantalla a la navegación. Cada botón abre una lista con búsqueda de ese tipo; escriba para acotarla por el nombre que dio al destino o por su nombre lógico y seleccione uno para colocarlo. Un botón solo aparece cuando el entorno tiene algo que colocar con él, así que un entorno sin informes no muestra el botón de informes. Cualquier elemento colocado admite una etiqueta de reemplazo y un icono opcionales, y se puede quitar. Para cambiar el orden de los elementos de un grupo, arrastre una fila por el asa de su borde inicial: el orden en que los deje es el orden que muestra la navegación de la aplicación. Sin ratón: enfoque el asa, pulse Space para levantar la fila, las teclas de flecha para moverla y Space de nuevo para soltarla. Seleccione Agregar grupo para agregar otro grupo de navegación.
8. Si lo desea, elija qué formularios y vistas ofrece esta aplicación para una tabla colocada; consulte Elegir qué ofrece la aplicación para una tabla más abajo. Bajo el nombre de cada tabla colocada, la fila indica lo que ofrece actualmente la aplicación («3 formularios · 2 vistas», o «2 de 5 formularios» una vez que ha acotado una lista), y el botón de controles deslizantes abre la elección. La fila de un panel y la de un informe indican en cambio cuál de los tres son, y no tienen botón de controles deslizantes: ninguno de los dos tiene formularios ni vistas entre los que elegir.
9. Elija la página de inicio de la aplicación: lo que se abre cuando un usuario inicia la aplicación y adónde lleva la entrada Inicio del carril. Puede ser una tabla, una pantalla de Studio o un informe, y la lista solo ofrece lo que ha colocado en la navegación. Una pantalla aquí es la manera de que una aplicación se abra con cifras en directo en lugar de con una cuadrícula de filas.
10. Seleccione Agregar aplicación (o Guardar, al editar). El panel se cierra y la lista se actualiza con sus cambios.
11. Entregue la aplicación a las personas que la usarán. Construirla no la comparte: una aplicación nueva es visible para los creadores y los administradores, y para nadie más. Seleccione la fila de la aplicación y después Compartir; consulte Entregar una aplicación a las personas que la usarán.

Pantallas e informes en una aplicación

Un elemento de navegación es un destino, y hay tres tipos:

• Una tabla abre su lista, y los registros, vistas y formularios que hay detrás.
• Una pantalla de Studio ocupa toda el área de contenido: lo que dibujó es la pantalla.
• Un informe abre el visor de informes sobre toda la tabla, listo para imprimir. (Un informe ejecutado desde el formulario de un registro o desde la barra de comandos de una vista lleva ese registro o ese filtro; uno abierto desde la navegación no, porque no hay nada en pantalla que pueda llevar).

Cada uno tiene una dirección propia, así que cualquiera de ellos se puede guardar en marcadores, compartir, actualizar y anclar: /apps/{app}/{table}, /apps/{app}/dashboard/{name}, /apps/{app}/report/{name}.

Quién puede abrir uno es un permiso. Abrir una pantalla y ejecutar un informe son concesiones que tiene un rol de seguridad como cualquier otro permiso. Un usuario sin la concesión ve el elemento en el carril y se le indica que no puede abrirlo, en lugar de mostrarle las cifras de otra persona. Por separado, todo lo que leen una pantalla y los conjuntos de datos de un informe se filtra según los permisos de registro de quien lo consulta, de modo que dos personas que abren la misma pantalla ven cada una los registros que puede ver.

Los paneles se han retirado

La plataforma ofrecía antes un panel (una cuadrícula de widgets de KPI, gráficos y vistas) como cuarto tipo de destino, y el Application Studio lo sustituyó: una pantalla dibujada hace todo lo que hacía un panel, y es el lienzo que ya está aprendiendo. Por eso no hay lista de paneles, ni diseñador de paneles, ni botón Agregar panel. Una aplicación que ya nombra uno lo sigue abriendo y su permiso sigue aplicándose (nada de lo almacenado ha cambiado), pero uno nuevo se dibuja como pantalla de Studio. Consulte Dibujar una aplicación de Studio.

Elegir qué ofrece la aplicación para una tabla

Una tabla acumula formularios y vistas a lo largo de su vida: un formulario de administración junto al que usa un comercial, una vista «Mis elementos abiertos» que solo importa a un equipo. Una aplicación que los muestra todos es como una tabla limpia se convierte en una aplicación abarrotada.

Seleccione el botón de controles deslizantes en la fila de una tabla colocada (Formularios y vistas de tabla) para abrir la elección. Cada lista es una de estas dos:

• Todos los formularios de esta tabla, incluidos los que se agreguen más adelante: la aplicación sigue a la tabla. Un formulario que agregue mañana a la tabla aparece automáticamente en esta aplicación.
• Solo los seleccionados abajo: una elección fija. Un formulario agregado después a la tabla no aparece en esta aplicación hasta que vuelva y lo marque.

Esa diferencia es la razón de tener ambas, y no es lo mismo que marcar todas las casillas: un creador que seleccionó con cuidado los formularios de una aplicación rara vez quiere que el siguiente aparezca en ella sin avisar, y un creador que no seleccionó nada siempre lo quiere. Cambiar a Solo los seleccionados empieza con todo marcado, así que quita lo que no quiere en lugar de reconstruir la lista.

Desmarcarlo todo no oculta la tabla (una tabla sin formulario no se podría abrir), así que se guarda como «todos», y el cuadro de diálogo lo indica mientras está en ese estado.

La selección decide qué formularios y vistas ofrece la aplicación, no el orden en que aparecen ni cuál se abre primero. Eso sigue siendo cosa de la tabla.

Los recuentos bajo el nombre de la tabla indican en qué estado está sin abrir el cuadro de diálogo: 3 formularios · 2 vistas es una tabla a la que sigue la aplicación, y 2 de 5 formularios es una lista que usted ha cerrado.

Dividir una navegación larga en áreas

Junto al título de cada grupo hay un cuadro área. Dé a varios grupos la misma área — Recepción para Reservas y Clientes, Configuración para la configuración — y en cuanto haya dos o más áreas con nombre, la navegación de la aplicación muestra un área cada vez, con un selector en su pie. Deje el cuadro vacío para un grupo que deba verse en todas las áreas, como una página de inicio u Hoy. Sin áreas, la navegación no cambia.

Qué ocurre entre bastidores

La aplicación se almacena como metadatos con ámbito en este entorno y con el espacio de nombres del prefijo del editor, como componente de la solución seleccionada. Su navegación hace referencia a cada destino por tipo y nombre; antes de guardar, la plataforma comprueba que cada tabla, panel e informe al que se hace referencia existe (en el almacén que indica su tipo) y que la página de inicio es uno de los destinos de la propia navegación. La aplicación en sí no contiene datos: es una vista seleccionada de los componentes del entorno.

Solución de problemas

• «… must be lower snake-case and start with the publisher prefix.» — el nombre lógico debe empezar por {prefix}_ y usar solo letras minúsculas, dígitos y guiones bajos.
• «Entity … is not defined in this environment.» — una tabla de la navegación no existe en este entorno; cree primero la tabla o quítela de la navegación.
• «Dashboard … is not defined in this environment.» (o Report …) — la navegación nombra uno que se ha eliminado o que nunca se importó aquí. Constrúyalo, impórtelo o quite el elemento.
• «The home page … must appear in the app's navigation.» — elija una página de inicio que haya agregado a la navegación. Un inicio al que nadie puede volver es una pantalla sin entrada en cuanto el usuario ha hecho clic en cualquier otro sitio.
• «An app named … already exists in this environment.» — elija otro nombre lógico; los nombres lógicos de las aplicaciones son únicos dentro de un entorno.
• «You do not have permission to open the dashboard …» (o … run the report …) — el destino existe, pero su rol de seguridad no tiene ninguna concesión sobre él. Un administrador concede <name>.Open para un panel o <name>.Run para un informe, o el comodín *.Open / *.Run para cubrir lo que se construya después.
• «Form … is not defined on entity …» (o View …) — la aplicación selecciona un formulario o una vista que la tabla ya no tiene, normalmente porque se le cambió el nombre o se eliminó después de construir la aplicación. Abra el cuadro de diálogo Formularios y vistas de la tabla y marque los actuales.
• Un formulario que agregué a una tabla no aparece en una aplicación. — esa aplicación selecciona formularios concretos, así que uno nuevo no se incluye hasta que lo agregue. La fila indicará «2 de 5 formularios» en lugar de un simple recuento. Abra la aplicación, seleccione el botón Formularios y vistas de la tabla y marque el nuevo formulario o vuelva a cambiar la lista a todos los formularios de esta tabla.

Escenarios relacionados

• Entregar una aplicación a las personas que la usarán.
• Crear una tabla.
• Crear un formulario.
• Crear una vista.
• Crear un informe.