Dinaup DocsSecciones
Lista, filtros, creación y edición de secciones y campos, el icono de cada sección y las condiciones que filtran un informe.
FlexHub → Secciones es el inventario de las tablas de la empresa: cada sección es una tarjeta que abre su ventana, con sus propiedades y lo que cuelga de ella. Qué es una sección y cómo hereda de una plantilla base: Secciones.
Hace falta ser Administrador. Lo que trae un módulo de fuera abre con un candado y el motivo: se lee pero no se cambia.
La lista
Cada tarjeta lleva el icono, el nombre y la palabra clave, las etiquetas Base, Líneas, Obsoleta o Eliminada cuando toca, el origen y la fecha de la última modificación. El origen sale en verde si la sección es tuya (Propia o el módulo que desarrolla esta licencia) y en azul con el nombre del módulo de fuera que la trae.
| Gesto | Qué abre |
|---|---|
| Pulsar la tarjeta | La ventana de la sección, en Contenido. |
| Editar | La ventana de la sección, en General. |
| Diseñar | El diseñador. No sale en una plantilla base. |
| Pulsar el icono | Cambiar el icono, si la sección es tuya. |
Salen 24 por página, lo último modificado primero. Cuando los filtros esconden secciones de otros módulos, debajo sale Ver de otros módulos (N).
Los filtros
Filtros abre las casillas agrupadas y cuenta las que no están como arrancaron: Filtros (2). Restablecer las devuelve a su sitio. Un grupo sin ninguna casilla marcada no filtra.
| Grupo | Casillas | Al abrir |
|---|---|---|
| Estado | Obsoletas y Eliminadas. Añaden filas que sin ellas no salen. | Ninguna. |
| Origen | Míos y De otros módulos. | Solo Míos. |
| Familia | Principales, Plantillas base y Tablas de líneas. | Solo Principales. |
Los mismos filtros, con otros grupos, salen en Contenido, en Módulos y al elegir una sección.
Crear una sección
Pulsa Nuevo
En la cabecera de la lista, pulsa Nuevo. Se abre Nueva sección.
Escribe el título
El Título es el nombre de la sección en el menú y el que usan el SDK, los scripts y las integraciones. Tiene que ser único, con al menos 4 caracteres, sin empezar por «Base - » y sin virgulilla, asterisco, signo de negación, menor, mayor ni exclamación.
Pulsa Aceptar
Tarda unos segundos. Junto a la sección se crean su plantilla base y su tabla de líneas. Sale Sección creada y se abre la sección en General.
Corrige el singular y el plural
Se crean con el valor del título. Corrígelos en General → Identidad.
La ventana de una sección
La cabecera lleva el icono y Editar sección; debajo, el Título, el Nombre interno y las pestañas. Renombrar una sección rompe lo que la buscaba por el nombre anterior, y no renombra su plantilla base ni su tabla de líneas.
Las pestañas
| Pestaña y tarjeta | Qué se configura |
|---|---|
| General → Identidad | Etiqueta singular, Etiqueta plural, El nombre es femenino y Descripción. Con ellas el ERP dice «Nueva factura». |
| General → Parámetros | Etiqueta del texto principal, Texto principal automático y Permitir nombres repetidos. El texto principal es lo que se lee de una ficha en un listado o en un desplegable. Con Texto principal automático se compone con los campos de la ficha. Permitir nombres repetidos solo se cambia en la plantilla base. |
| General → Retirar la sección | Marcar esta sección como obsoleta: deja de salir en el menú y en la API, y sus datos siguen ahí. En una plantilla base, sus derivadas también quedan obsoletas. |
| Bloqueos → Mensajes de bloqueo | Mensaje al intentar agregar una ficha, Mensaje al intentar eliminar una ficha y Mensaje al intentar editar una ficha. Con un mensaje escrito, la acción se bloquea y el usuario lee ese texto. |
| Contenido | Lo que cuelga de la sección y Secciones relacionadas. |
Lo que no gobierna la sección abierta sale apagado, con una frase que dice dónde se cambia. En una tabla de líneas, el singular, el plural, el femenino y la retirada se deciden en la sección principal.
Secciones relacionadas tiene una fila por pariente: Plantilla base, Tabla de líneas y, desde una base, cada derivada. Su Editar abre ese pariente encima.
Guardar
Aceptar guarda y cierra la ventana con Sección guardada. Si el servidor rechaza alguna propiedad, Avisos dice cuáles y por qué, y la ventana sigue abierta. Si alguien cambió la sección mientras la tenías abierta, se vuelve a leer, lo escrito sigue en pantalla y basta con volver a pulsar Aceptar. Si Avisos dice que el cambio todavía no surte efecto, pulsa Consolidar ahora: pregunta antes y tarda unos segundos.
Lo que cuelga de la sección
La pestaña Contenido tiene cinco pestañas: Campos, Informes, Documentos, Scripts y Algoritmos. Nuevo crea un objeto del tipo de la pestaña abierta y Editar abre su ventana:
- Un campo: La ficha de un campo.
- Informes. Sus columnas cuelgan del informe, no de la sección.
- Documentos.
- Scripts.
- Algoritmos. Se crean eligiendo primero su tipo.
La ficha de un campo
Un campo es una columna de la sección. Qué tipos hay y qué hace un rol: Campos y Roles de campo. El Nombre interno es con el que se llama al campo desde una fórmula o un script.
Crear un campo desde Contenido
Pulsa Nuevo
En Contenido → Campos, pulsa Nuevo.
Escribe la etiqueta
La Etiqueta es lo que se lee en la ficha al lado del dato. Necesita al menos tres caracteres.
Elige el tipo de dato
Elige entre Texto, Entero, Decimal, Sí/No, Fecha, Fecha y hora, Hora, Relación y Botón. El tipo no se cambia después: para cambiarlo, borra el campo y crea otro. Los tipos preparados, como Email, están en el diseñador.
Con Relación, elige la sección de destino
Pulsa Sección a la que apunta y elige la sección. Las plantillas base y las tablas de líneas no se pueden elegir.
Escribe las ayudas
Ayuda para quien lo rellena sale al lado del campo en la ficha. Nota para quien lo programa solo la lee quien programa.
Pulsa Aceptar
Tarda unos segundos. Sale Campo guardado y la lista de Campos se vuelve a leer.
Las pestañas de un campo
| Pestaña | Qué se configura |
|---|---|
| General | Ayudas y Qué guarda, de solo lectura: el tipo de dato, los decimales, la sección a la que apunta y si el valor es único. |
| En la ficha | Se ve en la ficha, Hay que rellenarlo, Cómo se muestra, Qué se valida, Bloqueo en el servidor y Bloqueo por la API REST. Un bloqueo impide escribir el campo desde ese sitio; el valor se sigue leyendo. Abrir el Diseñador lleva a donde se colocan la pestaña, la posición y el tamaño. |
En el campo de una plantilla base, En la ficha se configura en el campo de cada sección derivada.
Guardar un campo
Aceptar guarda y sale Campo guardado. Si sale Falta el orden de la pestaña, el campo está en una pestaña con orden 0. Deja Se ve en la ficha apagado o da a esa pestaña un orden mayor que cero en el diseñador.
El icono de una sección
El icono se cambia pulsándolo en la tarjeta de la lista, en la cabecera de la sección o en la ruta del diseñador, y solo si la sección es tuya.
Pon el icono principal
En Principal, suelta una imagen o pulsa el hueco para elegirla. Un SVG se sube tal cual; un png o un jpg se envuelve en un SVG.
Añade una insignia si quieres
Pon otra imagen en Insignia, que va en la esquina inferior derecha, o elige una de O una insignia de familia, como Tipos de….
Pulsa Aceptar
Confirma la subida. Sale Icono subido.
Quitar el icono devuelve la sección al icono por defecto.
Una condición de un informe
Añadir condición, en la pestaña Filtrado de un informe, compone una frase de dato, condición y valor que decide si una fila sale.
| Tarjeta | Qué pide |
|---|---|
| ¿Qué dato? | Un dato de la ficha o uno al que se llega por una relación, como la población del cliente. |
| ¿Qué condición? | Lo que admite esa clase de dato. |
| ¿Qué valor? | Con qué se compara. Con varios valores, la fila sale si coincide con cualquiera; Añadir otro valor admite hasta 20. |
| Así queda | La condición en palabras y lo que falta. |
Aceptar devuelve la condición al informe; el filtro se guarda con el Aceptar de la ventana del informe.