Moduly pro opakované využití

Pro opakované využívání je možné využívat moduly. Může jít o opakované použití v rámci jednoho dotazníku nebo v různých dotaznících. Typické scénáře mohou zahrnovat:

  1. Máte v rámci dotazníku stejnou sadu otázek, ale používáte ji v jiném kontextu. Příklad použití je napři v dotazníku FAST Elemementary Parent Post. Ptáme se na 9 různých aktivit v projektu pomocí stejné sady otázek - tj. jak byla aktivita srozumitelná, přínosná, zajímavá a jakou nám chtějí nechat zpětnou vazbu. Sadu otázek včetně hodnot máme v modulu a ten načteme v rámci jednoho dotazníku 9x. Tento scénář je popsán dále v použitých příkladech
  2. Máte standardizovaný nástroj - například Škála vnímaného stresu (PSSS), který chcete používat v různých výzkumech. Než abyste dotazník opakovaně kopírovali do dalších a dalších výzkumů, použijete jej jako modul.

Definice modulů

V adresáři questionnaires je podadresář modules. Moduly mají tento formát:

{
  "questions": [
    {
      "type": "wrapper",
      "name" : "activity_feedback",
      "items": [
        {
          "type": "question_table",
          "name": "params",
          "text": "Tato aktivita pro mě byla:",
          "values": {
            "1": "1 - Vůbec",
            "2": "2",
            "3": "3",
            "4": "4",
            "5": "5",
            "6": "6",
            "7": "7",
            "8": "8",
            "9": "9",
            "10": "10 - Maximálně"
          },
          "questions": [
            {
              "name": "understandable",
              "text": "Srozumitelná – bylo snadné pochopit, co máme dělat"
            },
            {
              "name": "interesting",
              "text": "Zajímavá – aktivita nás bavila, bylo příjemné ji dělat"
            },
            {
              "name": "helpful",
              "text": "Přínosná  -dozvěděl/a jsem se něco nového nebo jsem se něco nového naučil/a"
            }
          ]

        },
        {
          "type": "text_value",
          "name": "text",
          "text": "Chcete nám k této aktivitě ještě něco sdělit? Prosím napište nám to.",
          "rows": 4,
          "optional": true
        }
      ]
    }
  ]
}

Musí zde být obsažená položka questions. V jejím poli se potom nachází jedna nebo více otázek. Pokud je otázek více, tak při vložení do dotazníku musíme specifikovat, kterou otázku z dotazníku chceme využít pomoci direktivy section.

Dále zde vidíme použitý objekt Wrapper, který zajistí, že se budou všechny otázky vkládat dohromady. Ve wrapperu potom máme jednu tabulku a jednu otázku s volným textem.

Vložení modulu do výzkumu

Moduly se vkládají pomocí direktivy "type": "import":

    {
      "type": "import",
      "source": "FAST/activity_feedback"
      "name": "feedback_lottery",
    }

Direktiva source určuje odkud se modul načítá. Výchozí bod je adresář modules, zde je použitý jeho podadresář FAST (obsahuje moduly pro použití v Programu FAST).

Důležitá je direktiva name. Ta určuje, jaký prefix se vloží před název proměnné. Díky ní je možné použít modul ve výzkumu opakovaně, takže výsledné proměnné se budou jmenovat odlišně. Výsledné proměnné v tomto případě se budou jmenovat:

  • feedback_lottery_params_understandable
  • feedback_lottery_params_interesting
  • feedback_lottery_params_helpful
  • feedback_lottery_text

Logika složeného názvu:

  • feedback_lottery - je vložená v direktivě import
  • params - společná předpona tabulky
  • understandable, interesting, helpful - názvy řádků v tabulkách

Pokud potom použijeme další import, například v této podobě:

    {
      "type": "import",
      "source": "FAST/activity_feedback"
      "name": "feedback_family_group",
    }

Tak dostaneme následující proměnné:

  • feedback_family_group_params_understandable
  • feedback_family_group_params_interesting
  • feedback_family_group_params_helpful
  • feedback_family_group_text
Naposledy upraveno 29.11.2021: Module documentation (1bfc450)