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. Solo ofrece los servicios habilitados para tu institución. |
| Sexo | Lista con Ambos, Masculino o Femenino. |
| Edad mín / Edad máx | Rango de edad del paciente. |
| Activo | Casilla de estado. |
| Bloque RIPS | Casilla. Agrega al final del formulario la sección RIPS (consulta, modalidad, finalidad, causa externa y diagnósticos), que escribe sus datos en la atención. Ver Visor de atención. |
| Tiempo para editar | Lista (también está en la ficha, como Tiempo para editar). Ver más abajo. |
| 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. |
Propiedades generales del formato
Tiempo para editar define hasta cuándo el profesional puede corregir un registro después de guardarlo:
| Opción | Significado |
|---|---|
| Sin límite (mientras la atención esté abierta) | Se puede editar mientras la atención siga abierta. |
| No editable | Una vez guardado, solo admite adendas. |
| 15 minutos, 30 minutos, 1 hora, 2 horas, 4 horas, 8 horas, 12 horas, 24 horas, 48 horas | Se puede editar hasta ese tiempo después de creado el registro. |
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 |
| Estructura | Grupo / Sección, Título, Texto informativo, Separador |
| Componentes clínicos | Diagnóstico CIE, Tabla, Odontograma, Gráfica, y los bloques ya armados Signos vitales, RIPS y SOAP |
| 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. |
Condiciones, rangos y codificación
Según el tipo de campo, el panel muestra además:
| Propiedad | Descripción |
|---|---|
| Mostrar si | Condición para que el campo aparezca, escrita con los códigos de otros campos y variables del paciente, por ejemplo sexo == "F" && edad >= 10. Un campo con esta condición no puede ser obligatorio fijo. |
| Obligatorio si | Condición que vuelve obligatorio el campo, por ejemplo motivo == 'otro'. |
| Rangos de interpretación | Lista de rangos con Mín, Máx, Etiqueta y Nivel (Normal, Leve, Moderado, Alto o Crítico). Se agregan con Agregar rango. En un campo calculado, la casilla Mostrar la etiqueta del rango en lugar del número hace que el formulario muestre, por ejemplo, Sobrepeso en vez del valor del IMC. |
| Codificación | Sistema, Código y Unidad de una terminología estándar para el campo. El sistema y el código van en pareja. |
El editor avisa si los paréntesis de una condición no cierran.
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.
Componentes clínicos
| Componente | Propiedades |
|---|---|
| Tabla | Columnas (cada una con Código, Etiqueta, Tipo, Unidad, Ancho y la casilla Obligatoria; se agregan con Agregar columna; la tabla necesita al menos una), Permitir agregar filas y Totales de columnas para las columnas numéricas. |
| Odontograma | Dentición (Permanente, Temporal o Mixta) y la casilla Registrar placa bacteriana. |
| Gráfica | Tipo de gráfica (curvas OMS de peso, talla, IMC y perímetro cefálico para la edad, peso para la talla, Atalah IMC gestacional, Partograma o Tendencia) y los campos del formato que alimentan la gráfica (Tabla de origen, Columna del eje X y Columnas del eje Y en las gráficas de tendencia). |
| Campo calculado | Además de la fórmula, el Formato del resultado: Número o Fecha. |
Cómo se ven y se usan estos componentes al atender: Campos especiales de los registros.
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. La vista previa no usa un paciente simulado: trabaja con los datos que escribas en ella.
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