Keskeiset käsitteet
Yleiskatsaus lomakesuunnitteluun
Mikä on XLSForm?
rtSurvey käyttää laajennettua versiota XLSForm-standardista lomakesuunnitteluun, tarjoten tehokkaita ominaisuuksia kehittyneisiin kyselyihin. Tämä opas esittelee lomakesuunnittelun keskeiset käsitteet rtSurveyssa, XLSFormin perusrakenteesta edistyneisiin rtSurvey-kohtaisiin ominaisuuksiin.
XLSFormien avulla voit luoda lomakkeita ihmisluettavassa muodossa tutulla Excel-työkalulla, joten ne ovat lähes kaikkien käytettävissä. Tämä standardi mahdollistaa helpon jakamisen ja yhteistyön lomakkeiden laadinnassa.
Vaikka XLSFormit sopivat aloittelijoille, ne mahdollistavat myös monimutkaisten lomakkeiden luomisen kokeneemmille käyttäjille.
rtSurvey tarjoaa johdonmukaisen tavan sisällyttää edistyneitä toiminnallisuuksia, kuten ohitusehdot, lomakkeisiin eri verkko- ja mobiilitiedonkeruualustoilla.
XLSFormin rakenne
XLSForm koostuu tyypillisesti kahdesta päälaskentataulukosta:
- survey: Määrittelee lomakkeen rakenteen ja sisällön.
- choices: Määrittelee monivalintakysymysten vastausvaihtoehdot.
Valinnainen settings-laskentataulukko voi sisältää lisämääritelmiä.
On tärkeää huomata, että survey- ja choices-laskentataulukoiden pakkolliset sarakkeet on oltava olemassa, jotta lomake toimii oikein. Molempien taulukoiden valinnaiset sarakkeet antavat lisähallintaa jokaisen lomakemerkinnän toiminnalle, mutta ne eivät ole välttämättömiä.
Excel-työkirjasi sarakkeet voivat esiintyä missä järjestyksessä tahansa, ja valinnaiset sarakkeet voivat olla tyhjiä. On kuitenkin tärkeää käyttää XLSForm-dokumentaatiossa määriteltyä tarkkaa syntaksia ja nimeämiskäytäntöjä, jotta lomake toimii oikein.
Survey-laskentataulukko
Survey-laskentataulukko on paikka, jossa määritellään lomakkeen rakenne ja sisältö. Jokainen rivi survey-laskentataulukossa edustaa kysymystä tai elementtiä lomakkeessa. Seuraavat sarakkeet ovat pakollisia survey-laskentataulukossa:
type: Määrittää odotettavan merkintätyypin kysymykselle.name: Määrittää kyseisen merkinnän yksilöllisen muuttujannimen. Nimien on alettava kirjaimella tai alaviivalla ja voivat sisältää vain kirjaimia, numeroita, yhdysviivoja, alaviivoja ja pisteitä. Nimet ovat kirjainkokoherkkiä.label: Sisältää varsinaisen kysymystekstin, jonka vastaaja näkee lomakkeessa.
| type | name | label |
|---|---|---|
| today | today | |
| select_one gender | gender | Vastaajan sukupuoli? |
| integer | age | Vastaajan ikä? |
Choices-laskentataulukko
choices-laskentataulukkoa käytetään monivalintakysymysten vastausvaihtoehtojen määrittelemiseen. Jokainen rivi edustaa yhtä vastausvaihtoehtoa. Seuraavat sarakkeet ovat pakollisia choices-laskentataulukossa:
list_name: Ryhmittelee yhteen joukon toisiinsa liittyviä vastausvaihtoehtoja.name: Määrittää kyseisen vastausvaihtoehdon yksilöllisen muuttujannimen.label: Näyttää vastausvaihtoehdon täsmälleen sellaisena kuin haluat sen näkyvän lomakkeessa.
| list_name | name | label |
|---|---|---|
| gender | transgender | Transsukupuolinen |
| gender | female | Nainen |
| gender | male | Mies |
| gender | other | Muu |
Excel-työkirjaasi lisäämäsi sarakkeet, olivatpa ne pakollisia tai valinnaisia, voivat esiintyä missä järjestyksessä tahansa. Valinnaiset sarakkeet voidaan jättää kokonaan pois. Rivit tai sarakkeet voidaan jättää tyhjiksi luettavuuden parantamiseksi, mutta yli 20 peräkkäisen tyhjän sarakkeen tai rivin jälkeistä dataa ei käsitellä. Kaikki .xlsx-tiedoston muotoilu jätetään huomiotta, joten voit käyttää viivaajia, varjostusta ja muita fonttiformaatteja lomakkeen luettavuuden parantamiseksi.
Yksi muistettava asia lomakkeita Excelissä laadittaessa on, että käyttämäsi syntaksin on oltava tarkka. Esimerkiksi jos kirjoitat Choices tai choice choices:n sijaan, lomake ei toimi.
Settings-laskentataulukko
Settings-laskentataulukko on valinnainen, mutta antaa mahdollisuuden määritellä lomaketason metatietoja ja toimintoja. Yleisiä sarakkeita settings-laskentataulukossa ovat:
| Sarake | Kuvaus |
|---|---|
| form_title | Lomakkeen otsikko sellaisena kuin se näkyy käyttäjille |
| form_id | Lomakkeen yksilöllinen tunniste, käytetään tiedonhallinnassa ja API-kutsuissa |
| default_language | Monikielisten lomakkeiden oletuskielikoodi (esim. ‘fi’ suomelle) |
| version | Lomakkeen versionumero, hyödyllinen muutosten seurantaan |
| instance_name | Lauseke kunkin lomakelähetyksen yksilöllisen nimen luomiseksi |
| generation | Kokonaisluku, joka merkitsee lomakkeen sukupolvea. Kasvata rakenteellisten muutosten yhteydessä |
| family | Tunniste toisiinsa liittyvien lomakkeiden ryhmittelemiseksi rakenteellisten muutosten välillä |
rtSurveyn settings-laskentataulukko voi sisältää myös rtSurveyn laajennettuihin toiminnallisuuksiin liittyviä lisämäärittelyjä. Katso täydellinen luettelo tuetuista asetuksista rtSurvey-dokumentaatiosta.
Survey-laskentataulukon keskeiset komponentit
Survey-laskentataulukko on lomakesuunnittelun ydin. Tässä yleiskatsaus sen keskeisistä komponenteista:
| Komponentti | Kuvaus |
|---|---|
| type | Määrittää kysymystyypin (esim. text, integer, select_one) |
| name | Kysymyksen yksilöllinen tunniste |
| label | Vastaajalle näytettävä teksti |
| hint | Lisäohjeistus vastaajalle |
| appearance | Muuttaa kysymyksen näyttötapaa |
| relevant | Määrittää milloin kysymys esitetään (ohituslogiikka) |
| constraint | Validoi vastauksen |
| calculation | Laskee arvoja muiden vastausten perusteella |
| required | Määrittää onko kysymykseen vastaaminen pakollista |
Jokaisella näistä komponenteista on tärkeä rooli tehokkaiden kyselyjen luomisessa.
Kysymystyypit
XLSForm tukee useita kysymystyyppejä. Tässä joitakin vaihtoehdoista, joita voit syöttää type-sarakkeeseen XLSFormisi survey-laskentataulukossa:
| Kysymystyyppi | Syötetty vastaus |
|---|---|
| integer | Kokonaisluku (eli kokonainen numero). |
| decimal | Desimaaliluku. |
| range | Alue-syöte (mukaan lukien arviointi) |
| text | Vapaan tekstin vastaus. |
| select_one [options] | Monivalinta-kysymys; vain yksi vastaus voidaan valita. |
| select_multiple [options] | Monivalinta-kysymys; useita vastauksia voidaan valita. |
| select_one_from_file [file] | Monivalinta tiedostosta; vain yksi vastaus voidaan valita. |
| select_multiple_from_file [file] | Monivalinta tiedostosta; useita vastauksia voidaan valita. |
| rank [options] | Järjestys-kysymys; järjestä lista. |
| note | Näyttää huomautuksen näytöllä, ei vaadi syötettä. |
| geopoint | Kerää yksittäisen GPS-koordinaatin. |
| geotrace | Tallentaa linjan kahdesta tai useammasta GPS-koordinaatista. |
| geoshape | Tallentaa monikulmion useista GPS-koordinaateista; viimeinen piste on sama kuin ensimmäinen. |
| date | Päivämääräsyöte. |
| time | Aikasyöte. |
| dateTime | Hyväksyy päivämäärä- ja aikasyötteen. |
| image | Ota kuva tai lataa kuvatiedosto. |
| audio | Tee ääninauhoitus tai lataa äänitiedosto. |
| background-audio | Ääntä nauhoitetaan taustalla lomaketta täytettäessä. |
| video | Tee videonauhboitus tai lataa videotiedosto. |
| file | Yleinen tiedostosyöte (txt, pdf, xls, xlsx, doc, docx, rtf, zip) |
| barcode | Skannaa viivakoodi, vaatii viivakoodiskannerin asennuksen. |
| calculate | Suorita laskutoimitus; katso Laskenta-osio. |
| acknowledge | Vahvistuskehote, joka asettaa arvoksi “OK” jos valitaan. |
| hidden | Kenttä, johon ei liity käyttöliittymäelementtiä ja jota voidaan käyttää vakion tallentamiseen |
| xml-external | Lisää viittauksen ulkoiseen XML-tietoon |
Otsikot
Otsikot ovat vastaajille näytettävät tekstit kullekin kysymykselle. Ne ovat ratkaisevan tärkeitä selkeälle viestinnälle kyselyissä.
- Perus käyttö: Kirjoita kysymysteksti
label-sarakkeeseen. - Useita kieliä: Käytä lisäsarakkeita kuten
label::Finnishjalabel::Englishmonikielisiin kyselyihin. - Muotoilu: rtSurvey tukee perus HTML-muotoilua otsikoissa korostamista tai rakennetta varten.
Esimerkki:
| type | name | label | label::Finnish |
|------|------|-------|----------------|
| text | name | What is your name? | Mikä on nimesi? |
Vihjeet
Vihjeet tarjoavat vastaajille lisäohjeistusta ilman pääkysymystekstin tukkimista.
- Käyttö: Lisää vihjeitä
hint-sarakkeeseen. - Näkyvyys: Vihjeet näytetään tyypillisesti pääkysymystekstin alapuolella.
- Monikielinen: Kuten otsikot, vihjeet voidaan määrittää useille kielille käyttämällä
hint::Language-sarakkeita.
Esimerkki:
| type | name | label | hint |
|------|------|-------|------|
| integer | age | Kuinka vanha olet? | Anna ikäsi vuosina |
Ulkoasu
rtSurveyn appearance-sarake mahdollistaa kysymysten esittämistavan mukauttamisen.
- Vakiovaihtoehdot: Sisältävät
multilinetekstille,horizontalvalinnoille. - rtSurvey-laajennukset:
- Aikasyöte: Erilaiset kellonaikanäyttövaihtoehdot (esim.
inline,inline-1line) - Värin mukauttaminen: Käytä
colors()-funktiota ikonien värien muuttamiseen
- Aikasyöte: Erilaiset kellonaikanäyttövaihtoehdot (esim.
Esimerkki:
| type | name | label | appearance |
|------|------|-------|------------|
| text | time | Anna aika | inline-[%H:%M] |
Relevant
relevant-sarake toteuttaa ohituslogiikan, joka määrittää milloin kysymys näytetään.
- Syntaksi: Käytä XPath-lausekkeita ehtojen määrittelemiseen.
- Muuttujat: Viittaa muihin kysymysnimiin käyttämällä
${question_name}.
Esimerkki:
| type | name | label | relevant |
|------|------|-------|----------|
| text | allergies | Luettele allergiat | ${has_allergies} = 'yes' |
Required
required-sarake määrittää onko kysymykseen vastaaminen pakollista.
- Perus käyttö: Käytä ‘yes’ tai ’true’ tehdäksesi kysymyksestä pakollisen.
- Edistynyt: Voi käyttää lausekkeita ehdolliseen pakollisuuteen.
Esimerkki:
| type | name | label | required |
|------|------|-------|----------|
| text | email | Sähköpostiosoite | yes |
Toistot
Toistot mahdollistavat kysymysryhmän vastaamisen useita kertoja.
- Käyttö: Käytä
begin repeatjaend repeat-rivejä toistuvan ryhmän määrittelyyn. - Nimeäminen: Anna jokaiselle toistolle yksilöllinen nimi.
Esimerkki:
| type | name | label |
|------|------|-------|
| begin repeat | household_member | Kotitalouden jäsen |
| text | member_name | Nimi |
| integer | member_age | Ikä |
| end repeat | | |
Media
rtSurvey tukee erilaisia mediatyyppejä kyselyissä, mukaan lukien kuvat, ääni ja video.
- Kysymystyypit: Käytä ‘image’, ‘audio’ tai ‘video’ type-sarakkeessa.
- Media otsikoissa: Viittaa mediatiedostoihin otsikoissa käyttämällä HTML-tageja.
Esimerkki:
| type | name | label |
|------|------|-------|
| image | house_photo | Ota kuva talosta |
| note | | <img src="logo.jpg" /> Tervetuloa kyselyyn |
Vain luku
Vain luku -kysymykset näyttävät tietoja ilman käyttäjän syöttömahdollisuutta.
- Käyttö: Lisää ‘readonly’
appearance-sarakkeeseen. - Laskelmat: Käytetään usein calculate-tyypin kanssa laskettujen arvojen näyttämiseen.
Esimerkki:
| type | name | label | appearance | calculation |
|------|------|-------|------------|-------------|
| calculate | bmi | BMI | readonly | ${weight} / (${height} * ${height}) |
rtSurvey-laajennukset
rtSurvey laajentaa XLSForm-standardia tukemalla lisäominaisuuksia, kuten grid layout, html format ja monia uusia widgettejä.
Ruudukkoasettelu
rtSurvey mahdollistaa lomakkeen ulkoasun jäljittelemistä perinteisiä paperikyselyitä tiivistämällä useita kysymyksiä yhdelle riville.