Client application for Cisco - IT Assets Management System.

It will helps to handle with multiple hardware check-in/checkout and generates protocols.

Installation

1. Download the newest version using git clone:

   git clone https://github.com/praszuk/Client-IT_AMS.git
   

   or from here.

2. Install python, packet manager, virtualenv:

   • Python3.6 (with tkinter).
   • Package manager i.e. PIP.
   • It's recommended to use virtual environment i.e. to use virtualenv.

3. Install requirements:

   pip install -r requirements.txt
   

Configuration

Start application using:

python Main.py

It should generate empty config file .config.txt:

[GENERAL]
template_file_path=<path to .docx document>
[API]
url=<your url to hardware API>
token=<api token with "Bearer" >
[PRODUCT_INFO_API]
grant_type=client_credentials
client_id=<client_id>
client_secret=<client_secret>

1. template_file_path - path to .docx file see this file for more information.
2. url - ip or url to your Snipe-It system (without slash as last character) i.e. snipe-it.example.com.
3. token is from snipe-it app i.e. Bearer your-secret-token it can be obtained from here.
4. grant_type - it's default auth type for Cisco API. Don't change this if you don't need.
5. client_id - it's required to Product info API to use Auto-Add function. You need verified account (as partner account or employee account) at developer cisco.
6. client_secret - same as above.

How to use

1. Launch application.

2. Use Edit button to launch input data and fill with serial numbers, then press ok.

   Application will try to connect to internal snipe-it system first:

   If you don't have assets in your system yet. App will try to connect to Cisco Product Info API. If serial number is unique and asset exists in Cisco API database. You should get something like this:

   Then you can use Auto-add feature. Select asset with status "READY_TO_ADD" and auto-add button should be active.

   If you press Auto-add button, app will try add this to your internal system.

3. Use Generate button to generate docx protocol of this data. You can use your own template. Check this file for more information.

4. Use Check-in all button to check-in deployed assets.