Huvitegevuse andmete saatmine ArcGISi

Huvitegevuse andmete saatmine ArcGISi

1. Huvitegevuse andmeväljade muutmine seoses ArcGIS arendusega

Seoses ArcGISi arendamisega on tehtud muudatused huvikooli, huvikooli rühmade, lepingulise huvitegevuse ja lepingulise huvitegevuse ringi andmetes.

Lisatud on uued seadistused, nüüd on kasutusel:

  • ARNO_HK_KOHUSTUSLIKUD_VALJAD - Huvikooli jaoks

  • ARNO_HK_RYHM_KOHUSTUSLIKUD_VALJAD - Huvikooli rühmade jaoks

  • ARNO_LEP_HUVITEGEVUS_KOHUSTUSLIKUD_VALJAD - Lepingulise huvitegevuse jaoks

  • ARNO_LEP_HUVITEGEVUS_RINGI_KOHUSTUSLIKUD_VALJAD - Lepingulise huvitegevuse ringide jaoks

Seadistustes on võimalik määrata, millised väljad on kohustuslikud. Kohustuslikud väljad märgitakse tärniga.
Seadistustes on vaikimisi salvestatud need väljad, mis on vajalikud ArcGIS-i saatmiseks.

  • Seadistuse ARNO_HK_KOHUSTUSLIKUD_VALJAD salvestatud väärtus: kontakt, yldtelefon, peamine_epost;

  • Seadistuse ARNO_HK_RYHM_KOHUSTUSLIKUD_VALJAD salvestatud väärtus: adr_id, aadress, valdkond, alamvaldkond, toimumise_aeg, toimumise_koht, juurdepaas, toimumisperiood_algus, toimumisperiood_lopp, toetus_info, oppekeel;

  • Seadistuse ARNO_LEP_HUVITEGEVUS_KOHUSTUSLIKUD_VALJAD salvestatud väärtus: kontakt, yldtelefon, peamine_epost, etteteatamise_tahtaeg, aadress;

  • Seadistuse ARNO_LEP_HUVITEGEVUS_RINGI_KOHUSTUSLIKUD_VALJAD salvestatud väärtus: adr_id, aadress, alamvaldkond, toimumisaeg_markus, asukoht, juurdepaas, maksumus, toetus_info.

 

1.1 Muudatused väljade juures

Huvikooli ja lepingulise huvitegevuse andmetesse on lisatud aadressi väljad - vastavalt: "Huvikooli aadress" ja "Asutuse aadress".

Huvikooli rühma ja lepingulise huvitegevuse ringi andmetesse on lisatud aadressi väli "Tegevuse aadress". Väli on seadistustega ARNO_HK_RYHM_KOHUSTUSLIKUD_VALJAD, ARNO_LEP_HUVITEGEVUS_RINGI_KOHUSTUSLIKUD_VALJAD määratud kohustuslikuks.

Aadressi otsimiseks peab sisestama vähemalt kolm sümbolit. Peale seda avaneb rippmenüü kõikide leitud aadressidega. Kõik aadressid leitakse Maa-ameti registrist.

Aadressi valimiseks tuleb klikata aadressi rea peal. Valitud aadress paistab järgmiselt:

Valitud aadressi tühistamiseks peab klõpsama aadressi rea lõpus olevale ikoonile X.

Aadressi otsimist Arnos võib võrrelda aadressi otsimisega aadressilt: https://inaadress.maaamet.ee/generaator/.

Kui Maa-amet on maas, siis otsimisel tuleb veateade: "Aadressi otsimisel tekkis viga. Teie aadressi ei ole hetkel võimalik salvestada. Palun proovige hiljem uuesti".

 

Asutuse aadressi on võimalik lisada korraga kõikidele rühmadele / ringidele. 

  • Huvikooli vaade: Linnuke "Lisa aadress ka kõikidele rühmadele" lisab asutuse aadressi kõigile rühmadele, kus tegevuse aadressi ei ole.

  • Lepingulise huvitegevuse vaade: Linnuke "Lisa aadress ka kõikidele ringidele" lisab asutuse aadressi kõigile ringidele, kus tegevuse aadressi ei ole.

Kontaktandmed:

  • Väljale “Kontakt” lisatakse isiku või asutuse nimi, muu soovitud nimetus.

  • Väljale “Üldtelefon” lisatakse telefoninumber.

  • Väljale “Peamine e-post” on võimalik märkida ainult üks e-posti aadress.

image-20241205-105519.png

Kõik kolm välja on kohustuslikud täita.

 

Huvikooli rühma väli "Toimumise aeg":

  • Väli on seadistustega ARNO_HK_RYHM_KOHUSTUSLIKUD_VALJAD vaikimisi kohustuslik;

  • Kui väli ei ole täidetud, siis salvestamisel kuvatakse viga "Kohustuslik väli täitmata: Tegevuse toimumise aeg!";

  • Väljal on olemas maksimaalne pikkus. Kui see on ületatud, siis salvestamisel kuvatakse veateade "Väli on liiga pikk: Toimumise aeg (maksimaalne pikkus 200 sümbolit)".


Huvikooli rühma väli "Tegevuse toimumise koht":

  • Väli on seadistustega ARNO_HK_RYHM_KOHUSTUSLIKUD_VALJAD vaikimisi kohustuslik;

  • Kui väli ei ole täidetud, siis salvestamisel kuvatakse viga "Kohustuslik väli täitmata: Tegevuse toimumise koht!";

  • Väljal on olemas maksimaalne pikkus. Kui see on ületatud, siis salvestamisel kuvatakse veateade "Väli on liiga pikk: Tegevuse toimumise koht (maksimaalne pikkus 256 sümbolit)".

 

Huvikooli rühma väljad "Toimumisperioodi algus" ja "Toimumisperioodi lõpp":

  • Väljad on seadistustega ARNO_HK_RYHM_KOHUSTUSLIKUD_VALJAD vaikimisi kohustuslikud;

  • Kuupäevad peavad olema kujul pp.kk.aaaa;

  • Kuupäeva saab käsitsi sisestada või valida kalendrist, mis avaneb peale väljal klõpsamist;

image-20260320-114017.png
  • Kui väljad ei ole täidetud, siis kuvatakse vastavad veateated "Kohustuslik väli täitmata: Toimumisperioodi algus!" või "Kohustuslik väli täitmata: Toimumisperioodi lõpp!";

  • Toimumisperioodi alguskuupäev peab olema varasem või sama toimumisperioodi lõpukuupäevaga.

  • Kui toimumisperioodi lõpukuupäev on varasem kui toimumisperioodi alguskuupäev, siis salvestamisel kuvatakse veateade "Toimumisperioodi lõpp ei tohi olla varasem toimumisperioodi algusest".

 

Huvikooli rühma ja lepingulise huvitegevuse ringi väli "Toetuse info":

image-20260320-114241.png
  • Välja väärtust on võimalik valida ripploendist nelja valiku vahel:

a) Erahuviharidus valla toetusega

b) Valla munitsipaalhuviharidus/tegevus

c) Erahuvikoolid

d) Muu huvitegevus

  • Välja nime järel asub informatsiooni ikoon, millel klõpsates avaneb pikem selgitav tekst iga toetusliigi kohta.

image-20260320-115844.png

 

Huvikooli rühma ja lepingulise huvitegevuse ringi väli "Juurdepääs ratastooliga":

image-20260320-120122.png
  • Välja väärtust saab ripploendist valida: Ei / Jah;

  • Väli on seadistustega ARNO_HK_RYHM_KOHUSTUSLIKUD_VALJAD ja ARNO_LEP_HUVITEGEVUS_RINGI_KOHUSTUSLIKUD_VALJAD vaikimisi kohustuslik;

  • Kui väli jääb tühjaks, siis salvestamisel kuvatakse viga "Kohustuslik väli täitmata: Juurdepääs ratastooliga!".

  • Tühja väärtust on  võimalik salvestada juhul, kui väli ei ole määratud kohustuslikuks.

 

Lepingulise huvitegevuse väli "Veebilehe aadress":

image-20260320-120815.png
  • Väli ei ole kohustuslik;

  • Väljal on olemas maksimaalne pikkus. Kui see on ületatud, siis salvestamisel kuvatakse veateade "Väli on liiga pikk: Veebilehe aadress (maksimaalne pikkus 500 sümbolit)".


Lepingulise huvitegevuse ringi väli "Kuutasu (€)":

image-20260320-121104.png
  • Välja väärtust saab sisestada komaga või punktiga;

  • Väli on seadistustega ARNO_LEP_HUVITEGEVUS_RINGI_KOHUSTUSLIKUD_VALJAD vaikimisi kohustuslikuks;

  • Kui väli ei ole täidetud, siis salvestamisel kuvatakse viga "Kohustuslik väli täitmata: Kuutasu (€)!";

  • Kui on sisestatud negatiivne summa, siis salvestamisel kuvatakse veateade "Sisestatud kuutasu on vigane: summa ei tohi olla negatiivne!";

  • Kui väljale sisestatakse teksti, siis salvestamisel kuvatakse veateade "Kuutasu (€) väärtus peab olema arv!".

 

Vanusepiirid:

  • Lepingulise huvitegevuse ringi andmetes:

image-20260320-135227.png
  • Huvikooli rühma andmetes:

image-20260320-135432.png

 

 

 

 

2. Saadetavad väljad

Saadetava välja kood GISis

Kust andmed Arnos võetakse

Olulised piirangud, lisainfo

Saadetava välja kood GISis

Kust andmed Arnos võetakse

Olulised piirangud, lisainfo



Huvikool

Lepinguline huvitegevus



nimi

Kooli nimi

Asutuse nimi

Väli on kohustuslik

ryhmnimi

Rühma nimetus

Ringi nimetus

Väli on kohustuslik

ads

Rühma tegevuse aadress

Ringi tegevuse aadress

Väli on kohustuslik

kontakt

Huvikooli kontaktandmed: Kontakt

Asutuse kontaktandmed: Kontakt

Väli on kohustuslik

email

Huvikooli kontaktandmed: Peamine e-post

Asutuse kontaktandmed: Peamine e-post

Väli on kohustuslik

telefon

Huvikooli kontaktandmed: Üldtelefon

Asutuse kontaktandmed: Üldtelefon

Väli on kohustuslik

url

Huvikooli andmed: Veebilehe aadress

Asutuse andmed: Veebilehe aadress

Väli ei ole kohustuslik

arno_url

Rühma andmete vaade

Ringi andmete vaade

Tuleb süsteemist automaatselt

tyyp

Rühma valdkond

Ringi valdkond

Väli on kohustuslik

liik

Rühma alamvaldkond

Ringi alamvaldkond

Väli on kohustuslik

keel

Rühma andmed: Õppekeel

-

Huvikool: Väli on kohustuslik

juhendaja

Rühma andmed: Treener/õpetaja

-

Väli ei ole kohustuslik

vanusalam

Rühma andmed: Osaleja vanuse alampiir

Ringi andmed: Vanus alates

Väli ei ole kohustuslik

vanusylem

Rühma andmed: Osaleja vanuse ülempiir

Ringi andmed: Vanus kuni

Väli ei ole kohustuslik

lisainfo

Rühma andmed: Märkus (avalik)

Ringi andmed: Lühikirjeldus

Väli ei ole kohustuslik

taeg

Rühma andmed: Toimumise aeg

Ringi andmed: Toimumisaja märkus 

Väli on kohustuslik

kohaarvtais

Rühma andmed: “Kohtade arv” ja “Osalejaid”

-

Kui Arnos Kohtade arv = Osalejaid, siis paistab väärtus “Jah” (1). Vastasel juhul “Ei” (0).

vabadkohtarv

Rühma andmed: “Kohtade arv” ja “Osalejaid”

-

Huvikool: “Kohtade arv” miinus “Osalejaid”. Kui algandmed on märkimata, siis saadetakse info “Piiramata”.

Lepinguline huvitegevus: saadetakse “Piiramata”.

juurdepaas

Rühma andmed: Juurdepääs ratastooliga

Ringi andmed: Juurdepääs ratastooliga

Väli on kohustuslik. Saadetakse väärtus “Jah” (1) või “Ei” (0).

maksumus

Rühma osamakse (€)

Ringi andmed: Kuutasu (€)

Väli on kohustuslik

rlopp

Välja väärtus sõltub "Toimumisperioodi algus" ja "Toimumisperioodi lõpp" kuupäevadest.

Välja väärtus sõltub lepingulise huvitegevuse lepingu aastast ja lepingu staatusest.

Välja väärtused on "Jah" (tegevus on lõppenud) või "Ei" (kehtiv)

Huvikool:

  • Kui toimumisperiood praegu kehtiv, siis rlopp = "Ei";

  • Kui toimumisperioodi lõpp on kuni eile (k.a.), siis rühma tegevus on lõppenud, rlopp = "Jah";

  • Kui toimumisperioodi algus on tulevikus, siis rlopp väärtus on "Ei".

  • Kui rühm on peidus, siis saadetakse info, et rühm on lõpetanud tegevuse, rlopp = "Jah"

Lepinguline huvitegevus:

  • "Kehtiv" ja "Tulekul" staatuse puhul on rlopp "Jah";

  • "Tühistatud" ja "Lõppenud" staatuse puhul on rlopp "Ei".

akuupaev

Rühma andmed: Toimumisperioodi algus

-

Väli on kohustuslik. Kuupäevad on saatmiseks teisendatud millisekunditesse. Näit.: 02.09.2024 > 1725235200000 (kuupäeva õigsust millisekundites saab kontrollida siit: https://currentmillis.com/)

lkuupaev

Rühma andmed: Toimumisperioodi lõpp

-

Väli on kohustuslik. Kuupäevad on saatmiseks teisendatud millisekunditesse. Näit.: 02.09.2024 > 1725235200000 (kuupäeva õigsust millisekundites saab kontrollida siit: https://currentmillis.com/ )

kohtadearv

Rühma andmed: Kohtade arv / Kohtade arv piiramata

-

Väli ei ole kohustuslik

tkoht

Rühma andmed: Tegevuse toimumise koht

Ringi andmed: Asukoht

Väli on kohustuslik

toetusliik

Rühma andmed: Toetuse info

Ringi andmed: Toetuse info

Väli on kohustuslik

3. Saatmise loogika

3.1 Cron

Andmete ArcGIS-i saatmiseks on cron saadaArcGis. Kasutajaliideses ei ole võimalust andmete saatmise käivitamiseks.

Cron käivitub üks kord ööpäevas, öösel. Cron saadab ringe ükshaaval. Kui peale croni käivitamist muutuvad ringi / rühma andmed, siis need jõuavad ArcGISi järgmise croni käivitamisega (kui muu on korras).

Andmete uuesti saatmine: cron ei vaata, kas ja mis muudatusi tehti, vaid võtab kogu info ja saadab ArcGISi.

Huvikooli puhul:

  • Päringuga leitakse kõik käesoleva ja järgmise õppeaasta rühmad päringuga, mille kohta saata andmeid;

  • Õppeaasta vahetusel toimub viimane eelmise õppeaasta andmete saatmine 1. septembril  ja rohkem varasema õppeaasta rühma andmeid ei saada!

Lepingulise huvitegevuse puhul:

Saadetakse neid ringe, kus on kehtiv käesoleva aasta leping või järgmise aasta kehtiv leping ja käesoleva aasta leping puudub.

3.2 Logimine

Menüüs "Admin" > "Logid" > “ArcGIS“ lingile klõpsates avaneb ArcGISi saatmise logi.

image-20260320-133146.png

Kui rühm / ring on kord saadetud, siis logi tabelisse ilmub vastav rida. Kui ringi andmed uuenevad, siis logi tabelis uuendatakse olemasolevat rühma / ringi rida. Uut rida topelt ei teki.

Objekt ID: rühma / ringi ID, mis on lingitav ning viib vastava rühma või huviringi vaatesse.

Objekt tabel:

  • arno_huvikooli_ryhm: huvikooli rühma andmed.

  • arno_huviring: lepingulise huvitegevuse ringi andmed.

Teenuse kood: hetkel ainuke väärtus "huvitegevuse_saatmine".

Viimase saatmise kuupäev: kuupäev, millal cron viimati andmed saatis.

Veateade: antud veerus on veateated, mis võivad tekkida andmete saatmise käigus.

Päring: Veerus on nupp [Päring], millele klõpsates on näha, millised andmed saadeti ArcGISi.

Vastus: Veerus on nupp [Vastus], millele klõpsates on näha, kas andmete saatmine oli edukas või mitte.

4. Võimalikud veateated

Veateade

Mida see tähendab?

Mis tuleb teha

Veateade

Mida see tähendab?

Mis tuleb teha

Veakood: 10500, veakirjeldus: Database error has occurred

Ilmselt puuduvad vajalikud andmed

Tuleb minna rühma (või seotud asutuse) andmete vaatesse ja lisada puuduvad andmed.







Märkus: juhul, kui kasutajale kuvatakse teisi vigu, siis kuvatud vea kohta on võimalik infot vaadata siit: https://developers.arcgis.com/net/reference/platform-error-codes/