> For the complete documentation index, see [llms.txt](https://docs.mensajerodigital.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mensajerodigital.app/evaluacion-de-respuestas-en-formularios-dinamicos.md).

# Evaluación de respuestas en Formularios Dinámicos

Con esta funcionalidad un formulario puede comportarse como un **examen o quiz** (calificar respuestas y aprobar/reprobar), o como una **validación** (verificar que la persona responda lo esperado). Opcionalmente, cada respuesta acertada suma puntaje y, al final, el sistema calcula un resultado.

### Conceptos clave

| Término                  | Significado                                                                       |
| ------------------------ | --------------------------------------------------------------------------------- |
| **Campo evaluable**      | Campo del formulario que tiene una respuesta correcta definida y suma al puntaje. |
| **Puntaje**              | Puntos que vale acertar un campo (por defecto 1).                                 |
| **Nota mínima**          | Porcentaje necesario para considerar el envío como **Aprobado**.                  |
| **Aprobado / Reprobado** | Resultado del envío según si alcanza o no la nota mínima.                         |

### 1. Configuración

La configuración la realiza quien **diseña** el formulario, en el editor de formularios. Tiene dos partes: marcar la respuesta correcta en cada campo y activar la evaluación a nivel del formulario.

#### 1.1. Marcar la respuesta correcta de un campo

Los tipos de campo que admiten respuesta correcta son:

* **Opción de Chequeo Único** (una sola respuesta correcta)
* **Lista de Selección** (una sola respuesta correcta)
* **Opción de Chequeo Múltiple** (una o varias respuestas correctas)
* **Número** (un número exacto esperado)

Pasos:

1. En el editor del formulario, ubique el campo y abra **Configurar campo** (ícono de engranaje).
2. Active la casilla **"Este campo tiene respuesta correcta (evaluable)"**.
3. Indique el **Puntaje** (puntos que vale acertar este campo).
4. Defina la respuesta correcta:
   * En campos de opciones, marque el chip **"Correcta"** en la(s) opción(es) que correspondan, en la columna **Correcta** de la lista de opciones.
   * En campos de **Número**, escriba el **Número correcto esperado**.

<figure><img src="/files/qyw7lc1eJWkh61pjNMsx" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Mientras no haya definido la respuesta correcta, el campo muestra el aviso: *"Aún no has definido la respuesta correcta de este campo."*
{% endhint %}

**Cómo se califica cada tipo**

* **Chequeo Único / Lista de Selección:** se acierta si la opción seleccionada es la marcada como correcta.
* **Chequeo Múltiple:** se acierta solo si la persona selecciona **exactamente** todas las opciones correctas y **ninguna** incorrecta (todo o nada).
* **Número:** se acierta si el número coincide exactamente con el valor esperado (acepta coma o punto como decimal).

#### 1.2. Activar la evaluación del formulario

En el editor, en el panel lateral, abra la sección **"Evaluación de respuestas"**.

1. Active **"Activar evaluación (calificar respuestas correctas)"**.
2. Configure las opciones:

| Opción                                              | Descripción                                           |
| --------------------------------------------------- | ----------------------------------------------------- |
| **Nota mínima para aprobar (%)**                    | Porcentaje mínimo para aprobar (ej. 60).              |
| **Cómo mostrar el puntaje**                         | **Porcentaje** (ej. 80%) o **Puntos** (ej. 8 de 10).  |
| **Mostrar el resultado al usuario al terminar**     | Si está activo, la persona ve su resultado al enviar. |
| **Mostrar al usuario cuáles acertó y cuáles falló** | Muestra la retroalimentación campo por campo.         |
| **Mensaje al aprobar / reprobar**                   | Textos opcionales que se muestran según el resultado. |

<figure><img src="/files/68jcY8uIqt6Ucxzf9TEY" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
El panel muestra un contador: *"Actualmente tienes N campo(s) evaluable(s)"*. Le ayuda a confirmar cuántos campos cuentan para la calificación.
{% endhint %}

3. **Guarde el formulario** para aplicar la configuración.

### 2. Uso: lo que ve quien diligencia el formulario

Cuando una persona diligencia y envía el formulario, si la evaluación está activa y se configuró **mostrar el resultado**, verá una tarjeta de resultado con:

* **Aprobado** o **No aprobado** (verde o rojo).
* El **puntaje** según la escala configurada (porcentaje o puntos).
* La cantidad de **respuestas correctas** sobre el total evaluado.
* El **mensaje** de aprobado/reprobado (si se configuró).
* Opcionalmente, la **retroalimentación** de cuáles respuestas acertó y cuáles falló.

<figure><img src="/files/no44NU7fobSekz240Y4B" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Si desactiva *"Mostrar el resultado al usuario al terminar"*, el puntaje **igual se calcula y se guarda** para los reportes, pero la persona no lo verá al enviar.
{% endhint %}

### 3. Visualización en los reportes

El puntaje y el resultado de cada envío quedan disponibles para consulta interna en tres lugares.

#### 3.1. Visor de registros del formulario

En **Formularios → (registros del formulario)**, la tabla de registros incluye dos columnas adicionales cuando el formulario tiene la evaluación activa:

* **Puntaje (%)** — el puntaje del envío.
* **Aprobado** — muestra *Aprobado* o *Reprobado*.

<figure><img src="/files/23IOZU3nKSJekshN9Npd" alt=""><figcaption></figcaption></figure>

#### 3.2. Detalle "Datos del Formulario"

Al abrir el detalle de un registro (**Mostrar datos del formulario**), cada campo evaluable muestra un indicador junto a su título:

* **Correcta** (verde) si la respuesta fue acertada.
* **Incorrecta** (roja) si no lo fue.

<figure><img src="/files/U4WRWbISupdPUnIIcqH1" alt=""><figcaption></figcaption></figure>

#### 3.3. Exportar a Excel

Al exportar los registros (incluido el reporte **"Formularios Diligenciados por Fecha"**), las columnas **Puntaje (%)** y **Aprobado** se incluyen en el archivo descargado.

### Preguntas frecuentes

**¿Qué campos cuentan para el puntaje?** Solo los campos marcados como evaluables y con respuesta correcta definida. El resto de campos del formulario no afectan la calificación.

**Diligencié un formulario y la columna Aprobado aparece vacía. ¿Por qué?** Los envíos realizados **antes** de activar la evaluación no tienen puntaje, por lo que esas filas aparecen vacías en las columnas de evaluación. Los envíos hechos con la evaluación activa sí muestran el resultado.

**¿Se puede evaluar un campo de texto libre?** No. La respuesta correcta solo se puede definir en campos de opciones (Chequeo Único, Lista de Selección, Chequeo Múltiple) y en campos de **Número**. El texto libre no se evalúa porque la comparación exacta es poco confiable.

**Activé la evaluación pero el resultado no se muestra al usuario.** Verifique que la opción *"Mostrar el resultado al usuario al terminar"* esté activada en el panel **Evaluación de respuestas** del formulario.