Tovább a tartalomhoz
Tudástár

Kérdőív importálása

Már van egy kérdőíve: egy papíralapú űrlap, egy statisztikai hivatal PDF-je, egy Markdown-vázlat. Az importálás ebből kérdőívpiszkozatot készít a projektjében, QML-ben, a Z3-validátorral ellenőrizve, így ugyanúgy szerkesztheti, fordíthatja és terepre viheti, mint bármely más kérdőívet. Az Askalot beolvassa a fájlt, összegyűjti az összes benne talált kérdést a forrásban nyomtatott sorszámukkal, majd ebből a listából generálja a kérdőívet.

Formátum Korlátok
PDF, eredetileg digitális vagy szkennelt Legfeljebb 100 MB és 300 oldal
Markdown (UTF-8 szöveg) Legfeljebb 2 MB

A jelszóval védett PDF-et és a dinamikus XFA-űrlapot a rendszer elutasítja, és egy mondatban megmondja, mit tegyen (mentsen védelem nélküli másolatot; nyomtassa PDF-be az üres űrlapot). A hosszabb dokumentumot ossza fel, és részenként importálja. További formátumok, például az XLSForm, a LimeSurvey, a SurveyJS és a REDCap, tervben vannak.

  • Saját MI-szolgáltató. Az importálás az Ön két modellhelyét használja a Profilbeállítások → MI-modellek alatt: a Következtetési modellhelynek Anthropic API-kulcsot vagy AWS Bedrockot kell használnia, a Közvetlen LLM modellhely pedig azokat az oldalakat olvassa be, amelyekhez az oldal képe kell (szkennelt oldalak, rácsok, sérült szöveg). Lásd: MI-funkciók és modellválasztás.
  • Kérdőívtervezésre jogosító szerepkör. A szervezetben Tervező vagy Menedzser szerepkörre van szüksége, és szerkesztenie kell tudnia a projektet.
  • Havi importálási keret. Az ingyenes szolgáltatásban minden elindított importálás beleszámít a havi importálási keretébe, az is, amelyik később meghiúsul. Lásd: Méltányos használati korlátok.

Ha bármi hiányzik, a rendszer még a fájl tárolása és bármilyen MI használata előtt elutasítja az importálást, és az üzenet megmondja, mit kell módosítania.

A szerkesztőben kattintson a jobb gombbal a questionnaires mappára, és válassza a Kérdőív importálása PDF- vagy Markdown-fájlból… parancsot (a parancspalettán is megtalálja), majd válassza ki a fájlt. Importálást csak ez a parancs indít: a parancs nélkül a mappára ejtett fájlt a rendszer elutasítja, mert az importálás az Ön MI-szolgáltatóját használja, és beleszámít a havi keretébe.

Az MCP-n keresztül csatlakozó MI-kliens ugyanezt három hívással teheti meg; lásd: Nyomtatott kérdőív importálása.

Az importálás a háttérben fut. Egy rövid űrlap néhány percet vesz igénybe, egy hosszú mérőeszköz akár egy órát vagy többet is. Közben dolgozhat tovább, vagy be is zárhatja a szerkesztőt. A fájl a questionnaires mappában látható, azzal együtt, hogy az importálás éppen mit csinál („visitor-survey.pdf importálása – az oldalak beolvasása” és így tovább), minden lapon és a projekt minden kliensében. Amikor véget ér, megnyílik az új kérdőív, vagy a szerkesztő megmondja, miért állt le.

  • A kitöltött válaszokat a rendszer elveti. Ha a fájl kitöltött űrlap, az űrlapmezők értékeit, a bejelölt négyzeteket és a kézzel írt válaszokat a rendszer eltávolítja, mielőtt bármi más beolvasná a szöveget. A rendszer csak a nyomtatott kérdőívet használja fel, és a jelentésben jelzi, hogy válaszokat vetett el. A Markdown-fájlt a bejelölt négyzetein kívül üresnek tekinti.
  • A rejtett tartalmat figyelmen kívül hagyja. Az olvasó számára nem látható szöveget (fehér szöveg, az oldalon kívüli szöveg, Markdown-megjegyzések) a rendszer elhagyja.
  • A feltöltött fájl törlődik. A fájlja az importálás végén törlődik, akár sikeres volt, akár meghiúsult, akár elutasították. Nem kerül a projekt dokumentumai közé, és a rendszer a kereséshez sem indexeli.
  • Amit egy PDF-importálás beolvasott, megmarad. Az a szöveg, amelyből az importálás dolgozott, a válaszoktól már megtisztítva, az új kérdőívnél marad annak importforrásaként (lásd alább). A Markdown-fájl így nem marad meg, mert abban egy begépelt válasz nem különböztethető meg a kérdőív szövegétől.

Egy kérdőívpiszkozatot a projektben, a forrás nyelvén, a következőkkel:

  • A leltára: az a lista, amelyből a kérdőív készült. Minden, a forrásban nyomtatott kérdéssorszámot ahhoz az elemhez rendel, amely azt a kérdést felteszi, megmondja, a forrás mely részei maradtak ki és miért, és tartalmazza az importálási jelentést: a képről beolvasott oldalakat, azt, hogy a rendszer elvetett-e válaszokat, az ellenőrzési lépés nyitva maradt kifogásait, valamint a validátor által még jelzett problémákat. A leltár az első verziót írja le, és későbbi szerkesztései nem változtatják meg. Az MI-kliensek a get_questionnaire_inventory eszközzel olvassák.
  • Az importforrása (csak PDF esetén): az oldalak pontosan úgy, ahogy az importálás beolvasta őket, Markdownban, így egy kérdést összevethet azzal, amit az importálás látott. A nagyobb betűs címekből címsorok, a válaszlehetőségekből listaelemek lesznek; az ismétlődő élőfejeket, élőlábakat és nyomtatott oldalszámokat a rendszer eltávolítja és megszámolja. Minden oldalon szerepel, hogy a fájl hányadik oldala, milyen szám van rányomtatva, és hogy a szövegből vagy az oldal képéről olvasta-e be a rendszer; a leltár oldalszámai a fájl oldalszámai. A leltárhoz hasonlóan későbbi szerkesztések sosem változtatják meg, és a kérdőívvel együtt mozog, törlődik és áll vissza. Az MI-kliensek egyszerre néhány oldalt olvasnak belőle a get_questionnaire_import_source eszközzel.
  • Megjelölt kitalált ellenőrzések. Egyes ellenőrzéseket a forrás nem szigorú szabályként fogalmaz meg: ilyen egy puha ellenőrzés vagy egy kérdezőnek szóló utasítás, például „kérdezzen rá, ha több mint 80 óra”. Az importálás ezeket is ellenőrzésként írja meg, hogy az adatok következetesek maradjanak, de mindegyiket invented: true jelöléssel látja el, és a szerkesztő kiemeli őket. Erősítse meg vagy módosítsa mindegyiket, majd távolítsa el a jelölést. A válaszadók soha nem látják. Lásd: A QML szintaxisa.
  • Z3-ítélet. A kérdőívet a rendszer ugyanúgy validálja, mint bármely mást. Ha problémák maradnak, a szerkesztő megmondja, hány, és felsorolja őket a Problémák panelen; a rendszer a kérdőívet ettől még piszkozatként menti, a közzététel pedig addig vár, amíg ki nem javítja őket.

A nyomtatott ugrási utasításokból („Ha nem, ugorjon a Q12-re”) az átugrott kérdések feltételei lesznek, szakaszhatárokon át is. A nem követhető ugrást – például ha visszafelé mutat, vagy olyan kérdésre, amely nincs a fájlban – a rendszer sosem próbálja kitalálni: a leltárban kihagyottként szerepel, az okkal együtt, hogy Ön döntsön róla.