Skip to content

OG Mobile Test Case

Regina edited this page Jun 10, 2016 · 30 revisions

Open Grid 1.0

OpenGrid Mobile Test Case

Version 1.0


Submitted By:

September 2015


# Table of Contents

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, incident monitoring and responses. In lieu of reviewing numerous and disparate reports, OpenGrid provides access to service calls, asset locations, building information, tweets and other critical information.

    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 scenario based test scripts for Mobile device (IOS and Android) that will walk a user through the possible paths that's presented while navigating the application and the expected results of each action. The document also contains sample data-sets 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.

    OpenGrid Mobile 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: Are able to add and remove users to and from the system.

    • 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

    1. Type in valid userid and password. Select login button.
    1. 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.

    1. Type in invalid userid and/or password, then click on the login button.

      User should get an error message -

      1. “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 Requirements

      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
      1. Login and then have 30 minutes of inactivity. Attempt any command on OG 1.0 (The number of minutes is configurable).

      2. Type in invalid id and password.

      3. Login, perform quick search of tweet data “Tweet xxxx” to invoke the monitoring refresh. Have 35 minutes of no keyboard activity.
      1. Login page should be presented with message: “Your session has timed out. For your security, you were logged off”.

      2. Message should be replaced with “The login failed due to invalid username/password.”

      3. 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
      Android and Iphone
      ![](https://github.com/Chicago/opengrid/blob/master/docs/media/combine10.jpg)

      User without Administrative Rights
      Android and Iphone

      ![](https://github.com/Chicago/opengrid/blob/master/docs/media/combine11.jpg)

      Execution Steps
      Page Element#, Element Name/Description
      Expected Results Actual Result Comments
      1. Quick Search Bar;clicking on the quick search hint icon will display a “cheat sheet” with all the available commands and syntax.
      1. Should be able to type a value into the in quick search bar.

      2. Clicking on the hint icon should bring up the “cheat sheet” with available syntax to run a quick query. This box should not block the quick search and should remain visible until closed.

      2. Command bar
      1. Click the icon to the right, a drop list will appear. Select “Advanced Search” to bring up the advanced search panel.
      2. Click on “Clear Data” under advanced search this will clear the map and table view.
      3. Userid with admin rights. Click the dropdown icon to the right, Click on “Manage” to bring up the administration screens.
      4. Userid without admin rights. “Manage” should not be an option within the Command Bar.
      1. Side panel should expose with the Advanced Search menu. Values already on map remain.

      2. All values on the map grid and search panel are reset. Monitoring is turned off.

      3. Side panel should expose with Admin screen and options.

      4. “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 and 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 area when a location is selected .
      Full screen control returns map to full screen mode.
      Current location of a user is pinned on the map.
      7. Layer control will allow the user to switch between:
      1. Street View
      2. Aerial View
      3. Display list of available layers
      1. Street View
      2. Aerial View
      3. Display list of available layers
      8. Measurement Tools
      1. Distance between points.

      2. Distance around a point.

      3. Turn off measurement tool by clicking on icon again.
      1. Cursor should measure from point to point on the map. Measurement in feet, miles, yards, meters, or kilometers.

      2. Create circle around point in feet, miles, yards, meters, or kilometers.

      3. Clear measurement mode.

      9. Expandable table view panel.

      Perform any quick search

      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

      1. Type “50 W. Washington” in quick search
      2. Type in “50 Washington”
      1. Finds the specified address on map and in grid.
      2. Finds 50 East Washington on map and in grid.

      Latitude and Longitude

      1. Type in 41.8270, -87.6423
      2. Type in 418270, - 87.6423
      1. Displays a marker to show location of latitude and longitude entered. Nothing in grid.
      2. No marker on map or in grid.

      Place Name

      1. Type “Daley Center”
      2. Type “Eiffel Tower”
      1. Shows location of Daley Center, 50 W. Washington. Nothing in grid.
      2. Finds all data points for Eiffel Tower and centers on the map. Data in grid.

      Tweet

      1. Type "tweet"
      2. Type tweet coupon
      1. Pulls up all tweets throughout the grid.
      2. Pull up tweets that have key phrase coupon.

      Weather

      1. Type “weather 60602”
      2. Type “weather 60611”
      1. Displays a point in the middle of the zip code showing weather information. Data also in grid.
      2. 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
      1. Quick Search auto refresh
      1. Type in “tweets”. Leave on screen for 35 seconds
      1. 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

      1. 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.
      2. Load saved query drop down select the saved query, click submit.

      Adding data sets and Standard filters

      1. 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”

      1. Select within, the dropdown menu consist of Map Extent, Drawn Extent, Citywide, Zipcode and Ward. Click on Drawn Extent and submit.
      2. Clear Data - On the command bar to the right select the icon and click on the Clear Data button.
      3. Reset on advance search
      4. Modify the color, size and opacity of the points using icons in advanced search.
      5. Select Near, there are options to have “Me” or "Near Marker". Select Near me, select “Me”, and then submit.
      6. Select Marker, place markers on the map to specify points, click submit.
      1. The results from the commonly used query should appear.
      2. The results from the saved query should appear.
      3. The results from the dataset should appear on the map.
      4. Map, table and advance search are all reset as if initially logging on.
      5. Map and table do not change. Criteria on advance search panel are removed (as if initial time to Advanced Search).
      6. Attributes should change as specified.
      7. 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.

      1. The Near Me function should display a marker near your location.
      2. 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. When the phone is 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 will display.

      The menu bar holds functions for Columns, Exportation, Graph, Heat Map, Tile Map and Refreshing. The columns in the table grid are interchangeable; allows the user to add or remove columns suitable to the end user preference.

      The export function is a drop down format that gives you the option to export the data from the table into csv, pdf or excel format.

      The graph icon allows the user to place the data into a graph based off the query data-set results.

      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
      1. Click on one of the Rows. Click on another Row.
      2. Save query with special characters. Maximize the number of characters.
      3. Save the query with a new name but have the new query name the same as the original query name.
      4. Set multiple color attributes and save query, Clear Data and rerun the save query.
      1. Selected column from the table should highlight on the map. Data bubble should open. On the second click, the first data bubble should close and new one will open.
      2. Saved queries have a maximum character length of over 230 characters. Please be advised when saving a query to create a query name of reasonable length to maintain the appearance of the editing functions in the manage queries panel.
      3. Should get error message within a textbox “A query with name 'Happy Tweets' already exists. This will overwrite the existing query. Continue?”
      4. 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 Manage Queries Panel. When this option is selected, a list of the user’s Saved Queries are 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 Manage Queries Panel. 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/or save it as a query under a different name.

      Precondition: Valid login to OpenGrid.

      Execution Steps Expected Result Actual Result Comments
      1. Click the icon on the right; Then click on Advanced Search.
      2. Create a query,name and save it.
        (Note: Please create a query name of reasonable length to maintain the appearance of the editing functions in the manage queries panel.)
      • 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.
      1. 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.
      2. Click on Manage Queries.
      3. Select from the list of saved queries.
      4. Click on the Search link to return back to Advanced Search options.
      5. Modify color on dataset tab by selecting a color preference; click submit.
      6. Save modified color in dataset, click save.
      1. Advanced Search panel displays.
      2. Should display message "Success: Query was saved successfully."
      3. Validate new saved query displays.
      4. New page should display all of your saved queries.
      5. Saved query should be clickable.
      6. Query should load; query should display in the "Load Save Query" section.
      7. New color should be displayed on the map.
      8. New color should be saved and results of saved query (new color) should display on the 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”
      1. Should navigate to Manage Users tab

      Select “New user”

      1. New Users text box consist of:
      • User ID
      • First Name
      • Last Name
      • Groups (Name of Group)
      1. Enter a User ID, Password, First and Last Name
      2. Click on the submit button
      1. New User textbox appears
      2. If ID already exists in the database, a message “user id already exists” should appear upon submission. If not, continue to save the id.
      3. Data should be retained in the new user text box.
      4. 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

      1. Select from dropdown list. Select each separately and all of them on different user ids and test functionality by logging on as each user.
      1. 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 xxx dataset. This occurs for both quick search and advance search 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.

      1. Click on the small square icon.
      2. Create any updates to the User:
      • Update Password
      • Update First and Last Name
      1. Click OK
      1. The Update Item text box appears

      2. The updated information should replace the old data.
      • The User ID is not be editable.
      • The Password, First and Last Name are editable.
      1. The changes should appear in the columns where updates were submitted.

      Delete a User

      1. Click on the circle with the (x) in the middle on the first left column before the User ID column.
      • Click Cancel
      • Click OK
      1. 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”
      1. 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:

      1. Select the green new group button.

        Create a GroupID

        • Enter Name
        • Description of new group
        • AdminGroup
        • Enabled
      2. Click the Submit button.
      1. New Group textbox appears.

      2. 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 the application functionality (i.e. Quick Search, Advanced Search).

      Data Types column consist of datasets within the application (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.

      1. Scroll to either the functions or data types column.
      2. Click on the dropdown arrow in either the functions or data types column.
      3. Select a function and/or data type/s applicable to the group. (Note: In order to add a group you must have admin rights.)
      1. Scroll makes either the function column or data types column visible.
      2. Drop box appears with selection options. (Note: A group can have more than one function or datatypes.)
      3. 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.

      1. Click on the small square icon.
      2. To create any updates to a group:
      • Group ID
      • Update Name
      • Update Description
      • Remove or add Admin Group
      • Remove or add Enabled function
      1. Click the Submit button.
      1. The Update Item text box appears.
      2. The updated information should replace the old data.
      • The ID should not be editable.
      • The Name and Description can be updated.
      1. The changes should appear in the group details columns after the updates are submitted.

      Delete a Group

      1. Click on the circle with the (x) icon on the left of the Group Details column.
      • Click cancel
      • Click OK
      1. 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.

      Back to top

      Weekly meeting notes

      Roadmap proposals

      Scope and Planning

      Clone this wiki locally