eSodisce / GURS batch helper

Neuradna Firefox WebExtension za pomoč pri ponavljajočem se izpolnjevanju obrazca eSodisce/GURS. Različica 0.2.0 uporablja številčno šifro katastrske občine (KO), ne njenega imena.

Varnostni obseg

• Razširitev ne obravnava certifikatov, zasebnih ključev, gesel ali PIN-ov.
• Ne avtomatizira prijav in ne poskuša zaobiti opozoril, CAPTCHA ali varnostnih kontrol.
• Izrecno dejanje uporabnika za zagon je potrebno v trenutnem zavihku.
• Razširitev je omejena na https://esodisce.si/*.
• Razširitev ne uporablja Firefox Downloads API-ja in ne shranjuje PDF-datotek; samo izpolni obrazec in pritisne gumb btn_pdf.

Namestitev v Firefox

1. Odprite about:debugging.
2. Izberite This Firefox / Ta Firefox.
3. Kliknite Load Temporary Add-on….
4. Izberite manifest.json v tej mapi oziroma v razširjenem ZIP-u.
5. Odprite ciljno stran https://esodisce.si/evlozisce/javni_izpisi/list.html in preverite, da je obrazec že dosegljiv.
6. Kliknite ikono razširitve; odpre se sidebar. Izberite TXT/CSV in zaženite obdelavo za trenutno aktivni zavihek v istem oknu.

Za spremembe datotek razširitev odstranite in jo znova naložite v about:debugging. Sidebar ostane odprt med uporabo strani in izbiro datoteke; zadnja uspešno prebrana datoteka se shrani v lokalno shrambo razširitve.

Vhodna datoteka

Vsaka vrstica vsebuje dve polji: številčno šifro KO in parcelno številko. Podprta so ločila ;, tabulator in vejica. Prvo polje mora biti pozitivno celo število; vodilne ničle se ohranijo kot del niza. Drugo polje ostane niz, zato so podprte oblike, kot je 901/29.

Šifra KO;Parcelna številka
2491;901/29
2491;901/30
0107;1820

Primeri v example-input.txt so samo formatni primeri. Ne predstavljajo preverjeno veljavnih parcelnih številk ali šifer KO. Prazne vrstice in vrstice, ki se začnejo z #, se preskočijo; prikazana glava se obravnava kot neveljavna vrstica.

Kaj naredi

• poišče polji z dobesednima ID-jema idZnakNep.katastrskaObcina.idsrcsifrant in idZnakNep.parcelnaStevilka;
• v prvo polje neposredno vnese šifro KO ter sproži input in change;
• v drugo polje vnese parcelno številko;
• poišče gumb z dobesednim ID-jem btn_pdf in ga pritisne;
• ne prestreza, preimenuje ali shranjuje PDF-prenosov;
• podpira ročno potrjevanje pred vsakim zapisom ali samodejni način.

Če stran uporablja drug ID, iframe ali shadow DOM, bo potrebna prilagoditev. Trenutno je gumb namenoma izbran izključno z document.getElementById('btn_pdf').

Testni postopek

1. Zaženite node --check za background.js, content-script.js in popup.js.
2. Preverite, da je manifest.json veljaven JSON in da je različica 0.2.0.
3. Najprej preverite en formatni testni zapis v načinu ročno.
4. V Firefox Developer Tools konzoli na strani https://esodisce.si/evlozisce/javni_izpisi/list.html preverite:

   document.getElementById('idZnakNep.katastrskaObcina.idsrcsifrant')
   document.getElementById('idZnakNep.parcelnaStevilka')
   document.getElementById('btn_pdf')
   

5. Preverite, da se šifra KO in parcelna številka neposredno vneseta v obe polji, brez zahteve po izbiri autocomplete rezultata.
6. Preverite, da se vrednosti vnesejo v obe polji in da se pritisne gumb btn_pdf, brez ustvarjanja ali preimenovanja PDF-datotek.
7. Preverite napačen format šifre KO, manjkajoče polje in prekinitev med batchom.

Brez testiranja na dejanski strani ni mogoče potrditi popolne združljivosti z vsemi različicami obrazca.