Asennus

Pakolliset asennettavat moduulit ovat

• generic-expot-api
• generic-export-service
• cross-study-enrichment

Välivaraston käsittelyyn on toteutettu kaksi vaihtoehtoista moduulia.

• database-storage-service
• opensearch-storage-service

Näistä ensimmäinen tukee MySQL- ja MariaDB-tietokantoja. Jälkimmäinen tukee OpenSearch-indeksiä. OpenSearch-indeksin käyttö on kokeellinen ratkaisu, jota ei vielä suositella tuotantokäyttöön. Asennetaan vain toinen varastomoduuleista.

Maksullisen koulutuksen ilmoittautumisen kohteiden käsittelyyn tarkoitattu moduuli

• paid-education-enrichment

tarvitaan vain siinä tapauksessa, että maksullisen koulutuksen moduuli on asennettu ja halutaan viedä ilmoittautumisen kohteita.

Rikastuksen ja välivarastoon tallennukseeen on toteutettu erillinen moduuli, joka sisältää Karaf-komentoja prosessin käynnistämiseen:

• lum-triggers

Tarvittava konfiguraatiotiedosto on "/etc/generic_export.properties":

generic.export.organization=<Pepin organisaatioasetus>
generic.export.home.organization.code=<kotiorganisaation tilastokeskuskoodi>

generic.export.activemq.broker.url=<sisäisen ActiveMQ:n osoite>

generic.export.activemq.external.broker.url=<ulkoisen MQ:n osoite>
generic.export.activemq.external.target=<ulkoisen MQ:n jono tai topic>

generic.export.db.url=<tietokannan JDBC-osoite>
generic.export.db.prefix=<tietokannan nimen etuliite>
generic.export.db.name=<tietokannan nimi>
generic.export.db.url.properties=autoReconnect=true&useUnicode=true&characterEncoding=UTF-8
generic.export.db.username=<tietokannan käyttäjä>
generic.export.db.password=<tietokannan käyttäjän salasana>

Sisäistä ActiveMQ:ta käytetään integraation rikastus- ja tallennuspyyntöjen käsittelyyn. Sen arvo on esimerkiksi vm://esp, jos käytetään ServiceMixin sisäistä ActiveMQ-toteutusta. Ulkoinen MQ on sen "message brokerin" osoite, johon lähetetään päivityspyynnöt (esimerkiksi DigiVisiota varten).

Jos käytetään OpenSearch-indeksiä, niin tietokanta-asetukset korvataan indeksin osoitteella:

generic.export.index.host=<indeksin domain>
generic.export.index.port=<indeksin portti>

OpenSearch-indeksille ei vielä tueta autentikaatiota eikä HTTPS-yhteyttä.

Jos halutaan vaikuttaa automaattisen päivityksen ajastukseen, voidaan muuttaa niihin käytettyjä cron-määrityksiä (alla näkyvät oletusarvot):

generic.export.courseunitrealization.cron=0+0/10+*+*+*+?+*
generic.export.courseunit.cron=0+2/10+*+*+*+?+*
generic.export.studymodule.cron=0+5/10+*+*+*+?+***
generic.export.offering.cron=0+7/10+*+*+*+?+*
generic.export.programme.cron=0+10/30+*+*+*+?+*

Maksullisen koulutuksen ilmoittautumisen kohteiden päivityksen ajastukseen on kaksi asetusta, joista ensimmäinen päivittää nykyisiä ja tulevia kohteita ja jälkimmäinen kaikkia:

generic.export.registration_package.cron=0+9/30+*+*+*+?+*
generic.export.registration_package_all.cron=0+0+1+*+*+?+*

Maksullisen koulutuksen moduuli ei tarjoa tällä hetkellä mahdollisuutta päivittää vain muuttuneita kohteita.

Maksullisen koulutuksen ilmoittautumisen kohteiden "paluuosoitteen" muoto voidaan määritellä asenuksella

generic.export.registration_package.registration_url=

Oletusarvo on tyhjä, jolloin paluuosoitteita ei muodostu. Paluuosoitteeseen voi lisätä tunnisteen ja/tai koodin placeholdereilla {id} ja {code} esimerkiksi kirjoittamalla osoitteeksi http://localhost/registration?id={id}&code={code}.

Yhteiskäyttöisyyttä varten voidaan määritellä juuriorganisaatio, jotka otetaan huomioon, kun rikastetaan opetuselementtejä. Juuriorganisaatio liitetään opetuselementtiin, jos se tai sen alla hierarkiassa oleva organisaatioyksikkö on liitetty opetuselementtiin vastuunjako-välilehdellä.

generic.export.use.organisation.codes=ORG1,ORG2,...

Asetuksen arvona luetellaan kaikkien juuritason organisaatioysiköiden koodit. Lisäksi voidaan määritellä, rikastetaanko sellaisia opintoelementtejä ollenkaan, joilta puuttuu juuritason organisaatio.

generic.export.discard.without.organisation=true

Oletusarvo on false eli kaikki opintoelementit rikastetaan.