stothe2/access-db

PR metrics analysis tool

access-db

Analysis tool

##Pre-requisites

Before you run the script on your computer, go through the checklist below and ensure you have the pre-requisites.

1. python 2.7.7 (python 2.7.7 is the latest release of Python 2 as of June 25, 2014)

For windows, click here to install. Note that to be able to run python commands on the windows command line, you'd have to add the installation directory Python27 to the PATH variable. Check this thread for help.

2. pyodbc 3.0.7 (pyodbc 3.0.7 is the lastest release as of June 25, 2014)

To connect to Access DB, the script uses this external library. To install, click here. Note that if you're working on a LAM-issued computer, installing the 32-bit version is recommended.

3. openpyxl 2.0.4 (openpyxl 2.0.4 is the lastest release as of June 25, 2014)

To process Excel 2007 xlsx/xlsm files, the script uses this external library. To install, click here. Caution: the documentation for openpyxl 2.0.4 is still being updated, so don't fret if the code in the tutorial section of the library website doesn't work as it is supposed to (you might need to go to \Python27\lib\site-packages\openpyxl and check the invidual files and figure out the correct syntax on your own).

##Running the Script

Open the command line, and type python main.py.

##Example

> python main.py
1 Software
2 Controls...1
Path...C:\Users\yourUsername\Desktop\GitCode\analysis-tool\PR-Metrics.accdb
Workbook name ('something.xlsx')...test.xlsx
Previous worksheet name ('Sheet1')...13Jun
New worksheet name ('Sheet2')...24Jun

##Additional Comments

1. The script cannot work without a pre-existing Excel file containing a worksheet with data from your last analysis (keep their names handy -- you'd be asked to enter these).

2. Make sure you save the Access DB file on your system (and, like above, keep the address handy).

3. The script works under the assumption that your pre-existing Excel sheet is formatted in a particular way. To ensure correct numbers get copied over, do not change the formatting! Correct placement is given below.

Table	Placement
Med/Low	B5:E22
High	I5:L22
Linedown	O11:P13
Safety	O15:P17
Grand Total	F24:H26