OG Mobile Test Case

Open Grid 1.0

Test Cases

Version 1.0

Submitted By:

September, 2015

Table of Contents

• ACCEPTANCE

• REVISION HISTORY

• PROJECT OVERVIEW

  • Document Purpose

• SETUP

  • Test environment and client

• OPENGRID 1.0 (OG1.0) APPLICATION TEST CASES

  • User Roles

  • Authentication and Authorization

  • Functional Requirements Ref: 2.2.1-2.2.4, 2.2.6 10

    • Login and Logout

    • Session Time-out 11

  • Page Layout

  • Quick Search

  • Monitor mode of Quick Search

  • Advanced Search

  • Table Functions

  • Manage saved queries

• ADMINISTRATION “MANAGE” FUNCTION

  • User Administration

  • Group Administration

Acceptance

The signatures below indicate that the City of Chicago’s Department of Innovation and Technology concurs with the test plan described in this document prepared by Electronic Knowledge Interchange.

_______________________________ _______________________________

Department of Innovation & Technology Date

Revision History

Revision	Date	Author	Notes
1.0		Diana Clem	Initial Version
1.0		Regina Hightower

## Project Overview

The City of Chicago’s Department of Innovation & Technology (DoIT) developed OpenGrid, an enterprise geographic information system, to support situational awareness and incident monitoring and response. In lieu of reviewing numerous and disparate reports, OpenGrid gives key personnel access to service calls, asset locations, building information, tweets and other critical information all in one place.

The OpenGrid architecture consists of three primary parts: the user interface, service layer, and data layer. The user interface is design to remain unchanged. The service layer is meant to be flexible to any data source. The data layer will be implemented based on client specifications. From the application layer, users may then query data by type, time and distance from a point or within a boundary, and retrieve real-time or historical data.

Document Purpose

This document contains test scripts for Mobile device (IOS and Android) that will walk through the possible paths the end user is presented with while navigating the application and the expected results of each action. The document also contains sample data-set that that can be used to conduct testing.

Setup

Test Cases can be completed by accessing the application in DoIT’s quality assurance environment.

Test environment and client

These tests have been performed in the QA environment using the Open Grid client application.

Open Grid 1.0 (OG1.0) Application Test Cases

This section specifies the test cases that should be executed in order to complete Quality Assurance Test of the Open Grid 1.0 (OG1.0) application.

The ‘Execution Steps’ on each ‘Test Case’ outline the actions to be taken to complete the test case. For each execution step, please confirm that the actual results match the expected results identified in the ‘Expected Results’ column.

User Roles

The test cases below cover the user roles identified in requirement 2.1

• Administrator: able to add users to the system, able to remove users from the system, may access data in real-time

• Full Access-Real-time: public safety users; may access data in real-time

• Full Access-Reporting: public safety users; may accept slight delay in data freshness

• Basic Access-Reporting: non-public safety users: may accept slight delay in data freshness

Authentication and Authorization

Login and Logout

Precondition: User has unique User ID and password.

Execution Steps	Expected Results	Actual Result	Comments
1. Login Launch app: https:xxxxxxxxxxxxxxxxxx	When the application is initially opened on the browser and no active OpenGrid 1.0 session exists, a login window will be displayed. Id and password fields should be enterable. Login button should appear only after id and password are entered.
2. Valid login Execute step 1. Use an userid with access to OpenGrid Type in valid userid and password. Select login button.	Type in valid userid; remove the additional space from the userid by hitting the backspace button. In the Password textbox enter the user password. Click the Login button. Application landing page should appear. Logoff		Open Grid uses its own database.
3. Invalid login Execute step 1. Type in invalid userid and/or password, then click on the login button.	User should get an error message - “The login failed due to invalid username/password.”
4. Logout Execute step 2. Go to the command bar; click the box on the right side. From the dropdown list select your name, click on the down arrow dropdown list, and select Logout.	Logout should be in the name dropdown list. Upon execution of Logout, the login screen should display. A message should appear “You have been logged out”.

Session Time-out

Functional requirement 2.2.5 as amended in change request.

Session Timeout

After the application has been idle for 30 minutes, the user will be logged off. The next action on the screen will result in display of login page with a message indicating that the session has expired.

Precondition: Establish valid login session.

Execution Steps	Expected Results	Actual Result	Comments
Login and then have 30 minutes of inactivity. Attempt any command on OG 1.0 (The number of minutes is configurable). Type in invalid id and password. Login, perform quick search of tweet data “Tweet xxxx” to invoke the monitoring refresh. Have 35 minutes of no keyboard activity.	Login page should be presented with message: “Your session has timed out. For your security, you were logged off”. Message should be replaced with “The login failed due to invalid username/password.” Session should not time-out.

Page Layout

Functional Requirements Ref: 2.3.1-2.3.2

Page should match Functional Design section 3.1

User with Administrative Rights


User without Administrative Rights


Execution Steps Page Element #, Element Name/Description	Expected Results	Actual Result	Comments
Quick Search box;clicking on the quick hint icon will display a “cheat sheet” with all the available commands and syntax.	Should be able to type in quick search box. Clicking on hint icon should bring up the “cheat sheet” with available commands. This box should not block the quick search and should remain visible until closed.
2. Command bar Click the icon to the right, Click on “Advanced Search” to bring up the search panel. Click the dropdown icon to the right, Click on “Clear Data” this will clear the map and table view. Userid with admin rights. Click the dropdown icon to the right, Click on “Manage” to bring up the administration screens. Userid without admin rights. “Manage” should not be on Command bar.	Side panel should expose with the Advanced Search menu. Values already on map remain. All values on map and grid are reset. Monitoring is turned off. Side panel should expose with Admin screens. “Manage” button should not be on command bar
3. User panel, displaying the name of the currently logged in user with a drop down arrow to right of the username for logging out.	Display as Described.
4. Zoom-in/out controls	Map should zoom in, zoom out.
5. Reset Map view and Area Zoom	Map should reset to original view. Map should redirect to include all query results.
6. Zoom specification control Full-Screen control Geo-location control	Map zooms within specific location. Full screen control returns map to full screen mode. Current location is pinned on the map.
7. Layer control this will allow the user to switch between: Street View. Aerial View. Display list of available layers.	Street View. Aerial View. Display list of available layers.
8. Measurement Tools Distance between points. Distance around a point. Turn off measurement tool by clicking on icon again.	Cursor should measure click to click on map. Measurement in feet, miles, yards, meters, or kilometers. Create circle around point in feet, miles, yards, meters, or kilometers. Clear measurement mode.
9. Expandable table view panel. Perform any quick search or Chicago Find.	Bottom panel shows. Results of data search with displayable fields for each data point.
10. Main map display	Default is City of Chicago

Quick Search

Functional Requirements Ref: 2.12.4, 2.4.1

A Quick Search box can be used to perform common searches that will support the following commands/inputs:

Precondition: Valid Login

Execution Steps	Expected Result	Actual Result	Comments
Address Type “50 W. Washington” in quick search Type in “50 Washington”	Finds the specified address on map and in grid. Finds 50 East Washington on map and in grid.
Latitude and Longitude Type in 41.8270, -87.6423 Type in 418270, - 87.6423	Displays a marker to show location of latitude and longitude entered. Nothing in grid. No marker on map and in grid.
Place Name Type “Daley Center” Type “Eiffel Tower”	Shows location of Daley Center, 50 W. Washington. Nothing in grid. Finds all data points for Eiffel Tower and centers the map. Data in grid.
Tweet Type "tweet" Type tweet coupon	Pulls up all tweets throughout the grid. Pull up tweets that have key phrase coupon.
Weather Type “weather 60602” Type “weather 60611”	Displays a point in the middle of the zip code showing weather information. Data also in grid. Displays a point in the middle of zip code showing weather information. Data also in Grid.

Monitor mode of Quick Search

Precondition: Valid login to OpenGrid.

Execution Steps	Expected Result	Actual Result	Comments
Quick Search auto refresh Type in “tweets”. Leave on screen for 35 seconds	After 35 seconds, the screen should refresh the data.

Advanced Search

Functional Requirements Ref: 2.4, 2.10, 2.11-2.12 excluding 2.12.4

Precondition: Valid login to OpenGrid.

Execution Steps	Expected Result	Actual Result	Comments
Existing Queries Click the dropdown box on the right. Go to Advanced Search; Existing Queries: In the commonly used query drop down list select one of the commonly used queries, then click submit. Load saved query drop down select the saved query, click submit. Adding data sets and Standard filters Click on add datasets, select the saved dataset from the list (for ex: twitter). Click submit. Add a rule or group to your dataset Adding a rule gives you the option to query by date, city, screen name or text. Additional/Geo-spatial filters There are two filters to search by “Within” and “Near” Select within, the dropdown menu consist of Map Extent, Drawn Extent, Citywide, Zipcode and Ward. Click on Drawn Extent and submit. Clear Data - On the command bar to the right select the icon and click on the Clear Data button. Reset on advance search Modify the color, size and opacity of the points using icons in advanced search. Select Near, there are options to have “Me” or Near Marker. Select Near me, select “Me”, and then submit. Select Marker, place markers on the map to specify points, click submit.	The results from the commonly used query should appear. The results from the saved query should appear. The results from the dataset should appear on the map. Map, table and advance search are all reset as if initially logging on. Map and table do not change. Criteria on advance search panel are removed (as if initial time to Advanced Search). Attributes should change as specified. Attributes should appear or change as specified after submit button. Note: Make sure the location services is set to ON for the Near Option to function. The Near Me function should display a marker near your location. The results from the query should appear.

Table functions

Precondition: Valid login to OpenGrid.

Complete an Advanced Search with results. At the bottom of the screen, pull up the table grid. The table consists of standard columns: Date, Screen Name, Text, City, Latitude and Longitude. The phone held vertically - to the right under the menu bar there is a search text box. If the phone is held horizontally - to the left next to the menu bar the search textbox is displayed.

The menu bar holds functions for Columns, Exportation, Graph, Heat Map, Tile Map and Refreshing. The Columns icon is interchangeable allows you to setup table columns suitable to the user. The export function is a dropdown format that gives you the option to export the data from the table into csv, pdf or excel format. The graph icon gives you the ability to place the data into a graph based off screen name or city. The Heat Map gives you a graphical representation of data where the values contained in a matrix are represented as colors. The refresh function allows you to pause, resume or refresh data within the grid. The Tile Map presents an overview of selected data in tile format.

Execution Steps	Expected Result	Actual Result	Comments
Click on one of the Rows. Click on another Row Save query with special characters. Maximize the number of characters. Save the query with a new name but have the new query name the same as the original query name. Set multiple color attributes and save query, Clear Data and rerun the save query.	Selected column from the table should highlight on the map. Data bubble should open. On second click, first data bubble should close and new one will open. Not sure what the limit is for a query name.? Should get error message within a textbox “A query with name 'Happy Tweets' already exists. This will overwrite the existing query. Continue?” Colors should display as set. Map and table will clear with the “clear data”. Running the saved query should result in same results.

Manage Saved Queries

All previously saved queries are accessible from the Saved Queries option on the main navigation menu. When this option is selected, a list of the user’s Saved Queries is displayed where user can delete or rename the query. The name of the query is an active link that will perform the search when clicked.

Opening a saved query will invoke the query and used the user options saved along with the search criteria.

Recently saved queries can also be opened from the Build query tab. Selecting a specific query from the Load Saved Query dropdown will load the saved query. At this point the user can choose to submit the query as-is or update the query definition to add more datasets or change the query filter and save it as a query under a different name.

Precondition: Valid login to OpenGrid.

Execution Steps	Expected Result	Actual Result	Comments
Click the icon on the right; Then click on Advanced Search. Create a query,name and save it. Go to Datasets and Standard Filters Click on Add datasets; select the dataset from drop down. Add rule, group or color. Add additional Geo Spatial Filters (optional). Create new query name in the "Save Query As" text box; click save. Click on “Load saved query”. A list of saved queries including any new queries added should display from dropbox. Select save query and click Submit. Click on Manage Queries. Select from the list of saved queries. Click on the Search link to return back to Advanced Search options. Modify color on dataset tab by selecting a color preference; click submit. Save modified color in dataset, click save.	Advanced Search panel displays. Should display message "Success: Query was saved successfully." Validate new saved query displays. New page should display all of your saved queries. Saved query should be clickable. Query should load; query should display in the "Load Save Query" section. New color should be displayed on the map. New color should be saved and results of saved query (new color) should display on map.

Administration “Manage” function

User Administration

Precondition: Valid login to OpenGrid. User has been given access as an administrator.

Functional Requirements Ref: 2.16

On the application’s administration page, users with Administrator role should be able to add and remove users from OpenGrid Active Directory groups. From the Manage pane, when the Manage Users option is selected from the menu, a user search screen is displayed where users can be searched by typing in the user name (user ID) or given name (will require both First and Last Name).

On the User administration screen, the administrator should also be able to:

• Add a new User
• Add a group or groups to a User
• Update an existing User
• Delete A User

Execution Steps	Expected Results	Actual Result	Comments
On the command bar click the icon on the right hand side. Select “Manage” Select “Manage Users”	Should navigate to Manage Users tab
Select “New user” New Users text box consist of: User ID First Name Last Name Groups (Name of Group) Enter a User ID, Password, First and Last Name Click on the submit button	New User textbox appears If ID already exists in the database, a message “user id already exists” should appear upon submission. If not, continue to save the id. Data should be retained in the new user text box. New User should appear in the User ID column under Manage Users.		For OpenGrid type in any ID
Add a group/s to a User Select from dropdown list. Select each separately and all of them on different user ids and test functionality by logging on as each user.	Each user id should only have the access granted. Each group can have different dataset access. If a user does not have access to a particular dataset, a message will be returned stating that they do not have access to xx dataset. This occurs for both quick search of data as well as advance search of the data. The dataset will be on the list of available datasets but will return no values and a message.
Update a User To the left of the UserID column there is an edit function. Click on the small square icon. Create any updates to the User: Update Password Update First and Last Name Click OK	The Update Item text box appears The updated information should replace the old data. The User ID is not be editable. The Password, First and Last Name are editable. The changes should appear in the columns where updates were submitted.
Delete a User Click on the circle with the (x) in the middle on the first left column before the User ID column. Click Cancel Click OK	The Manage Users textbox will appear with a question “All queries saved by this user will be deleted as well. Continue?” If click cancel the User will remain within the list. Click OK the User will be removed from the list.

Group Administration

Precondition: Valid login to OpenGrid. ID has been given access as an administrator.

Functional Requirements Ref: 2.18-2.19

The administrator must be able to create an OpenGrid group and manage a group’s membership.

On the group administration screen, the administrator should also be able to:

• Add a new group
• Add functions and data types to a group
• Update an existing group
• Delete a Group

Execution Steps	Expected Results	Actual Result	Comments
On the command bar click the icon on the right hand side. Select “Manage” Select “Manage Groups” Manage Group consist of: Group Details (Group Overview) Functions (Types of functionality assigned to the Group) Data Types (The types of datasets)	Manage screen should appear. The default screen is the Manage Group tab.
Select “New group” New Group text box consist of: ID (Userid) Name (Name of Group) Description (Type of Group) AdminGroup checkbox Enabled checkbox To add a New Group: Select the green new group button. Create a GroupID, Enter Name, Description of new group and check preference of AdminGroup and/or Enabled. Click the Submit button.	New Group textbox appears. The new group is saved; added group should appear in the group details column under "Manage Groups".
Add functions and data types to groups Functions and Data Types columns are both drop down boxes. Functions column consist of app functionality (i.e. Quick Search, Advanced Search). Data Types column consist of datasets within the app (i.e. Twitter, weather). To add function/s and/or data types you will need to know the group you want to add a function and/or datatypes towards. Scroll to either the functions or data types column. Click on the dropdown arrow in either the functions or data types column. Select a function and/or data type/s applicable to the group. (Note: In order to add a group you must have admin rights.)	Scroll makes either the function column or data types column visible. Drop box appears with selection options. (Note: A group can have more than one function or datatypes.) Check mark will appear next to the function or datatypes.
Update an Existing Group To the left of the Group Details column there is an edit function. Click on the small square icon. To create any updates to a group: Group ID Update Name Update Description Remove or add Admin Group Remove or add Enabled function Click the Submit button.	The Update Item text box appears. The updated information should replace the old data. The ID should not be editable. The Name and Description can be updated. The changes should appear in the group details columns after the updates are submitted.
Delete a Group Click on the circle with the (x) icon on the left of the Group Details column. Click cancel Click OK	The Manage Groups textbox will appear with a question “ Are you sure you want to delete this group?" If click cancel the Group will remain within the list. Click OK the Group will be removed from the list.