Mallinnustyökalun käyttöönotto ja mallien ajantasaisuuden hallinta terveydenhuollon integraatioissa
Ruohoniemi, Janne (2026)
Ruohoniemi, Janne
2026
Tietotekniikan DI-ohjelma - Master's Programme in Information Technology
Informaatioteknologian ja viestinnän tiedekunta - Faculty of Information Technology and Communication Sciences
Hyväksymispäivämäärä
2026-06-17
Julkaisun pysyvä osoite on
https://urn.fi/URN:NBN:fi:tuni-202606167561
https://urn.fi/URN:NBN:fi:tuni-202606167561
Tiivistelmä
Tässä diplomityössä on kehitetty toimialakohtainen mallinnuskieli sekä automaatioprosessi terveydenhuollon integraatioarkkitehtuurin dokumentoinnin tehostamiseksi. Terveydenhuollon IT-infrastruktuurin monimutkaistuminen pirstaloi integraatiotietoa ja haastaa manuaalista dokumentointia. Työn tavoitteena oli mahdollistaa integraatioputkien automaattinen visualisointi suoraan keskitetyn integraatioalustan teknisestä konfiguraatiosta, mikä parantaa dokumentaation ajantasaisuutta ja ymmärrettävyyttä.
Tutkimusmenetelmänä hyödynnettiin suunnittelutiedettä kehittämällä kaksi toisiaan tukevaa artefaktia: MetaEdit+-ympäristöön toteutettu metamalli sekä .NET-pohjainen orkestraattorisovellus. Metamalli määrittelee integraatioalustan käsitteistön ja kytkentäsäännöt, ja orkestraattori automatisoi tiedon tiedonhankinnan integraatioalustalta mallinnusympäristöön. Ratkaisu integroi teknisen konfiguraatiotiedon organisaation järjestelmäsalkkuun varmistaen tiedon eheyden ja kytkennän todellisiin tietojärjestelmiin. Sovelluksen lähdekoodi on julkaistu avoimena lähdekoodina.
Työn tulokset osoittavat, että automaatiolla saavutetaan merkittävä toiminnallinen hyöty verrattuna manuaaliseen dokumentointiin. Verifiointi vahvisti, että puhdistetulla lähdedatalla orkestraattori ja asettelualgoritmi tuottavat virheettömän ja asiantuntijalle suoraan luettavan visuaalisen arkkitehtuurikuvan sekunneissa. Tutkimus paljasti, että asettelun alkuperäiset epäonnistumiset ja rajapintojen ylikuormittuminen johtuivat korruptoituneesta lähdeaineistosta. Kun datan laatu varmistettiin, täysin automaattinen mallinnus toteutui onnistuneesti. Ratkaisu poistaa tiedonsyötön virhealttiuden ja vähentää arkkitehtuurin hallintaan kuluvaa työaikaa yli 99 prosenttia.
Johtopäätöksenä DSM-menetelmän ja automaation yhdistelmä tarjoaa skaalautuvan ratkaisun monimutkaisten integraatioekosysteemien hallintaan, edellyttäen että lähdedata on validia ja kaaviot rajataan loogisiin osakokonaisuuksiin. Kehitetty menetelmä on yleistettävissä muillekin toimialoille, joilla arkkitehtuurin läpinäkyvyys on kriittistä. Jatkokehityskohteiksi tunnistettiin mallien automaattinen jatkovienti muihin järjestelmiin sekä visualisointien elinkaaren hallinnan parantaminen mallinnusympäristön roolin vahvistamiseksi keskitettynä arkkitehtuuritiedon lähteenä. This Master’s thesis presents a domain-specific modeling (DSM) language and an automation process to enhance the documentation of healthcare integration architecture. Driven by the increasing complexity of healthcare IT infrastructure and the fragmentation of manual documentation, the objective was to enable automatic visualization of integration pipelines directly from the technical configuration of a centralized platform, thereby improving documentation up-to-dateness and comprehensibility.
Following the Design Science Research methodology, two complementary artifacts were developed: a metamodel in the MetaEdit+ environment and a .NET-based orchestrator application. The metamodel defines the concepts and connection rules of the integration platform, while the orchestrator automates data extraction, transformation, and loading into the modeling environment. The solution integrates technical configuration data with the organization's system portfolio, ensuring data integrity and connectivity to actual information systems. The application's source code has been published as open source.
The results demonstrate that automation provides significant operational benefits over manual documentation. Verification confirmed that, with cleaned source data, the orchestrator and layout algorithm generate a flawless and instantly readable visual architecture diagram in seconds. The study revealed that initial layout failures and API overloads were caused by corrupted source data. Once data quality was ensured, fully automated modeling was successfully achieved. The solution eliminates manual data entry errors and reduces the time required for architecture management by over 99 percent.
In conclusion, combining the DSM method with automation provides a scalable solution for managing complex integration ecosystems, provided that source data is valid and diagrams are scoped into manageable logical entities. While limited to healthcare, the method is generalizable to other industries requiring architectural transparency. Future development goals include automated model export to other systems and deepening the lifecycle management of visualizations to strengthen the modeling environment's role as a centralized source of architectural information.
Tutkimusmenetelmänä hyödynnettiin suunnittelutiedettä kehittämällä kaksi toisiaan tukevaa artefaktia: MetaEdit+-ympäristöön toteutettu metamalli sekä .NET-pohjainen orkestraattorisovellus. Metamalli määrittelee integraatioalustan käsitteistön ja kytkentäsäännöt, ja orkestraattori automatisoi tiedon tiedonhankinnan integraatioalustalta mallinnusympäristöön. Ratkaisu integroi teknisen konfiguraatiotiedon organisaation järjestelmäsalkkuun varmistaen tiedon eheyden ja kytkennän todellisiin tietojärjestelmiin. Sovelluksen lähdekoodi on julkaistu avoimena lähdekoodina.
Työn tulokset osoittavat, että automaatiolla saavutetaan merkittävä toiminnallinen hyöty verrattuna manuaaliseen dokumentointiin. Verifiointi vahvisti, että puhdistetulla lähdedatalla orkestraattori ja asettelualgoritmi tuottavat virheettömän ja asiantuntijalle suoraan luettavan visuaalisen arkkitehtuurikuvan sekunneissa. Tutkimus paljasti, että asettelun alkuperäiset epäonnistumiset ja rajapintojen ylikuormittuminen johtuivat korruptoituneesta lähdeaineistosta. Kun datan laatu varmistettiin, täysin automaattinen mallinnus toteutui onnistuneesti. Ratkaisu poistaa tiedonsyötön virhealttiuden ja vähentää arkkitehtuurin hallintaan kuluvaa työaikaa yli 99 prosenttia.
Johtopäätöksenä DSM-menetelmän ja automaation yhdistelmä tarjoaa skaalautuvan ratkaisun monimutkaisten integraatioekosysteemien hallintaan, edellyttäen että lähdedata on validia ja kaaviot rajataan loogisiin osakokonaisuuksiin. Kehitetty menetelmä on yleistettävissä muillekin toimialoille, joilla arkkitehtuurin läpinäkyvyys on kriittistä. Jatkokehityskohteiksi tunnistettiin mallien automaattinen jatkovienti muihin järjestelmiin sekä visualisointien elinkaaren hallinnan parantaminen mallinnusympäristön roolin vahvistamiseksi keskitettynä arkkitehtuuritiedon lähteenä.
Following the Design Science Research methodology, two complementary artifacts were developed: a metamodel in the MetaEdit+ environment and a .NET-based orchestrator application. The metamodel defines the concepts and connection rules of the integration platform, while the orchestrator automates data extraction, transformation, and loading into the modeling environment. The solution integrates technical configuration data with the organization's system portfolio, ensuring data integrity and connectivity to actual information systems. The application's source code has been published as open source.
The results demonstrate that automation provides significant operational benefits over manual documentation. Verification confirmed that, with cleaned source data, the orchestrator and layout algorithm generate a flawless and instantly readable visual architecture diagram in seconds. The study revealed that initial layout failures and API overloads were caused by corrupted source data. Once data quality was ensured, fully automated modeling was successfully achieved. The solution eliminates manual data entry errors and reduces the time required for architecture management by over 99 percent.
In conclusion, combining the DSM method with automation provides a scalable solution for managing complex integration ecosystems, provided that source data is valid and diagrams are scoped into manageable logical entities. While limited to healthcare, the method is generalizable to other industries requiring architectural transparency. Future development goals include automated model export to other systems and deepening the lifecycle management of visualizations to strengthen the modeling environment's role as a centralized source of architectural information.
