Meta
Meta-kysymystyypit tallentavat automaattisesti laite-, luetteloija- ja ajoitustiedot ilman vastaajan syötettä.
Meta-kysymystyypit ovat erityiskenttiä, jotka täytetään automaattisesti — vastaaja ei koskaan näe niitä. Ne tallentavat asiayhteystietoja lähetyksestä: milloin se kerättiin, mitä laitetta käytettiin ja kuka keräsi sen. Lisää ne survey-laskentataulukkoon kuten muutkin kysymystyypit; ne eivät yksinkertaisesti näy näytöllä.
XLSForm-perusmäärittely
| type | name | label |
|---|---|---|
| start | start | |
| end | end | |
| deviceid | deviceid |
Otsikot ovat valinnaisia metatiedoille, koska niitä ei koskaan näytetä.
Ajoituksen metatiedot
start
Tallentaa päivämäärän ja kellonajan, jolloin lomake avattiin. Tallennetaan ISO 8601 -muodossa (YYYY-MM-DDTHH:MM:SS.sss+HH:MM).
type | name | label
start | start |
end
Tallentaa päivämäärän ja kellonajan, jolloin lomake lähetettiin. Yhdessä start:n kanssa voit laskea lomakkeen täyttämiseen kuluvan ajan:
type | name | calculation
calculate | duration_min | (decimal-date-time(${end}) - decimal-date-time(${start})) * 1440
today
Tallentaa nykyisen päivämäärän (ei aikakomponenttia). Tallennetaan muodossa YYYY-MM-DD. Hyödyllinen, kun tarvitaan vain päivämäärä ilman täyttä aikaleimaa.
type | name | label
today | today |
Laitteen metatiedot
deviceid
Tallentaa tietojenkeruussa käytetyn laitteen yksilöllisen tunnisteen. Androidilla tämä on tyypillisesti IMEI tai Android ID. Hyödyllinen jokaisen lomakkeen lähettäneen laitteen seuraamiseen ja saman laitteen kaksoislähetysten havaitsemiseen.
type | name | label
deviceid | deviceid |
devicephonenum
Tallentaa laitteen SIM-kortin puhelinnumeron (jos saatavilla). Voi olla tyhjä, jos laitteessa ei ole SIM-korttia tai numero ei ole tallennettu SIM-kortille.
type | name | label
devicephonenum | devicephonenum |
simserial
Tallentaa SIM-kortin sarjanumeron (ICCID). Hyödyllinen sen tunnistamiseen, mitä SIM-korttia/operaattoria käytettiin.
type | name | label
simserial | simserial |
subscriberid
Tallentaa IMSI:n (International Mobile Subscriber Identity) — SIM-kortin yksilöllisen tilaajatunnisteen.
type | name | label
subscriberid | subscriberid |
Luetteloijan metatiedot
username
Tallentaa kirjautuneen luetteloijan käyttäjänimen (rtSurvey-sovelluksessa käytetty tili). Tämä on luotettavin tapa seurata, kuka keräsi kunkin lähetyksen.
type | name | label
username | username |
email
Tallentaa kirjautuneen luetteloijan sähköpostiosoitteen.
type | name | label
email | email |
phonenumber
Tallentaa luetteloijan tiliin liitetyn puhelinnumeron (jos konfiguroitu).
type | name | label
phonenumber | phonenumber |
Tarkastusloki
audit
audit-metakenttä mahdollistaa yksityiskohtaisen tarkastuslokin — se tallentaa aikaleimattua lokia jokaisesta kysymyksestä, jonka luetteloija vieraili, kuinka kauan he viettivät siinä, ja (valinnaisesti) heidän GPS-sijaintinsa kussakin vaiheessa. Tarkastusloki tallennetaan erillisenä audit.csv-tiedostona jokaisen lähetyksen ohessa.
type | name | parameters
audit | audit | location-priority=balanced location-min-interval=30 location-max-age=60
Tarkastusparametrit
| Parametri | Kuvaus |
|---|---|
location-priority | GPS-tarkkuustaso: no-gps, low-power, balanced, high-accuracy |
location-min-interval | Vähimmäissekunnit sijaintien tallennusten välillä |
location-max-age | Hyväksytyn välimuistisijainnin enimmäisikä (sekunteina) |
Tarkastusloki tallentaa:
- Kysymyksen nimen ja tapahtumatyypin (
question,form.start,form.exit,form.save,form.finalize) - Alku- ja loppuaikaleiman kullekin tapahtumalle
- GPS-koordinaatit (jos
location-priorityon asetettu)
audit-kenttä luo erillisen tiedoston kutakin lähetystä kohden. Varmista, että tietokäsittelylinjasi käsittelee sekä päälomakkeen tiedot että tarkastus-CSV:n.
Täydellinen esimerkki
Tyypillinen kotitalouslomake voi sisältää kaikki ajoitus- ja luetteloijan metatiedot:
| type | name | label |
|---|---|---|
| start | start | |
| end | end | |
| today | today | |
| deviceid | deviceid | |
| username | username | |
| audit | audit | |
| text | household_id | Kotitaloustunnus |
| … | … | … |
Parhaat käytännöt
- Sisällytä aina
startjaend— ne ovat ilmaisia, automaattisia ja korvaamattomia laadunvalvonnassa. - Sisällytä aina
usernameluetteloijien seuraamiseen. - Sisällytä
deviceid, kun haluat havaita kaksoislähetykset tai seurata kenttälaitteita. - Käytä
audit-kenttää korkean vastuullisuuden kyselyissä, joissa sinun on varmistettava, että luetteloijat todella vierailivat jokaisessa kysymyksessä. - SIM-liittyvät kentät (
simserial,subscriberid,devicephonenum) ovat luotettavia vain Android-laitteilla aktiivisten SIM-korttien kanssa — ohita ne tablettivain-käyttöönottoihin.
Rajoitukset
- Kaikki metatiedot ovat vain luku — niihin ei voi viitata tai niitä muokata muiden laskujen toimesta.
usernamejaemailvaativat luetteloijan kirjautumisen; ne ovat tyhjiä anonyymissä lähetyksessä.- SIM/puhelin-metatiedot voivat palauttaa tyhjiä arvoja vain-Wi-Fi-tableteilla ja joillakin Android-versioilla lupavaatimusten vuoksi.