Tâche de consignes

Version : v1 (actuelle)

Une tâche d'affichage de contenu pour présenter aux participants des informations sur l'étude, des formulaires de consentement, des consignes ou du matériel pédagogique.

Vue d'ensemble

La tâche de consignes est un composant polyvalent de présentation de contenu qui affiche des informations en texte enrichi aux participants pendant une étude. Contrairement aux tâches comportementales qui mesurent les réponses, cette tâche présenté simplement du contenu et attend que le participant indique qu'il l'a lu et compris avant de poursuivre.

Cette tâche est essentielle pour :

• Introductions d'étude : Messages de bienvenue et aperçu de l'étude
• Consentement éclairé : Affichage des informations de consentement (bien que le consentement formel devrait utiliser des formulaires de consentement dédiés)
• Consignes de tâche : Instructions détaillées avant des tâches complexes
• Debriefing : Informations et explications post-étude
• Contenu pédagogique : Materiel d'enseignement dans les études d'intervention
• Écrans de pause : Periodes de repos entre les tâches exigeantes

La tâche prend en charge le formatage HTML enrichi (via l'éditeur Quill), les images, les vidéos et les liens externes, ce qui la rend adaptée aux besoins sophistiqués de présentation de contenu. Elle peut aussi, en option, collecter des fichiers téléversés par les participants.

Pourquoi les chercheurs utilisent cette tâche

1. Contrôle du déroulement de l'étude : Structurer l'étude avec des phases informationnelles
2. Préparation du participant : S'assurer que les participants comprennent ce qui va suivre
3. Standardisation : Délivrer des informations identiques a tous les participants
4. Documentation : Créer une trace d'audit de ce qui a été montré aux participants
5. Flexibilité : Presenter tout contenu nécessaire a la conception de l'étude
6. Collecte de fichiers : Recueillir en option des fichiers téléversés (documents, images, médias) auprès des participants

Paramètres de configuration

Paramètres de contenu

Paramètre	Type	Défaut	Description
main_instructions	string (HTML)	''	Contenu en texte enrichi a afficher (édité comme instructions_text dans le formulaire ; sérialisé sous main_instructions).
hint_instructions	string (HTML)	''	Texte d'indice optionnel.

Paramètres de téléversement de fichiers

Le téléversement de fichiers est désactivé par défaut. Lorsque file_upload_enabled vaut true, le runtime affiche une zone de glisser-déposer et les paramètres suivants s'appliquent.

Paramètre	Type	Défaut	Plage	Description
file_upload_enabled	boolean	false	—	Affiche la zone de téléversement.
file_upload_required	boolean	false	—	Bloque l'achèvement de la tâche tant qu'au moins un fichier n'a pas été téléversé.
file_upload_instructions	string (HTML)	''	—	Consignes en texte enrichi affichées au-dessus de la zone de téléversement.
max_files	number	5	1–50	Nombre maximum de fichiers.
max_file_size_mb	number	250	1–250	Taille maximale par fichier (Mo).
max_total_size_mb	number	1000	1–1000	Taille combinée maximale de tous les fichiers (Mo).
allowed_file_types	string[]	[] (tous)	—	Types MIME autorisés. La config propose des préréglages : Images (image/*), PDF (application/pdf), Documents (application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document), Vidéos (video/*), Audio (audio/*).

Données de sortie

Marqueurs et réponses

Marqueur (stimulus_shown) : émis une fois lorsque la page est affichée. Le temps de lecture est mesuré a partir de ce point. Aucun champ de données supplémentaire n'est attaché.

{
  "type": "stimulus_shown",
  "ts": "2024-01-01T00:00:00.000Z",
  "hr": 1234.56
}

Données de réponse (achèvement, enregistré pour chaque participant) :

{
  "event": "instructions_complete",
  "responded": true,
  "reading_time_ms": 13450,
  "files_uploaded": 0,
  "total_size_mb": 0,
  "files": []
}

Lorsque des fichiers ont été téléversés, files[] contient une entrée par fichier téléversé avec id, name, size (octets) et type.

Lorsque le téléversement de fichiers est activé, des réponses supplémentaires sont enregistrées pour chaque action sur les fichiers :

Fichier téléversé :

{
  "event": "file_uploaded",
  "file_id": "abc123",
  "file_name": "document.pdf",
  "file_size": 204800,
  "file_type": "application/pdf",
  "filename": "instructions_upload_0_abc123_document.pdf"
}

Fichier supprimé :

{
  "event": "file_removed",
  "file_id": "abc123",
  "file_name": "document.pdf"
}

Erreur de téléversement (les champs de contexte supplémentaires varient selon le code d'erreur) :

{
  "event": "file_upload_error",
  "error": "file_too_large",
  "file_name": "document.pdf",
  "file_size_mb": 312.5,
  "max_size_mb": 250
}

Codes d'erreur possibles : "max_files_exceeded", "file_too_large", "total_size_exceeded", "invalid_file_type", "upload_failed".

Artefact de synthèse

La tâche de consignes ne génère pas d'artefact de synthèse. Lorsque le téléversement de fichiers est activé, chaque fichier téléversé est émis comme artefact binaire (nom de fichier instructions_upload_{taskIndex}_{fileId}_{nomOriginal}), traité par la page de participation.

Exemples de cas d'utilisation

Écran d'accueil de l'étude

<h2>Welcome to the Cognitive Assessment Study</h2>
<p>Thank you for participating! This study will take approximately 30 minutes.</p>
<p>You will complete several brief cognitive tasks measuring attention, memory, and decision-making.</p>
<p>Please ensure you are in a quiet environment and will not be interrupted.</p>
<p>Click "Begin" when you are ready to start.</p>

Configuration :

{
  "main_instructions": "<h2>Welcome...</h2>..."
}

Consignes avec téléversement de fichier

Collecter un document ou un autre fichier auprès du participant avant qu'il ne continue.

{
  "main_instructions": "<h3>Téléversez votre formulaire de consentement</h3><p>Veuillez joindre le PDF signé avant de continuer.</p>",
  "file_upload_enabled": true,
  "file_upload_required": true,
  "file_upload_instructions": "<p>Glissez-déposez le fichier, ou cliquez pour parcourir.</p>",
  "max_files": 1,
  "allowed_file_types": ["application/pdf"]
}

Écran de debriefing

<h2>Study Complete - Thank You!</h2>
<p>The tasks you completed help researchers understand cognitive processing.</p>

<h3>What We Measured</h3>
<ul>
  <li><strong>Attention</strong>: Your ability to focus and filter distractions</li>
  <li><strong>Memory</strong>: How you encode and retrieve information</li>
  <li><strong>Processing Speed</strong>: How quickly you process information</li>
</ul>

<h3>Your Data</h3>
<p>Your responses are confidential and will only be used for research purposes...</p>

<p>If you have questions, please contact: researcher@university.edu</p>

Configuration :

{
  "main_instructions": "<h2>Study Complete...</h2>..."
}

Informations de consentement (a titre informatif uniquement)

<h2>Study Information</h2>
<p><strong>Purpose:</strong> This study investigates cognitive aging...</p>
<p><strong>Procedures:</strong> You will complete computerized tasks (30 min)...</p>
<p><strong>Risks:</strong> Minimal; possible eye strain or fatigue...</p>
<p><strong>Benefits:</strong> Contribute to aging research; receive summary of results...</p>
<p><strong>Confidentiality:</strong> Data stored securely, coded with ID numbers...</p>
<p><strong>Voluntary:</strong> You may withdraw at any time without penalty...</p>

<p><em>Note: By clicking "I Understand and Agree," you indicate you have read and understood this information.</em></p>

Configuration :

{
  "main_instructions": "<h2>Study Information...</h2>..."
}

Recommandations de conception

Conception du contenu

• Clarté : Utilisez un langage simple et direct
• Structure : Décomposez le contenu en sections avec des titres
• Longueur : Gardez le contenu concis ; répartissez les contenus longs sur des tâches consécutives
• Hiérarchie visuelle : Utilisez des titres, du gras et des listes pour faciliter la lecture rapide
• Accessibilité : Assurez un contraste suffisant et une taille de police lisible

Téléversement de fichiers

• Verrou obligatoire : Activez « téléversement requis » pour bloquer l'achèvement tant qu'un fichier n'est pas joint.
• Restrictions de type : Limitez allowed_file_types aux formats réellement nécessaires.
• Limites de taille : Définissez max_file_size_mb et max_total_size_mb de façon prudente pour éviter les téléversements volumineux.

Séquencement

• Flux logique : Pour les contenus longs, répartissez-les sur plusieurs tâches de consignes consécutives, du général vers le détail.
• Cohérence : Maintenez un formatage cohérent dans toute la séquence.

Problemes courants et solutions

Probleme	Solution
Contenu trop long pour l'écran	Répartissez sur plusieurs tâches de consignes consécutives ; assurez un design adaptatif
Les images ne se chargent pas	Utilisez des URL absolues ; vérifiez l'hébergement des images et les paramètres CORS
Formatage HTML casse	Utilisez l'éditeur Quill ; validez le HTML ; testez le rendu
Fichiers téléversés rejetés	Vérifiez allowed_file_types, max_file_size_mb et max_total_size_mb par rapport au fichier

Considerations de conformite

Consentement éclairé :

• La tâche de consignes peut AFFICHER les informations de consentement
• Cependant, le consentement formel devrait utiliser le système de formulaire de consentement dédié de l'étude
• Ne vous fiez pas uniquement a la tâche de consignes pour la documentation légale du consentement

Collecte des données :

• Les données de temps passé sur la page montrent l'engagement mais ne prouvent pas la compréhension
• Pour une compréhension critique, utilisez la tâche de questionnaire avec des vérifications de compréhension

Documentation :

• Les événements enregistrés fournissent une trace d'audit de ce qui a été montré et quand
• Le versionnage du contenu est important pour les études longitudinales

Références

Ceci est une tâche utilitaire sans littérature scientifique spécifique. Lignes directrices générales pour la conception de consignes :

• Sweller, J. (1988). Cognitive load during problem solving: Effects on learning. Cognitive Science, 12(2), 257-285. (Considerations de charge cognitive pour la conception de consignes)

• Nielsen, J. (1997). How users read on the web. Nielsen Norman Group. (Lisibilite du contenu web et patterns de lecture rapide)

Voir aussi

• Questionnaire - Pour collecter les réponses des participants et les vérifications de compréhension