Rajapintakyselyiden testausohje

Sääntömoottorin asetusten testaus

Rajapintakyselyiden testaamisessa käytetään Testiaineistopalvelua:

• osoite: https://testiaineisto.fiAvautuu uuteen ikkunaan.
• tunnukset palveluun saat käyttöönottotiimiltä

Tutustu sääntömoottorien kuvauksiin: 

• Sääntömoottori yrityksen puolesta asioinnissa (OrganizationalRoles)
• Sääntömoottori henkilön puolesta asioinnissa (Delegate, Authorization)

Yrityksen puolesta asiointi

Testaa rajapintapalvelun integraatio ja varmista, että  valtuuskyselyssä asiointipalvelulle palautuvat ne roolit ja valtuudet,  joita yrityksen puolesta asiointi asiointipalvelussanne edellyttää.

Suosittelemme asioinnin sallimista ainakin toimitusjohtajalle ja nimenkirjoitusoikeudelliselle, koska he voivat joka tapauksessa valtuuttaa itsensä asioimaan. Näille rooleille tulisi siis  sallia perusrekisteripohjainen yrityksen puolesta asiointi, jotta heidän ei tarvitse tarpeettomasti valtuuttaa itseään. Säännöt 015.002.1.1 ja  016.002.1.2 mahdollistavat tämän, ja valtuuskyselyn vastauksesta tulee  silloin huomioida TJ- ja NIMKO-roolit.

Sääntömoottorin sääntö: 015.002.1.1 Henkilöllä on oltava määritelty toimielintehtävä

Säännön valinta ja säännön palauttama tieto: ELI, IS, J, PJ, S, TIL, TJ, YHM

Testataan valitsemalla Testiaineistopalvelusta henkilö, jolla on yrityksessä ko. rooli. Tarkista palautuuko rooli valtuuskyselyn vastauksessa.

Esimerkki vastaussanomasta Web API -liitynnällä TJ-roolilla:

[{"name":"Rova Oy","identifier":"7019376-8","complete":true,"roles":["TJ"]}]

Esimerkki vastaussanomasta Palveluväylä-liitynnällä TJ-roolilla:

<organization>
    <organizationIdentifier>7019376-8</organizationIdentifier>
    <name>Rova Oy</name>
    <roles>
        <role>TJ</role>
    </roles>
</organization>

Muut roolit välitetään valtuuskyselyn vastaukseen samoin eli roolista välitetään roolin lyhenne vastaussanomaan, jos rooli on valittuna sääntömoottorin asetuksissa.

Sääntömoottorin sääntö: 016.002.1.2 Henkilöllä on oltava nimenkirjoitusoikeus tietyllä oikeustasolla

• Säännön valinta: oikeutettu, prokuristi
• Säännön palauttama tieto: NIMKO

Testaa valitsemalla Testiaineistopalvelusta henkilö, jolla on nimenkirjoitusoikeus yritykseen. Tarkista palautuuko valtuuskyselyn vastauksessa NIMKO-rooli.

HUOM! Tällä roolilla on syytä aina mahdollistaa yrityksen puolesta asiointi, koska yrityksen nimenkirjoitusoikeudellinen voi joka tapauksessa aina valtuuttaa itsensä.

Esimerkki vastaussanomasta Web API -liitynnällä:

[{"name":"Rova Oy","identifier":"7019376-8","complete":true,"roles":["NIMKO"]}]

Esimerkki vastaussanomasta Palveluväylä-liitynnällä

<organization>
  <organizationIdentifier>7019376-8</organizationIdentifier>
  <name>Rova Oy</name>
    <roles>
        <role>NIMKO</role>
    </roles>
</organization>

Sääntömoottorin sääntö: 019.003.1.2 Henkilölle löytyy valtuus valtuusrekisterissä

• Säännön valinta: <valtuusasia>
• Säännön palauttama tieto: <valtuusasian tekninen tunniste (URI)>

HUOM! Vain sääntömoottorilla valitut valtuusasiat palautetaan valtuuskyselyssä. Valtuuskoodien luvituksen sääntömoottorille voi pyytää käyttöönottotiimiltä.

Esimerkki vastaussanomasta Web API -liitynnällä:

[{"name":"Rova Oy","identifier":"7019376-8","complete":true,"roles":
["http://valtuusrekisteri.suomi.fi/palkkatietojen_ilmoittaminen"]}]

Esimerkki vastaussanomasta Palveluväylä-liitynnällä

<organization>
  <organizationIdentifier>7019376-8</organizationIdentifier>
  <name>Rova Oy</name>
    <roles>
        <role>http://valtuusrekisteri.suomi.fi/palkkatietojen_ilmoittaminen</role>
    </roles>
</organization>

Henkilön puolesta asiointi

Henkilön puolesta asioinnissa valtuuskyselyn vastauksessa palautuu  aina kyllä/ei-tyyppinen vastaus tai säännön 019.003.1.1 alta valittu  valtuusasian tekninen tunniste (URI). Muutoin säännöt ovat asioinnin  estäviä sääntöjä.

• Authorization-kyselyllä palautuu ALLOWED / DISALLOWED.
• AuthorizationList-kyselyllä palautuu ALL-rooli, jos on oikeus  alaikäisen huollettavan puolesta asiointiin, tai valtuuskoodin tekninen  tunniste, jos on saatu valtuus aikuisen puolesta asiointiin.