ServiceNow Task Verifier Web Application

Table of Contents

1. About The Project
2. Usage
3. Contributing
4. License
5. Contact

About The Project ℹ️

ServiceNow Task Verifier is a web application giving the possibility to exercise and train with pre-made assignements on a ServiceNow Developer Instance and check the tasks. Every user can login with it's ServiceNow Instance credentials and verify the tasks in the application. Every tasks consists a JS script which verifies the CMDB and checks if specific tables, fields or records are existing.

In addition to the Web Application you can download and use the Desktop App as well. Simply download the last realease and follow the instructions in the README.md file.

The Web Application is running JS scripts to check for the specific tables or records that you have create on your Developer Instance, following the assegnements. The scripts connects to your instance using a API and pre-made queries to the CMDB are used to extract the values from the tables/records.

Build with 🔧

Following technologies were used in the project:

• HTML/CSS/Javascript/Ruby
• ServiceNow Developer Portal
• ServiceNow REST API
• Obsidian
• Oracle VM Virtual Box
• Vagrant

Usage ❓

⚠️ Before logging in the platform you should create a CORS rule in your ServiceNow Instance. Navigate to Applications --> System Web Services --> REST --> CORS Rules. Create a new rule with the following data:

• Name --> Give it a name by your choose.
• REST API --> Choose Table API[now/table] from the dropdown menu.
• Domain --> Insert the domain of the Web App https://snow-environment.github.io.
• Max age --> Leave as 0.
• Application --> Global, by default.
• HTTP Methods --> Leave GET and POST as set by default.

⚠️ To be able to log in, your ServiceNow instance should be in Online status.

🔓 Getting your instance credentials:

• Navigate to the Developer Portal and sign in with your account.
• On the top-right corner open your profile and choose Manage instance password
• In the newly opened window you can check your credentials. To login in ServiceNow Task Verifier Web Application you will need Instance name in format devXXXXXX, Username and Password.

➡️ Follow these steps to fullfill and verify the given tasks:

• After succsesful login you will be able to review the pre-made tasks.
• Check the assignements for every task you will find in the application.
• Go back in your Developer Instance and perform the tasks.
• After finishing the tasks in your Developer Instance go back in the Web Application and press Validate button for the respective task. You should receive a feedback IF or IF NOT the assignement was done properly.

Contributing 💻

You are more than welcome to take a part in further developing and maintenance of this project. You can fork the project, commit your changes and open a pull request. The project is using servicenow-rest-api library for javascript to write simple scripts establishing connection to the ServiceNow Instance and verifying the pre-made tasks.

⚠️ To install the ServiceNow API

npm install servicenow-rest-api

Check the API Documentaion and GitHub Repo:

• ServiceNow REST API Documentation
• GitHub Repo

1️⃣. Fork the Project
2️⃣. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3️⃣. Commit your Changes (git commit -m 'Add some AmazingFeature')
4️⃣. Push to the Branch (git push origin feature/AmazingFeature)
5️⃣. Open a Pull Request

💡 You can open an issue with [BUG] tag or [FEATURE] if you have an idea for improving the project or adding some new features.
💡 Open issue with [DOC] tag for documentation improvement

We highly appreciate giving the project a ⭐!

Licence 📜

• Distributed under the GPL-3.0 license. See LICENSE for more information.

Contact 📫

• Aleksandar Karastoyanov - LinkedIn - [email protected]
• Georgi Balabanov - LinkedIn - [email protected]