Page History

...

Osoitepalvelu on tarkoitettu OPH:n työntekijöille osoitetietojen hakemista vartenvirkailijoille.  Palvelussa on käyttöliittymä, jonka avulla työntekijä voi hakea osoitetietoja yhteystietoja eri hakukriteereillä . Hakukriteerit voi myös tallentaa haluamalleen nimelle myöhempää tarvetta varten.ja tarvittaessa lähettää haetulle joukolle massasähköpostin.

Virkailija tarvitsee tunnukset Opintopolkuun ja seuraavat käyttöoikeudet: Osoitepalvelu ja Viestinvälityspalvelu - raportointi

Osoitepalvelu hakee tietoja seuraavista palveluista:

• Osoitepalvelun tekninen dokumentaatio
  • Organisaatioiden (esim. koulutuksen järjestäjät, oppilaitokset, toimipisteet) yhteystiedot.
  • Erityisesti huomioitavaa, varhaiskasvatuksen järjestäjien tiedot siirtyvät Organisaatiopalvelusta Vardaan. Vardasta siirtyy varhaiskasvatuksen toimipaikat Organisaatiopalveluun.  Varhaiskasvatuksen järjestäjien ja toimipaikkojen tiedot ovat Osoitepalvelussa poimittavissa OPHn virkailijoille. Avoimen rajapinnan kautta tietoja ei ole mahdollista saada.
• Käyttäjähallintapalvelu
  • Virkailijakäyttäjien yhteystiedot
  • Käyttöoikeusryhmät rajausehtolistaukseen
• Koulutustarjontapalvelu
  • Osoitteita voi hakea koulutustarjontaan tallennetun koulutuksen perusteella 
• Osoitepalvelun tekninen dokumentaatio
  • Rajausehtolistaukset: oppilaitostyypit, organisaation kielet, opetuskielet, vuosiluokat, koulutuksen järjestäjät
  • Rajausehtolistaukseen koulutusalat, opintoalat, tutkintotyypit sekä näiden väliset suhteet
  • Rajausehtolistaukseen maakunnat ja kunnat sekä näiden suhteet
  • Osoitteisiin täydennettävät lokalisoidut postitoimipaikat postinumeron perusteella

Osoitepalvelu noutaa Organisaatiopalvelun (kello 03:00) tiedot kerran yössä omaan väliaikaismuistiinsa, jona toimii MongoDB-kanta. Koodistopalvelusta tiedot noudetaan tarvittaessa ja niitä säilytetään väliaikaismuistissa MongoDB-tietokannassa korkeintaan vuorokausi.

• Organisaatiopalvelusta
  • koulutustoimijat
  • oppilaitokset
  • varhaiskasvatuksen toimija (ei perhepäivähoitajia tai ryhmäperhepäivähoitajia) 
  • varhaiskasvatuksen toimipaikat (ei perhepäivähoitajia tai ryhmäperhepäivähoitajia)
  • organisaatioiden tunnistetiedot (OID, oppilaitostunnus ja Y-tunnus)
  • sijaintikunta
  • koulutustoimijan yritysmuoto
  • Organisaatiotietojen hakuehdot
    
    • organisaatiotyyppi, oppilaitostyypit, organisaation kieli, vuosiluokat (perusopetus), koulutuksen järjestäjät joilla on ammatillisen koulutuksen järjestämislupa
    • rajausehtolistaukseen maakunnat ja kunnat
• Opetus- ja kulttuuri ministeriön Oiva palvelu
  • koulutuksen järjestäjät joilla on ammatillisen koulutuksen järjestämislupa ja niiden yhteystiedot Organisaatiopalvelusta.
• Käyttäjähallintapalvelu
  • Virkailijakäyttäjien yhteystiedot
  • Käyttöoikeusryhmät rajausehtolistaukseen
• Integraatiot
  • Opintopolun Viestintäpalveluun (massasähköpostin lähetys)
  • OKMn Oiva-palveluun (ammatillisen koulutuksen järjestämisluvat)
  • Käyttöoikeuspalveluun (virkailijat oppilaitoksissa)
  • Koodistopalveluun (koodistot)

Hakuja varten tarvittavat rajapinnat on kuvattu Swaggerillä Hakuja varten tarvittavat rajapinnat on kuvattu Swaggerillä (ks. sivun alaosa).

Lisäksi sähköpostin lähetystä varten Osoitepalvelu on integroitu Viestintäpalveluun jolla voi lähettää massasähköpostia.

...

Arkkitehtuuri

Osoitepalvelu koostuu kahdesta moduulista: käyttöliittymästä (osoitepalvelu-ui) ja palvelin-osasta (osoitekoostepalvelu).

...

Järjestelmä hakee tietonsa Organisaatio-, Käyttäjähallinta-,  Koulutustarjontapalvelusta ja ja Koodistopalveluista. Sähköpostiviestien lähettämistä varten käytetään Viestintäpalvelua

Audit-lokitus on toteutettu auditlogger-palvelua käyttäen. 

...

Teknologiat

Osoitepalvelu käyttää MongoDB-kantaa tiedon tallennukseen ja sitä ajetaan Apache Tomcat -sovelluspalvelimella.

Osoitepalvelussa käytettävät kirjastot ja sovelluskehykset:

Rajapinnat

Swagger-dokumentaatio:

...