Variables

Resumen

Las variables en NueForm te permiten crear experiencias de formularios dinámicas y personalizadas. Puedes referenciar respuestas de encuestados, parámetros de URL y variables de formulario personalizadas en cualquier lugar de los títulos de tus preguntas, descripciones, pantallas de bienvenida y pantallas de agradecimiento usando la sintaxis de sustitución {variableName}.

Tipos de Variables

NueForm soporta tres tipos de variables:

1. Variables de Respuesta

Las variables de respuesta capturan la respuesta de un encuestado a una pregunta específica y la hacen disponible para uso en preguntas posteriores.

Cómo configurar:

1. Selecciona una pregunta en el constructor de formularios.
2. En los ajustes de la pregunta, encuentra el campo Answer Variable.
3. Ingresa un nombre de variable (por ejemplo, name, company, rating).
4. La respuesta del encuestado a esa pregunta ahora se almacena como {name}, {company} o {rating}.

Ejemplo:

• Pregunta 1: "¿Cuál es tu nombre?" (Answer Variable: name)
• Título de Pregunta 2: "¡Encantado de conocerte, {name}! ¿Qué te trae aquí hoy?"

Cuando el encuestado escribe "Sarah" en la Pregunta 1, la Pregunta 2 mostrará: "¡Encantado de conocerte, Sarah! ¿Qué te trae aquí hoy?"

Conversión de valores:

2. Variables de URL

Las variables de URL son valores pasados al formulario a través de parámetros de consulta de URL. Están disponibles inmediatamente cuando el formulario se carga, antes de que se responda cualquier pregunta.

Cómo usar:

Agrega parámetros de consulta a la URL de tu formulario:

https://nueform.io/f/my-form?firstName=John&company=Acme&source=email

Estos parámetros están disponibles automáticamente como variables:

• {firstName} se resuelve a "John"
• {company} se resuelve a "Acme"
• {source} se resuelve a "email"

Casos de uso:

• Prellenar campos de formulario con datos conocidos.
• Personalizar saludos: "Hola {firstName}, tenemos algunas preguntas para ti."
• Rastrear fuentes de referencia en tus datos de respuesta.
• Enrutar encuestados usando saltos lógicos de inicio basados en parámetros de URL.

3. Variables de Formulario

Las variables de formulario son variables predefinidas con un nombre, tipo y valor predeterminado. Se definen a nivel de formulario y pueden ser modificadas por acciones de variable en saltos lógicos.

Cómo definir:

Las variables de formulario se definen en las definiciones de variables del formulario y tienen las siguientes propiedades:

Cómo se modifican:

Las variables de formulario se modifican a través de acciones de variable en saltos lógicos. Cuando la condición de un salto lógico coincide, sus acciones de variable asociadas se ejecutan:

Ejemplo: Construir una calculadora de puntuación

1. Define una variable de formulario: score (tipo: number, predeterminado: 0).
2. En cada pregunta, agrega saltos lógicos con acciones de variable:
   • Si Rating >= 4, sumar 10 a score.
   • Si Rating >= 2, sumar 5 a score.
3. En la pantalla de agradecimiento: "Tu puntuación es {score} de 50."

Sintaxis de Sustitución

La sintaxis {variableName} funciona en las siguientes ubicaciones:

Cómo Funciona la Sustitución

1. El sistema escanea el texto buscando patrones {variableName} (llaves simples con caracteres de palabra dentro).
2. Busca el nombre de la variable en el mapa de variables actual.
3. Si se encuentra, el token se reemplaza con el valor de la variable.
4. Si no se encuentra, el token se reemplaza con un string vacío.

Detección de Variables

NueForm detecta automáticamente todas las variables referenciadas en tu formulario escaneando:

• Tokens {variableName} en todos los campos de texto (títulos, descripciones, pantallas de bienvenida/agradecimiento).
• Campos con prefijo url: en condiciones de saltos lógicos.
• Nombres de variables en acciones de saltos lógicos.
• Declaraciones answerVariable en preguntas.
• Definiciones de variables a nivel de formulario.

Este escaneo exhaustivo produce una lista ordenada y deduplicada de todos los nombres de variables usados en tu formulario.

Orden de Resolución de Variables

Al resolver un token {variableName}, NueForm verifica las variables en este orden:

1. Variables de URL -- pasadas a través de la URL del formulario.
2. Variables de respuesta -- establecidas por las respuestas del encuestado a preguntas con answerVariable configurado.
3. Variables de formulario -- definidas a nivel de formulario y modificadas por acciones de saltos lógicos.

Si el mismo nombre de variable existe en múltiples fuentes, las variables de URL tienen precedencia (ya que son la fuente pasada a la función de sustitución junto con las variables de formulario/respuesta combinadas).

Ejemplos

Bienvenida Personalizada

URL: https://nueform.io/f/feedback?name=Sarah&product=Widget

Título de Bienvenida: "¡Hola {name}!" Descripción de Bienvenida: "Nos encantaría escuchar tus opiniones sobre {product}."

Resultado: "¡Hola Sarah!" / "Nos encantaría escuchar tus opiniones sobre Widget."

Preguntas de Seguimiento Dinámicas

Pregunta 1: "¿Cuál es tu rol?" (Answer Variable: role) Pregunta 2: "Como {role}, ¿cuál es tu mayor desafío?"

Visualización de Puntuación Calculada

Variable de Formulario: score (number, predeterminado: 0) Acciones de Salto Lógico: Sumar puntos basados en respuestas Descripción de Agradecimiento: "¡Obtuviste {score} puntos! Gracias por completar el cuestionario."

Enrutamiento Condicional con Variables de URL

URL: https://nueform.io/f/survey?plan=enterprise

Salto Lógico de Inicio:

• Condición: url:plan es igual a "enterprise"
• Destino: Saltar a preguntas específicas de enterprise
• Acción: Establecer plan_name a "Enterprise"

Mejores Prácticas

1. Usa nombres descriptivos: Elige nombres de variables que indiquen claramente lo que almacenan (por ejemplo, customer_name en lugar de n).
2. Establece valores predeterminados: Para variables de formulario, siempre proporciona un valor predeterminado significativo en caso de que la variable nunca se modifique.
3. Prueba con parámetros de URL: Cuando uses variables de URL, prueba tu formulario con varias combinaciones de parámetros para asegurar que todas las rutas funcionen correctamente.
4. Maneja variables faltantes con elegancia: Si una variable de URL podría no proporcionarse, diseña tu texto para que se lea de forma natural incluso cuando la variable se resuelve a un string vacío.