In this thesis, a template-based code generator was developed to support handling structured client documents from the Social Welfare Client Data Repository within a software system. A structured document refers to electronic records generated from social welfare activities, for which the Finnish Institute for Health and Welfare (THL) has defined a specific structure and content. The generator was implemented using Microsoft's Text Template Transformation Toolkit (T4). The primary objective of the study was to assess how comprehensively the generator can produce source code based on THL’s document structure definition in JSON schema format. The research aimed to determine which parts of the source code can be reliably generated and which portions still require manual implementation by the developer. Additionally, the study sought to evaluate whether using the generator in a similar context is efficient and whether it can accelerate and streamline the development process for programmers.
Template-based generation was used to support the software development process in the implementation of support for 60 structured client documents in a software system. The generator was found to reduce both the time required for developing document support and the repetitive tasks of software developers. After the generation process, the remaining work for the developer primarily involved relocating the generated components within the source code to a position where they could be utilized alongside other structured documents or modifying the implementation to use existing components. Additional tasks included reviewing the generated output and making necessary corrections. A key challenge was avoiding errors that were technically correct but semantically incorrect.Diplomityössä toteutettiin template-pohjainen generaattori, joka tuottaa sosiaalihuollon asiakastietojärjestelmänä toimivaan ohjelmistoon tuen käsitellä sosiaalihuollon asiakastietovarannon rakenteisia asiakasasiakirjoja. Asiakasasiakirjalla tarkoitetaan sosiaalihuollon toiminnasta syntyviä sähköisiä asiakirjoja, joille Terveyden ja hyvinvoinnin laitos on määrittänyt rakenteen ja sisällön. Generaattori toteutettiin käyttäen Microsoftin Text Template Transformation Toolkit (T4) työkalua. Tutkimuksen päätavoite oli tutkia, miten kattavasti generaattorilla pystytään tuottamaan lähdekoodia THL:n asiakirjarakennemäärittelyn JSON-skeeman pohjalta. Mitkä kohdat lähdekoodista pystytään generoimaan varmuudella ja mikä osuus jää kehittäjälle. Tutkimuksella pyritään vastaamaan siihen, onko generaattorin käyttäminen vastaavanlaisessa tilanteessa tehokasta ja pystytäänkö sillä tekemään ohjelmointiprosessista nopeampaa ja mielekkäämpää kehittäjälle.
Template-pohjaista generointia käytettiin ohjelmointiprosessin tukena 60 asiakasasiakirjan tuen kehittämisessä asiakastietojärjestelmään. Generaattorin todettiin vähentäneen sekä asiakasasiakirojen tuen kehittämiseen tarvittavaa aikaa, että ohjelmistokehittäjän toisteista työtä. Generoinnin jälkeen kehittäjälle jäänyt työ koostui suurimmaksi osaksi generoitujen komponenttien siirtämisestä lähdekoodissa sijaintiin, josta niitä voidaan hyödyntää muiden rakenteisten asiakirjojen kanssa tai muuttaa toteutusta käyttämään jo olemassa olevia komponentteja. Muu kehittäjälle jäänyt työ oli tarkastaa generoinnin lopputulos ja korjata tarvittaessa. Haasteena oli välttää muodostamasta virheitä, jotka olivat teknisesti oikein, mutta semanttisesti väärin.
