Kickin it old school!
If this fits your needs, continue reading our example of using SoapUI to test XML SOAP web services.
You will need:
- Install the latest version of SoapUI
- Some programming experience
- A ProjectInsight account with a web service key & credentials
To use the REST API's for testing purposes
Figure 1 - SoapUI can perform both SOAP and REST operations.
Next, we'll create a New SOAP Project (see screenshot for details)
Figure 2 - Creating a new SOAP Project Tip: You can specify any name for the project. Make sure to point to the WSDL. Click here to learn about WSDL files. Also, the project can create template requests for each method within the web services.
After creating a project and connecting to the specified web service, expand the WebServiceLogin method and make a call to return a session key. By providing your Project Insight credentials, you can use the "session key" as an authentication for method calls within this web services.
Figure 3 - Setup the WebServiceLogin method. Tip: Provide your Project Insight license key, username and password to return a valid session key. Session keys last for 20 minutes within a session.
Example: The WebServiceLogin method resides on all web services. In this example, I renamed the default request to "Create New Session Key" as a reminder of what this method does. The "?" parameter between the nodes are the expected values.
Provide your credentials to make a successful call to the web service. If successful, you will have the session key returned, otherwise, the web service will provide some sort of error handling message for you to review and correct.
Figure 4 - Call the WebServiceLogin method to return both SessionKey and UserId properties with your ProjectInsight credentials. Tip: You can override the session key by calling the method again.
The last step of this tutorial is to use the GetAllUsers method, which will return a 'users' object list. You'll need to enter the session key as the only parameter for this method.
Figure 5 - Call the GetAllUsers method to return a list of 'users'. Tip: This method will return all users whether active or inactive. Try using the GetUsers method to return a specific set of users or GetUser to return a single user object.
This is just one example of using a 3rd party tool, such as SoapUI, to test and validate Project Insight RESTful services.