3. Guía Completa del Entorno Survey Debug Sandbox
Manual operativo del entorno de depuración de encuestas: modo flujo completo, modo Single Sandbox, inspector de estado JSON en vivo y simulación de terminaciones.
Entorno de Pruebas y Depuración Aislada: El Survey Debug Sandbox (/survey/[id]/test) es el banco de pruebas interactivo que permite a investigadores y programadores verificar el renderizado de componentes, la lógica condicional y las reglas de terminación en un entorno seguro sin alterar los datos de producción ni consumir cuotas reales.
1. Acceso y Modos de Ejecución#
Se puede acceder al Debug Sandbox directamente desde la pestaña Details del panel Manage Survey (botón Open Survey Preview) o mediante la ruta directa:
https://su-dominio.com/survey/[id]/testEl panel lateral derecho del Sandbox ofrece dos modalidades de prueba:
| Modo de Prueba | Alcance Operativo | Cuándo Utilizarlo |
|---|---|---|
| Phased Flow (Flujo Completo) | Ejecuta el cuestionario completo en el orden real de las fases (Pre-screener → Screener → Survey), evaluando ramificaciones, piping y umbrales. | Para pruebas integrales de experiencia de usuario antes de publicar el estudio a panelistas. |
| Single Sandbox (Pregunta Aislada) | Aísla cualquier pregunta específica del cuestionario, permitiendo interactuar con ella sin haber respondido las preguntas anteriores. | Para depurar componentes complejos (matrices, comboboxes, dropdowns dinámicos) de forma instantánea. |
2. Características del Modo Single Sandbox#
Al seleccionar el tab Single Sandbox, el panel derecho activa herramientas de inspección atómica:
- Selector Desplegable de Preguntas: Menú con todas las preguntas del estudio identificadas por su ID, fase asignada y descripción inicial (ej.
S1 (screener): ¿Cuál es su especialidad...?). - Navegación Rápida (
← Previous/Next →): Permite avanzar o retroceder de forma secuencial entre preguntas sin rellenar formularios obligatorios. - Simulación de Terminaciones (Screenout Mocking):
- Si en modo Sandbox se selecciona una opción con regla de cierre (
[CLOSE]o[SOFT TERM]), el sistema muestra una notificación flotante de advertencia simulada en lugar de expulsar al operador:
🛑 Screen out / CLOSE validation triggered at S1 (Mocked in Sandbox Mode)Esto permite validar que las banderas de terminación funcionan correctamente sin perder la sesión de prueba.
3. Inspector de Estado en Vivo (Live Data State)#
En la parte inferior del panel lateral derecho se encuentra el visor reactivo de datos:
- Objeto JSON en Tiempo Real (
answers): - Muestra en vivo la estructura de datos que se va compilando conforme el usuario interactúa con los controles.
- Permite comprobar los tipos de datos almacenados (cadenas, números, arreglos de multicode o coordenadas de matrices).
- Botón Reset State (Reiniciar Estado):
- Limpia inmediatamente el objeto de respuestas en memoria y reinicia el flujo para realizar nuevas pruebas desde un estado en blanco sin tener que recargar el navegador.
4. Diferencias entre Modo Test y Modo Producción#
| Característica | Sandbox (/survey/[id]/test) | Producción (/survey/[id]) |
|---|---|---|
| Persistencia en BD | No guarda registros. Las respuestas viven únicamente en la memoria del navegador. | Persistencia completa en la base de datos de respuestas. |
| Balanceo de Cuotas | No consume cuotas. Permite probar caminos llenos sin bloquear el estudio. | Incrementa contadores de cuota en tiempo real. |
| Panel de Depuración | Visible lateralmente con selector de preguntas e inspector JSON. | Oculto. Interfaz limpia para el encuestado. |
| Retorno a Administración | Botón directo Back to Survey Management. | No disponible para el encuestado final. |
5. Preguntas y Respuestas (Q&A)#
¿El modo Single Sandbox respeta el piping de preguntas no respondidas?#
En modo Single Sandbox, si la pregunta evaluada utiliza piping dinámico (ej. [PIPE: S1]) y la pregunta fuente S1 aún no tiene respuesta en el inspector, el motor muestra un valor comodín seguro para permitir la interacción con el componente sin provocar errores de renderizado.
¿Puedo probar enlaces con parámetros de panel (ej. ?uid=test123) en el Sandbox?#
Sí. El Sandbox captura e inyecta los parámetros query string en el contexto de la sesión, mostrándolos en el inspector de estado en vivo para verificar que los identificadores de panelistas se pasen correctamente.
¿Te resultó útil este recurso?
Tus comentarios nos ayudan a mejorar la documentación continuamente.