The Hand Hygiene Data Collection Definition (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

Uitleg over DCD-specificaties

Bovenstaande specificaties voor datacollectiedefinitie (Data Collection Definition - DCD) worden gepubliceerd in een MS Excel-bestand met gebruikmaking van een licht gewijzigd XLSForm-formaat. XLSForm is een formulierstandaard die is ontwikkeld om het opstellen van formulieren te vereenvoudigen. De opmaak geschiedt in een door de mens leesbaar formaat. XLSForms biedt een praktische standaard voor het delen van en samenwerken aan de auteur van formulieren. Voor een gedetailleerde handleiding voor de XLSForm-standaard verwijzen wij naar https://xlsform.org/en/rg/en/.

Elke DCD Excel-werkmap heeft drie werkbladen: "instellingen", "enquête" en "keuzes". Soms bestaat een project uit meerdere DCD's. In dat geval wordt voor elk DCD een werkblad "enquête" aangemaakt. De lijsten met waarden voor alle DCD's worden opgenomen in een enkel "keuzes" werkblad.

Hoewel niet alle enquête- en keuzemogelijkheden door healthdata.be worden gebruikt om de Gegevensverzamelingsdefinities te beschrijven, zijn alle standaard XLSForm-kolommen toch aanwezig in het MS Excel-bestand.

Opmerking: healthdata.be zelf gebruikt de XLSForm-standaard niet om zijn DCD's in zijn eigen toepassingen (HD4DP, HD4Patient) te creëren. De XLSForm standaard (gebruikt door populaire Electronical Data Capturing systemen zoals OpenClinica, LibreClinica, ODK, ...) is enkel gekozen om het DCD te beschrijven omdat het een menselijk leesbaar formaat is.

Het enquêtewerkblad

Dit werkblad geeft de algemene structuur van het DCD en bevat het grootste deel van de inhoud. Het bevat de volledige lijst van variabelen en informatie over hoe zij in het formulier moeten verschijnen. Elke rij vertegenwoordigt gewoonlijk één variabele.

De volgende kolommen worden hoofdzakelijk in het enquête-werkblad gebruikt om het DCD te beschrijven:

• type: Stelt het type vraag/variabele in
• name: Unieke ID (naam) van de vraag/variabele
• label::[English]: Vraag/variabele in het Engels, wordt weergegeven op het scherm
• label::[French]: Vraag/variabele in het Frans, wordt weergegeven op het scherm label::[Dutch]: Vraag/variabele in het Nederlands, wordt weergegeven op het scherm
• label::[German]: Vraag/variabele in het Duits, wordt weergegeven op het scherm
• hint::[English]: Hint of helptekst voor een vraag, in het Engels
• hint::[French]: Hint of helptekst voor een vraag, in het Frans
• hint::[Dutch]: Hint of helptekst voor een vraag, in het Nederlands
• hint::[German]: Hint of helptekst voor een vraag, in het Duits
• constraint_javascript: Beperking op de toegestane waarden voor een antwoord gedefinieerd in javascript
• constraint_message::[English]: Het bericht dat een gebruiker te zien krijgt als het antwoord niet geldig was, in het Engels
• constraint_message::[French]: Het bericht dat een gebruiker te zien krijgt als het antwoord niet geldig was, in het Frans
• constraint_message::[Dutch]: Het bericht dat een gebruiker te zien krijgt als het antwoord niet geldig was, in het Nederlands
• constraint_message::[German]: Het bericht dat een gebruiker te zien krijgt als het antwoord niet geldig was, in het Duits
• required: Of een vraag/variabele moet worden beantwoord om verder te kunnen gaan/het formulier in te dienen
• relevant_javascript: “Skip logic” voorwaarde (de relevante voorwaarde waaraan moet worden voldaan om de onderhavige vraag te kunnen weergeven)
• read_only: Of een vraag/variabel antwoord kan worden bewerkt
• berekening
• repeat_count: Aantal herhalingen voor een herhalingsgroep
• hidden: Velden verborgen in de HD4DP applicatie

Het keuzenwerkblad

Dit werkblad wordt gebruikt om de antwoordkeuzen voor meerkeuzevragen op te geven. Elke rij vertegenwoordigt een antwoordkeuze. Antwoordkeuzen met dezelfde lijstnaam worden beschouwd als deel van een verwante set keuzen en zullen samen verschijnen voor een vraag/variabele. Dit maakt het ook mogelijk een set keuzen te hergebruiken voor meerdere vragen/variabelen (bijvoorbeeld ja/nee-vragen).

De volgende kolommen worden hoofdzakelijk gebruikt in het keuzewerkblad om de DCD te beschrijven:

• list_name: Een unieke naam voor elke reeks keuzes
• name: ID (naam of code) van de specifieke keuze
• label::[English]: Keuze label in het Engels, zal worden weergegeven op het scherm
• label::[French]: Keuze label in het Frans, zal worden weergegeven op het scherm
• label::[Dutch]: Keuze label in het Nederlands, zal worden weergegeven op het scherm
• label::[German]: Keuze label in het Duits, zal worden weergegeven op het scherm

Het instellingenwerkblad

...