Käyttäjätilin resurssien käyttöä voi seurata käyttäjätilin hallinnointi sivulla.
Kun kuukausittainen tiedonsiirto kiintiö on käytetty käyttäjätilin tiedonsiirto sivustolta internettiin ei ole käytettävissä. Käyttöliittymässä on pääsy lisä aikajakson tilaamis toimintoon jolla voi uudelleen aktivoida tiedonsiirron.
Tallennuskapasiteetti on käyttäjätilin kaikkien järjestelmässä olevien tietojen summan maksimimäärä. Suurin osa tallenuskapasiteetista on tyypillisesti puu rakenteiden merkkidataa. Tallennettu merkki vie 1-4 tavua tilaa riippuen merkin vaatimasta tilasta utf-8 merkistökoodauksessa. Ascii merkki vie tilaa yhden tavun. Solmun ja puussa siihen osoittavan linkin tallentaminen vie tilaa 26 tavua + tallennetun tekstidatan viemä tila.
Tallennus kapasiteetti kiintiön täytyttyä uusien tietojen tallentaminen lakkaa. Käyttöliittymässä on pääsy lisä aikajakson tilaamis toimintoon jolla voi tilata heti käytettävissä olevan tallennus kapasiteetin lisäyksen.
Termit
| Puu | Verkko jossa jokaisesta solmusta jokaiseen toiseen solmuun johtaa yksi polku |
| Solmu | Teksti data tallennetaan puun solmuihin |
| Linkki | Linkki yhdistää puu rakenteessa lähde ja kohde solmut |
| Linkki lista | Järjestetty lista linkkejä joissa lähde solmu on sama |
| Juuri solmu | Puu rakenteen solmu josta linkki kytkökset alkaa |
| Polku | Ketju linkkejä joissa seuraavan linkin lähde solmu on edellisen linkin kohde solmu |
Käyttöliittymässä käytetään yleisesti termiä verkko kun tarkoitetaan puu tietorakenteita joihin tekstidata liittyy
Verkon tallennettavien tietojen rakenteen esittäminen dokumentaatiossa
Verkon solmujen teksti sisältö listataan allekkain niin että solmuun on linkki edeltävältä riviltä jonka tekstin sisentämisen määrä on yhtä tasoa vähemmän. Suluissa oleva teksti on kommentti joka ei sisälly noodin tekstiin.
Linkit: aikajakson tilaaminen palveluun
Statistiikka: resurssien käyttö
Salasanan vaihto
Create a graph.
Verkon tietojen näyttäminen ja navigointi puu rakenteena, html sivu
Näkymän toiminnot:
| ▶ / ▼ | Avaa / sulkee listan solmuista joihin on linkki puu rakenteessa toiminnon solmusta |
Verkon tietojen näyttäminen puu rakenteena, kaikki tiedot kanvas näkymässä.
Näkymän toiminnot:
| Hiiren vasemman painikkeen pitäminen pohjassa ja hiiren liikuttaminen | Liikuttaa näkymää |
| Hiiren scroll toiminto | Vierittää näkymää ylös / alas |
| Shift + hiiren scroll toiminto | Kasvattaa / pienentää fontin kokoa |
| Hiiren vasen painike + hiiren scroll toiminto | Kasvattaa / pienentää puu rakenteen kokoa |
Etsi verkosta solmuja tekstin perusteella.
Verkon solmujen tiedot on muokattavana tekstialue elementissä.
Sivulla on aluksi verkon juuri solmu.
Solmun toiminnot:
| ▶ / ▼ | Avaa / sulkee listan solmuista joihin on linkki puu rakenteessa toiminnon solmusta |
| Tallenna | Tallentaa tekstialuessa olevat tiedot |
| Poista | Poistaa solmun järjestelmästä |
| Lisää | Lisää uuden solmun ja tekee linkin puu rakenteessa toiminnon solmusta uuteen solmuun |
| Siirrä | Vaihda lähde solmu linkissä jossa toiminnon solmu on kohde solmu |
| Ylös | Siirrä solmua linkki listassa ylös |
| Alas | Siirrä solmua linkki listassa alas |
| Linkin sijainti | Valitse solmun sijainti linkki listassa |
| * | Avaa kaikki listat solmuista joihin on polku alkaen toiminnon solmusta |
Muutoksia solmun tekstiin ei voi tallentaa sen jälkeen kun puuhun on tallennettu muutos eri selain ikkunasta.
Verkon muokkaus osoitteen sivulla voi kirjautua verkon käyttäjätunnuksilla. Palvelun hallinnointi käyttäjätunnuksilla ei voi kirjautua.
Poista verkko.
Toiminto tekee verkon tiedoista tiedoston jonka tiedot voi tuoda "Lisää verkko" toiminnolla. Tiedostot listataan sivulla ja niiden sisällön voi ladata sekä poistaa.
Tiedosto on gzip ohjelmalla pakattu binaari tiedosto jossa on verkon jokaisen solmun tiedot niin että ensin on uint32_t tyypin integer arvo "linkin lähdesolmun id", sitten uint32_t tyypin integer arvo joka on "solmun id", sitten uint32_t tyypin integer arvo joka on tekstin pituus tavuina, jonka jälkeen on solmun teksti tieto.
Muutosten poistaminen ja listaus
Muutos tyypit
Verkon rajapinnan kohteita voi lisätä. Listauksessa on muokkaus ja poisto toiminnot. Kohteisiin voi määritellä tallennettavien tietojen konversio sääntöjä sekä validointi sääntöjä.
Näkymän "form" tyypin elementti tallentaa tiedot valittuun kohteeseen, muokkaa kohteeseen tallennettuja tietoja ja näyttää tallennetut muokattavat tiedot täytettynä lomakeen kontrolleihin.
| Kohteen nimi | Kohteen nimi sen valitsemista varten näkymän lomake tyypin elementille |
| Valitse solmu | Kohteen solmun valinta. Kohteeseen tallennettavat tiedot lisätään valitulle solmulle lisättävän linkin kohde solmuun. |
| Uudelleen ohjaus url osoite: tietojen tallentaminen onnistui | Url osoite johon selain ohjataan kun lomakkeen validoinnissa tai tietojen tallentamisessa ei tapahtunut virhettä. |
| Uudelleen ohjaus url osoite: virhe, tietoja ei tallennettu | Url osoite johon selain ohjataan kun lomakkeen validoinnissa tai tietojen tallentamisessa tapahtui virhe. |
| Viesti: tietojen tallentaminen onnistui | Teksti viestiin joka näytetään ylläpitokäyttöliittymässä kun tietojen tallentaminen onnistui |
| Viesti: virhe, tietoja ei tallennettu | Teksti viestiin joka näytetään ylläpitokäyttöliittymässä kun tietojen tallentamisessa tapahtui virhe ja tietoja ei tallennettu |
Konversio säännöt määrittelevät muunnoksen joka tekstille suoritetaan kun tiedot tallennetaan tai haetaan muokattavaksi näkymän lomake tyypin elementillä.
Validointi säännöt määrittelevät ehdot jotka nimetyn kontrollin tallentaman tekstin pitää täyttää jotta tiedot tallennetaan.
Näkymä on käyttäjän määrittelemä vapaamuotoinen html sisältö joka on tarkoitettu tietojen syöttämiseen verkkoihin vapaamuotoisilla html lomakkeilla. Näkymän muokkaus lomakkeessa on toimintoja tietojen kohteen valitsemiseksi tallentamista varten.
Verkkojen käyttäjille voi lisätä käyttöoikeuden näkymään. Tietojen lukemista ja tallentamista varten käyttäjällä on oltava oikeudet verkon rajapintaan.
Luo uusi näkymä jolla on nimi.
(Verkon alkuperäinen juuri solmu)
(Uusi tallennettu solmu)
parametri1 (ensimmäinen avain)
x (ensimmäinen arvo)
parametri2 (toinen avain)
y (toinen arvo)
Näkymän katselussa voi käyttää html elementeissä data attribuutteja tietojen tuomiseksi verkoista sekä tietojen viemiseksi verkkoihin lähettämällä html lomakkeita. Html koodin attribuuttien arvojen merkitsemiseen on käyttettävä " merkkiä.
Elementin nimeä vastaava painike tekee elementin jolla on sitä vastaavat toiminnot aktivoiva data attribuutti. Tekstialueen kursorin asettaminen elementin tagin määrittelevän tekstin sisälle tuo näkyviin kontrollit elementin asetusten määrittelemistä varten.
Jos html lomakkeelle asettaa verkon rajapinnan kohteen tiedot lisätään lomakkeen tallentamisen yhteydessä kohteen solmun linkiksi.
Käytössä olevat määritelmät
| Elementin nimi käyttöliittymässä | Elementin kuvaus | data-element-type attribuutin arvo | Kontrolli | Data attribuutin nimi | Kuvaus |
| Ei elementti tyyppiä | Kontrollit ovat käytössä kaikissa html elementeissä | Näkyvyys ehto: url get parametrin nimi | data-condition-url-parameter-name | Url osoite get parametrin nimi elementin näkymiselle määriteltävälle ehdolle | |
| Näkyvyys ehto: url get parametrin arvo | data-condition-url-parameter-value | Jos get parametrilla on määritelty arvo elementin näkyvyys ehto on voimassa | |||
| Näkyvyys ehto: get parametrin nimi ei ole url osoitteessa | data-condition-url-parameter-name-unset | Jos kontrolli on valittu tai attribuutin arvo on "1" elementti on näkyvissä jos attribuutilla ei ole määriteltyä arvoa. | |||
| Form elementti | Html form elementin tietojen käsittely. Verkon rajapinnan kohteen valinta tietojen tallentamista ja kontrollien täyttämistä varten. | form | Verkon rajapinnan kohde | data-node-api-target-id | Lomake lähetetään kontrollissa valittuun verkon rajapintaan |
| Lomake datan juuri solmun tietojen nimi | data-source-name | Kontrollin määrittelemää nimettyä solmua käytetään lomake datan juuri solmuna. Lomake datan juuri solmun linkkien kohteena olevien solmujen teksti vastaa kontrollin nimeä. Kontrollin nimen määrittelevän solmun ensimmäistä linkkiä käytetään kontrollin arvona. | |||
| Lomake id palvelimen palauttamille validaatio viesteille | data-form-id | Tunniste lomakkeen valitsemiseksi kun näytetään palvelimen palauttamat validaatio viestit. | |||
| Lomake datan juuri solmu id, selaimen get parametrin nimi | data-url-source | Nimeä vastaavaa url get parametrin arvoa käytetään täytettävien lomake kontrollien tietojen juuri solmun id tietona. Lomake datan juuri solmun linkkien kohteena olevien solmujen teksti vastaa kontrollin nimeä. Kontrollin nimen määrittelevän solmun ensimmäistä linkkiä käytetään kontrollin arvona. | |||
| Linkki lista | Verkon solmun linkkien tietojen hakeminen | link-list | Listan linkkien lähde solmun verkko | data-source-node-id | Verkon valinta listan linkkien lähdesolmun valintaa varten. Linkkien lähdesolmuksi asetetaan valittaessa verkon juurisolmu. |
| Kohde noodi, linkki polku | data-source-node-id | Solmun valinta listan linkkien lähdesolmuksi valitusta verkosta. | |||
| Solmun tekstitietojen nimi | data-node-name | Kontrollin määrittelemää nimeä käytetään listan solmujen tietojen valitsemiseksi elementin sisällä olevissa elementeissä. | |||
| Tulosten maksimimäärä sivulla | data-pagination-result-count | Linkkien maksimi lukumäärä yhdellä sivulla kun käytetään sivunumerointia | |||
| Listan nimi tulos sivu elementin asetuksissa | data-pagination-list-name | Listan nimi sen valitsemista varten tulos sivu elementille | |||
| Käännä linkkien järjestys | data-list-order-reverse | Jos kontrolli on valittu tai attribuutin arvo on "1" linkkien järjestys käännetään | |||
| Sisältö ei ole näkyvissä ennen kun tiedot on ladattu, | data-content-load-hide | Jos kontrolli on valittu tai attribuutin arvo on "1" elementin sisältö ei ole näkyvissä ennen kun tiedot on ladattu | |||
| Listan järjestys ehto n, linkki polku arvo solmun tekstisisällölle | data-sort-condition-type-n="value" data-sort-condition-value-n | Lista ehtoja linkkipolun muodostamiseksi linkki listan solmun linkin kohde noodista eteenpäin. "n" on ehdon indeksi, ensimmäisen ehdon indeksi on 0. Ehdon indeksiä vastaavan linkkipolun linkin kohde noodin teksti täytyy olla sama kuin ehdon kontrollin teksti. Ehdon täyttävä linkkipolun linkki on järjestyksessä ensimmäinen ehdon täyttävistä linkeistä. | |||
| Listan järjestys ehto n, linkki polku arvo linkin indeksille | data-sort-condition-type-n="index" data-sort-condition-value-n | Lista ehtoja linkkipolun muodostamiseksi linkki listan solmun linkin kohde noodista eteenpäin. "n" on ehdon indeksi, ensimmäisen ehdon indeksi on 0. Ehdon indeksiä vastaavan linkkipolun linkin järjestys indeksi täytyy olla sama kuin ehdon kontrollin teksti. | |||
| Solmu | Verkon solmun tietojen hakeminen | node | Kohde solmu, linkki polku | data-source-node-id | Tietojen solmun ja verkon valinta |
| Solmun tietojen nimi | data-node-name | Kontrollin määrittelemää nimeä käytetään listan solmujen tietojen valitsemiseksi elementin sisällä olevissa elementeissä. | |||
| Linkki | Nimetyn lähde solmun linkin valinta kohdesolmun tietojen käyttöä varten. | link | Linkin teksti | data-source-value | Ehto linkin ja kohde solmun valitsemiseksi. Kohde solmun teksti täytyy olla sama kuin kontrollin teksti. |
| Solmun tietojen nimi | data-node-name | Kontrollin määrittelemää nimeä käytetään listan solmujen tietojen valitsemiseksi elementin sisällä olevissa elementeissä. | |||
| Linkin indeksi | data-source-index | Ehto linkin ja kohde solmun valitsemiseksi. Linkin järjestys indeksi täytyy olla sama kuin kontrollin teksti. | |||
| Tietojen lähde: solmun tietojen nimi | data-source-name | Kontrollin määrittelemää nimettyä solmua käytetään linkin valinnan ehdon lähde solmuna. | |||
| Linkki listan sivunumerointi | Elementin sisältö on valitun linkki listan sivunumerointi | link-list-pagination | Linkki listan nimi | data-list-name | Sivunumerointi elementin nimi sen valitsemista varten linkki lista elementin asetuksissa |
| Elementin attribuutti | Elementin sisältämän tekstin asettaminen sisältävän elementin attribuutin arvoksi. | element-attribute | Sisältävän elementin attribuutin nimi | data-element-attribute-name | Asetettavan attribuutin nimi |
| Solmun teksti ehto | Elementin sisältö tulostetaan jos valitun solmun teksti vastaa asetuksia | value-condition | Tietojen lähde: solmun tietojen nimi | data-source-name | Kontrollin määrittelemää nimettyä solmua käytetään linkin valinnan ehdon lähde solmuna. |
| Solmun teksti | data-condition-value | Ehdon edellyttämä solmun teksti | |||
| Reverse condition | data-condition-reverse | Ehdon kääntäminen. Jos kontrolli on valittu tai attribuutin arvo on "1" elementti on näkyvissä jos solmun teksti ei vastaa kontrollin tekstiä | |||
| Script | script | Elementin teksti sisältö suoritetaan javascript koodina. Elementti ei näy selaimessa. | |||
| Node id | text-node-id | Verkon solmun id tiedon tulostaminen | Tietojen lähde: solmun tietojen nimi | data-source-name | Kontrollin määrittelemää nimettyä solmua käytetään id tiedon tulostamiseen |
| Javascript eval | eval | Elementin teksti sisältö suoritetaan javascript koodina "eval" funktiolla ja suorituksen tulostus asetetaan html elementin innerHTML arvoksi | |||
| Aika | time | Tulostaa sekunttien määrän kellonaika formaatissa | Formaatti | data-format | Formaatin määrittely. Tunnit: "HH". Minuutit: "mm". Sekunnit: "ss". Esim. "HH:mm:ss". |
| Päivämäärä kellonaika | date-time | Tulostaa "Unix timestamp" numero arvon päivämäärä kellonaika formaatissa | Formaatti | data-format | Formaatin määrittely. Vuodet: YYYY. Kuukaudet: MM. Päivät: DD. Tunnit: "HH". Minuutit: "mm". Sekunnit: "ss". Esim. "YYYY-MM-DD HH:mm:ss". |
| Solmun teksti | node-value | Tulostaa solmun tekstin | Tietojen lähde: solmun tietojen nimi | data-source-name | Kontrollin määrittelemää nimettyä solmua käytetään teksti tiedon tulostamiseen |
| Korvaa teksti: lähde | data-replace-source-0 | Tekstin korvaaminen javascript replaceAll funktiolla, lähde tieto | |||
| Korvaa teksti: kohde | data-replace-target-0 | Tekstin korvaaminen javascript replaceAll funktiolla, kohde tieto |
Puu tietorakenteisiin käyttöoikeuksia omaavien "verkkojen käyttäjätilien" ylläpito.
Käyttäjille voi antaa näyttämis tai muokkaus oikeuden. Verkkojen käyttäjätilien on käytettävä kirjautumiseen käyttöoikeus listassa olevaa kirjautumis linkkiä.
Verkkojen käyttäjätili voi navigoida ylläpitokäyttöliittymässä listaan kaikista verkoista joihin sillä on pääsy.
Lisää verkolle käyttäjä
Tietojen muokkaus lomake
Käyttöoikeuksien lisääminen valittuun verkkoon:
Käyttöoikeuksien listaus ja poisto
Pääsy käyttöoikeuden lisääminen ja poistaminen näkymään.
Käyttöoikeuden lisääminen, listaus ja poistaminen. Verkon rajapinnan käyttöoikeudet määrittelevät mitä tietoja voi hakea ja tallentaa näkymän elementtejä käyttämällä.
| Käyttöoikeus tyyppi | Kuvaus |
| Katselu | Näkymän elementeillä voi hakea solmun tekstin. |
| Lisää | Verkon rajapinnan kohteeseen jonka solmuun käyttäjällä on "lisää" tyypin oikeus voi lähettää html lomakkeen jonka kontrollien arvont tallennetaan niin että rajapinnan solmuun lisätään linkki jonka kohde solmu on lomake tietojen juuri solmu, kontrollien nimiä käytetään juuri solmuun tallennettavien linkkien kohdesolmujen tekstinä ja kontrollien arvot tallennetaan nimiä vastaavien solmujen ensimmäisen linkin kohdesolmun arvona. |
| Muokkaa | Käyttäjä voi muokata tallennettujen solmujen tekstiä ja lisätä uusia avaimia sekä arvoja jotka vastaavat uusien kontrollien tietoja näkymän "form" tyypin elementillä jos verkon rajapinnan kohteelle jolla tiedot lisättiin oli valittu muokkaus oikeuksien lisääminen tietoa lisättäessä. Lisäksi käyttäjällä on "Katselu" oikeutta vastaava pääsy solmun tietoihin. |
Lisää lomake tallentaa käyttäjälle käyttöoikeuden verkon solmuun. "lisää" tyypin oikeudelle voi valita käyttöoikeus tyypin joka annetaan käyttäjälle kaikkiin lisättyihin solmuihin.
Poista verkon käyttäjätili.
Api käyttäjä tunnuksilla voi tehdä kyselyjä palvelun rajapintaan tiedon lisäämiseksi valittuun verkkoon. Api käyttäjä tunnuksilla ei voi kirjautua ylläpitokäyttöliittymään.
| Api url | Toiminto |
| https://verkkodata.fi/api/data/save/inputs/:access_id/:username/:password |
Lähetettyjen tietojen lisääminen verkkoon. Juuri solmuun lisätään uusi solmu jolla ei ole teksti sisältöä. Palvelimelle tehdyssä pyynnössä lähetetyt GET parametrit tai POST data tallennetaan lisättyyn solmuun. Selain pyynnön lomake tietojen avaimien nimet tallennetaan solmuina joihin tehdään linkki juureen lisätystä solmusta. Tietojen arvot tallennetaan solmuina joihin tehdään linkki vastaavasta avaimesta. Esimerkki. Selain pyyntö: https://verkkodata.fi/api/data/save/inputs/1/testuser/testpassword?parametri1=x¶metri2=y Tallennetut tiedot:
(Verkon alkuperäinen juuri solmu)
(Uusi tallennettu solmu)
parametri1 (ensimmäinen avain)
x (ensimmäinen arvo)
parametri2 (toinen avain)
y (toinen arvo)
|
Api käyttäjän lisääminen
Api käyttäjän muokkaaminen
Käyttöoikeuksien lisääminen ja poistaminen valittuun verkkoon.
Käyttöoikeudelle voi määritellä url osoitteen johon selain ohjataan onnistuneen tallentamisen jälkeen sekä url osoitteen johon selain ohjataan epäonnistuneen tallentamisen jälkeen.
Salasanan voi vaihtaa ilman pääsyä järjestelmään tekemällä 1e tilisiirron niin että maksun tekijä ja vastaanottaja ovat samat kun palvelun tilaamisessa ja laittamalla viestiin tekstin "salasanan vaihto", käyttäjätunnuksen, sekä sähköposti osoitteen johon salasanan vaihto linkki lähetetään.