Trubar
Program search
[
Kazalo ||
Naprej ||
Nazaj
]
Program search je namenjen iskanju podatkov v izbranih katalogih.
Poženemo ga lahko samo iz dokumenta HTML. Možni parametri so naslednji:
- obvezen sistemski parameter, s katerim določimo skupino katalogov,
v kateri bomo iskali podatke
- parameter z imenom catalog, s katerim določimo katalog,
v katerem naj program išče podatke. Če želimo iskati
po več katalogih naenkrat, lahko parameter catalog
definiramo večkrat.
- parameter z imenom form, s katerim tudi določimo kataloge,
v katerih naj program išče podatke. Za vrednost tega parametra lahko
vpišemo katerikoli obrazec, ki je opisan v opisni datoteki naše
skupine katalogov, program pa bo potem podatke iskal v vseh katalogih, v katere lahko
vstavljamo iz tega obrazca. Tudi parameter form lahko definiramo
večkrat.
- parameter z imenom template, s katerim določimo
vzorčno datoteko, ki opisuje, kako naj program
prikaže najdene zapise. Ime datoteke naj bo polno ime ali relativno ime glede
na delovno področje izbrane skupine katalogov.
- parameter z imenom mode, s katerim določimo način
iskanja po katalogu. Možne vrednosti tega parametra so:
- all - vsak zapis v katalogu ustreza iskalnim kriterijem
- exact (privzeta vrednost) - natančno ujemanje
- word - iskanje besede
- substring - iskanje podniza
- V primeru, da ima parameter mode eno izmed vrednosti
exact, word ali substring,
moramo določiti še naslednja dva parametra:
- parameter z imenom item, ki določa, katero vrednost,
besedo ali podniz naj išče
- parameter z imenom field, ki določa ključ,
pod katerim naj išče določeno vrednost. Če
tega parametra ne definiramo ali če ima vrednost *,
bo program iskal po vseh ključih.
- Parameter z imenom skip določa, prvih koliko najdenih zapisov
naj ignorira (čeprav ustrezajo iskalnim kriterijem). Privzeta vrednost je
0.
- Parameter z imenom max določa največje število
zapisov, ki jih program za iskanje sme izpisati. Privzeta vrednost je
10, vrednost all pa pomeni, da naj izpiše
vse najdene zapise.
- definiramo lahko tudi parameter za jezikovne nastavitve
Program bo iskal podatke samo v katalogih, ki smo jih navedli s parametri
catalog in form. Če nismo navedli nobenega kataloga,
bo program iskal v vseh katalogih iz naše skupine.
Še nekaj primerov, kako lahko pokličemo program:
...
...
...
...
Ko program najde podatke, ji izpiše na način, kot določa
vzorčna datoteka, ki smo jo določili s
parametrom template. Če tega nismo storili, bo program uporabil
privzeto obliko za glavo in konec dokumenta, posamezne zapise pa bo izpisoval tako kot
določa vzorčna datoteka obrazca, ki katerega so bili ti podatki vstavljeni
v katalog.
Če program v katalogih ne najde nobenega zapisa, ki bi ustrezal
iskalnim kriterijem, potem definira spremenljivko &FAILED,
ki jo lahko uporabimo v tretjem delu vzorčne datoteke (FOOTER).
[
Kazalo ||
Naprej ||
Nazaj ||
Na začetek
]