Action Définir / Enregistrer une Variable

L'action Set / Record Variable écrit une valeur dans une variable au moment où l'événement qui la contient se déclenche. Elle se trouve dans la catégorie Variable Actions du système d'événements, et c'est l'action la plus courante dans Labvanced : presque toutes les mesures comportementales enregistrées et presque toutes les conditions déclenchées par des variables dans une étude passent par elle à un moment donné.

Aperçu

Une fois qu'une variable existe, Set / Record Variable est la façon dont elle obtient réellement une valeur : un temps de réaction, le choix d'un participant, un score en cours, une paire de coordonnées provenant d'un mouvement de souris. Sans cela, une variable reste à sa valeur de départ pendant toute l'étude.

Cas d'Utilisation Courants

Set / Record Variable apparaît dans presque chaque catégorie d'étude, des tâches simples de pression de bouton aux enregistrements physiologiques complets.

• Enregistrer une mesure comportementale : enregistrer un temps de réaction, un score de précision, ou une réponse tapée dans une variable pour qu'elle apparaisse dans les données exportées.
• Construire un compteur : incrémenter une variable de 1 chaque fois qu'un déclencheur est activé, pour compter les essais complétés, les erreurs commises, ou les clics de bouton.
• Capturer des valeurs spécifiques à un déclencheur : écrire des valeurs fournies par un déclencheur, telles que les coordonnées X/Y de la souris ou une position de regard, directement dans une variable.
• Conduire une logique conditionnelle : définir une variable qu'un Requirement Action ultérieur vérifie pour décider quelle branche de l'étude s'exécute ensuite.

Connaissances Préalables Requises

Avant de plonger dans cette action, il est recommandé de comprendre les fonctionnalités de base de la création de variables et de leurs propriétés, comme décrit dans ces pages :

Comment Ça Fonctionne

Pour accéder à Set / Record Variable, ouvrez le Système d'Événements dans l'éditeur de tâches et créez un nouvel événement. Sous Add Action → Variable Actions, sélectionnez Set / Record Variable.

Une simple boîte de dialogue apparaît avec deux parties, lues comme une équation :

C'est toute l'action : choisissez une variable, définissez sa nouvelle valeur, terminé. La boîte de dialogue montre également une ligne fixe, "Les enregistrements auront lieu à la fin de l'essai" : la valeur de la variable s'actualise immédiatement pour le client lorsque l'action s'exécute, mais cette valeur n'est envoyée au serveur et enregistrée qu'à la fin de l'essai, pas à chaque changement individuel.

Un scénario pratique : construire un compteur. Il n'y a pas de variable "compteur" spéciale intégrée dans Labvanced, toute variable peut agir comme un compteur. Créez une variable numérique avec le nom qui convient à votre étude (par exemple trial_count ou error_count), puis utilisez l'option Arithmetic du Menu de Sélection de Valeurs pour définir la nouvelle valeur de cette variable à elle-même plus un, chaque fois que le déclencheur pertinent se déclenche. C'est le même mécanisme derrière les compteurs d'essai, les compteurs d'erreurs, et les compteurs de clics dans les tâches Labvanced, donc il est important de comprendre comment une telle configuration fonctionne afin de saisir les capacités derrière cette action.

Dans certains cas, lors de la création de votre tâche, vous pourriez être invité par une boîte de dialogue à accepter que des événements soient créés automatiquement pour capturer certains types de données, comme le suivi oculaire. Accepter cela construit à la fois le déclencheur et une action Set / Record Variable pour vous, déjà configurée, exactement la même action et boîte de dialogue abordées ci-dessus.

Conseils de Workflow

• Planifiez vos variables avant de construire : avant de commencer à construire, assurez-vous de connaître toutes les données que vous devez capturer dans votre étude, et ayez une idée générale des variables qui devront être créées pour stocker ces données. Set / Record Variable est l'endroit où ce plan est exécuté, donc le décider à l'avance évite de restructurer les événements en cours de construction.
• Réutilisez une action similaire plutôt que de la reconstruire : si vous avez déjà une action Set / Record Variable similaire sous le même déclencheur ou ailleurs dans l'étude, utilisez Copy to Clipboard et collez-la où nécessaire, puis éditez légèrement la variable cible ou la valeur, plutôt que de passer par Select et le Menu de Sélection de Valeurs à nouveau depuis le début.
• Groupez les actions qui vont ensemble : si plusieurs actions Set / Record Variable vont généralement ensemble, planifiez votre design d'événement autour d'un Action Group qui les héberge. Déplacer ou copier l'ensemble du groupe plus tard est plus rapide que de gérer chaque action individuellement.
• Vérifiez d'abord pour la Configuration Automatique des Événements : dans certains cas, comme le suivi oculaire, la détection des émotions, ou le rythme cardiaque, Labvanced peut proposer de construire le déclencheur et son action Set / Record Variable pour vous. Vérifiez si ce dialogue est disponible avant de configurer la même chose manuellement.

Études et Scénarios d'Exemples

Deux exemples réels provenant de tâches Labvanced publiées, l'une marquant une seule réponse et l'autre enregistrant un mouvement continu.

Marquer la précision dans la Tâche Flanker

Dans la tâche Main_task_desktop_Flanker de la Tâche Flanker, le Cadre 3 (Response Window), un Requirement Action à l'intérieur de l'événement Response Recording & Progression vérifie si la touche pressée correspond à la direction cible. Lorsque c'est le cas, Set / Record Variable définit la variable accuracy à 1.

Enregistrer les données de trajectoire de la souris

La configuration de suivi de souris de la Web Bridge utilise Set / Record Variable pour écrire la valeur spécifique à un déclencheur Mouse [Name, Info, X, Y] Array dans une variable à chaque mouvement de souris. Elle définit le Format sur Array, le Type d'Enregistrement sur Time series, et la méthode d'Échantillonnage sur record all (allow repeated duplicates), donc chaque mouvement est capturé plutôt que juste le dernier.

Lectures Complémentaires et Matériaux Ouverts

Système d'Événements

La référence complète pour chaque déclencheur et action dans Labvanced.

Menu de Sélection de Valeurs

Comment définir des constantes, des variables, des valeurs spécifiques à un déclencheur, et des expressions comme valeur assignée par cette action.

Action de Requirement (Si... Alors... Sinon Si)

Le bloc de logique conditionnelle qui déclenche le plus souvent Définir / Enregistrer une Variable à l'intérieur de ses branches Alors et Sinon.

Création de Variables

Comment créer une variable et définir son type de données, son format, et ses options d'enregistrement avant ou pendant l'utilisation de cette action.