Editor visual de campos
El editor —o builder— es donde se arma el formato: se arrastran campos desde una paleta a un lienzo, se ordenan y se les configuran sus propiedades. No hace falta escribir código ni saber de bases de datos.
Acceso
Desde el listado de Registros clínicos, icono de engranaje (Configurar campos) en la fila del registro.
- Ruta:
/administracion/registros-clinicos/<id>/builder.
El editor ocupa la pantalla completa. El botón de flecha del encabezado vuelve al listado.
La barra superior
Junto a la flecha de retorno están los datos generales del registro, editables sin salir del editor:
| Elemento | Descripción |
|---|---|
| Nombre del registro | El mismo nombre de la ficha. |
| Servicios | Ámbitos a los que aplica. |
| Edad mín / Edad máx | Rango de edad del paciente. |
| Activo | Casilla de estado. |
| Vista previa | Abre el formato como lo verá el profesional, con sus validaciones reales. |
| Guardar | Guarda los datos generales y los campos, en una sola operación. |
Nada se guarda solo. Todo lo que arrastres y configures vive en tu navegador hasta que pulses Guardar. Si sales del editor antes, se pierde.
Las tres zonas
Izquierda — Campos (la paleta)
Los tipos de campo disponibles, agrupados:
| Grupo | Campos |
|---|---|
| Texto | Texto, Texto largo, Email, Teléfono, URL |
| Numéricos | Número, Entero, Decimal, Deslizador, Campo calculado |
| Selección | Lista desplegable, Selección múltiple, Opción única, Casillas, Sí / No |
| Fecha / Hora | Fecha, Hora, Fecha y hora |
| Archivo | Archivo |
| Estructura | Grupo / Sección, Título, Texto informativo, Separador |
| Componentes clínicos | Diagnóstico CIE |
| Mis componentes | Bloques clínicos completos publicados por BIAI. Este grupo solo aparece si hay componentes disponibles. |
Los componentes son subárboles ya armados (por ejemplo, un bloque de signos vitales completo). Al soltarlos en el lienzo se expanden en campos normales y totalmente editables: no son piezas cerradas. En esta pantalla la biblioteca es de solo lectura: se usan, pero no se crean ni se editan aquí.
Centro — El lienzo
Es el formato en construcción. Cuando está vacío muestra "Arrastra campos desde la izquierda para construir el registro clínico".
- Agregar un campo: arrástralo desde la paleta hasta el lienzo.
- Reordenar: arrastra un campo por el icono de puntos, a la izquierda de su nombre.
- Seleccionar: haz clic sobre el campo. Sus propiedades aparecen en el panel derecho.
- Eliminar: icono de papelera en la esquina del campo.
Cada campo se dibuja con su etiqueta, el tipo entre paréntesis, un asterisco si es obligatorio y una miniatura de cómo se verá.
Grupo / Sección es el único campo contenedor: acepta otros campos adentro y muestra "Arrastra campos aquí" mientras está vacío. Es la herramienta para organizar el formato en bloques (Anamnesis, Examen físico, Plan…).
Derecha — Propiedades
Muestra las propiedades del campo seleccionado. Con el lienzo sin selección dice "Selecciona un campo del lienzo para editar sus propiedades".
Propiedades comunes
| Propiedad | Descripción |
|---|---|
| Etiqueta | El texto que lee el profesional. |
| Código | Identificador interno del campo. Se genera solo a partir de la etiqueta; solo tócalo si sabes por qué. Es el nombre con el que el campo se referencia en las fórmulas. |
| Obligatorio | El formato no se puede cerrar sin diligenciar el campo. |
| Ancho (columnas de 12) | Cuánto ocupa el campo a lo ancho. 12 / 12 es una fila completa; 6 / 12, media fila; 4 / 12, un tercio. Es lo que permite poner varios campos en la misma línea. |
| Texto de ayuda | Aclaración que se muestra bajo el campo. |
| Eliminar campo | Borra el campo del lienzo. |
Propiedades según el tipo
| Tipo de campo | Propiedades adicionales |
|---|---|
| Texto, Texto largo, Email, Teléfono, URL | Placeholder (texto guía dentro del campo) y Longitud máxima. |
| Número, Entero, Decimal, Deslizador | Mín, Máx, Paso y Unidad (kg, mmHg, °C…). |
| Lista desplegable, Selección múltiple, Opción única, Casillas | Origen de opciones y la lista de opciones. Ver más abajo. |
| Archivo | Permitir varios archivos y Formatos permitidos (PDF, imagen, etc.). |
| Título, Texto informativo | Alineación: Izquierda, Centro o Derecha. |
| Campo calculado | Fórmula y Decimales, además de Unidad. Ver más abajo. |
Opciones de los campos de selección
El desplegable Origen de opciones ofrece dos modos:
- Opciones fijas: escribes tú la lista. Cada opción tiene dos partes: el valor (lo que se guarda) y la etiqueta (lo que se lee). Se agregan con Agregar opción y se quitan con la papelera de cada fila.
- Origen de datos (query): las opciones las trae una consulta publicada por BIAI. Al elegir este modo aparece el desplegable Origen de datos para seleccionarla. Sirve para listas que cambian solas o que son demasiado largas para escribirse a mano.
Campo calculado
Calcula su valor a partir de otros campos del mismo formato.
- En Fórmula se escribe una expresión aritmética usando los códigos de los campos, por ejemplo
peso / (talla * talla)para el índice de masa corporal. - Debajo de la caja, el editor lista los códigos disponibles para que no haya que adivinarlos.
- Se admiten
+,-,*,/,%y paréntesis. - Decimales define con cuántas cifras se muestra el resultado.
Si la fórmula está mal escrita o alguno de los campos que menciona no tiene un valor numérico, el campo simplemente queda sin resultado: no bloquea el formato ni muestra un error técnico. Verifícala siempre con Vista previa.
Vista previa
El botón Vista previa abre el formato como lo verá el profesional: los campos reales, con sus anchos, sus validaciones y sus cálculos funcionando.
Es la única forma de confirmar cómo quedó antes de ponerlo en circulación. Úsala siempre antes de guardar por última vez.
Guardar
Guardar manda al servidor los datos generales y el árbol completo de campos. Al terminar aparece el mensaje Registro clínico guardado y el lienzo se recarga con lo que quedó almacenado.
Si dos campos quedaron con el mismo código, el sistema los diferencia agregando un sufijo numérico al guardar. Aun así conviene revisar los códigos, porque son los que se usan en las fórmulas.
Recomendaciones
- Empieza por la estructura. Coloca primero los Grupos / Secciones y después arrastra los campos adentro. Reorganizar al final es mucho más trabajoso.
- Guarda seguido. El editor no guarda solo, y un formato largo representa mucho trabajo acumulado en el navegador.
- Usa el ancho para agrupar visualmente lo que va junto. Presión sistólica y diastólica en 6 / 12 cada una se leen como un par; en 12 / 12 parecen dos preguntas sin relación.
- Marca como obligatorio solo lo que realmente lo es. Cada campo obligatorio de más es una atención que no se puede cerrar.
- Nombra los códigos antes de escribir fórmulas. Si después renombras un código, la fórmula que lo mencionaba deja de calcular.
Así se ve la pantalla
Dirección en el sistema:
/administracion/registros-clinicos/<id>/builder