Envoyer l'action PostMessage
L'action Envoyer PostMessage envoie un message de votre expérience Labvanced en cours à une cible externe, telle qu'une page web parente, une application personnalisée ou un cadre intégré, en utilisant l'API postMessage du navigateur.
Table des matières
Aperçu
Cette action est répertoriée sous Actions API dans le menu de sélection des actions.
Cas d'utilisation courants
- Notifier une application parente (par exemple, un LMS ou un portail institutionnel) lorsqu'un participant atteint un certain point ou termine une tâche.
- Transmettre une valeur de variable, comme un score, une réponse ou un label de condition, à un système externe en temps réel.
La configuration à deux côtés
L'utilisation de postMessage entre Labvanced et une page externe (comme un iFrame ou une application parente) est un processus à deux côtés. Labvanced gère un côté : cette action envoie le message. L'autre côté est la page externe, qui doit être programmée pour le recevoir.
L'API postMessage est une fonctionnalité standard des navigateurs. La page externe a besoin d'un écouteur window.addEventListener('message', handler) pour recevoir les messages de Labvanced. Cet écouteur doit également filtrer par domaine, vérifiant que l'origine du message est Labvanced, afin qu'il n'agisse que sur les messages d'une source de confiance. Vous ou votre développeur devrez écrire ce code. Un outil de codage AI peut aider à le générer rapidement si nécessaire.
Comment ça marche
Lorsque cette action se déclenche, Labvanced envoie un postMessage à la fenêtre cible. Le message est livré à toute page au Domaine de Destination qui écoute avec un window.addEventListener('message', handler).
La charge utile du message contient la Valeur à envoyer. Si une Clé est définie, elle est incluse dans la charge utile afin que le destinataire puisse identifier le type de message et le traiter en conséquence.
La page externe est responsable du traitement du message. Son écouteur doit vérifier l'origine du message avant d'agir, pour s'assurer qu'il ne répond qu'aux messages envoyés depuis Labvanced.
Après avoir sélectionné Envoyer PostMessage, la configuration suivante apparaîtra :
Options de l'action
| Article du menu | Options de l'action Envoyer PostMessage |
|---|---|
Domaine de Destination | Spécifie l'origine cible qui doit recevoir le message. La valeur par défaut est *, ce qui envoie à n'importe quelle origine. Remplacez * par l'URL complète de la cible (par exemple, https://yoursite.com) lorsque la destination est connue. Il est recommandé de spécifier le domaine exact pour des raisons de sécurité. |
Clé | Attribue une clé d'identification au message sortant. Cela structure la charge utile du message comme Clé: valeur, que le destinataire peut utiliser pour distinguer les différents types de messages. Laissez vide si aucune clé n'est nécessaire. |
Valeur à envoyer | Définit les données à inclure dans le message sortant. Cliquez sur l'icône de modification pour ouvrir le menu de sélection de valeur et spécifier quoi envoyer : une valeur constante, une variable Labvanced ou une expression. |
Note : Le système recevant le message (la page parente ou l'application externe) doit implémenter un écouteur window.addEventListener('message', ...) pour gérer le postMessage entrant de Labvanced.
Lectures complémentaires et matériaux ouverts
- Déclencheur PostMessage Reçu: le déclencheur associé pour écouter les postMessages entrants de sources externes.
- Menu de sélection de valeur: comment définir quelle valeur envoyer à l'aide de variables, de constantes ou d'expressions.
- Extension Web Bridge de Labvanced: contexte sur la façon dont postMessage est utilisé pour la communication avec des sites externes intégrés.
- Aperçu des événements: une introduction complète au système de logique de déclencheur et d'action dans Labvanced.