Meta
Typy pytań meta automatycznie przechwytują informacje o urządzeniu, ankieterze i czasie bez żadnych danych od respondenta.
Typy pytań meta to specjalne pola wypełniane automatycznie — respondent ich nigdy nie widzi. Przechwytują kontekst zgłoszenia: kiedy zostało zebrane, jakie urządzenie zostało użyte i kto je zebrał. Dodaj je w arkuszu survey jak każdy inny typ pytania — po prostu nie pojawiają się na ekranie.
Podstawowa specyfikacja XLSForm
| type | name | label |
|---|---|---|
| start | start | |
| end | end | |
| deviceid | deviceid |
Etykiety są opcjonalne dla pól meta, ponieważ nigdy nie są wyświetlane.
Pola meta dotyczące czasu
start
Rejestruje datę i godzinę otwarcia formularza. Przechowywane w formacie ISO 8601 (YYYY-MM-DDTHH:MM:SS.sss+HH:MM).
type | name | label
start | start |
end
Rejestruje datę i godzinę przesłania formularza. Razem z start można obliczyć czas spędzony na wypełnianiu formularza:
type | name | calculation
calculate | duration_min | (decimal-date-time(${end}) - decimal-date-time(${start})) * 1440
today
Rejestruje bieżącą datę (bez składnika czasu). Przechowywane jako YYYY-MM-DD. Przydatne, gdy potrzebujesz tylko daty bez pełnego znacznika czasu.
type | name | label
today | today |
Pola meta dotyczące urządzenia
deviceid
Rejestruje unikalny identyfikator urządzenia używanego do zbierania danych. Na Androidzie jest to zazwyczaj IMEI lub Android ID. Przydatne do śledzenia, które urządzenie przesłało każdy formularz, i wykrywania duplikatów zgłoszeń z tego samego urządzenia.
type | name | label
deviceid | deviceid |
devicephonenum
Rejestruje numer telefonu karty SIM w urządzeniu (jeśli dostępny). Może być pusty, jeśli urządzenie nie ma karty SIM lub jeśli numer nie jest zapisany na karcie SIM.
type | name | label
devicephonenum | devicephonenum |
simserial
Rejestruje numer seryjny karty SIM (ICCID). Przydatne do identyfikacji, której karty SIM/operatora użyto.
type | name | label
simserial | simserial |
subscriberid
Rejestruje IMSI (International Mobile Subscriber Identity) — unikalny identyfikator abonenta na karcie SIM.
type | name | label
subscriberid | subscriberid |
Pola meta dotyczące ankietera
username
Rejestruje nazwę użytkownika zalogowanego ankietera (konto używane w aplikacji rtSurvey). Jest to najbardziej niezawodny sposób śledzenia, kto zebrał każde zgłoszenie.
type | name | label
username | username |
email
Rejestruje adres e-mail zalogowanego ankietera.
type | name | label
email | email |
phonenumber
Rejestruje numer telefonu powiązany z kontem ankietera (jeśli skonfigurowany).
type | name | label
phonenumber | phonenumber |
Dziennik audytu
audit
Pole meta audit włącza szczegółowe rejestrowanie audytu — zapisuje oznaczony czasem dziennik każdego pytania odwiedzonego przez ankietera, czasu spędzonego na każdym pytaniu oraz (opcjonalnie) jego lokalizacji GPS na każdym etapie. Dziennik audytu jest zapisywany jako oddzielny plik audit.csv obok każdego zgłoszenia.
type | name | parameters
audit | audit | location-priority=balanced location-min-interval=30 location-max-age=60
Parametry audytu
| Parametr | Opis |
|---|---|
location-priority | Poziom dokładności GPS: no-gps, low-power, balanced, high-accuracy |
location-min-interval | Minimalna liczba sekund między przechwyceniami lokalizacji |
location-max-age | Maksymalny wiek (w sekundach) buforowanej lokalizacji do zaakceptowania |
Dziennik audytu przechwytuje:
- Nazwę pytania i typ zdarzenia (
question,form.start,form.exit,form.save,form.finalize) - Znaczniki czasu rozpoczęcia i zakończenia każdego zdarzenia
- Współrzędne GPS (jeśli ustawiono
location-priority)
Pole audit generuje oddzielny plik dla każdego zgłoszenia. Upewnij się, że Twój potok danych przetwarza zarówno główne dane formularza, jak i plik CSV audytu.
Kompletny przykład
Typowe badanie gospodarstw domowych może zawierać wszystkie pola meta dotyczące czasu i ankietera:
| type | name | label |
|---|---|---|
| start | start | |
| end | end | |
| today | today | |
| deviceid | deviceid | |
| username | username | |
| audit | audit | |
| text | household_id | ID gospodarstwa domowego |
| … | … | … |
Najlepsze praktyki
- Zawsze uwzględniaj
startiend— są bezpłatne, automatyczne i bezcenne do monitorowania jakości. - Zawsze uwzględniaj
username, aby śledzić ankieterów. - Uwzględnij
deviceid, gdy chcesz wykrywać duplikaty zgłoszeń lub śledzić urządzenia w terenie. - Używaj
auditw badaniach wymagających wysokiego poziomu rozliczalności, gdzie musisz zweryfikować, że ankieterzy faktycznie odwiedzili każde pytanie. - Pola SIM (
simserial,subscriberid,devicephonenum) są wiarygodne tylko na urządzeniach Android z aktywnymi kartami SIM — pomiń je w przypadku wdrożeń wyłącznie na tabletach.
Ograniczenia
- Wszystkie pola meta są tylko do odczytu — nie mogą być odwoływane ani modyfikowane przez inne obliczenia.
usernameiemailwymagają zalogowania ankietera — będą puste dla anonimowych zgłoszeń.- Pola meta SIM/telefonu mogą zwracać puste wartości na tabletach tylko z Wi-Fi i niektórych wersjach Androida z powodu ograniczeń uprawnień.