Testen met SoapUI
- Planning.nl
U kunt SoapUI (https://www.soapui.org/downloads/soapui.html) gebruiken om de webservice van Cloudplan te testen. Het programma SoapUI kan voorbeeldrequests genereren op basis van de WSDL.
Hieronder staat beschreven hoe u dat kunt doen:
| Start SoapUI en kies voor new Soap project |
| Ga naar https://api.cloudplan.nl/v1 en kopieer het adres van de WSDL |
| Plak het adres in het venster en druk op ok. SoapUI genereert nu voorbeeld XML voor inloggen en uitloggen via de webservice met behulp van de informatie in de authenticatie wsdl. |
| Rechtermuisknop op project, en kies voor 'add wsdl'. |
| Plak hier het adres van WSDL van de resourceservice . (zie https://api.cloudplan.nl/v1 voor het adres) toe en druk op Ok. |
| Nu we de authenticatieservice en resourceservice hebben toegevoegd kunnen we inloggen en resources ophalen. Om in te loggen, open het voorbeeldrequest van de login en vul hier gebruikersnaam en wachtwoord in. Druk daarna op de groene knop. |
| Als de authenticatie is gelukt, verschijnt het authenticatietoken in de respons. |
| Open het voorbeeld voor getResources en plak de eerder verkregen authenticationtoken bij <token>. De matcher bepaalt welke gegevens worden opgehaald. Binnen een matcher zijn diverse elementen beschikbaar om op te zoeken. Sommige elementen hoeven niet gespecificeerd te worden. Deze zijn te herkennen aan het Optional commentaar boven de tag.
In dit voorbeeld worden alle resources opgehaald. Als u zeer veel resources verwacht kunt u hiermee een zware belasting van de webservice veroorzaken. Planning.nl kan de verbinding dan verbreken en voorkomen dat u de webserver verder (over)belast. Laat bij grote hoeveelheden data de matcher nooit leeg, zodat de webservice niet alles ophaalt maar de hoeveelheid data beperkt. Let op bij delete.. dat de matcher niet leeggelaten wordt. Cloudplan zal alle gevonden gegevens verwijderen! Hetzelfde geldt voor een push.! |
