FlexHub

Secciones

Crear y editar secciones y campos, filtrar los listados, cambiar el icono de una sección y usar las ventanas de elegir y de condición.

FlexHub → Secciones es el inventario de las tablas de la empresa. Cada sección sale en una tarjeta; al pulsarla se abre su ventana, con sus propiedades y con todo lo que cuelga de ella: campos, informes, documentos, scripts y algoritmos. Qué es una sección y cómo hereda de una plantilla base: Secciones.

Antes de empezar

  • Ser Administrador de la empresa. Ver FlexHub.
  • Lo que trae un módulo de fuera se lee pero no se cambia: su ventana abre con un candado y el motivo del servidor. Lo tuyo es lo que ha creado la empresa y, en una licencia de desarrollo, lo del módulo que desarrolla.
  • Crear una sección o un campo consolida la estructura de toda la empresa y tarda unos 11 segundos. La ayuda de la ventana lo avisa antes de pulsar Aceptar.

La lista

La tarjeta Secciones lleva el subtítulo Las tablas de tu empresa. Las plantillas base y las tablas de líneas están en los filtros. En la cabecera están Nuevo y el icono de recargar. Debajo, el buscador Buscar por nombre o palabra clave… (busca el servidor) y el botón Filtros.

Cada sección es una tarjeta con:

ElementoQué es
IconoEl de la sección. Si la sección es tuya, pulsarlo abre Cambiar el icono.
Nombre y palabra claveEl título y, en letra de código, el nombre interno.
EtiquetasBase (plantilla base), Líneas (tabla de líneas), Obsoleta y Eliminada. Solo salen si la sección lo es.
OrigenUn punto de color y un texto. Verde si es tuya: Propia (la ha hecho esta empresa) o el nombre del módulo que desarrolla esta licencia. Azul con el nombre del módulo de fuera que la trae, que la sobrescribe en cada actualización.
FechaLa fecha de la última modificación de la sección, en la misma línea que el origen.
BotonesDiseñar y Editar, con icono y palabra. Diseñar no sale en una plantilla base: una base no tiene ficha que dibujar.

Qué abre cada gesto:

GestoQué abre
Pulsar la tarjetaLa ventana de la sección, en la pestaña Contenido, que arranca en Campos.
EditarLa misma ventana, en la pestaña General.
DiseñarEl diseñador del formulario, en /App/FlexHub/Secciones/{id}. Diseñando la ficha

Salen 24 tarjetas por página, lo último modificado primero. Si hay más, debajo salen Mostrando X-Y de N y el paginador. Cuando los filtros esconden secciones de otros módulos, debajo de la lista aparece Ver de otros módulos (N): marca la casilla De otros módulos y las trae.

Estado vacío No hay secciones que enseñar, con tres explicaciones según el caso:

  • Aquí no hay nada tuyo: las N que quedan vienen de otros módulos. Pulsa Ver de otros módulos (N).
  • Ninguna encaja con los filtros. Quita alguno para ver más.
  • Puede que la búsqueda no encaje con ninguna, o que esta empresa todavía no tenga secciones propias.

Los filtros

El botón Filtros abre un cuadro con casillas agrupadas. Cuando alguna casilla no está como arrancó, el botón lo cuenta: Filtros (2). Dentro aparece entonces Restablecer, que las devuelve a su sitio y cierra el cuadro. El cuadro no se cierra al marcar, para cambiar varias casillas seguidas.

Un grupo sin ninguna casilla marcada no filtra, y el cuadro lo dice: Sin marcar ninguna salen todas. Estado funciona al revés: sus casillas añaden filas que sin ellas no salen, y ahí esa frase no aparece.

En Secciones hay tres grupos:

GrupoCasillasAl abrir
EstadoObsoletas (marcadas para no usarse) y Eliminadas (borradas, se guardan para el historial). Marcar una vuelve a preguntar al servidor.Ninguna marcada.
OrigenMíos (las que has creado tú y, si la licencia desarrolla un módulo, las de ese módulo) y De otros módulos (vienen con un módulo que no desarrollas tú).Solo Míos.
FamiliaPrincipales (las que se abren y guardan datos), Plantillas base (otras secciones heredan sus campos) y Tablas de líneas (las líneas de una ficha).Solo Principales.

Con Plantillas base o Tablas de líneas marcadas, el subtítulo de la lista cambia a Incluye las plantillas base y las tablas de líneas: son piezas internas y no se abren. Los mismos filtros, con otros grupos, salen en la pestaña Contenido de una sección, en las listas globales, 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 la ventana pequeña Nueva sección, con la tarjeta Cómo se llama y el subtítulo El resto se rellena después, con la sección ya creada. Pide un solo dato, el Título, en rojo hasta que lo escribes.

Escribe el título limpio

El título es el nombre de la sección en el menú y en los listados. Con él la llaman también el SDK, los scripts y las integraciones. Tiene que ser único en toda la empresa, distinguiendo mayúsculas. Con algo escrito, debajo del campo sale el motivo si no vale:

  • El título es demasiado corto (mínimo 4 caracteres).
  • El título no debe empezar por 'Base - ' (se añade automáticamente). Lo mismo con Lista - , EDU - , Base Lista - , Base EDU - y Base Lista EDU - : los prefijos de la familia los pone el servidor.
  • El título de la sección no puede contener, seguido del carácter que sobra. No entran la virgulilla, el asterisco, el signo de negación, los de menor y mayor ni los de exclamación.

Si pulsas Aceptar con un título que no vale, la notificación Título no válido repite el motivo. Con el título vacío, el motivo es Escribe un título. Es el nombre público de la sección.

Pulsa Aceptar

El botón pasa a Creando… y tarda unos 11 segundos. Mientras dura, Cerrar está apagado y ni Esc ni pulsar fuera cierran la ventana. Cerrar ahí no cancela nada y dejaría la sección creada sin salir en la lista. El servidor crea la tabla en la base de datos y monta las cuatro filas de la familia. Son la principal, su plantilla base, la tabla de líneas y la base de esa tabla. Después consolida la estructura, y la ventana pone a la sección y a su plantilla base el icono que llevan todas las secciones nuevas.

La ventana se cierra con la notificación Sección creada y se abre la ventana de la sección recién creada, en la pestaña General. Al cerrarla, la lista se vuelve a leer.

El singular y el plural se crean con el valor del título, aunque el plural quede mal escrito: se corrigen en General, en la tarjeta Identidad. Si el servidor acepta la sección pero rechaza alguna propiedad, la notificación es Sección creada con rechazos, dice cuáles y manda a corregirlas en General.

La ventana de una sección

Es la única ventana de una sección: la misma para crear y para editar. En la cabecera, el icono de la sección y Editar sección. El icono se cambia pulsándolo si la sección es tuya y no está bloqueada.

Debajo va una tarjeta con el Título a todo el ancho, el Nombre interno y las tres pestañas. Una línea bajo el título avisa si la sección es la tabla de líneas de otra o si la trae un módulo. El título es también el nombre con el que la llaman el SDK, los scripts y las integraciones. Al renombrarla, lo que usaba el nombre anterior deja de encontrarla. Renombrar cambia solo esta sección. Su plantilla base y su tabla de líneas conservan su nombre y se abren desde Secciones relacionadas, en Contenido.

Avisos

La tarjeta Avisos solo aparece cuando hay algo que contar:

AvisoQué hacer
Candado con el motivoLa sección se lee pero no se escribe: viene de un módulo ajeno, está eliminada o el servidor no deja cambiar secciones desde la web. Aceptar desaparece y el icono no se cambia.
Esta sección está marcada como obsoleta.Sigue guardando sus datos, pero no sale en el menú ni en la API, y se edita igual. Para volver a ofrecerla, desmarca el interruptor de Retirar la sección, en General.
El resultado del último guardadoEn verde si entró, en rojo si no, con el motivo del servidor.
Tabla Propiedad / MotivoLas propiedades que el servidor ha rechazado una a una. Siguen pendientes: corrige y vuelve a pulsar Aceptar.
El cambio está guardado, pero todavía no surte efecto. Consolida la estructura.Pulsa Consolidar ahora. Pregunta antes: reconstruye la estructura de toda la empresa, tarda unos diez segundos y mientras dura nadie puede cambiarla.

Las pestañas

Pestaña y tarjetaQué se configura
General → IdentidadEtiqueta singular, Etiqueta plural, El nombre es femenino y Descripción. Con el singular y el plural el ERP dice «Nueva factura» y no un nombre genérico. Los dos salen en rojo mientras estén vacíos, aunque no impiden guardar. Debajo, una línea muestra cómo lo dirá el ERP con lo escrito: «la factura · las facturas · Nueva factura».
General → ParámetrosEtiqueta 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, en un desplegable o dentro de otra ficha. Con Texto principal automático, la frase se compone con los campos de la ficha: la etiqueta pasa a valer Referencia y se bloquea. Al desmarcarlo vuelve la anterior. Permitir nombres repetidos deja que dos fichas se llamen igual, y solo se cambia en la plantilla base.
General → Retirar la secciónEl interruptor Marcar esta sección como obsoleta. Una sección obsoleta no sale en el menú ni en la API y no se le crean índices nuevos, pero sus datos siguen ahí. En una plantilla base, sus derivadas también quedan obsoletas. No borra nada: eliminar una sección no se hace desde aquí. La tarjeta solo sale si el servidor deja retirar secciones.
Bloqueos → Mensajes de bloqueoMensaje al intentar agregar una ficha, Mensaje al intentar eliminar una ficha y Mensaje al intentar editar una ficha. Vacío, la acción se puede hacer. Con un mensaje escrito, se bloquea, y ese texto es lo que lee el usuario. Sirven para cerrar una sección que se rellena sola, por un script o una integración.
ContenidoLo que cuelga de la sección (campos, informes, documentos, scripts y algoritmos) y la tarjeta Secciones relacionadas.

Lo que la sección abierta no gobierna sale con su control apagado y una frase debajo que dice dónde se cambia. Lo que se decide en la plantilla base o en las derivadas remite a Secciones relacionadas. En una tabla de líneas, el singular, el plural, el femenino y la retirada se deciden en la sección principal, la misma sin «Lista - » delante. En una sección cuyos datos administra el motor, el texto principal es siempre automático. Si el servidor no publica ninguna propiedad de una tarjeta, sale No hay nada que rellenar: no es un problema de permisos.

La tarjeta Secciones relacionadas, al final de Contenido, tiene una fila por pariente: Plantilla base, Tabla de líneas y, desde una base, cada derivada con Comparte la plantilla. Su Editar abre ese pariente en otra ventana encima, en General. Al cerrarla vuelves a la sección de la que venías. Salen de seis en seis con Ver más (N).

Guardar y cerrar

Aceptar guarda. Si todo entra y no queda nada pendiente, la ventana se cierra sola con la notificación Sección guardada. Si algo no es válido antes de enviar, no se envía nada y la notificación lo dice:

  • Sin cambios: no has cambiado nada.
  • Título no válido, con el motivo. En una plantilla base o una tabla de líneas el prefijo es obligatorio, por ejemplo El título debe comenzar por 'Base - '. En una sección normal, el título lleva al menos 3 caracteres y ningún prefijo.
  • Faltan propiedades por rellenar, con las que no pueden quedar vacías.

Si el servidor rechaza alguna propiedad, la notificación Hay propiedades sin guardar y la tabla de Avisos dicen cuáles, y la ventana sigue abierta. Si alguien cambió la sección mientras la tenías abierta, la notificación No se ha guardado la sección lo explica. La sección se vuelve a leer, lo escrito sigue en pantalla y basta con volver a pulsar Aceptar.

La ventana no se cierra con Esc ni pulsando fuera. Cerrar con cambios sin guardar pregunta Hay cambios sin guardar. Si cierras ahora, se pierden., con Cerrar y perder los cambios o Seguir editando.

Lo que cuelga de la sección

La pestaña Contenido es la tarjeta Lo que cuelga de esta sección, con cinco pestañas: Campos, Informes, Documentos, Scripts y Algoritmos. En la cabecera, Nuevo crea un objeto del tipo de la pestaña abierta, y el icono de recargar vuelve a leer la lista. Nuevo no sale si el servidor no deja crear ese tipo.

Cada pestaña tiene su buscador, Buscar por nombre o nombre interno…, el botón Filtros (Estado y Origen) y una rejilla de 20 filas por página. Las casillas de Estado arrancan como estaban en la lista de secciones. Las columnas: el nombre, Módulo (Propio, tu módulo o el de fuera, más Obsoleto o Eliminado cuando los filtros los piden), Modificado y el botón Editar. Ver de otros módulos (N) sale debajo cuando los filtros esconden filas.

La ayuda de la tarjeta avisa de dos cosas:

  • Las columnas de un informe no están aquí. Cuelgan del informe, no de la sección, y se abren desde el informe, en su pestaña Columnas. Ver Informes.
  • Un algoritmo se crea eligiendo primero su tipo: lineal, de dato, relacionado, calculadora o de búsqueda. El tipo decide sobre qué secciones calcula y no se cambia después. Si el servidor de la empresa no admite crearlos desde la web, Nuevo lo avisa con una notificación y no abre nada. Ver Algoritmos.

Estados vacíos, con el título Sin campos, Sin informes, Sin documentos, Sin scripts o Sin algoritmos:

CasoTexto
CamposEsta sección todavía no tiene campos propios. Pulsa «Nuevo» para añadir el primero.
InformesEsta sección todavía no tiene informes propios. Pulsa «Nuevo» para crear el primero.
DocumentosEsta sección todavía no tiene documentos. Pulsa «Nuevo» para crear el primero.
ScriptsEsta sección todavía no tiene scripts. Pulsa «Nuevo» para crear el primero.
AlgoritmosEsta sección todavía no tiene algoritmos. Pulsa «Nuevo» para crear el primero.
Con los filtros en MíosNo hay ninguno propio. Los N que hay vienen de otros módulos. Para verlos, pulsa «Ver de otros módulos».
Con los filtros en De otros módulosLos N que hay son propios de esta empresa. Para verlos, marca «Míos» en «Filtros».

Editar abre la ventana del objeto, una por tipo, con sus propiedades y su contenido en pestañas. La de un campo es La ficha de un campo; las demás están en Informes, Documentos, Scripts y Algoritmos. Al volver de cualquiera, la lista se vuelve a leer.

La ficha de un campo

Un campo es una columna de la sección: el hueco que se rellena en la ficha. Qué tipos hay y qué hace un rol: Campos y Roles de campo. La ventana es una para crear y para editar. En la cabecera, el icono del tipo de dato, Nuevo campo o Editar campo y, cuando se saben, el tipo de dato y la sección. Debajo, la Etiqueta a todo el ancho y el Nombre interno: con ese nombre se llama al campo desde una fórmula o un script.

Crear un campo desde Contenido

Pulsa Nuevo

En Contenido → Campos, pulsa Nuevo. Se abre Nuevo campo, sin pestañas: la Etiqueta y las tarjetas Tipo de dato y Ayudas.

Escribe la etiqueta

La Etiqueta es lo que se lee en la ficha, al lado del dato. Sale en rojo, con La etiqueta necesita al menos 3 caracteres. debajo, hasta que tiene tres. El servidor rechaza las etiquetas reservadas y muestra su motivo en Avisos. Son Destinador, ContenedorListado, Fecha Dato, Exportar en módulos, Autor del alta, Empleado, Fecha Alta del registro y Hora local.

Elige el tipo de dato

La tarjeta Tipo de dato avisa en su subtítulo: Qué clase de dato guarda el campo. No se cambia después. La caja Tipo de dato abre Elegir el tipo de dato, con nueve tipos: Texto, Entero, Decimal, Sí/No, Fecha, Fecha y hora, Hora, Relación y Botón. Debajo de la caja sale la línea de ayuda del elegido. Una vez creado el campo, la única forma de cambiar el tipo es borrarlo y crear otro.

Los tipos preparados, como Email (texto con una máscara), no se eligen aquí: están en la ventana Nuevos campos del diseñador. Ver Diseñando la ficha.

Con Relación, elige la sección de destino

Aparece Sección a la que apunta, que abre Elegir la sección de destino: Este campo guarda una ficha de la sección que elijas. Debajo, el aviso Las plantillas base y las tablas de líneas no se pueden elegir como destino.

Escribe las ayudas

En la tarjeta Ayudas, Ayuda para quien lo rellena sale al lado del campo a quien rellena la ficha. Nota para quien lo programa la lee quien programa.

Pulsa Aceptar

El botón pasa a Creando…: crear un campo consolida la estructura y tarda unos once segundos. Si falta algo, la notificación lo nombra: Falta el tipo de dato, Falta la sección de destino o Falta la etiqueta. Con el campo creado, la notificación Campo guardado lo confirma, la ventana se cierra y la lista de Campos se vuelve a leer. Si el servidor rechaza alguna propiedad, la ventana sigue abierta, ya con sus pestañas, y Avisos dice el motivo.

Las pestañas de un campo

PestañaQué se configura
GeneralLa tarjeta Ayudas, con Ayuda para quien lo rellena y Nota para quien lo programa. Y la tarjeta Qué guarda, de solo lectura: Tipo de dato, Enteros y decimales (en un decimal), Apunta a la sección (en una relación), Valor único y Sección. Su subtítulo es Se decide al crear el campo y no se cambia después. No es por permisos: el servidor no deja cambiar el tipo de dato de un campo. Para guardar otra cosa, crea un campo nuevo.
En la fichaUna tarjeta con Se ve en la ficha, Hay que rellenarlo, Cómo se muestra y Qué se valida; los desplegables los publica el servidor. La tarjeta Quién puede escribirlo, con Bloqueo en el servidor y Bloqueo por la API REST. Un bloqueo impide escribir el campo desde ese sitio, y el valor se sigue leyendo. Y la tarjeta Dónde sale el campo.

En el campo de una plantilla base, las tarjetas de En la ficha dicen Estas propiedades se configuran en el campo de cada sección. Abre el campo desde esa sección.

La tarjeta Dónde sale el campo lleva el subtítulo La pestaña, la posición y el tamaño se tocan en el Diseñador, arrastrando. Su botón Abrir el Diseñador cierra la ventana, preguntando antes si hay cambios sin guardar, y abre el diseñador de la sección del campo. Si no se sabe de qué sección es el campo, el botón no sale y la nota lo dice: ábrelo desde Secciones y pulsa Diseñar.

Guardar un campo

Aceptar guarda. Si todo entra y no queda nada pendiente, la ventana se cierra con la notificación Campo guardado. Si algo no es válido antes de enviar, no se envía nada y la notificación lo dice:

  • Sin cambios: no has cambiado nada.
  • Faltan propiedades por rellenar: una obligatoria está vacía.
  • Etiqueta demasiado corta: tiene menos de tres caracteres.
  • Falta el orden de la pestaña: has encendido Se ve en la ficha en un campo cuya pestaña se quedó en la posición 0. Pasa con cualquier pestaña que no sea General ni Detalles, y el servidor rechazaría el guardado entero. Deja Se ve en la ficha apagado y guarda el resto, o da a esa pestaña un orden mayor que cero en el diseñador.

Si el servidor rechaza alguna propiedad, Hay propiedades sin guardar y la tabla de Avisos dicen cuáles. Si pide consolidar, Avisos lo dice con Consolidar ahora, igual que en la sección. Un campo eliminado no se edita: el candado manda a darlo de alta otra vez desde el diseñador de su sección. Como la de la sección, esta ventana no se cierra con Esc ni pulsando fuera, y Cerrar con cambios pregunta lo mismo.

El icono de una sección

El icono se cambia pulsándolo en la tarjeta de la lista, en la cabecera de la ventana de la sección o en la ruta de navegación del diseñador. Solo se cambia si la sección es tuya. El icono lo ven todas las empresas que usan Dinaup, y el de una sección de otro módulo no se cambia desde aquí.

La ventana Cambiar el icono tiene tres tarjetas:

TarjetaQué hay
Antes y despuésCompara Ahora (Icono propio, Icono por defecto o Sin comprobar) con Nuevo (Sin elegir hasta que pones una imagen). El subtítulo dice si la sección tiene icono propio o usa el de por defecto.
Elegir el iconoDos ranuras: Principal (obligatoria) e Insignia (opcional, va en la esquina inferior derecha). En cada una sueltas una imagen o la eliges pulsando el hueco. Un SVG se sube tal cual; un png o un jpg se envuelve en un SVG con la imagen dentro.
Dónde se guardaLa URL pública del icono, https://dinaupcdn.com/ico/{id}.svg, con el subtítulo La dirección es la misma para todas las empresas que usan Dinaup.

Debajo de las ranuras va O una insignia de familia, la tira con las familias de secciones que se repiten en Flex. Cada una se rotula como empieza el nombre de la sección, por ejemplo Tipos de…. Pulsar una la pone en Insignia y pulsarla otra vez la quita. Detalles de… no va en la esquina: es un marco que envuelve el icono. Con insignia y sin icono principal, el aviso es Falta el icono principal. Añádelo para combinar la insignia.

Aceptar pregunta antes de subir, en Cambiar el icono: el icono nuevo se ve en todas las empresas que usan Dinaup. Sin imagen en Principal, avisa con Falta el icono. Quitar el icono sale si la sección ya tiene uno, y pregunta antes de borrar: la sección vuelve al icono por defecto en todas las empresas. Las notificaciones son Icono subido e Icono quitado.

Las ventanas de elegir

Varias pantallas de FlexHub eligen con la misma pareja: una caja en el formulario y una ventana que se abre al pulsarla. Al elegir, la ventana se cierra. En las tres, Enter elige, Esc o Cerrar salen sin elegir, y el título lo pone quien la abre.

Una condición de un informe

La ventana Añadir condición (o Editar condición) compone una frase de tres partes, dato, condición y valor, que decide si una fila sale en un informe. Se abre desde la ventana de un informe, en su pestaña Filtrado, con Añadir condición o con el lápiz de una condición. Qué es el filtro de un informe: Informes y Informes en Flex.

Los tres pasos son tarjetas que aparecen en orden, y la última, Así queda, dice cómo va la condición:

TarjetaQué pide
¿Qué dato?El dato que se comprueba en cada ficha. El selector Dato abre el explorador de datos relacionados. Vale un dato de la ficha o uno al que se llega por una relación, como la población del cliente. La flecha abre una relación y se busca escribiendo. Solo ofrece los datos sobre los que se puede preguntar algo.
¿Qué condición?Sale con el dato elegido: Qué se comprueba sobre ese dato. El desplegable Condición lista lo que admite esa clase de dato, según el catálogo del servidor. Si no admite nada: Sobre este dato no se puede comprobar nada. Elige otro dato.
¿Qué valor?Solo si la condición compara con algo: Con qué se compara el dato. Un control por valor según el dato: o No, un número, una fecha, una fecha y hora, una hora o un texto. En una relación, una ficha de la sección a la que apunta, elegida en el selector de filas. Con varios valores, la ficha sale si coincide con cualquiera. Añadir otro valor suma huecos hasta lo que admita la condición, con un tope de 20, y el aspa Quitar este valor quita los que sobran. Un valor que se calcula al abrir el informe sale apagado, con Se calcula al abrir el informe. al lado: se conserva, pero no se edita.
Así quedaLa condición en palabras mientras la montas: el dato con su camino, la condición y los valores separados por o. Si falta algo, dice qué: Falta elegir el dato que se comprueba., Falta elegir qué se comprueba sobre el dato., Falta el valor con el que se compara. o Faltan valores: hacen falta N y hay M.

Aceptar devuelve la condición a la ventana del informe; si falta algo, la notificación La condición no está completa lo repite. Cerrar, Esc o pulsar fuera la descartan. Esta ventana no escribe en el servidor: el filtro se guarda con el Aceptar de la ventana del informe.

Una condición que el servidor no puede desmontar en sus piezas sale en la tarjeta Esta condición no se puede cambiar aquí. Su subtítulo dice Se queda en el informe tal y como está., y solo queda el botón Cerrar.

En esta página