WebAPI:n toteutus asiakastulosteiden hallintaan

Abstract

Insinöörityönä toteutettiin palvelu yritykselle Kojamo Oyj. Toteutettu palvelu sai nimekseen PdfLetterService, ja se vastaa yrityksestä lähtevien PDF-muotoisten E-kirjeiden lähetyksestä. Lähteviä PDF-muotoisia E-kirjeitä ovat esimerkiksi sopimus- ja hakemusvahvistukset sekä maksumuistutukset.

Palvelu korvaa aiemman kirjeiden lähetykseen käytetyn sovelluksen. Tavoitteena oli toteuttaa toimintavarma ja skaalautuva kokonaisuus, joka suoriutuu raskaistakin lähetyskuormista. Lisäksi palvelun haluttiin pystyvän lähettämään kirjeitä ajastetusti haluttuun aikaan.

PdfLetterService toteutettiin käyttämällä ASP.NET Web Api -viitekehystä. PdfLetterService hyödyntää toiminnassaan pilvipalveluita, ja se on itsekin hostattuna pilveen. Käytetty pilvipalveluntarjoaja on Microsoft Azure. Microsoft Azuren tarjoamista palveluista PdfLetterService käyttää mm. seuraavia: Azure App Service, Azure Cosmos DB, Azure Blob Storage ja Azure Table Storage.

Työlle arvioitu toteutusaika saavutettiin. PdfLetterServicen toteutus kesti yhteensä n. 5 viikkoa, joista jokainen viikko sisälsi 37,5 h työtä. Raportin kirjoittamista ei laskettu mukaan kuluneeseen aikaan.

Lopputuloksena saatiin valmiiksi toimiva palvelu. PdfLetterService on päivittäisessä käytössä yrityksen sovellusten tuotantopuolella. Aiempaan kirjeiden lähetyssovellukseen verrattuna PdfLetterService säästää aikaa ja rahaa sekä selkeyttää lähetettävien kirjeiden esikatselua.

The purpose of this Bachelor’s thesis was to produce a service, which handles the sending process of PDF-form electrical letters. For example, the service will send PDF-form contract verifications and reminders.

The project was produced to a company called Kojamo Oyj. The service was named as PdfLetterService and it replaces an old system that the company has been using to send electrical letters. The goals of this project were to create a service that is reliable and can be scaled to handle massive amounts of letter send requests. In addition, PdfLetterService was also required to be able to send scheduled letters.

PdfLetterService was developed using ASP.NET Web API framework. The advantage of cloud services were a major part of PdfLetterService’s development. Microsoft Azure was used as the provider of these cloud services.

PdfLetterService used among other things these Microsoft Azure services: Azure App Service, Azure Cosmos DB, Azure Blob Storage and Azure Table Storage.

Estimated schedule of the project was 5 weeks and each week including 37.5 working hours. The project was completed on time. Writing process of the raport of this thesis was not included in this timeline.

In conclusion, the project was a success. PdfLetterService is being used on daily basis to send electrical letters. Compared to the previous system PdfLetterService saves the companys time, money and trouble.