Tiedon siirto Pulseway-etähallintaohjelmiston APIlta tietokantaan

Abstract

Opinnäytetyön tarkoituksena oli mahdollistaa muokattavien raporttien tekeminen etähallintaohjelmiston datasta. Työssä tarkasteltiin Pulseway-etähallintaohjelmistoa. Työn tarve syntyi Pulsewayn omien raporttipohjien puutteista, sillä niitä ei pysty muokkaamaan työn tilanneen yrityksen tarpeisiin sopeutuviksi. Työn keskeisenä tavoitteena oli tuoda data Pulsewayltä yrityksen omaan tietokantaan. Omasta tietokannasta datan voi jatkossa viedä eteenpäin ja siitä voi tehdä täysin muokattavia hakuja.

Pulsewayn kaikki data saadaan vietyä Pulsewayn APIn kautta omilla palvelimilla olevaan MariaDB-tietokantaan. Datan siirtäminen tietokantaan tapahtuu Python-skriptillä. Skriptissä apuna käytettiin MariaDB-kirjastoa, joka mahdollistaa SQL-kyselyjen tekemisen koodista. Toinen apukirjasto oli slumber, jolla saadaan yhteys Pulsewayn APIin.

Opinnäytetyön tuloksena oli valmis tietokanta ja perustoiminnallisuuden toteuttava skripti. Tietokannan rakenne suunniteltiin sisältämään kaikki APIn data. Datan viite-eheys varmistetaan pääavaimella, joka on Microsoft Windows -käyttöjärjestelmän laitekohtainen tunnus. Valmis skripti täyttää tietokannan APIlta tulevalla datalla, mutta skripti ei pysty muokkaamaan jo tietokannalla olevaa dataa. Ajankohtaisen raportin luomiseksi tietokanta pitää tyhjentää ennen skriptin ajoa. Tyhjentäminen ei kuitenkaan ole ongelma, sillä tietokantaa käytetään vain raporttien luomiseen eikä sinne säilötä dataa.

Jatkossa skriptiä voisi kehittää joustavammaksi. Skriptin SQL-kyselyitä voisi parantaa lisäämällä niihin päivitysehdon duplikaatti avaimella. Tällöin tietokanta päivittäisi kenttien arvot, eikä sitä tarvitsisi poistaa ennen skriptin jokaista ajoa.

The purpose of this study was to create a functioning base for generating customizable reports from Pulseway. The reports that Pulseway creates by default were not suited for use at the company. To generate customizable reports, a database was needed. In addition to the database the data retrieved from Pulseway API needed to be handled by a Python script.

The database was built to a specification that required all data to be in a single relational database. Additionally, in order to ensure relational integrity Microsoft Windows device ID was selected as primary key. The Python script that handled data importing used SQL queries embedded in the script to insert data from Pulseway API to the database.

The result was a database built to a specification that worked as intended. The script used for data importing functioned appropriately, though there is room for improvement. As it stands the Python script only allows populating the database once. For up-to-date information to be present in the reports generated from the data in the database, the database needs to be wiped of all existing data. However, this is not an issue since the database is only used as a tool to generate reports and not for storing data.

To further improve the script, exception handling could use upgrading. As it stands, for the test data to be imported into the database only light exception handling is necessary. The second element that could be examined in the future is the SQL queries, which could be changed so that it is not necessary to wipe the database before every run.