64 lines
3.5 KiB
Markdown
64 lines
3.5 KiB
Markdown
# 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`.
|
|
|
|
```text
|
|
Š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:
|
|
```javascript
|
|
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.
|