Autorizace respondentů do dotazníku

Dotazníky mají různé potřeby, jak registrovat a popřípadě autorizovat respondenty. Proto systém podporu 4 autorizační mechanismy. Tyto mechanismy se primárně vztahují na respondenty, kteří přicházejí sami na stránky Dotazníků. Nově už funkcionalitu autorizačních mechanismů částečně přebírají Zprostředkovatelé (brokeři)

Typ autorizace je specifikován parametrem authorizer v top level konfiguraci dotazníku.

Implicitní autorizace

{
  "authorizer": "self_register_authorizer"
}

SelfRegisterAuthorizer je nejjednoduší autorizační mechanismus. Nový respondent, který začne vyplňovat dotazník, obdrží unikátní kód. Respondent není žádným způsobem kontrolován. Pokud tentýž respondent přijde znovu, tak dostane nový kód a není možné zkontrolovat, jestli náhodou už dotazník nevyplnil dříve.

Autorizace předem distribuovaným kódem

{
  "authorizer": "predefined_code_authorizer",
  "authorizer_config": {
    "code_file_name": "oxytocin-access-codes.csv"
  }
}

Při zahájení dotazníku systém po respondentovi požaduje kód, který mu byl předán předem. Toto scháma bylo použito například při odběru slin, kdy kód by na zkumavce a následně se stejným kódem potom respondent vypňoval dotazník. Každý kód lze použít právě jednou.

code_file_name je název souboru, ve který jsu uloženy kódy, jeden kód na řádek. Příklad použitých kódů:

SWIG
RNUF
REPY
DFWZ
TGQG
OWJZ
MIWY
AUTM

Autorizace předem distribuovaným kódem nebo implicitní autorizace

{
  "authorizer": "optional_predefined_code_authorizer",
  "authorizer_config": {
    "code_file_name": "oxytocin-access-codes.csv"
  }
}

Funguje jako oba výše uvedené mechanismy dohromady. Respondent je vyzván, aby zadal kód. Pokud ho zadá, tak se kód zkontroluje a pokud odpovídá a ještě nebyl použit, tak je respondent zaregistrován. Dále ale může respondent vstoupit bez kódu a potom je mu přidělen nový unikátní kód.

Znovupoužití kód po již vyplněném dotazníku

{
  "authorizer": "reuse_code_authorizer",
  "parent_research_id": 16
}

Pokud už respondent už dříve vyplnil jiný dotazník, tak na konci se mu může zobrazit jeho kód s poznámkou, aby si ho uložil. A potom s tímto kódem respondent vstoupí do nového dotazníku, čímž je zajištěno párování respondentů napříč dotazníky (retesty a podobně).

parent_research_id označuje id (číselný identifikátor) předchozího dotazníku. Tady je syntaxe poněkud nekonzistentní, protože paramer není uzavřen v bloku authorizer_config.