Enviar Acción PostMessage
La acción Enviar PostMessage envía un mensaje desde tu experimento en ejecución de Labvanced a un objetivo externo, como una página web madre, una aplicación personalizada o un marco embebido, utilizando la API postMessage del navegador.
Tabla de Contenidos
Descripción general
Esta acción está listada bajo Acciones de API en el menú de selección de acciones.
Casos de uso comunes
- Notificar a una aplicación madre (por ejemplo, un LMS o portal institucional) cuando un participante alcanza un cierto punto o completa una tarea.
- Pasar un valor de variable, como una puntuación, una respuesta o una etiqueta de condición, a un sistema externo en tiempo real.
La Configuración Bidireccional
Usar postMessage entre Labvanced y una página externa (como un iFrame o una aplicación madre) es un proceso bidireccional. Labvanced maneja un lado: esta acción envía el mensaje. El otro lado es la página externa, que debe estar programada para recibirlo.
La API postMessage es una característica estándar del navegador. La página externa necesita un oyente window.addEventListener('message', handler) para recoger mensajes de Labvanced. Ese oyente también debe filtrar por dominio, verificando que el origen del mensaje sea Labvanced, para que solo actúe sobre mensajes de una fuente confiable. Tú o tu desarrollador deberán escribir ese código. Una herramienta de codificación de IA puede ayudar a generarlo rápidamente si es necesario.
Cómo funciona
Cuando se activa esta acción, Labvanced envía un postMessage a la ventana de destino. El mensaje se entrega a cualquier página en el Dominio de Destino que esté escuchando con un window.addEventListener('message', handler).
El contenido del mensaje incluye el Valor a enviar. Si se establece una Clave, se incluye en el contenido para que el receptor pueda identificar el tipo de mensaje y manejarlo en consecuencia.
La página externa es responsable de procesar el mensaje. Su oyente debe verificar el origen del mensaje antes de actuar sobre él, para asegurarse de que solo responda a mensajes enviados desde Labvanced.
Al seleccionar Enviar PostMessage, aparecerá la siguiente configuración:
Opciones de Acción
| Elemento del Menú | Opciones de Acción Enviar PostMessage |
|---|---|
Dominio de Destino | Especifica el origen objetivo que debería recibir el mensaje. El valor predeterminado es *, que envía a cualquier origen. Sustituye * por la URL completa del destino (por ejemplo, https://tusitio.com) cuando se conozca el destino. Se recomienda especificar el dominio exacto por razones de seguridad. |
Clave | Adjunta una clave identificadora al mensaje saliente. Esto estructura el contenido del mensaje como Clave: valor, que el receptor puede usar para distinguir diferentes tipos de mensajes. Déjalo vacío si no se necesita una clave. |
Valor a enviar | Define los datos que se incluirán en el mensaje saliente. Haz clic en el ícono de edición para abrir el Menú de Selección de Valor y especificar qué enviar: un valor constante, una variable de Labvanced o una expresión. |
Nota: El sistema que recibe el mensaje (la página madre o aplicación externa) debe implementar un oyente window.addEventListener('message', ...) para manejar el postMessage entrante de Labvanced.
Lectura Adicional y Materiales Abiertos
- Activador de PostMessage Recibido: el activador emparejado para escuchar los postMessages entrantes de fuentes externas.
- Menú de Selección de Valor: cómo definir qué valor enviar utilizando variables, constantes o expresiones.
- Extensión de Puente Web de Labvanced: contexto sobre cómo se utiliza postMessage para la comunicación con sitios web externos embebidos.
- Descripción General de Eventos: una introducción completa al sistema de lógica de activador y acción en Labvanced.