View source for Check survey logic - Advanced/sl

<languages />
__TOC__


=Splošno=


Pomembna možnost, ki vam pomaga ustvariti in enostavno vzdrževati kompleksne ankete, je '''Preveri logiko ankete'''.

Med razvojem in testiranjem ankete ter pred njeno aktivacijo je zelo pomembno preveriti logiko ankete. To še posebej velja, ko uporabljate zapletene enačbe ustreznosti, prilagajanja in preverjanja veljavnosti – prepričani morate biti, da se pri izvedbi ankete nič ne pokvari. 

Ta funkcija vam omogoča hitro preverjanje točnosti vaše ankete, skupine in vprašanj. Do njega lahko dostopate z možnostmi menija v zgornji vrstici, ki se nahajajo pod nastavitvami, povezanimi z anketo. Dostopen je preko menija '''Orodja''':


[[Datoteka:show_logic_file.jpg]]


Kot lahko opazite zgoraj, lahko to možnost zaženete štirikrat za vsak jezik, uporabljen v anketi.

=Opis=


Možnost '''Preveri logiko ankete''' prikazuje vse, kar ste določili za vsako vprašanje in skupino (npr. ime, besedilo, pomoč, pogoje/relevantnost, pravila preverjanja, privzete vrednosti, podvprašanja, odgovore) v priročni obliki tabele. Označuje napake in vam omogoča, da kliknete ID vprašanja in skupine (ali spremenljivke, uporabljene v enačbah), da odprete nove zavihke brskalnika za urejanje teh vprašanj ali skupin. To olajša hitro urejanje morebitnih napak in osvežitev strani za logično preverjanje, da potrdite točnost ankete, preden jo aktivirate.

Zaslon je zasnovan tako, da ga lahko berejo raziskovalci in sponzorji študije, tako da lahko potrdijo točnost zasnove in logike ankete. Preverjanje logike ankete posodobi predpomnilnik za vse izraze, uporabljene v aktivni anketi.

Vključuje naslednje stolpce:

*''''#'' - prikazuje število zaporedij skupin in vprašanj, začenši z 0.

*''Ime<nowiki> [</nowiki> ID]''' - prikazuje kodo vprašanja za skupino/vprašanje/podvprašanje. Te kode je mogoče uporabiti kot spremenljivke znotraj [[ExpressionScript - Presentation|izrazov]]. '''ID''' je ID vprašanja (QID) ali ID skupine (GID). To polje prikazuje tudi [[ExpressionScript - Presentation#Qcode_variable_naming|vrsto vprašanja]] (npr. Več možnosti [M])).


{{Opomba|Če želite izvedeti več o tem, katere spremenljivke je mogoče uporabiti znotraj izrazov, preberite naslednji [[ExpressionScript - Presentation#Access_to_Variables|wiki pododdelek]].}}


*''''Relevantnost<nowiki> [</nowiki> Validation] (privzeto)'' - prikaže naslednje:
**''Relevance'' - s sintakso označeno [[ExpressionScript - Presentation|enačbo ustreznosti]] za vprašanje ali skupino. Če je vedno res (prikazano v katerem koli scenariju), bo vrednost '''1'''.
**''Validation'' - ExpressionScript samodejno ustvari [[ExpressionScript_Engine_-_Quick_start_guide#Validation|validacijo enačba]] na podlagi izbranih atributov vprašanja (npr. najmanjše/največje število odgovorov, najmanjše/največje/enako vrednosti vsote, najmanjše/največje posamezne vrednosti ali preverjanje regularnega izraza). Ta razdelek prikazuje ustvarjeno validacijsko enačbo, tako da lahko odkrijete morebitne napake (kot so nedefinirane spremenljivke).
***Preverjanje na ravni vprašanja prikazuje enačbo, potrebno za preverjanje zgoraj opisanih atributov vprašanja
* **Preverjanje na ravni podvprašanja prikazuje enačbo, potrebno za implementacijo [[QS:Array_filter|array_filter]], [[QS:Array_filter_exclude|array_filter_exclude]] in [[QS:Exclusive_option|exclusive_option]]
**''Default '' - če ima vprašanje privzeto vrednost, je prikazana tukaj, sintaktično označena (ker je privzeta vrednost lahko izraz).

*''Besedilo<nowiki> [</nowiki> Pomoč] (Namig)'' - prikaže naslednje:
**''Besedilo'' - besedilo skupine, vprašanja, podvprašanja ali odgovora. Označena je s sintakso, da prikaže vse vdelane [[ExpressionScript - Presentation#Tailoring.2FPiping|krojenje]], kar vam omogoča, da preverite, ali ste prijavili vse spremenljivke, ki jih nameravate uporabiti pri krojenju.
**''Pomoč '' - to prikazuje besedilo pomoči za vprašanje, ki je tudi sintaksno označeno.
**''Namig'' - to prikazuje interno ustvarjen potrditveni namig, ki temelji na atributih vprašanja. Ta isti nasvet se uporablja v vseh slogih anket, poleg tega pa tudi v anketah za tiskanje in zaslonih za vnos podatkov.
**''Atributi vprašanja'' - prikazuje tabelo vseh ustreznih atributov vprašanja za to vprašanje. Atributi, ki bi lahko bili enačbe, so skladenjsko poudarjeni, tako da lahko preverite njihovo točnost.

Vrstice so barvno kodirane na naslednji način:
*'''Skupine''' - so prikazane s svetlo sivim ozadjem
*'''Vprašanja''' - so prikazane s svetlo zelenim ozadjem
*' ''Podvprašanja'' - so prikazana z bledo rumenim ozadjem
*'''Odgovori''' - so prikazana z navadnim belim ozadjem

Odgovori imajo dodaten atribut v stolpcu '''Relevance''':
*'''Value''' - to je privzeta notranja vrednost, ki jo uporabljajo izračuni. Če uporabljate [[Ocene]], bo to vrednost ocene. V nasprotnem primeru bo to enako imenu odgovora.


{{Opomba|Opis ankete, pozdravna in končna sporočila, končni URL, obvestilo o pravilniku o podatkih ankete in oznaka so navedeni v logiki ankete Cgeck (nad tabelo), če njihova ustrezna polja niso prazna!}}

=Uporaba=


Na vrhu strani je povzetek sporočila. Če je vse v redu, bo pisalo "V tej anketi ni zaznanih sintaksnih napak" ali "Ta skupina" ali "To vprašanje", "samo po sebi ne vsebuje sintaksnih napak". Če je res nasprotno, bo pisalo "X vprašanj ima sintaktične napake, ki jih je treba popraviti".

Vsako vprašanje s sintaksnimi napakami dobi ozadje skrajno levega stolpca (tj. '''#''') barvno kodirano rdeče. Pod stolpcem '''Ime [ID]'' bo prikazano tudi opozorilo, ki navaja najmanjše število napak pri vprašanju. Pogoste so naslednje napake:

*[[Preverite logiko ankete - Napredno#Nedefinirana spremenljivka|Nedefinirana spremenljivka]] - če niste definirali vseh svojih spremenljivk ali napačno vnesli array_filter (ali različne nize možnosti odgovora za array_filter), bodo nekatera vaša preverjalna vprašanja pokazala napake . Nedefinirane spremenljivke so prikazane z rdečim besedilom, obrobljene z rdečo črto.

*[[Preverite logiko ankete - Napredno#Slaba sintaksa|Slaba sintaksa]] - ko začnete uporabljati enačbe ustreznosti, lahko uporabite preveč ali premalo oklepajev. Takšne sintaksne težave so označene in obrobljene z rdečo. Če se z miško pomaknete nad tako rdeče obrobljeno besedilo, bo napaka opisana v orodnem namigu.

== Barve v sintaksi ExpressScript ==
Pogoji in enačbe so sintakse označene, da lažje ugotovite, kaj gledate:
# Zelena / Svetlo modra: spremenljivka, ki se nanaša na vprašanje prej v anketi
# Modra : funkcija
# Siva: nizovni izraz
# Rjava: izraz TOKEN (podatki o udeležencih)
# Črna: Operator
Stvari za preverjanje:
# Vijolična: spremenljivka, ki se sklicuje na vprašanje kasneje v anketi. Običajno je to napaka in jo je treba preveriti.
# Rdeč ali rdeč okvir: neobstoječa spremenljivka ali sklic na prejšnje vprašanje ali sintaksna napaka - običajno je treba preveriti.


==Nedefinirane spremenljivke==


Če so uporabljene nedefinirane spremenljivke, bo ime zadevne spremenljivke označeno z rdečo barvo in obdano z rdečo črto. Če z miško premaknete nad ime spremenljivke, bo pisalo "nedefinirana spremenljivka":


<center>[[Datoteka:undefined_varaible.jpg]]</center>


{{Alert|title=Pozor|text=Upoštevajte, da LimeSurvey skrbnikom anket ne dovoljuje ustvarjanja vprašanj, ki uporabljajo isto kodo vprašanja. Lahko pa se zgodi, da so podobne kode vprašanj znotraj ankete, če uvozite skupino vprašanj ali vprašanje, ki uporablja isto kodo vprašanja kot eno od vaših že definiranih vprašanj. Vprašanje je še vedno mogoče uvoziti, ker so ID-ji vprašanj različni. Če pa želite izvoziti rezultate ankete za nadaljnje raziskovanje [[Exporting_results|rezultatov ankete]] (R ali SPSS), bodite previdni, ker se koda vprašanja obravnava kot spremenljivka!}}


<center>[[Datoteka:same_code_name_not_recommended.png]]</center> }}

==Slaba sintaksa==


Večina napak, povezanih z izrazi, je povezanih s slabo sintakso. To je povezano z dejstvom, da skrbniki anket običajno ne dodajo zavitega oklepaja, pravilno uporabijo oklepaje ali napačno uporabljajo izraze:


<center>[[Datoteka:Syntax_highlighting_parantheses.png]]</center>

<center>[[Datoteka:Syntax_highlighting_extra_comma.png]]</center>


Tu je veliko dobrih primerov uporabe [[ExpressionScript How-tos#Syntax_Highlighting|označevanja sintakse]].


===Slab JavaScript po meri===


Napake JavaScript bodo poudarjene tudi pri preverjanju logike ankete:


<center>[[Datoteka:javascript_error.jpg]]</center>

=Hitro urejanje in preverjanje=


Vse besedilo, označeno s sintakso, ima vdelane opise orodij, ki jih je mogoče klikniti:
#Opis orodij
#*Funkcije - če lebdite nad miško, lahko vidite namen in definicijo sintakse funkcije;
#*Imena spremenljivk - Če lebdite na miški, lahko vidite položaj (skupina, zaporedje vprašanj), besedilo vprašanja in dovoljene odgovore za vprašanje.
#Dejanja
#*Imena spremenljivk - s klikom na ime spremenljivke se odpre novo okno, ki vam za urejanje vprašanja. To olajša krmarjenje in preverjanje logike – preprosto še naprej klikajte imena spremenljivk, ki so relevantna ali merila za preverjanje, za vprašanje, da vidite, od kod prihajajo in kako se uporabljajo.


=Primeri=


Naslednji primeri so vzeti iz [[Vzorčne ankete ExpressionScript|vzorčne ankete ExpressionScript]]. Na tej strani lahko najdete posnetke zaslona izvajanja anket, razlage in prenose.


==Indeks telesne mase==


Tukaj so [[ExpressionScript sample surveys#Screenshots|posnetki zaslona]] tega primera.

To je pogled preureditve vprašanj za izračun indeksa telesne mase. Enačbe ustreznosti za težo, višino in BMI si lahko ogledate pod stolpcem »Vprašanje«:


<center>[[File:BMI_reorder.jpg]]</center>


Za boljši pregled ankete preverite stran z logiko ankete:


<center>[[File:BMI_logic1.jpg]]</center>


Ta primer ankete je tudi dober primer ugnezdenih stavkov if() za ustvarjanje "statusa teže".


<center>[[File:BMI_logic2.jpg]]</center>

==Kaskadna logika==


Tukaj so [[ExpressionScript sample surveys#Cascading Array Filters|posnetki zaslona]] tega primera.

Prikazuje logiko potrjevanja podvprašanja, ki se samodejno ustvari, ko uporabite [[QS:Array_filter|array_filter]] in [[QS:Array_filter_exclude|array_filter_exclude]]. Ta primer tudi prikazuje, kako lahko nadomestite prilagojeno vrednost »Drugo« (odgovor za Q02_other je Q01_other).


<center>[[File:cascading_logic1.jpg]]</center>


Q05 v tem primeru prikazuje hkratno uporabo array_filter in array_filter_exclude na Q01 oziroma Q02. Ta primer prikazuje kaskadne zmogljivosti array_filter. Upoštevajte, da je eden od glavnih razlogov za prikaz kriterijev '''validacije''' ravni vprašanja in podvprašanja pomagati zagotoviti, da niste naredili tipkarskih napak pri podajanju imen spremenljivk array_filter ali array_filter_exclude (ali v primeru, da uporabljate različna imena spremenljivk za vaš seznam filtriranih podvprašanj). Če imate takšne tipkarske napake, bodo vsa neveljavna imena spremenljivk prikazana rdeče, kar pomeni, da so nedefinirana, kar vam bo omogočilo, da hitro odpravite težavo.


<center>[[File:cascading_logic2.jpg]]</center>


==Dinamična ustreznost==


Ta primer prikazuje dinamično kaskadno logiko ustreznosti za nadzor prikaza vidnosti vprašanja. Ta primer lahko prenesete [[ExpressionScript sample surveys#Download|tukaj]].

Upoštevajte tudi, da so vprašanja prikazana samo, če so izpolnjena določena merila za preverjanje veljavnosti. Na primer, če oseba izjavi, da ima 2 otroka, mora anketiranec izpolniti določena vprašanja (otrok1 in otrok2).


<center>[[Datoteka:dynamic_relevance_logic1.jpg]]</center>

==Ustreznost na ravni skupine==


Ta primer prikazuje, kako je relevantnost na ravni skupine prikazana v logičnem preverjanju. Tukaj so [[ExpressionScript sample surveys#Sample Census|posnetki zaslona]] primera, opisanega spodaj.

Kot lahko vidite, se enačba ustreznosti na ravni skupine (cohabs > 1 && p1_rel != "") pojavi v sivi vrstici Oseba 2 za G-2.

Morda boste tudi opazili, da so vsa vprašanja obvezna. Če pa je skupina nepomembna, so nepomembna tudi vsa njena vprašanja. Posledično so ta vprašanja resnično obvezna le, če je skupina ustrezna.

Morda boste tudi opazili, da so določena vprašanja prikazana le, če odgovor na prejšnje vprašanje ni prazen. Spodaj lahko vidite, da če p2_sex ni izpolnjen, p2_name ne bo prikazan, čeprav je to obvezno vprašanje. Obvezno vprašanje p2_age tudi ne bo prikazano, če p2_name ni izpolnjeno. Ta vprašanja lahko štejemo za "pogojno obvezna". 

Poleg tega upoštevajte, da se tudi sporočila '''nasvet''' samodejno ustvarijo za vas. Urejeni so po obsegu vrednosti (min/max), obsegu vrednosti vsote (min/max/equals), številu odgovorov (min/max) itd. (odvisno od uporabljene vrste vprašanja in aktivnih atributov). Včasih želite potrditi obseg odgovorov, vendar ne želite prikazati tega, kar bi se uporabniku morda zdelo neumni nasveti za preverjanje veljavnosti. V takih primerih lahko uporabite možnost vprašanja [[QS:Hide_tip|hide_tip]] (kot v tem primeru, da uporabniku ne poveste, da mora biti starost med 0 in 115, razen če poskuša vnesti napačno vrednost - glejte p2_age ).


<center>[[File:person2_logic.jpg]]</center>

==Vejica kot radikalno (decimalno) ločilo==


Čeprav LimeSurvey v celoti podpira uporabo vejice kot (decimalnega) ločila v času izvajanja, morate še vedno uporabiti decimalko kot ločilo v času načrtovanja (npr. pri podajanju najmanjših/največjih vrednosti v naprednih atributih vprašanj). Delujoči primer je lahko [[ExpressionScript vzorec ankete#Uporaba vejice kot ločila radiksa (decimalna vejica)|najdete tukaj]].

Ne pozabite tudi, da se logika '''validacije''' samodejno ustvari za vas iz omogočenih atributov vprašanja. Enačbe so morda videti ogromne, vendar vam zaradi njih ni treba skrbeti.


<center>[[File:radix_logic1.jpg]]</center>