Trubar
Program insert
[
Kazalo ||
Naprej ||
Nazaj
]
Program insert je namenjen vstavljanju novih podatkov
v izbrani katalog. Program se mora nahajati na istem področju
kot nastavitvena datoteka trubar.ini.
Program je smiselno uporabljati samo v kombinaciji z obrazcem v jeziku HTML, tako
da ga pokličemo kot akcijo obrazca. Možni parametri programa so:
- obvezen sistemski parameter, s katerim določimo skupino katalogov,
v katero bomo vstavljali podatke
- parameter z imenom formid, s katerim povemo, iz katerega obrazca
vstavljamo podatke. Vrednost tega parametra mora biti ime nekega prijavljenega
obrazca v skupini katalogov, kamor vstavljamo podatke. Če tega parametra
ne definiramo, bo program privzel, da vstavljamo iz obrazca, katerega ime smo
definirali v opisni datoteki za našo skupino katalogov s spremenljivko
defaultform. Če tudi
tam nismo nič definirali, si bo izbral prvi obrazec iz seznama obrazcev.
- parameter z imenom catalog, s katerim določimo katalog,
v katerega bomo vstavili podatke. Vrednost tega podatka mora biti simbolno
ime nekega prijavljenega kataloga v naši skupini katalogov. Izbrani
katalog mora imeti v seznamu obrazcev, iz katerih lahko vstavljamo,
tudi ime obrazca, ki smo ga navedli s parametrom formid.
Če parametra catalog ne definiramo, bo program v seznamu
prijavljenih katalogov sam poiskal prvi katalog, ki ima v seznamu obrazcev vpisano
tudi ime našega obrazca.
- parameter z imenom reflabel uporabljamo samo, kadar želimo
poudariti, da se podatki, ki jih želimo vstaviti v katalog, nanašajo
na neke druge podatke, ki so že vpisani v (isti) katalog. Za vrednost tega
parametra vpišemo oznako podatkov, na katere se nanašajo novi podatki.
- definiramo lahko tudi parameter za jezikovne nastavitve
Spodaj je napisanih še nekaj primerov klicev programa insert.
Kot je že bilo omenjeno, je smiselno klicati program samo kot akcijo nekega obrazca,
zato spodaj navajamo samo definicije lastnosti action značke
form:
action="/trubar/insert.exe/slovarji"
action="/trubar/insert.exe/slovarji?formid=tujke"
action="/trubar/insert.exe/slovarji?formid=kratice&catalog=temp"
action="/trubar/insert.exe/slovarji?formid=rac&language=slo&reflabel=o12"
Če ima katalog, v katerega vstavljamo, indeksno datoteko
(zasebno ali skupno), potem bodo podatki vedno dodani na konec kataloga, ne glede na to,
kaj predpisuje spremenljivka insert v
opisni datoteki izbrane skupine katalogov. Ko vstavi
podatke, program še popravi indeksno datoteko. V njo doda
nov indeks, in sicer tako, kot predpisuje spremenljivka insert.
Če pa katalog nima indeksne datoteke, se bodo novi podatki dodali na mesto,
ki ga določa spremenljivka insert.
Na koncu (če je bilo vse v redu) program izpiše sporočilo, ki ga
najde v datoteki s sporočilom za izbrani obrazec. Ta datoteka je lahko
običajna datoteka HTML, lahko pa samo opisuje sporočilo, ki se bo
izpisalo. Besedilo opišemo z običajno
vzorčno datoteko. Pri opisu vzorca lahko uporabljamo vse
običajne spremenljivke, vse spremenljivke, ki smo
jih pravkar vstavili v katalog, poleg teh pa še posebne spremenljivke,
kot so oznaka, datum, ura, ime kataloga, ...
Te spremenljivke imajo naslednja imena:
&formid
| ime obrazca, iz katerega smo dobili podatke
|
&catalog
| simbolno ime kataloga
|
&catalogdesc
| kratek opis kataloga
|
&label
| oznaka, ki so jo dobili vstavljeni podatki
|
&reflabel
| referenčna oznaka
|
&date
| datum sprejema podatkov v obliki YYYYMMDD
|
&time
| ura sprejema podatkov v obliki HHMM
|
[
Kazalo ||
Naprej ||
Nazaj ||
Na začetek
]