SOFTWARE DESIGN SPECIFICATION

advertisement
Urban Science Web Reporting Tool
Urban Science
Web Reporting Tool
Software Design Specification
Senior Design Team Fall 2005
Tuesday, November 10, 2005
Todd Pugh
Josh Squillets
Martha R. Casing
Steve Myslinski
2/12/2016
Urban Science Web Reporting Tool
SOFTWARE DESIGN SPECIFICATION ......................................................................................... 1
1.0 Introduction ...................................................................................................................................... 1
1.1 Goals and objectives ..................................................................................................................... 1
1.2 Statement of scope ........................................................................................................................ 1
1.4 Major constraints .......................................................................................................................... 1
2.0 Data design ....................................................................................................................................... 1
2.1 Internal software data structure .................................................................................................... 1
2.2 Global data structure ..................................................................................................................... 2
2.3 Temporary data structure .............................................................................................................. 2
2.4 Database description ..................................................................................................................... 2
3.0 Architectural and component-level design ....................................................................................... 3
3.1 Program Structure ......................................................................................................................... 3
3.1.1 Architecture diagram ................................................................................................................. 3
3.2 Description of Components .......................................................................................................... 3
3.2.1 Description for Dealer Search.................................................................................................... 3
3.2.2 Description for Dealer Profile.................................................................................................... 4
3.2.3 Description for Dealer Census ................................................................................................... 4
3.2.4 Description for Dealer Activity ................................................................................................. 4
3.2.5 Description for Export Report ................................................................................................... 5
3.3 Software Interface Description ..................................................................................................... 5
3.3.1 External machine interfaces ....................................................................................................... 5
3.3.2 Human interface ........................................................................................................................ 5
4.0 User interface design ........................................................................................................................ 5
4.1 Description of the user interface ................................................................................................... 5
4.1.1 Screen Images ............................................................................................................................ 6
4.1.2 Objects and Actions ................................................................................................................... 8
4.2 Interface design rules .................................................................................................................... 8
4.3 Components available ................................................................................................................... 8
4.4 UIDS description .......................................................................................................................... 8
5.0 Restrictions, limitations, and constraints .......................................................................................... 8
6.0 Testing Issues ................................................................................................................................... 8
6.1 Classes of tests .............................................................................................................................. 8
6.2 Expected software response .......................................................................................................... 9
6.3 Performance bounds ..................................................................................................................... 9
6.4 Identification of critical components ............................................................................................ 9
7.0 Appendices ......................................................................................................................................10
7.1 Requirements traceability matrix .................................................................................................10
7.2 Packaging and installation issues.................................................................................................10
7.3 Design metrics to be used ............................................................................................................10
7.4 Supplementary information (as required) ....................................................................................10
7.4.1 Detailed Table Information.......................................................................................................10
7.4.2 Test Plan ...................................................................................................................................11
2/12/2016
i
Urban Science Web Reporting Tool
Figure 1 - Relationships.................................................................................................................................. 2
Figure 2 - Architecture Diagram .................................................................................................................... 3
Figure 3 - Main Menu..................................................................................................................................... 7
Figure 4 - Dealer Search ................................................................................................................................. 7
2/12/2016
ii
Urban Science Web Reporting Tool
SOFTWARE DESIGN SPECIFICATION
1.0 Introduction
This section provides an overview of the entire design document. This document
describes all data, architectural, interface and component-level design for the
software.
1.1 Goals and objectives
To create a front-end for a set of relational databases that provides service through
the Internet.
1.2 Statement of scope
The software will retrieve data from an SQL server upon user defined queries.
The users should have quick response time to the data. This will be used by the
software to create reports. These reports can be viewed from Internet Explorer
and/or printed and/or exported.
1.3 Software context
This end product will be provided via the Intranet to Urban Science employees to
access data that will provide up to date information on dealership locations around
the country, dealer profile information and a census by manufacturer by
geographical location. (I.e. Added, terminated, relocated, bought/sold)
1.4 Major constraints

No Java language can be used.

Tool must operate in Microsoft environment.

Must work in Internet Explorer 6

The information store will be an SQL database.
2.0 Data design
A description of all data structures including internal, global, and temporary data
structures.
2.1 Internal software data structure
When SQL returns the results of the query sent to it by ASP, the results of the
query will be passed back to ASP using the built in data structures.
2/12/2016
1
Urban Science Web Reporting Tool
2.2 Global data structure
We are not using any global data structures at this time.
2.3 Temporary data structure
We will be using a cookie saved on the user’s machine to temporarily store the
user’s query entry. This is so the user can go back to the query page and easily
modify their last query to refine or widen their search as needed.
2.4 Database description
A database will be used to store all of the dealer data used to create the reports
needed. The database is made up of five tables. BestLocCodes, Composite,
Franchise, Manuf and Changes. The relationships for these tables are shown
below. Changes has no relationships to the other four tables.
Figure 1 - Relationships
The database will be implemented using SQL.
For detailed descriptions of tables and fields refer to Appendix A.
2/12/2016
2
Urban Science Web Reporting Tool
3.0 Architectural and component-level design
3.1 Program Structure
A data-centered architecture is the obvious choice for the software. The database
will be stored using SQL Server 2000 and accessed using ASP.NET. Almost
every component of the software will interact with the database in some way.
The data that is retrieved will be returned to be displayed in a user friendly format
within the user’s web browser or exported for use in Microsoft Excel.
3.1.1 Architecture diagram
Dealer Census
Dealer Search
Dealer Activity
Dealer Profile
Export Report
Dealer Database
Figure 2 - Architecture Diagram
3.2 Description of Components
3.2.1 Description for Dealer Search
3.2.1.1 Processing narrative (PSPEC) for Dealer Search
Dealer Search will display a page with a form allowing the user to enter
information to search for the dealer of their choice. They must at least
enter the State, select a time period, and select at least one Manufacturer.
A list of dealers that match the information the user enters will be
displayed. The user can then select any of these dealers to continue to the
Dealer Profile page.
3.2.1.2 Dealer Search interface description.
The user will input data using their web browser. An SQL query will be
generated using their selections and sent to SQL Server. The data from
the query will then be returned and processed using ASP.NET before
being sent back and displayed to the user.
2/12/2016
3
Urban Science Web Reporting Tool
3.2.2 Description for Dealer Profile
3.2.2.1 Processing narrative (PSPEC) for Dealer Profile
The Dealer Profile will provide a summary of data available for one
particular dealer. The user can continue from this page to look at the
Dealer Activity reports for the county where the dealer is located.
3.2.2.2 Dealer Profile interface description.
An SQL query will retrieve all data on the dealer from SQL Server. The
data from the query will then be returned and processed using ASP.NET
before being sent back and displayed to the user.
3.2.3 Description for Dealer Census
3.2.3.1 Processing narrative (PSPEC) for Dealer Census
Dealer Census will allow the user to access reports that cover greater
geographical regions than those accessed using the Dealer Profile page.
The user will be presented with various options to select from and fields to
enter to get the data they need. They will then be able to continue to the
Dealer Activity reports associated with that data.
3.2.3.2 Dealer Census interface description.
The user will input data using their web browser. An SQL query will be
generated using their selections and sent to SQL Server. This information
will be used once they proceed to the Dealer Activity page.
3.2.4 Description for Dealer Activity
3.2.4.1 Processing narrative (PSPEC) for Dealer Activity
The Dealer Activity reports will vary based on what data group the user
has selected. If the user comes from the Dealer Profile page data from the
surrounding county will be displayed, if they come from the Dealer
Census page the data will span whatever geographical region they have
selected. The data will be retrieved using an SQL query and then bound
an ASP.NET Data Grid control to be displayed to the user.
3.2.4.2 Dealer Activity interface description.
Using information from the previous page a query will be sent to SQL
Server to retrieve all data needed by the activity report. The data will be
returned and processed using ASP.NET before being sent back and
displayed to the user.
2/12/2016
4
Urban Science Web Reporting Tool
3.2.5 Description for Export Report
3.2.5.1 Processing narrative (PSPEC) for Export Report
Export Report will be available to users while viewing any dealer reports.
The data from the report that is currently displayed on the screen will be
exported to a format that is compatible with Microsoft Excel for further
use.
3.2.5.2 Export Report interface description.
The data will be converted by ASP.NET and sent to the user.
3.3 Software Interface Description
3.3.1 External machine interfaces
The software will interface with a machine running SQL Server 2000
where all of the dealer information will be stored.
3.3.2 Human interface
The software will be available on the Intranet where users will have access
to it using Microsoft Internet Explorer 6.0 or higher. Details of the
implementation of this interface are available in Section 4.0.
4.0 User interface design
A description of the user interface design of the software is presented.
4.1 Description of the user interface
The user interface (UI) is web-based and provides a visual front-end to our client's
databases and queries.

Main Menu Page
The main menu page allows a user to navigate to either the dealer search or dealer
census pages.

Dealer Search Page
The dealer search page contains fields for the user to fill in with information to
search for specific dealers or a more generalized area containing multiple dealers.
It also contains a navigation menu on the side that will allow the user to quickly
get from the search page to wherever they want within the site. At the bottom
there is a box in which the search results will be displayed. In the results box, a
user can choose a dealer and go to the dealer profile or the dealer activity page for
more info on the dealer they choose.
2/12/2016
5
Urban Science Web Reporting Tool

Dealer Activity Page
The dealer activity page has information on the activity of dealerships around the
dealership that the user has chosen. Activities such as dealerships being added to,
relocated to or away from, closed and bought or sold in the area. This page also
has the navigation menu along the side of the page; except this navigation bar also
has links to certain parts of the page. Due to the possible length of each report on
activity, this was added.

Dealer Profile Page
The dealer profile page contains information on the location, phone number, when
it was opened, brands at the facility and other dealerships closely located. This
page also contains an image of the dealership, navigation bars to cycle through
dealership profiles that came up in the original search and the navigation menu on
the side with a new option to go to the dealer activity page of the currently
selected dealership.

Dealer Census Page
The dealer census page will be similar to the main menu, except that it's the main
menu for all the reports. From this page, you can access the dealer activity
summary report and the franchise report. Again the navigation menu is along the
side.

Dealer Activity Summary Report Page
The dealer activity summary report page will have the options to choose a state,
manufacturer and a dealer census to generate a region based report for dealership
activity. This would include add, relocate, close, and buy/sell information on
dealerships within the region the user selects.
4.1.1 Screen Images
Shown here are the interface screens of the web application.
2/12/2016
6
Urban Science Web Reporting Tool
Figure 3 - Main Menu
Figure 4 - Dealer Search
2/12/2016
7
Urban Science Web Reporting Tool
4.1.2 Objects and Actions
The main object on all of the pages is the navigation menu that will allow
the user to get to the main menu, the dealer search and the dealer census
portion of the site. Depending on what page you are on there may be more
options in the navigation menu. There is also a search button that
commences searching of the databases based on criteria, and displays the
results in a result box on the dealer search page. The same page also has a
reset button that will clear all the fields so that the user can start with a
clean slate of search criteria. On the dealer profile page, there will be
navigation buttons allowing the user to move through the list of results
provided by the search that the user makes.
4.2 Interface design rules
The only standards that we are currently following are to conform to the general
color scheme of the Urban Science web site, www.urbanscience.com
4.3 Components available
There are none at this time.
4.4 UIDS description
We are going to be developing this website with ASP.net and using SQL to query
the database.
5.0 Restrictions, limitations, and constraints

No Java language can be used.

Tool must operate in Microsoft environment.

Must work in Internet Explorer 6

The information store will be an SQL database
6.0 Testing Issues
Test strategy and preliminary test case specification are presented in this section.
Additional test cases are located in the Appendix section in spreadsheet format.
6.1 Classes of tests

2/12/2016
Performance Test – ensure that the response time for information
retrieval is within an acceptable range.
8
Urban Science Web Reporting Tool

Accuracy Test – determine if queries return the expected results.

User Interface Test – make sure the user interface is clear and easy to use
with all types of users

Security test – ensure that users can only perform the tasks specified for
their user group

Repeatability Test – The software returns the same result for repeated
queries.
6.2 Expected software response

Performance Test – all activities should respond within 30 seconds.

Accuracy Test – Returned report matches manual report.

User Interface Test – Unfamiliar user can use the interface with minimal
instruction and achieve the desired results.

Security Test – Users are restricted to activities in their class.

Repeatability Test – If an identical query is repeated the same response is
given each time.
6.3 Performance bounds

Must be compatible with Internet Explorer and work on Microsoft IIS

Search process should not take longer than 30 seconds.

Page request process should not take longer than 30 seconds.

All activities done by the software should respond within 30 seconds.
6.4 Identification of critical components

2/12/2016
Database connectivity
9
Urban Science Web Reporting Tool
7.0 Appendices
7.1 Requirements traceability matrix
Because of the small size and rapid development of this application, a traceability
matrix is not needed.
7.2 Packaging and installation issues
There are none at this time.
7.3 Design metrics to be used
For the interface, the user must be able to use 90% of the system functionality
after a 1 hour training session.
7.4 Supplementary information (as required)
7.4.1 Detailed Table Information
2/12/2016
10
Urban Science Web Reporting Tool
7.4.2 Test Plan
Shown below are test plans for General tests and the different web
pages, which are Log In, Main Menu, Dealer Search, Dealer Profile,
Dealer Activity, Dealer Census and Activity Summary Report.
Test condition
No.
Expected Result
Log In
1
2
Enter web address.
Enter web address and user name and
password.
User should be shown the log in screen.
A valid user should be able to enter username and password and
then be shown the main screen upon successful log in.
General
Tests
Test all links on each web page from the site
map
For each link selected, the link should change color, so the user
knows what was previously selected. The user should also be
taken to the correct and corresponding link.
Test numeric in text box fields on web pages
Where applicable, the user should be allowed to enter numeric
data into the text box fields.
The user should be shown the correct and corresponding web
page with performance time considered.
Where applicable, the user should be allowed to enter
alphanumeric data into text box fields.
The user should be shown reports, without error. Else an error
message will be shown.
The user should be able to export all reports without error. Else
an error message will be shown.
The user should be able to navigate using the previous and next
buttons on the page.
Test that the report being viewed is the correct report has the
correct data displayed.
Test that the web site loads.
Test that there is a database connection.
3
4
Test opening each web page
5
6
Test alphanumeric in text box fields on web
pages
Test viewing reports
7
Test exporting reports
8
9
10
11
12
Test previous and next buttons on Profile
page.
Test the Reports
Test the web site from the server end.
Test the database connection
Main Page
Notice the main web page
The user should see the site map on the left side of the screen.
The user should see two available options to select from in the
center of the page (dealer search and dealer census), the title of
the page should be on the top of the screen. There should also be
a way to log out link. The links that appear in the site map should
include Dealer Search, Reports, main menu, and Urban Science
home page.
The user should be taken to the corresponding web page of the
link selected.
The user should be able to log out of the web site.
Each link should take the user to the corresponding web page.
13
14
15
16
Notice the main web page and select the two
links on the center of the page.
Notice the main web page and select log out.
From the main web page, notice the links on
the left side in the site map, test each link.
2/12/2016
11
Urban Science Web Reporting Tool
Dealer
Search
From the main web page, select Dealer Search,
notice the web page that appears.
17
18
19
20
21
22
23
Enter numeric characters into the text box
fields.
From the Dealer Search page, select census,
manufacturer and state (these are required fields
for the report to be shown), and then Search
button.
From the Dealer Search page, select census,
manufacturer and state (these are required fields
for the report to be shown), and then Search
button. Select a check box in the results section
The user should be shown the Dealer Search page. The site map
should be on the left side of the screen. The text boxes and drop
down boxes should be set to default values. The Dealer Profile and
Dealer Activity buttons should be hidden until state, census, and
manufacturer are selected. Search button should be dimmed until
manufacturer is selected, state, and census are selected. "All" should
be included as an option in the manufacturer list. The links that
appear in the site map should be main menu, dealer search, dealer
census, and Urban Science home page.
The user should only be allowed to enter numeric characters into
zip field, all others should be alpha characters.
The user should be shown the search results in the lower portion of
the screen.
The user should be able to select the check box next to a dealer.
Only one box should be able to be checked at one time, and the
rest disabled and/or shaded out.
From the Dealer Search page, select census,
manufacturer and state (these are required fields
for the report to be shown), and then Search
button. Next select the Dealer Profile button.
The user should be shown the Dealer Profile page.
From the Dealer Search page, select census,
manufacturer and state (these are required fields
for the report to be shown), and then Search
button. Next select the Dealer Activity button.
The user should be shown the Dealer Activity Page.
From the Dealer Search page, select census,
manufacturer and state (these are required fields
for the report to be shown), and then Reset
button.
The user should be able to select the Reset button and then the text
boxes and the drop down boxes are set to default values.
Dealer
Profile
From the Dealer Search page, select Dealer
Profile, notice the web page that appears.
From the Dealer Search page, select Dealer
Profile, enter data into the text boxes and
other fields.
The User should be shown the site map on the left side of the
screen. The site map links should include main menu, Dealer
Search, Dealer Census, Dealer Activity, and Urban Science home
page. The user should also be shown text boxes and drop down
boxes populated with data that was previously selected. The user
should see the dealer image, as well as, previous dealer, change
dealer and next dealer buttons.
The user should not be allowed to enter or change any of the text
boxes or other fields shown on the screen, they should be locked.
This is view only screen.
From the Dealer Profile page, test the links on
the site map.
From the Dealer Profile page, test the
previous, next and change dealer buttons.
The user should be able to view and go to all of the links on the
web site map.
The user should be taken to the corresponding page for each
button selected.
24
25
26
27
2/12/2016
12
Urban Science Web Reporting Tool
Dealer
Activity
From the Dealer Search page, select
Dealer Activity, notice the web page.
28
From the Dealer Activity page, scroll
down to view the entire page.
29
The user should see the site map on the left side of the screen. The site
map should include Reports and list each (add, relocate, close, buy/sell),
main menu, Dealer Search, Dealer Census, Dealer Profile, and Urban
Science home page. There should also be print and export buttons. The
user should be shown data grids for each report (add, relocate, close,
but/sell) with the criteria selected.
The user should be shown all of the report data grids. The user should
be able to select the links in the site map to view the same data grids on
the web page.
Dealer
Census
From the Main menu page, select the
Dealer Census option. Notice the web
page that appears.
The user should be shown the Dealer Census page. The Census page
should have a title, site map, which includes main menu, Dealer Search,
Dealer Census, and Urban Science home page. There should be an
option to select the Dealer Activity Summary Report.
From the Dealer Census page, select the
link Dealer Activity Summary Report.
Notice the web page that appears.
The user should be shown the Dealer Activity Summary Report page.
The page should have a web site map, which includes main menu, and
urban science home page. There should also be a Generate button,
options to select state, manufacturer, and dealer census date.
From the Dealer Activity Summary
Report page, select state, manufacturer,
and census, and then the Generate
button.
The user should be shown the summary report for the options selected
from the Dealer Activity Summary Report page.
30
Dealer
Activity
Summary
Report
31
32
2/12/2016
13
Download