La Définition de la Collecte de Données sur l'Hygiène des Mains (HDBP0025)

Explanation of DCD specifications

The above Data Collection Definition (DCD) specifications are published in an MS Excel file using a slightly modified XLSForm format. XLSForm is a form standard created to simplify the creation of forms. The creation is done in a human readable format. XLSForms are a convenient standard for sharing and collaborating on form creation. For a detailed guide to the XLSForm standard, we refer you to https://xlsform.org/en/.

Each DCD Excel workbook has three worksheets: "settings", "survey" and "choices". Sometimes a project is composed of several DCDs. In this case, a "survey" worksheet is created for each DCD. The lists of values for all DCDs are listed in a single "choice" worksheet.

While not all survey and choice characteristics are used by healthdata.be to describe the data collection definitions, all standard XLSForm columns are present in the MS Excel file.

Note: healthdata.be itself does not use the XLSForm standard to create its DCD in its own applications (HD4DP, HD4Patient). The XLSForm standard (used by popular electronic data capture systems such as OpenClinica, LibreClinica, ODK,…) is chosen to describe the DCD only because it is a human readable format.

The "Survey" worksheet

This worksheet gives the general structure of the DCD and contains most of the content. It contains the complete list of variables and information on how they should appear in the form. Each row usually represents one variable.

The following columns are primarily used in the survey worksheet to describe DCD:

• type: Defines the type of question/variable
• name: Unique ID (name) of the question / variable
• label::[English]: Question / variable in English, appears on the screen
• label::[French]: Question / variable in French, appears on the screen
• label::[Dutch]: Question / variable in Dutch, appears on the screen
• label::[German]: Question / variable in German, appears on the screen
• hint::[English]: Hint or explanatory text for a question, in English
• hint::[French]: Hint or explanatory text for a question, in French
• hint::[Dutch]: Hint or explanatory text for a question, in Dutch
• hint::[German]: Hint or explanatory text for a question, in German
• constraint_javascript: Constraint on the allowed values for a response defined in javascript
• constraint_message::[English]: The message displayed to the user if the answer is not valid, in English
• constraint_message::[French]: The message displayed to the user if the answer is not valid, in French
• constraint_message::[Dutch]: The message displayed to the user if the answer is not valid, in Dutch
• constraint_message::[German]: The message displayed to the user if the answer is not valid, in German
• required: If a question or variable must be completed for the form to continue or be submitted
• relevant_javascript: Skip logic condition (the relevant condition that must be met for this question to be displayed)
• read_only: If a variable question/answer can be changed
• calculation
• repeat_count: Number of repetitions for a group of repetitions
• hidden: Hidden fields in the HD4DP application

The "Choices" worksheet

This worksheet is used to specify answer choices for multiple choice questions. Each row represents an answer choice. Answer choices with the same list name are considered part of a set of related choices and appear together for a question/variable. This also allows a choice set to be reused for multiple questions/variables (for example, yes/no questions).

The following columns are primarily used in the choices worksheet to describe the DCD:

• list_name: A unique name for each choice set
• name: ID (name or code) of the specific choice
• label::[English]: The choice label, in English, appears on the screen
• label::[French]: The choice label, in French, appears on the screen
• label::[Dutch]: The choice label, in Dutch, appears on the screen
• label::[German]: The choice label, in German, appears on the screen

The "Settings" worksheet

• form_title: Title displayed at beginning of form, in form list
• public_key: Key required for encrypted forms
• submission_url: Specific URL for uploading data
• default_language: If form uses multiple languages, this one sets which to use by default
• style: Separate questions groups into pages. Switch to a different theme.
• instance_name: Allows user to create a dynamic naming convention for each submitted instance
• status: status of the form: options are "final" and "draft"
• start_date: date start form in production
• end_date: date end form in production

Explication sur les spécifications DCD

Les spécifications de la Définition de la Collecte des Données (DCD) ci-dessus sont publiées dans un fichier MS Excel utilisant un format XLSForm légèrement modifié. XLSForm est une norme de formulaire créée pour simplifier la création de formulaires. La création se fait dans un format lisible par l’utilisateur. Les XLSForms constituent une norme pratique pour le partage et la collaboration en matière de création de formulaires. Pour un guide détaillé sur le standard XLSForm, nous vous renvoyons à https://xlsform.org/en/.

Chaque classeur Excel de la DCD comporte trois feuilles de calcul : « paramètres », « sondage » et « choix ». Parfois, un projet se compose de plusieurs DCDs. Dans ce cas, une feuille de calcul « sondage » est créée pour chaque DCD. Les listes de valeurs pour toutes les DCDs sont répertoriées dans une seule feuille de calcul « choix ».

Si toutes les caractéristiques des sondages et des choix ne sont pas utilisées par healthdata.be pour décrire les définitions de collecte de données, toutes les colonnes standard du XLSForm sont néanmoins présentes dans le fichier MS Excel.

Remarque : healthdata.be lui-même n'utilise pas la norme XLSForm pour créer ses DCDs dans ses propres applications (HD4DP, HD4Patient). Le standard XLSForm (utilisé par les systèmes populaires de capture électronique de données comme OpenClinica, LibreClinica, ODK,...) est uniquement choisi pour décrire la DCD parce que c'est un format lisible par l’utilisateur.

La feuille de calcul « Sondage »

Cette feuille de calcul donne la structure générale de la DCD et contient la majeure partie du contenu. Elle contient la liste complète des variables et des informations sur la manière dont elles doivent apparaître dans le formulaire. Chaque ligne représente généralement une variable.

Les colonnes suivantes sont principalement utilisées dans la feuille de calcul du sondage pour décrire la DCD :

• type : Définit le type de question/variable
• name : ID unique (nom) de la question / variable
• label::[English] : Question / variable en anglais, s'affiche à l'écran
• label::[French] : Question / variable en français, s'affiche à l'écran
• label::[Dutch] : Question / variable en néerlandais, s'affiche à l'écran
• label::[German] : Question / variable en allemand, s'affiche à l'écran
• hint::[English] : Indice ou texte explicative pour une question, en anglais
• hint::[French] : Indice ou texte explicative pour une question, en français
• hint::[Dutch] : Indice ou texte explicative pour une question, en néerlandais
• hint::[German] : Indice ou texte explicative pour une question, en allemand
• constraint_javascript : Contrainte sur les valeurs autorisées pour une réponse définie en javascript
• constraint_message::[English] : Le message affiché à l'utilisateur si la réponse n'est pas valide, en anglais
• constraint_message::[French] : Le message affiché à l'utilisateur si la réponse n'est pas valide, en français
• constraint_message::[Dutch] : Le message affiché à l'utilisateur si la réponse n'est pas valide, en néerlandais
• constraint_message::[German] : Le message affiché à l'utilisateur si la réponse n'est pas valide, en allemand
• required : Si une question ou une variable doit être remplie pour que le formulaire continue ou soit soumis
• relevant_javascript : Condition « Skip logic » (la condition pertinente qui doit être remplie pour que la présente question soit affichée)
• read_only : Si une question / réponse variable peut être modifiée
• calcul
• repeat_count : Nombre de répétitions pour un groupe de répétitions
• hidden: Champs cachés dans l'application HD4DP

La feuille de calcul « Choix »

Cette feuille de calcul est utilisée pour spécifier les choix de réponse pour les questions à choix multiples. Chaque ligne représente un choix de réponse. Les choix de réponse ayant le même nom de liste sont considérés comme faisant partie d'un ensemble de choix apparentés et apparaissent ensemble pour une question/variable. Cela permet également de réutiliser un ensemble de choix pour plusieurs questions/variables (par exemple, les questions oui/non).

Les colonnes suivantes sont principalement utilisées dans la feuille de calcul des choix pour décrire la DCD :

• list_name : Un nom unique pour chaque ensemble de choix
• name : ID (nom ou code) du choix spécifique
• label::[English] : L'étiquette de choix, en anglais, s'affiche à l'écran
• label::[French] : L'étiquette de choix, en français, s'affiche à l'écran
• label::[Dutch] : L'étiquette de choix, en néerlandais, s'affiche à l'écran
• label::[German] : L'étiquette de choix, en allemand, s'affiche à l'écran