Esimerkit on tehty SoapUI työkalulla, joka on hyödyllinen työkalu API-toiminnallisuuden kokeilemiseen. Työkalu on ilmainen ja sen voi ladata SOAP UI sivuilta (https://www.soapui.org/tools/soapui/)
Työajan APIn metodit saa lisättyä SoapUI työkaluun valitsemalla SOAP -> New SOAP Project -> Syötä Project Name ja Initial WSDL-osoitteeksi https://time.nepton.com/WebService.php?WSDL
Henkilötietojen APIn metodit saa lisättyä SoapUI työkaluun valitsemalla SOAP -> New SOAP Project -> Syötä Project Name ja Initial WSDL-osoitteeksi https://go.nepton.com/API/SOAPWebService.asmx?wsdl
Tallenna vielä lisäämäsi SOAP projekti FIle-valikosta -> Save all projects.
Kutsujen muodostaminen
Kutsu muodostetaan SOAPUI:lla navigoimalla vasemmassa laidassa haluttuun projektiin ja sieltä haluttuun metodiin. Metodilla on muodostunut valmiiksi kutsu (request). Näitä voi tehdä lisää, muokata ja ajaa muokkausikkunasta painamalla vihreää nuolta.
Kutsua muokataan siten, että sinne tehdään parametrit käyttäjän tunnistautumiselle sekä varsinainen kutsun sisältö. Valinnaiset parametrit ovat esitetty kysymysmerkillä kentän välissä ja ne voidaan pääsääntöisesti poistaa. Kutsussa ei tule lähettää yhtään kysymysmerkki-kenttää vaan jäljelle jäävissä kentissä tulee olla arvo.
GetActivities - esimerkki
Alla olevassa esimerkissä kutsumme funktiota GetActivities. Kutsuja tunnistetaan käyttäjätunnuksella ja salasanalla.
Suodattimiksi on määritelty, että haluamme kaikki poistamattomat tapahtumat henkilöille "Estonia Manager" ja "Office1 Tallinn" ja aikaväliltä 2018-05-10 ja 2018-05-15. Oikealla puolella voimme nähdä 2 palautettua tapahtumaa asetettujen suodattimien perusteella.
GetAccrualValuesForUser - esimerkki
Alla olevassa esimerkissä kutsumme funktiota GetAccrualValuesForUser. Kutsuja tunnistetaan käyttäjätunnuksella ja salasanalla.
Kutsussa haetaan kertymän arvoa päivämäärällä 2020-06-02. Oikealla puolella näemme 1 kutsun palauttaman kertymän arvon. Kertymän ”Saldo” arvo henkilölle 7545 on kyseisenä päivänä 3 tuntia 43 minuuttia ja se on vähentynyt 57 minuuttia sinä päivänä.
InsertProjects - example
EnsureProjectExistsV3 - esimerkki
Alla olevassa esimerkissä kutsumme funktiota EnsureProjectExistsV3. Kutsuja tunnistetaan käyttäjätunnuksella ja salasanalla. Kutsussa varmistetaan että projekti, jonka koodi on 'HALUAMANI_KOODI' on palvelussa annetuilla tiedoilla. Projektille lisätään projektipäälliköksi kaksi henkilöä joista toisen käyttäjänimi on 'Projektipäällikön XXX käyttäjänimi' ja toisen henkilönumero on 'Projektipäällikön YYY henkilönumero'. Koska RemoveOthers - elementin arvoksi on asetettu "true", poistetaan aiemmat Neptonissa olevat projektipäälliköt, jos projekti on olemassa ja sillä on aiempia projektipäälliköitä joita ei ole kutsussa lisätty projektipäälliköiksi. Jos aiempia projektipäälliköitä ei haluta poistaa, jätetään RemoveOthers - elementti kokonaan pois kutsusta.
EnsureProjectExistsV2 - esimerkki
Alla olevassa esimerkissä kutsumme funktiota EnsureProjectExistsV2. Kutsuja tunnistetaan käyttäjätunnuksella ja salasanalla. Kutsussa varmistetaan että projekti, jonka koodi on 'HALUAMANI_KOODI' on palvelussa annetuilla tiedoilla.
InsertActivitiesV2 - esimerkki työlisän merkitsemisestä
Alla olevassa esimerkissä kutsumme funktiota InsertActivitiesV2. Kutsuja tunnistetaan käyttäjätunnuksella ja salasanalla. Kutsussa luodaan työtapahtuma projektille 'HALUAMANI_KOODI'. Tapahtumaan liitetään työlisää numero yksi 10 kappaletta.