Form Builder — Formulario de IDT
Los documentos IDT tienen un schema de formulario que define los campos que el técnico completa al ejecutar el protocolo en el CTR. Esta página explica cómo configurarlo.
El schema solo se puede editar en Borrador. Una vez que el documento pasa a En revisión, el schema queda congelado. Al efectivizar, el sistema genera un template.docx con los campos anclados que se usa para la ejecución del protocolo en CTR.
¿Qué es el Form Builder?
Cuando un técnico ejecuta un protocolo IDT en el CTR, necesita completar datos específicos del procedimiento: resultados de medición, identificación de equipos, parámetros del ensayo, etc. El Form Builder es la herramienta que permite al equipo de Calidad definir exactamente qué campos aparecen en ese formulario y dónde se encuentran en el DOCX fuente.
El schema construido en el Form Builder se convierte en el "esqueleto" del protocolo que el técnico ve al ejecutar el informe en CTR. Cada campo en el schema corresponde a una celda específica en el DOCX (definida por la ancla DOCX).
Flujo de trabajo típico
Subí el archivo desde la pestaña Documento. El sistema intenta parsear automáticamente las tablas del DOCX para precargar los campos.
El panel de validación muestra si encontró tablas sin clasificar o campos preloaded sin mapeo ITS Lab. Atendé las advertencias antes de continuar.
Verificá que el schema refleja correctamente la estructura del protocolo. Podés agregar secciones, agregar o editar campos, reordenarlos con drag & drop.
El botón naranja guarda y verifica el schema. Si hay errores los señala. Si todo está OK, el schema queda listo para la efectivización.
Secciones
El formulario se organiza en secciones. Cada sección agrupa campos relacionados y tiene:
- Título — nombre descriptivo de la sección (ej: "Datos del equipo", "Resultados de medición")
- Instrucción — texto opcional que orienta al técnico sobre qué completar en esta sección
Para agregar una sección: hacé clic en + Agregar sección. Para editarla: clic en el ícono de lápiz junto al nombre. Para reordenarlas: arrastrá por el handle de arrastre.
Campos y tipos disponibles
Cada sección contiene campos. Para agregar uno: hacé clic en + Agregar campo dentro de la sección.
| Tipo | Descripción | Uso típico |
|---|---|---|
text | Texto libre de una línea | Identificadores, nombres, observaciones breves |
number | Valor numérico | Resultados de medición, temperaturas, masas |
date | Fecha | Fecha de ensayo, fecha de preparación |
textarea | Texto largo multilínea | Observaciones extendidas, descripción de anomalías |
select | Selección de una opción de una lista fija | Resultado pasa/no pasa, tipo de muestra |
equipment | Selector de equipo del inventario ITS Lab | Identificación del instrumento usado |
standard | Selector de estándar del catálogo ITS Lab | Estándar de calibración utilizado |
solvent | Selector de solvente del catálogo ITS Lab | Solvente o reactivo utilizado |
Los tipos equipment, standard y solvent se precargan con los datos de ITS Lab cuando el técnico abre el protocolo en CTR, si el bundle tiene una orden de trabajo vinculada.
La ancla DOCX (_docx_anchor)
Cada campo del schema tiene una ancla DOCX que indica en qué celda del archivo Word está el dato correspondiente. El sistema usa esta información para generar el template.docx con bookmarks que el CTR completa al ejecutar el protocolo.
La ancla se define por tres valores:
| Atributo | Descripción |
|---|---|
table_index | Número de tabla en el DOCX (0 = primera tabla, 1 = segunda, etc.) |
row_index | Número de fila dentro de esa tabla (0 = primera fila) |
col_index | Número de columna (0 = primera columna) |
Si un campo no tiene ancla DOCX configurada, se omite silenciosamente al generar el template.docx. Verificá que todos los campos que deben completarse tienen su ancla correctamente definida antes de efectivizar.
El parser automático intenta detectar las anclas al subir el DOCX. Si el resultado no es correcto, podés editar los valores manualmente haciendo clic en el ícono de lápiz del campo y modificando los valores de tabla/fila/columna.
Campo ITS Lab (its_lab_field)
Para los campos de tipo equipment, standard y solvent, el atributo its_lab_field define qué dato específico de ITS Lab se mapea a ese campo. Por ejemplo, equipment.serial_number precarga el número de serie del equipo.
| Valor | Dato que precarga |
|---|---|
equipment.brand | Marca del equipo |
equipment.model | Modelo del equipo |
equipment.serial_number | Número de serie |
equipment.internal_id | ID interno del laboratorio |
equipment.location | Ubicación del equipo |
work_order.number | Número de orden de trabajo ITS Lab |
Botón "Verificar schema"
El botón naranja ✓ Verificar schema hace tres cosas simultáneamente:
- Guarda el estado actual del schema en la base de datos
- Verifica que el schema es consistente (anclas válidas, sin campos duplicados, etc.)
- Reparsea el DOCX fuente si está disponible para detectar cambios
Usá el botón Verificar schema cada vez que hagas cambios significativos, incluyendo cuando el schema se ve correcto pero querés asegurarte antes de enviar el documento a revisión. El botón también funciona para IDTs sin campos (sections vacías).
Panel de validación
Debajo del Form Builder, el panel de validación muestra dos tipos de advertencias:
Tablas sin clasificar
El parser detectó tablas en el DOCX que no fueron asignadas a ninguna sección ni campo. Esto puede indicar que hay datos del protocolo que no están siendo capturados. Para cada tabla sin clasificar, el panel muestra una preview de las primeras filas. Opciones:
- Crear el campo manualmente usando + Agregar campo y asignando la ancla DOCX correspondiente
- Ignorar la tabla si contiene datos no relevantes para el protocolo (encabezados decorativos, tablas de firma, etc.)
Campos preloaded sin mapeo ITS Lab
Hay campos de tipo equipment/standard/solvent que no tienen el atributo its_lab_field configurado. Estos campos se mostrarán vacíos cuando el técnico abra el protocolo. Editá cada campo para asignar el mapeo correcto.
Preguntas frecuentes
No. El schema queda congelado cuando la versión sale del estado Borrador. Si necesitás modificarlo, el documento debe volver a Borrador (via rechazo de revisión o recall del autor) o debés crear una nueva versión.
El parser puede tener dificultades con celdas fusionadas o tablas anidadas. En esos casos, el panel de validación mostrará las tablas como "sin clasificar". Podés configurar las anclas manualmente ingresando los índices de tabla/fila/columna. Ante dudas, consultá al admin para verificar los índices correctos.
Sí para los datos estructurados del protocolo. El CTR también captura firma electrónica del técnico y verificador, pero esos no son campos del schema — son parte del flujo regulado del bundle CTR.
El template.docx es el DOCX fuente con bookmarks inyectados en cada celda anclada. Se genera automáticamente al efectivizar el documento. CTR usa este template para completar los datos del protocolo y generar el informe final. No es un archivo que el usuario edita directamente.