Dokumenttikäsittelijän ohjelmoiminen Java -kielellä

Abstract

Työn tarkoituksena on luoda ohjelmistokomponentti joka osaa täyttää PDF lomakkeet automaattisesti. Lomakepohjan kenttiin täytetään saadut tiedot ja dokumentti voidaan tämän jälkeen tallentaa tai tulostaa. Järjestelmään on pystyttävä lisäämään uusia lomakepohjia tarpeen mukaan, ja niiden kentät on pystyttävä linkittämään tietokannan kenttiin. Lomakkeen kenttien linkitystieto tallennetaan tietokantaan. Lisäksi ohjelmistokomponentin on osattava hallita tilanne, jolloin annettu tieto ei mahdu sille varattuun kenttään. Toteutuksessa luodaan yleiskäyttöinen palvelu, jota voivat kutsua kaikki palvelua tarvitsevat ohjelmistokomponentit. Opinnäytetyö tehdään Mediconsult Oyj:n toimeksiantona.

Kehitystyö aloitetaan valitsemalla käytettävä dokumenttiformaatti ja sitä tukeva Java -kirjasto. Tämän jälkeen luodaan loogiset kuvaukset käyttötilanteista ja vaadituista toiminnollisuuksista. Lisäksi suoritetaan toiminnallisuuden tarkempi määrittely. Ohjelmointityössä käytetään Java EE:tä ja PDFBox Java -kirjastoa. Ohjelmiston toiminnallisuus varmistetaan kirjoittamalla toiminnollisuuksien testitapaukset rinnakkain varsinaisen ohjelmakoodin kanssa.

Työn tuloksena on palvelu, jonka avulla voidaan käsitellä ja täyttää annettuja PDF -lomakkeita. Lomakkeiden analysointi ja lomakkeen sekä tietokannan kenttien linkittäminen toisiinsa suoritetaan pääkäyttäjän toimesta ja linkityksen jälkeen ohjelmisto osaa täyttää tiedot lomakkeelle itsenäisesti. Ohjelmisto osaa lisäksi käsitellä tilanteen, jossa kirjoitettava tieto ei mahdu lomakkeella sille varattuun tilaan. Tällöin mahdollisia toimintatapoja on kaksi. Joko tiedolle luodaan uusi kenttä lomakkeen loppuun, tai varattua alkuperäistä kenttää venytetään niin, että tieto saadaan mahtumaan.

Toteutuksella saadaan useita etuja. Lomakkeiden täyttäminen tulostusta varten on helppoa ja nopeaa. Järjestelmään pystytään lisäämään mikä tahansa PDF lomake linkittämällä lomakkeen kentät tietokannan kenttiin. Lisäksi niissä tilanteissa, joissa annettu tieto ei mahdu sille varattuun kenttään, ohjelmakomponentti tarjoaa käyttäjälle paremman käyttäjäkokemuksen siirtämällä tiedon kokonaisena lomakkeen loppuun, tai venyttämällä alkuperäistä kenttää.

The purpose of this thesis was to implement a software module which would fill up PDF forms automatically. It had to be possible to add further form templates into the system and perform configuration for new templates. All configuration data was saved into a database. In addition, the software module needed to know how to handle situations where given data does not fit into the reserved field. This assignment was commissioned by Mediconsult Oyj.

Development work was started with selecting used document format and Java library for document handling. Work continued with creating use cases and logical graphs of the required functionality. Requirements of the software module was written down in a greater detail. The programming work was done using Java EE and PDFBox Java -library. Test driven development was used as a method to ensure the development quality.

As a result, a software module which can fill up pre-defined PDF forms was created. It supports mapping document fields and database fields together and saving mapping data into a database. Additionally, it can handle situations where data does not fit into the given field. It either moves data to the end of the document, or stretches the original field – along with the rest of the document. Implemented software module is a service which is available for all other software components in the system.

This Implementation has several benefits. Filling up a form with customer’s information is fast and easy. Implementation offers an easy way to enter new documents into a system and configure them so that they can be filled up automatically. Furthermore, it offers a great benefit in cases where too small space is reserved for information in the form template. In such cases, the software module can stretch the field so that the information fits. Another option is to create new field to the end of the document for this information. Thus, end user enjoys an improved user experience.