A Software Tester's Blog: January 2021

Jan 26, 2021

API Testing 'A Beginners View': Newman API Testing

Hi Everyone!!! Let's check out some details about NEWMAN 😊

Newman gives the capability of running Postman collections through the command line. It basically helps you automate your Postman tests with ease.

Got some insight on this from my daily worklife. So why wait Let's get started!

Basic Steps of NEWMAN Kickstart:

Step 1: Install NodeJS
Step 2: Install Postman's Newman
Step3: Create a Collection and Running Tests Scripts
Step4: Exporting Postman Collection and its associated Environment file if applicable
Step5: Running the Collection in Newman

Step1: Install NodeJS

Installing NodeJS is pretty straight forward, visit their download page here, download your platform version to install.

Note: Kindly make sure to install the latest higher version.

After installing, go to your Terminal and enter the command below to check if everything is fine to go.

node -v
npm -v

You should see an output similar to the one below:

Step2: Install Postman's Newman :

Now that NodeJS is set up, we need to install "Newman" and some NodeJS modules that will be useful for our test report generations.

Run the below command:

npm install newman request rimraf newman-reporter-html newman-reporter-htmlextra --save --force

After installation you will see similar output:

Step3: Create a Collection and Running Tests Scripts

In Postman select "New" >> "Collection". Give a name to the collection. I’ll be using a sample collection in my local which has Test Scripts designed already just for the purpose of the explanation.

Sample Collection with Test Scripts:

Step4: Exporting Postman Collection and its associated Environment file if applicable

Under the ‘View more actions' option of the collection, select ‘Export’.

Save the Collection to your local directory. The collection should be saved as a .postman_collection json file.

Note: To export the environment variables, Go to the ‘Manage Environment’ section from the top right corner and click on Download, environment file will be downloaded as .postman_environment json file

Step5: Running the Collection in Newman

Open the terminal and navigate to where the Postman Collection and associated environment json file is saved. To execute the tests run the below command:

newman run Jenkins-Testing.postman_collection.json -e Reltio-MDM-UCI.postman_environment.json --export-environment Reltio-MDM-UCI.postman_environment.json

Similar output will be prompted:

Collection executed successfully through the command line.

Now somebody might think why did I pass the environment file twice in a different way. Let me explain it why?

The Collection that I used above for my explanation needs an access token to be generated freshly for each run. Could we not just attach a token to the tests, export the collection and put them into our CI? No we can’t. That would work for a while but the tests would fail once the access token expires. So any access token I attach to my Postman collection to run in CI is eventually going to be invalid.

We need a way of automatically generating a fresh access token and passing it into our Postman tests. In CI terms, we need to be able to generate an access token on every run of tests. In order to achieve this, I have added an environment variable to store the access token that gets generated by a request of Authentication. So now when we send a request for an access token we can now grab that access token from the response and attach it to any future responses we need. But wait a min by POSTMAN the scenario will work fine but NEWMAN does not update the environment variables file during a run of tests. So to save the new values of the environment variables after a collection run, simply add this argument when running the collection that updates the variables: --export-environment OurEnvironmentFile

In our case :

newman run Jenkins-Testing.postman_collection.json -e Reltio-MDM-UCI.postman_environment.json --export-environment Reltio-MDM-UCI.postman_environment.json

That’s it and now we are familiar with the basics of NEWMAN.

Hope the article was useful! Happy Learning! 😊

Jan 18, 2021

API Testing 'A Beginners View': How to receive notification of POSTMAN Test execution completion in GOOGLE CHAT ROOM

Google chat API is an interesting API that lets you to get notification of the Test Scripts execution completion for every run. Just install GOOGLE CHAT in your machine and follow the below steps and that’s it

Steps to it:

Create a room in Google chat (Addin the member's list).

Room is setup:

Select “Manage webhooks” as displayed below:

Type any name as per your need and click save:

Copy the link to the Clipboard. Open your collection/folders, just add this as a new POST request to the existing ones.

Click on “Send”:

In this BOT you can add some Test Scripts based on the previous requests execution status to showcase the Test Report.

Sample is below:

var resp = JSON.parse(responseBody);

console.log(resp);

//Checking the Response Status Code

pm.test("Response is Successful with Status Code 200", function ()

{

pm.response.to.have.status(200);

console.log("Response is Successful with Status Code 200");

});

// this counter is from previous step (in your script need to define it)

to check the completion of run

const counter_check = pm.environment.get("counter");

if(counter_check == 10)

{

pm.test("Execution Passed" , function ()

{

console.log("Execution Passed");

});

}

else

{

pm.test("Execution Failed" , function ()

{

pm.expect.fail('Execution failed, please check test results of previous steps');

});

}

Happy Learning 😇

Hope this was useful 😇

A Software Tester's Blog

Software Testing