Laskentakohteiden käsittelyn toiminnot jakautuvat seuraaviin toimintoihin:
| Integraatio | HTTP-metodi | Resurssi | DTD | Esimerkki |
| Laskentakohdelistan nouto | GET | dimensionlist.nv | Lataa | |
| Laskentakohteen tuonti | POST | dimensionitem.nv | Lataa | Lataa |
| Laskentakohteen piilotus | POST | dimensiondelete.nv |
Laskentakohdelistan nouto
Resurssi: dimensionlist.nv
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| showhidden | 0..1 | Jos 1, myös piilotetut laskentakohteet näytetään tuloksissa | 1 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | Root | Aggregaatti | 1 | ||
| 1 | DimensionNameList | Aggregaatti | 1 | ||
| 2 | DimensionName | Aggregaatti | 0...n | ||
| 3 | Netvisorkey | Numeerinen | 1 | Laskentakohdeotsikon Netvisor-avain | 123 |
| 3 | Name | Merkkijono | 1 | Laskentakohdeotsikon nimi. | |
| 3 | IsHidden | Boolean | 1 | Onko kohde piilotettu: true tai false | false |
| 3 | LinkType | Numeerinen | 1 | ||
| 3 | DimensionDetails | Aggregaatti | 1 | Laskentakohdeotsikon alla olevien laskentakohteiden listaus | |
| 4 | DimensionDetail | Aggregaatti | 0...n | ||
| 5 | Netvisorkey | Numeerinen | 1 | Laskentakohteen tunnus Netvisorissa | |
| 5 | Name | Merkkijono | 1 | Laskentakohteen nimi | |
| 5 | IsHidden | Boolean | 1 | Onko laskentakohde piilotettu: True tai false | |
| 5 | Level | Numeerinen | 1 | Laskentakohteen taso | |
| 5 | Sort | Numeerinen | 1 | Laskentakohteen järjestysnumero. Numerointi alkaa nollasta (0). | |
| 5 | EndSort | Numeerinen | 1 | Kyseisen laskentakohteen viimeisen alilaskentakohteen järjestysnumero. | |
| 5 | FatherId | Numeerinen | 1 | Laskentakohteen ylemmän kohteen tunnus |
Laskentakohteen tuonti
Resurssi: dimensionitem.nv
Käytetään Netvisorin laskentakohteen lisäykseen ja muokkaamiseen. Lisättävän laskentakohteen laskentakohdeotsikko tulee löytyä järjestelmästä.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| method | 1 | add tai edit Itse sanomalla ilmoitetaan minne kohde lisätään hierarkiassa tai mitä kohdetta muokataan. | add |
| updateparentreference | 0...1 | Aina true. Käytetään vain laskentakohteen muokkauksessa, mahdollistaa laskentakohteen hierarkian muuttamisen. | true |
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | dimensionitem | Aggregaatti | 1 | ||
| 2 | name | Merkkijono Max. 50 | 1 | Laskentakohdeotsikon nimi jonka alle laskentakohde luodaan | Laskentakohde otsikko |
| 2 | item | Merkkijono Max. 200 | 1 | Laskentakohteen nimi. Laskentakohdeotsikon tulee olla perustettuna Netvisoriin ennen laskentakohteen lisäystä. | Laskentakohde |
| 2 | olditem | Merkkijono | 0...1 | Jos halutaan päivittää vanhaa olemassa olevaa kohdetta, niin annetaan päivitettävän kohteen nimi (*1 | Laskentakohde |
| 2 | fatherid | Numeerinen | 0...1 | Laskentakohteen id Netvisorissa jonka alle uusi kohde luodaan hierarkiassa (*2 | 0 |
| 2 | fatheritem | Merkkijono | 0...1 | Laskentakohteen nimi Netvisorissa, jonka alle uusi kohde luodaan hierarkiassa (*2 | Uusi laskentakohde |
| 2 | ishidden | Boolean | 0...1 | Onko laskentakohde piilotettu: True tai False True=Piilotettu, False=Näkyvillä | true |
Huomioitavaa XML-sanoman sisällössä laskentakohteita lisättäessä ja muokatessa:
*1) Elementti olditem on pakollinen kun muokataan olemassa olevaa laskentakohdetta, ei väliä missä kohtaa hierarkiaa muokattava kohde on
*2) Elementit fatherid ja fatheritem ovat pakollisia kun uusi laskentakohde halutaan lisätä jo olemassa olevan laskentakohteen alle eli alemmalle tasolle hierarkiassa
Laskentakohteen piilotus
Resurssi: dimensiondelete.nv
Käytetään laskentakohteen piilottamiseen Netvisorista. Resurssi poikkeaa muista siten, että siinä ei lähetetä XML-dataa tuonnissa vaan kaikki data kuljetetaan QueryString:ssä. Rajapinnan yli ei ole mahdollista poistaa laskentakohteita.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| dimensionname | 1 | Laskentakohdeotsikko, jonka alla piilotettava kohde on | |
| dimensionsubname | 1 | Piilotettavan kohteen nimi |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback