Lisamoodul: Saurus 4 ADR

Taust

See on read me fail "Saurus 4 ADR" laiendusmoodulile.

ADR on laiendusmoodul, mille abil saab avalikustada ja otsida avalikke dokumente Saurus CMSil põhinevatelt kodulehtedelt, mis on liidestatud Postipoisi või DocLogix'i dokumendihaldustarkvaraga. Lisaks võimaldab ADR nimetatud süsteemidesse saata kasutajate teabenõudeid.

Laiendusmooduli failid kirjutatakse versiooniuuenduste paigaldamisel üle. Kui soovite muuta lehe- või sisumalle, tehke moodulist koopia ning looge oma eriversioon moodulist.

Nõutav Sauruse versioon: alates 4.5.3 [7 July 2008]

Paigaldusjuhend: Postipoiss (vaikimisi)

1. Lae laiendusmoodul alla (http://www.saurus.info/saurus-cms-4-extensions), paki lahti ning tõsta kaust "saurus4_adr" saidi juurkataloogis paiknevasse kausta "extensions".
2. Sisene saidis: Admin > Tarkvara laiendused > Tarkvara laiendused ning kliki "Uuenda." Logi välja ja seejärel uuesti sisse ning veendu, et Tarkvara laienduste menüüs näidatakse 5 uut adminlehte. Kui ei näidata 5 uut adminlehte, kliki veelkord "Uuenda" ja logi välja-sisse ning korda protsessi seni kuni kõik adminlehed on nähtaval.
3. Kustuta kaustas "extensions/saurus4_adr" kaustad "temp" ja "install".
4. Sisene saidis: Admin > Presentatsioon > CSS stiilid ning lisa tekstivälja "Saidi CSS stiilid" algusesse:

   @import url(extensions/saurus4_adr/css/ADR.css);

5. ADR-lehemalli määramiseks (valikuline) sisene saidis: Admin > Presentatsioon > Põhimallid ning vali, et soovitud keele "Lehemall" oleks "ADR > Lehemall". Seejärel sisene saidis: Admin > Presentatsioon > CSS stiilid ning asenda tekstivälja "Saidi CSS stiilid" sisu järgnevaga:

   @import url(extensions/saurus4_adr/css/main.css);
   @import url(extensions/saurus4_adr/css/ADR_main.css);
   @import url(extensions/saurus4_adr/css/ADR.css);

6. Sisene editor-vaates lehele ning loo uus alamleht Dokumendiotsing ja määra lehe sisumalliks "ADR > Dokumendiotsing". Loo uus alamleht Dokumendiregister ja määra lehe sisumalliks "ADR > Dokumendiregister". Loo uus alamleht Teabenõue ja määra lehe sisumalliks "ADR > Teabenõue".
7. Sisene saidis: Admin > Tarkvara laiendused > Asutuste seaded ja vajuta "Uus", et lisada dokumendiregistrit kasutavaid asutusi. Pärast asutuse lisamist tee lehe paremas ääres tulbas "Aktiivne" linnuke märkeruutusse ja ning vajuta "Salvesta". Sellega on asutusega seotud andmevood seatud töövalmis.
8. Sisene saidis: Admin > Tarkvara laiendused > Andmevoogude seaded ning veendu, et näha on 5 erinevat andmevoogu (ATP dokument, ATP dokumendi ajalugu, ATP teema, ATP teabenõue, ATP dokumendi kustutamine). Määra soovitud andmevood aktiivseks, seadista XML-failide kaustad, vajadusel muuda alustavaid XML-vormingu elemente, kodeeringuid, käivitusviise ning vajuta "Salvesta".
9. Seadista crontöö (valikuline), lisades crontabi:

   */20 * * * * cd /path/to/saurus/extensions/saurus4_adr/lib/cron/ ; /usr/bin/php xml_flow.cron.php > /dev/null

Paigaldusjuhend: DocLogix

1. Lae laiendusmoodul alla (http://www.saurus.info/saurus-cms-4-extensions), paki lahti ning tõsta kaust "saurus4_adr" saidi juurkataloogis paiknevasse kausta "extensions".
2. Ava kaust "extensions/saurus4_adr/install/" ja nimeta fail "saurus4_adr_postipoiss.sql" ümber "saurus4_adr_postipoiss.sql.ignore".
3. Nimeta fail "saurus4_adr_doclogix.sql.ignore" ümber "saurus4_adr_doclogix.sql".
4. Sisene saidis: Admin > Tarkvara laiendused > Tarkvara laiendused ning kliki "Uuenda." Logi välja ja seejärel uuesti sisse ning veendu, et Tarkvara laienduste menüüs näidatakse 5 uut adminlehte. Kui ei näidata 5 uut adminlehte, kliki veelkord "Uuenda" ja logi välja-sisse ning korda protsessi seni kuni kõik adminlehed on nähtaval.
5. Kustuta kaustas "extensions/saurus4_adr" kaustad "temp" ja "install".
6. Sisene saidis: Admin > Presentatsioon > CSS stiilid ning lisa tekstivälja "Saidi CSS stiilid" algusesse:

   @import url(extensions/saurus4_adr/css/ADR.css);

7. ADR-lehemalli määramiseks (valikuline) sisene saidis: Admin > Presentatsioon > Põhimallid ning vali, et soovitud keele "Lehemall" oleks "ADR > Lehemall". Seejärel sisene saidis: Admin > Presentatsioon > CSS stiilid ning asenda tekstivälja "Saidi CSS stiilid" sisu järgnevaga:

   @import url(extensions/saurus4_adr/css/main.css);
   @import url(extensions/saurus4_adr/css/ADR_main.css);
   @import url(extensions/saurus4_adr/css/ADR.css);

8. Sisene editor-vaates lehele ning loo uus alamleht Dokumendiotsing ja määra lehe sisumalliks "ADR > Dokumendiotsing". Loo uus alamleht Dokumendiregister ja määra lehe sisumalliks "ADR > Dokumendiregister". Loo uus alamleht Teabenõue ja määra lehe sisumalliks "ADR > Teabenõue".
9. Sisene saidis: Admin > Tarkvara laiendused > Asutuste seaded ja vajuta "Uus", et lisada dokumendiregistrit kasutavaid asutusi. Pärast asutuse lisamist tee lehe paremas ääres tulbas "Aktiivne" linnuke märkeruutusse ja ning vajuta "Salvesta". Sellega on asutusega seotud andmevood seatud töövalmis.
10. Sisene saidis: Admin > Tarkvara laiendused > Andmevoogude seaded ning veendu, et näha on 3 erinevat andmevoogu (ATP dokument, ATP teema, ATP teabenõue). Määra soovitud andmevood aktiivseks, seadista XML-failide kaustad, vajadusel muuda alustavaid XML-vormingu elemente, kodeeringuid, käivitusviise ning vajuta "Salvesta".
11. Seadista crontöö (valikuline), lisades crontabi:

    */20 * * * * cd /path/to/saurus/extensions/saurus4_adr/lib/cron/ ; /usr/bin/php xml_flow.cron.php > /dev/null

Laiendusmooduli uuendus versioonilt 3.x versioonile 4.0: Postipoiss

1. Lae laiendusmoodul alla (http://www.saurus.info/saurus-cms-4-extensions), paki lahti ning tõsta kaust "saurus4_adr" saidi juurkataloogis paiknevasse kausta "extensions". Vana (versioon 3.x) "saurus4_adr" kausta võib üle kirjutada või eelnevalt ümber nimetada.
2. Sisene saidis: Admin > Tarkvara laiendused > Tarkvara laiendused ning kliki "Uuenda." Logi välja ja seejärel uuesti sisse ning veendu, et Tarkvara laienduste menüüs näidatakse 5 uut adminlehte. Kui ei näidata 5 uut adminlehte, kliki veelkord "Uuenda" ja logi välja-sisse ning korda protsessi seni kuni kõik adminlehed on nähtaval.
3. Käivita "extensions/saurus4_adr/temp/saurus4_adr_update_3.x-4.0.sql":

   $ mysql -u<user> -p <ver4db> < saurus4_adr_update_3.x-4.0.sql

4. Käivita "extensions/saurus4_adr/temp/saurus4_adr_update_3.x-4.0.sql" (loob indeksid otsingu hõlbustamiseks):

   $ mysql -u<user> -p <ver4db> < saurus4_adr_update_3.x-4.0_index.sql

5. Sisene saidis: Admin > Tarkvara laiendused > Andmevoogude seaded ning veendu, et näha on 5 erinevat andmevoogu (ATP dokument, ATP dokumendi ajalugu, ATP teema, ATP teabenõue, ATP dokumendi kustutamine). Veendu, et soovitud andmevood on aktiivsed, XML-failide kaustad korrektsed, kodeeringud õiged jm. NB! Kui andmevoogusid on rohkem kui 5 (sealjuures esindatud on nii "ATP dokument" kui ka "PP dokument (ATP)"), siis käivita "extensions/saurus4_adr/temp/fix_flow_settings.php".
6. Sisene saidis: Admin > Presentatsioon > CSS stiilid ning lisa tekstivälja "Saidi CSS stiilid" algusesse:

   @import url(extensions/saurus4_adr/css/ADR.css);

7. Crontöö seadistamiseks (valikuline), muuda seni töös olnud crontööd nii:

   */20 * * * * cd /path/to/saurus/extensions/saurus4_adr/lib/cron/ ; /usr/bin/php xml_flow.cron.php > /dev/null

   Sisene saidis: Admin > Tarkvara laiendused > Andmevoogude seaded ning veendu, et soovitud andmevoogude käivitus oleks märgitud "Cron-tööna".
8. Seni lisatud dokumentide tõstmiseks kaustast "public" eraldi kausta (valikuline), käivita "extensions/saurus4_adr/temp/convert_document_location.php". Sellega tõstetakse kõik avaliku dokumendiregistri dokumendid kausta "public/adr_upload".
9. Kustuta kaustas "extensions/saurus4_adr" kaustad "temp" ja "install".

Versiooniajalugu

Versioon 1.0 / 25.10.2006

• Algversioon

Versioon 2.0 / 11.12.2006

• Lisatud DocLogix tugi

Versioon 2.1 / 28.03.2007

• Veaparandus: "ADR module: Document search didn't find correct search values from the field "info". [ #2486 ]"

Versioon 2.2 / 21.05.2007

• Veaparandused

Versioon 3.0 / 25.10.2006

• Lisatud CAPTCHA tugi

Versioon 3.1 / 06.05.2008

• Loetavusprobleemid PHP >= 5.1.3

Versioon 3.2 / 20.10.2008

• Sõnastiku grupid muudatud "ATP"-st "Saurus4 ADR"-ks.
• Päringute optimeerimised

Versioon 4.0 / 07.01.2009

• ADR 4 versioon on viidud vastavusse 1.jaan 2009 jõustunud Avaliku Teabe seaduse muudatustega
• Lisandusid juurdepääsupiirangu andmeväljad
• Lisandus ületekstiotsing kõigist dokumendi väljadest
• Uus kujundus ja kasutusmugavuse parendused dokumendiotsingul, dokumendiregistril ja teabenõude vormil
• Uuendatud administreerimisliides
• Lisandus uus tööriist administraatorile "ADR dokumentide haldus", mis võimaldab filtreerida ja korraga kustutada tervet komplekti dokumente korraga
• Lisandus uus aruanne administraatorile "Importimiste aruanne", mis võimaldab näha määratud ajavahemiku kohta detailset XML dokumentide importimise aruannet
• Lisandus uus impordi funktsionaalsus: võimalus saata Postipoisist üksikute dokumentide kustutamise käsud, vastavad dokumendi kustutatakse ADR-ist
• Uus installatsiooni komplekt

Versioon 4.1 / 06.02.2009

• Veaparandus: Digiallkirjastatud dokumendid avati veebilehitsejas XML-formaadis.

Versioon 4.2 / 04.03.2009

• Veaparandus: Dokumendiotsingu mallis asutuse valiklistis ei kuvatud asutuse nimesid.
• Veaparandus: Teabenõude mallil ei olnud näha captcha pilti Internet Exploreris.
• Veaparandus: Olemasoleva dokumendi uuesti importimisel ei kustutatud failisüsteemist ära vanu, dokumendiga enam mitte seotud faile.
• Muudatus: Mallide seadistamisel ei ole enam alati kuvatavaid välju. (muudetav failis extension.config.php).

Versioon 4.3 / 10.03.2009

• Veaparandus: Dokumendiotsingu mallis JA dokumendi detailvaates näidati topelt välja 'Registreerimise nr.', kusjuures esimesel esinemisel oli väärtus tühi. Enam topelt kirjet ei kuvata.
• Veaparandus: Dokumendi detailvaates oli väli 'Asutus' number ja mitte tekst
• Veaparandus: .ddoc failide korral otsiti faili valest kohast.
• Veaparandus: Teabenõudel captcha on IE-s pooleks lõigatud

Versioon 4.4 / 23.03.2009

• Veaparandus: Mitte-superuser toimetaja ei saanud üksikuid dokumente kustutada, isegi kui vastavad õigused olid määratud.

Versioon 4.5 / 09.04.2009

• Veaparandus: Juhul, kui üks impordi andmevoogudest saab vea, lukustatakse kõik ülejäänud andmevood, et ei juhtuks situatsiooni, kus dokumendid imporditakse poolikult.

Versioon 4.6 / 17.04.2009

• Veaparandus: Mitte-superuser toimetaja ei saanud üksikuid dokumente kustutada, isegi kui vastavad õigused olid määratud. Parendatud dokumendi kustutamise dialoogi.
• Veaparandus: Parandatud formaadi vead kuupäevade kuvamisel.
• Veaparandus: Parandatud seotud dokumentide vaadet: kui reg.kuupäeva väärtus puudub, siis ei tohi kuvada ka väljanime "Kp:"

Versioon 4.7 / 28.04.2009

• Veaparandus: cronjobi kaudu käivitatud impordid ei kustutanud ära dokumendiga seotud faile.

Versioon 4.8 / 19.05.2009

• Veaparandus: dokumendi teistkordsel importimisel (uuendamisel) jäid impordi failis olevad tühjad väljad baasis täidetuks.

Versioon 4.9 / 17.06.2009

• Veaparandus: Seotud dokumentide vaates kuvati samu dokumente mitmekordselt.
• Veaparandus: Esmase paigalduse käigus lisatakse dokumendi detailvaatesse samad aktiivsed väljad nagu otsingu tulemusteski.
• Veaparandus: Adminstreerimislehed annavad teate kui puudub ADR moodul (varem jäd lehed tühjaks).
• Veaparandus: Dokumentidega seotud failide konverteerimisel oli formaadituvastus ebakorrektne.
• Veaparandus: Dokumendi vaadete administreerimiskeskkonnas määratud järjekord ei kaj astunud avalikus veebis.

Versioon 4.10 / 11.08.2009

• Lisandus digiallkirjastatud dokumentide sees olevate failide allalaadimise tugi. Kui on rohkem, kui üks fail DDOC failis, siis need laetakse alla ZIP arhiivina. DDOC faile endid ei saa allalaadida.
• DDOC failide allalaadimise piiramiseks, tuleks lisada "public/adr_upload" kataloogi ".htaccess" fail või täiendada Apache seadistusi järgmise reegliga: <Files ~ "\.(d|D)(d|D)(o|O)(c|C)$"> Order allow,deny Deny from all </Files>
• Veaparandus: Dokumendi kustutamine ei töötanud alates versioonist 4.9

Versioon 4.11 / 11.01.2010

• Veaparandus: Näita alates 2009 seadistus näitas vaid dokumente aastast 2009.

Versioon 4.12 / 09.02.2010

• Veaparandus: Dokumendi uuendamisel ei kustutatud väärtusi, kui need olid impordi XMLis tühjad.
• Veaparandus: Import ei leidnud seotud faile juhul kui dokumendifaili nimes olid täpitähed.
• Veaparandus: Kui aliased on aktiveeritud Sauruse CMSis, siis osad ADRi vaated ei kuvanud dokumente või nende detailvaateid.
• Turvaparandus.

Versioon 4.13 / 28.05.2010

• Doglogix'u tuge täiendatud.
• Otsingtulemustes ei kuvatud kuupäevi, mis ulatusid kaugemale tulevikku kui 2037.
• Turvaparandus.
• Teabenõude e-posti pealkiri on nüüd kodeeritud korrektselt.