Avalikust veebist dokumentide registreerimine

Avalikult veebivormilt kannete lisamise võimalus on loodud selleks, et klient saaks ise ehitada HTML vormi ja selle nt oma kodulehele üles panna. Vormi postitamisel luuakse WD-sse vastav kanne. Klient võib vormi mis iganes visuaalsel kujul disainida. Oluline on, et postitamisel oleks teatud väljad ja name atribuudid sellised, nagu WD ootab. Seda funktsionaalsust võib kasutada nt avalduste, teabenõuete vms esitamiseks.

Lahendus on mõeldud töötama nii, et on seadistatud nn vahetüüp, millele kõik veebist registreeritud kanded tulevad. Avades sealt registreerimata kande, saab selle lõpptüübile registreerida, vajadusel kohandada enne registreerimist või märkida registreerituks, ilma päriselt registreerimata (nt spämm/vigased sisestused). Teoorias on võimalik seadistada ka nii, et kanne registreeritakse otse lõpptüübile, probleem on selles, et taolise lahenduse puhul saab ka spämm koheselt registreeritud.

1. Konfiguratsioonis tuleb lahendus sisse lülitada: linnuta „Avaliku dokumendi salvestamine lubatud“.
2. Looge grupp laiendusenimega “public_web_documents”. Grupi nimi ei ole oluline, kuid laienduse nimi peab kindlasti õige olema! Sellesse gruppi kuuluvad inimesed näevad avalehe plokki “Veebi dokumendid “ ja saavad sealt kandeid registreerida.
3. Looge vahetüüp (MILLELT kantakse info üle) ehk siis see andmetüüp, kuhu veebist registreertud kanded esmalt luuakse. Selle tüübihalduses peab olema linnutatud “On avalikust veebist lisatav”.
4. Kui andmetüüp / alamtüüp on seadistatud avalikust veebist lisatavaks, tekib andmeväljade seadistusse „On avalikust veebist lisatav“ väli.
5. Lõpptüübi (MILLELE kantakse info üle) seadistamine: tüübil, millele kannete lõppregistreerimine toimuma hakkab, peab olema tüübiseadetes tehtud valik „Avaliku veebi dokumendi tüüp“, ning valida, milliselt vahetüübilt sellele tüübile registreeritakse:
6. Iga välja puhul, kuhu soovitakse avalikust veebist tulnud kandelt infot üle tuua, tuleb valida väljaseadetes “Avaliku veebi dokumendi väli” ehk siis vahetüübi väli, kust info üle tuua:
7. NB! Andmeväljad peavad üks-ühele kattuma (lõpptüübil võib rohkem andmevälju olla, aga vähem mitte). Jälgi, et dünaamilise nime reegel oleks samasugune nagu tüübil, millelt soovid andmeid üle kanda.
8. Konfiguratsioonis seadistage ligipääsud: a) “API võtmed”, mida kliendi vorm peab postitamisel päringu päises kaasa andma, et WD päringu vastu võtaks (HTTP_X_API_KEY päises); b) “Avalikud URL-aadressid“, mille puhul WD kontrollib REFERER’i järgi, milliselt aadressilt vorm postitati, ehk sinna on vaja seadistada täisaadressid, kus vorm asub.
9. Seejärel looge ise või laske oma IT-l luua veebileht, kus muuhulgas on kirjas WD andmetüübi ID ja vastavuses olevate andmeväljade laienduste nimed. Puhtalt brauseri poolelt vormiga saatmist tasub kasutada ainult REFERER variandi puhul. Juhul, kui kasutada API võtit, siis peaks algne vormi sisu postitamine toimuma kliendi serveri pihta, kus lisataks API võti muule infole kaasa ning siis edastataks WD serveri poole edasi. Vormil võib klient kasutada JS’i, et teha seal välju kohustuslikuks või neid peita. Lisaks võib lisada nt CAPTCHA. Väljade kohustuslikkuse puhul tuleks veenduda, et kui WD poolel on väli kohustuslik, siis PEAB see olema kohustuslik ka veebivormil. Kui vastav rida vormi täitmisel tühjaks jääb, saab kasutaja registreerimisel vea. Detailne tehniline juhend valmimisel.

“Avaliku veebi dokumentide registreerijad” grupi liikmetele kuvatakse avalehel avaliku veebi saabunud / registreerimata dokumentide plokk. Kui avaliku veebi dokumendi tüüpe on mitu ja on erinevates sarjades, siis avaliku veebi dokumendi registreerijale kuvatakse avalehel ainult nende sarjade dokumente, kus tal on kehtivad õigused.

Veebi dokumendi avamisel kuvatakse dokumendi registrikaarti koos veebis sisestatud infoga. Vastavalt seadistustele on võimalik valida dokumendiliik, millele dokument registreeritakse või siis ei tehta dokumendiga enam midagi ning märgitakse registreerituks. Isik, kes teeb ümberregistreerimisi, peab kuuluma gruppi, mille laienduse nimetus on „public_web_documents“ (vastasel korral ei täideta ülekandmisel andmevälju).

Tagasi administraatori juhendi avalehele