Tabulaattorilla erotellun arvon kyselyrakenne
From LimeSurvey Manual
Kyselyn rakenteen tuonti ja vienti tabulaattorilla erotettuina arvoina
Tämän ominaisuuden avulla kyselyiden laatiminen ja muokkaaminen on helppoa taulukkolaskentaohjelmalla, kuten LibreOfficella, Excelillä tai Google Docsilla. Se poistaa täysin riippuvuuden kysymysten SGQA-koodeista.
Ominaisuus tukee ASCII- tai UTF-8-koodattujen tabulaattorilla erotettujen arvojen (TSV) tiedostojen tuontia. Tiedostojen tunnisteen tulee olla .txt.
Aloittaminen
Helpoin tapa on ottaa olemassa oleva kysely ja viedä se tabulaattorilla erotettujen arvojen muodossa. Käytä tavallista kyselyn vientipainiketta ja valitse .lss-muodon sijaan "Tab Separated Values format (*.txt)". Kysely tallennetaan tabulaattorilla erotettujen arvojen tiedostona oikeassa muodossa (tabulaattorilla erotettu Unicode-tiedosto) kaikkine oikeine sarakeotsikoineen.
Mikä tahansa tabulaattorilla erotettuja arvoja tukeva taulukkolaskentaohjelma kelpaa (esim. OpenOffice tai LibreOffice). LimeSurvey ohittaa taulukon kaiken muotoilun, mutta voit lisätä muotoilua, jos siitä on sinulle apua.
Jokaista ryhmää, kysymystä, alikysymystä ja vastausta kohden on yksi rivi. Lisäksi on rivit kyselyn yleisille muuttujille ja kielikohtaisille kyselymuuttujille. Ensisijainen kieli luetellaan ensin ja sen jälkeen mahdolliset muut kielet. Jos kieliä on useita, kantakielen koko sisältö (esim. kaikki ryhmät, kysymykset, alikysymykset ja vastaukset) näkyy siis ensin. Tämän jälkeen tulee käännetty kopio jokaista toissijaista kieltä varten (käännetyssä joukossa rivejä on täsmälleen yhtä monta ja ne ovat samassa järjestyksessä).
Suhteet päätellään rivien läheisyyden perusteella. Ryhmän jälkeen tulevat kysymykset kuuluvat kyseiseen ryhmään, kysymyksen jälkeen tulevat alikysymykset kuuluvat kyseiseen kysymykseen ja kysymyksen jälkeen tulevat vastaukset kuuluvat kyseiseen kysymykseen. Siksi sinun ei tarvitse tietää minkään kysymyksen tunnisteita (gid, qid, sqid). Ne lasketaan automaattisesti tuonnin yhteydessä. Itse asiassa tämä muoto ei käytä lainkaan gid-, qid- tai sqid-tunnisteita (eikä SGQA-koodeja).
Vinkkejä
Tabulaattorilla erotettujen arvojen tuonnin ja viennin tavoitteena on antaa sinun suunnitella kyselysi nopeasti taulukkolaskentaohjelmalla. Oletamme, että tuot taulukon usein, tarkistat sen kelvollisuuden "Show Survey Logic" -toiminnolla ja testaat sen. Jokaisella tuontikerralla saat uuden kyselyn. Näin sinulle voi kertyä monta keskeneräistä kyselyä, mutta se ei haittaa. Muista vain pitää kirjaa siitä, mikä on uusin, tai poista vanha kysely uuden tuomisen jälkeen. Koska tabulaattorilla erotetuissa arvoissa ei koskaan käytetä SGQA-koodeja, sinun ei tarvitse huolehtia siitä, mitä koodeja LimeSurvey antaa kyselyn, ryhmän, kysymyksen ja vastauksen pääavaimille. Voit siis tuoda ja viedä niin usein kuin haluat.
Tässä muutamia käteviä asioita, joita voit tehdä tällä tavalla kyselyitä laatiessasi:
- Käytä samoja vastauksia useille kysymyksille. Kopioi vain 'A'-rivit ja liitä ne jokaisen sellaisen kysymyksen perään, jolla pitäisi olla sama joukko.
- Käytä samoja alikysymyksiä useille kysymyksille. Kopioi vain 'SQ'-rivit ja liitä ne jokaisen sellaisen kysymyksen perään, joka tarvitsee ne.
- "Silmukointi" - käytä samaa ryhmää monta kertaa. Kun ryhmä on haluamallasi tavalla, kopioi se niin monta kertaa kuin tarvitaan. Käytä Excelin suodatusta näyttääksesi vain 'G'-rivit (ryhmät) ja käytä Excelin sarakkeen vetotoimintoa päivittääksesi kunkin ryhmän relevanssiyhtälöt (esim. väestölaskennassa ensimmäinen relevanssi voisi olla "numPeople > 1", seuraavan tulisi olla "numPeople > 2". Vetotoiminto päivittää numeron automaattisesti). Suodata 'Q'-rivit ja varmista, että jokaisella kysymyksellä on yksilöllinen arvo (esim. jos nimeät muuttujasi g1_q1, g1_q2, g1_qN, käytä etsi/korvaa-toimintoa muuttaaksesi g1 muotoon g2 toisessa ryhmässä, g3 kolmannessa jne.).
- Kysymysten/ryhmien järjestyksen muuttaminen. Muuta vain taulukkotiedoston rivien järjestystä.
- Kyselymoduulien testaus. Pitkissä kyselyissä testaus kannattaa ehkä jakaa moduuleihin. Luo kullekin moduulille uusi taulukkotiedosto ja poista tarpeettomat rivit. Näin vältät suuren tietomäärän syöttämisen kyselyn myöhempien osien testaamiseksi.
- Pakollisten kysymysten testaus. Yleinen valitus ei ole tarve tehdä monesta kysymyksestä pakollisia, vaan tarve poistaa pakollisuus käytöstä testauksen ajaksi. Luo pääkopio taulukosta niin, että pakollisuus on asetettu lopullisiin arvoihin. Testataksesi sitä poista "mandatory"-sarake ja tallenna taulukon testiversio. Kun tuot tämän version, mikään kysymys ei ole pakollinen. Kun testaus on valmis, tuo pääkopio.
- Oletusarvojen asettaminen. Graafisen käyttöliittymän sijaan voit syöttää haluamasi oletusarvot default-sarakkeeseen. Tämä on erityisen hyödyllistä silloin, kun graafinen käyttöliittymä ei salli haluamasi arvon syöttämistä, kuten lausekkeet listavaihtoehtojen oletusarvon asettamiseksi (esim. listan täyttäminen osallistujan attribuutista).
- Kääntäminen. Voit luoda taulukostasi kopioita - yhden kieltä kohden. Sisällytä kaikki ensisijaisen kielen rivit, kopioi ja liitä ne alapuolelle ja muuta vetämällä kielikenttä kohdekieleksi. Nämä voidaan jakaa kääntäjille ja yhdistää takaisin yhdeksi taulukkotiedostoksi, kun ne ovat valmiita.
- Kysymysten lisäattribuuttien massa-asetus. Saatat haluta, että kaikki yhtälösi ovat aluksi näkyvissä (jotta näet niiden arvot tietoja kerätessäsi), mutta piilottaa ne kaikki ennen tuotantokäyttöä. Suodata taulukko ehdolla class = 'Q' ja kysymyksen tyyppi = '*' (yhtälö) ja aseta always_hide arvoon 1 jokaiselle näistä kysymyksistä. Vastaavasti, jos kyselyn luomisen jälkeen päätät, mitkä kysymykset näkyvät julkisissa tilastoissa, suodata ehdolla class = 'Q' ja aseta public_statistics = 1 kaikille kysymyksille, joiden tulee näkyä tilastoissa, sen sijaan että muokkaisit jokaista kysymystä graafisessa käyttöliittymässä.
- Etsi ja korvaa. Jos päätät muuttaa sanamuotoja kaikissa kysymyksissäsi, voit tehdä muutokset Excelin etsi ja korvaa -toiminnolla. Samoin, jos päätät nimetä muuttujasi massana uudelleen, etsi ja korvaa auttaa. Jos tarvitset säännöllisiin lausekkeisiin perustuvaa etsi ja korvaa -toimintoa, voit valita haluamasi sarakkeen, kopioida sen tekstieditoriin, tehdä etsi ja korvaa -toiminnon ja liittää sarakkeen takaisin taulukkoon.
- Hyväksyntöjen hankkiminen. Jos teet tutkimusta, eettinen toimikunta saattaa vaatia kysymysten tekstien näkemistä. Tämä voi olla kätevä tapa jakaa ne. Sama koskee asiakkaan kanssa käytäviä keskusteluja.
- Tiimin yhteisymmärrys. Jos yrität saada ryhmän sopimaan kysymyksen tai ryhmän sanamuodosta tai ulkoasusta, voit luoda prototyypin / muokata taulukkoa nopeasti, tuoda sen ja näyttää tiimille (kysymyksen tai ryhmän esikatselun avulla) täsmälleen, mitä käyttäjät näkevät. Näin saat tiimin hyväksynnän jo ennen kuin he poistuvat huoneesta sen sijaan, että vaatimukset pitäisi dokumentoida, toteuttaa ja hyväksyttää myöhemmissä kokouksissa.
- Päivitys muista kyselymuodoista. Jos kyselysi on XML-, Word- tai muussa muodossa, voit luoda muunnosprosessin, joka kuvaa ne tähän muotoon. Vaikka voisit yrittää kuvausta myös .lss-muotoon, tämän muodon etu on, ettei sinun tarvitse seurata ryhmien, kysymysten, alikysymysten, vastausten ja oletusarvojen välisiä viiteavainsuhteita.
Rajoitukset
- Suunnittelun mukaisesti tämä ominaisuus toimii oikein vain kyselyissä, jotka käyttävät qcode-nimeämistä (SGQA:n sijaan). Ominaisuus olettaa, että muuttujien nimet (kysymysten tunnisteet) ovat yksilöllisiä koko kyselyssä. Alikysymysten nimiä voi toistaa, kunhan ne ovat yksilöllisiä tietyn kysymyksen sisällä.
Tiedostomuoto
Yleistä
Käytämme samoja sarakeotsikoita useisiin tarkoituksiin. Ensimmäiset 14 saraketta palvelevat eri tarkoituksia kohteen tyypin mukaan (esim. ryhmä, kysymys, vastaus). Loput sarakkeet ovat aakkosjärjestyksessä oleva luettelo kysymysten lisäattribuuttien tietokantakenttien nimistä. Alla on kunkin kohdetyypin syntaksi
Ensimmäiset 14 saraketta ovat:
- id (New in 3.14.0 )
- related_id (New in 3.14.0 )
- class
- type/scale
- name
- relevance
- text
- help
- language
- validation
- mandatory
- other
- default
- same_default
Kyselyn yleiset parametrit
Surveys-taulussa on yksi rivi parametria kohden.
- class => 'S'
- name => tietokantakentän nimi
- text => arvo
Kyselyn kielikohtaiset parametrit
Surveys_languagesettings-taulussa on yksi rivi kenttää ja kieltä kohden. Kaikki tietyn kielen merkinnät kerätään ennen niiden lisäämistä kyseiseen tauluun.
- class => 'SL'
- name => tietokantakentän nimi
- text => arvo
- language => kieli
Ryhmät
Yksi ryhmärivi kyselykieltä kohden (esim. jos kyselyssä on 3 kieltä, ryhmärivejä on 3).
- id => ryhmän yksilöllinen numeerinen tunniste, alkaen numerosta 1; käytä samaa tunnistetta saman ryhmän muille kielille
- class => 'G'
- name => group_name -- ryhmän yksilöllinen tunniste
- relevance => grelevance -- ryhmätason relevanssiyhtälö ilman aaltosulkeita
- text => description -- ryhmän kielikohtainen kuvaus
- language => language -- ryhmän kieli (esim. 'en')
Kysymykset
Yksi kysymysrivi kyselykieltä kohden (esim. jos kyselyssä on 3 kieltä, kysymysrivejä on 3). Kysymysten oletetaan kuuluvan niitä edeltävään ryhmään.
- id => kysymyksen yksilöllinen numeerinen tunniste, alkaen numerosta 1; käytä samaa tunnistetta saman kysymyksen muille kielille
- class => 'Q'
- type/scale => type -- (yleensä yhden kirjaimen) kysymystyyppi (esim. 'M' on monivalinta)
- name => title -- kysymyksen yksilöllinen nimi (qcode-nimeämisjärjestelmän juuri)
- relevance => relevance -- kysymyksen relevanssiyhtälö
- text => question -- kysymyksen kielikohtainen teksti
- help => help -- kielikohtainen ohjeteksti
- language => language -- ryhmän kieli (esim. 'en')
- validation => preg -- kysymyksen valinnainen säännöllisen lausekkeen validointiehto
- mandatory => mandatory -- 'Y', jos pakollinen
- other => other -- 'Y', jos "Muu"-vaihtoehdon tulisi olla käytettävissä (vain joillekin kysymystyypeille)
- default => default -- jos asetettu, tämä arvo lisätään tämän kysymyksen defaultvalues-tauluun
- same_default => same_default -- 'Y' tarkoittaa tosi, jolloin ensisijaiselle kielelle asetettu oletusarvo koskee myös muita kieliä
Alikysymykset
Yksi alikysymysrivi kyselyn kieltä kohti. Alikysymysten oletetaan kuuluvan niitä edeltävään kysymykseen.
- id => sama yksilöllinen numeerinen tunniste, jota käytetään kysymyksille. Alikysymysten tulee käyttää seuraavaa vapaata arvoa, ja kysymysten ja alikysymysten tunnisteiden tulee olla erilaiset (esim. käytä tunnusta 1 kysymykselle ja tunnuksia 2, 3 ja 4 kysymykseen 1 kuuluville alikysymyksille, seuraavan kysymyksen tunnus on 5 jne.). Käytä samaa alikysymyksen tunnusta saman alikysymyksen muille kielille.
- class => 'SQ'
- type/scale => scale_id -- 0 tai 1 kysymystyypin mukaan (esim. taulukkotekstillä on kaksi asteikkoa)
- name => title -- alikysymyksen "nimi", esim. exclude_all_others-asetuksessa käytettävä nimi
- relevance => relevance -- (Tulevaisuudessa) alikysymystason relevanssin tukemiseksi
- text => question -- alikysymyksen kielikohtainen teksti
- help => help -- (Tulevaisuudessa) alikysymystason ohjeen tukemiseksi
- language => language -- alikysymyksen kieli
- validation => preg -- (Tulevaisuudessa) alikysymystason säännöllisen lausekkeen validoinnin tukemiseksi (esim. osoitteen osille)
- mandatory => mandatory -- (Tulevaisuudessa) alikysymystason pakollisuuden tukemiseksi (esim. vain muutama alikysymys pakolliseksi)
- default => default -- jos asetettu, tämä on alikysymyksen oletusarvo (lisätään defaultvalues-tauluun)
- same_default => same_default -- jos asetettu, ensisijaisen kielen oletusarvoa käytetään kaikille muille kielille
Vastaukset
Yksi vastausrivi kyselyn kieltä kohti (esim. jos kyselyssä on 3 kieltä, vastausrivejä on 3). Vastausten oletetaan kuuluvan niitä edeltävään kysymykseen ja olevan halutussa luokittelujärjestyksessä.
- id => käytä samaa tunnusta kuin sillä kysymyksellä, johon vastaus kuuluu
- class => 'A'
- type/scale => scale_id -- 0 tai 1 (esim. kaksoisasteikolle)
- name => code -- yksilöllinen vastauksen tunniste
- relevance => assessment_value -- jos käytetään arviointivaihtoehtoa, tämä on vastauksen arviointiarvo
- text => answer -- vastauksen kielikohtainen teksti
- language => language -- vastauksen kieli (esim. 'en')
Arvioinnit
Yksi arviointirivi kyselyn kieltä kohti (esim. jos kyselyssä on 3 kieltä, arviointirivejä on 3). Arvioinnit kirjoitetaan tiedoston loppuun.
- id => arvioinnin yksilöllinen numeerinen tunniste, alkaen numerosta 1, käytä samaa tunnusta saman arvioinnin muille kielille
- related_id => sen ryhmän tunnus, johon kyseinen arviointi kuuluu
- class => 'AS'
- type/scale => arvioinnin laajuus: T-Total (yhteensä), G-group (ryhmä)
- name => name
- text => message
- min_num_value => Minimum
- max_num_value => Maximum
- language => language -- vastauksen kieli (esim. 'en')
Kiintiöt
Yksi rivi kiintiötä kohti. Kiintiöt kirjoitetaan tiedoston loppuun.
- id => kiintiön yksilöllinen numeerinen tunniste, alkaen numerosta 1
- class => 'QTA'
- name => kiintiön nimi
- mandatory => limit
- other => kiintiön toimenpide
- default => active
- same_default => automaattisesti ladattava URL
Kiintiökieliasetus
Yksi kiintiörivi kyselyn kieltä kohti. Kiintiön kieliasetusten oletetaan kuuluvan niitä edeltävään kiintiöön.
- id => kiintiön kieliasetusten yksilöllinen numeerinen tunniste, alkaen numerosta 1. Kunkin kyselykielen rivillä tulee olla eri tunnus
- related_id => sen kiintiön tunnus, johon tämä asetus kuuluu
- class => 'QTALS'
- relevance => message
- text => URL
- help => URL-osoitteen kuvaus
- language => language -- kiintiön kieli (esim. 'en')
Kiintiön jäsenet
Yksi rivi kiintiön jäsentä kohti, ei kieliriippuvainen. Kiintiön jäsenen rivi tulee sijoittaa heti sen kysymyksen jälkeen, johon se liittyy. Kiintiön jäsenten oletetaan kuuluvan niitä edeltävään kysymykseen.
- id => kiintiön jäsenen yksilöllinen numeerinen tunniste, alkaen numerosta 1
- related_id => sen kiintiön tunnus, johon tämä jäsen kuuluu
- class => 'QTAM'
- name => vastauskoodi
Ehdot
Yksi rivi ehtoa kohti, ei kieliriippuvainen. Ehtorivi tulee sijoittaa heti sen kysymyksen jälkeen, johon se liittyy. Ehtojen oletetaan kuuluvan niitä edeltävään kysymykseen.
- id => ehdon yksilöllinen numeerinen tunniste, alkaen numerosta 1.
- related_id => liittyvän kysymyksen tunnus, jos sovellettavissa
- class => 'C'
- type/scale => skenaario
- name => vastauskentän nimi
- relevance => vertailuoperaattori
- text => odotettu vastaus