1. Home
  2. TC1.1 - The main entry of the Snap4City service

TC1.1 - The main entry of the Snap4City service

Test Case Title

TC1.1 - The main entry of the Snap4City service: www.snap4city.org

Goal

A user can:

Prerequisites

A snap4city user registered on the Snap4City portal. There is also a separate Test Case for users that register for the first time.

The following functionalities are available only for specific Snap4city users with specific privileges.

Expected successful result

An integrated suite of tools, at least for what we can have so far.

Steps

  

 

In the following the details of the various menu items for the Developer User (Area Manager) are explained, with a view of the various tools available in accordance to the different snap4City users’ privileges.

User experience

The snap4city portal is the home  entry of all tools of snap4city.

 

By using its credentials, the Snap4City User accesses to the snap4city application entry page that shows on the left column a set of menu items in according to the user privileges.

The user interface after the login presents a menu on the left and a frame that is updated in according to the menu item selected by the user, all integrated in the same interface.

The entry page is the Snap4City portal, as in the following image.

Three different user’s types are managed by Snap4city, each of them has different privileges and accesses to a different number of applications and functionalities via the left column menu.

 

The Final User (Manager) accesses to the following menu items.

 

In the case, of Developers (Area Manager), on the left column, the menu with the list of available tools and settings is available. The list is coherent with the User privileges.

The following image shows the Snap4City menu items and submenus for users with privileges as Developer.

 

 

The Developers (Area Manager), user has more privileges with respect the final user and access to the same menu items of the Final User and in addition to the following items:

The Root Admin user is the user with more privileges and has the access to all menu items and settings.

An intermediate role of ToolAdmin is also present, and the password have been provided to you.

With respect the Developer user, the RootAdmin has also access to the following menu items:

 

In the next a view of the major menu items are provided for the Developer profile.

Dashboards (view of the AreaManager, Developer)

The Dashboards menu item lists the available dashboards associated with the user. The dashboard list is shown in the form of previews. By clicking the preview, it is possible to see the dashboards in view. Below each preview, an Edit button is present according to the user privileges.

 

A full text search field on the top right of the page allows to simplify the search of a dashboard by inserting a term of search (like Title, author, etc.). On the top right the button to create a new dashboard is present [New dashboard]. By pressing the New dashboard button, a new wizard to create a dashboard is shown. The creation of a new dashboard has been completely restructured with the aim to simplify to the user the population of a dashboard with the different widgets available.

By clicking the New dashboard button on the top right of the Dashbaords view, the Dashboard Wizard is opened and the Developer User enters in a new interface that has been completely developed from scratch, allowing the user to populate its dashboard according to the available widgets and metrics. The Dashboard Wizard has been created for:

  • Supporting the users in understanding which graphical widget can be used to show each certain type of data or MicroApplication or event or service
  • Supporting the user in shortening the time in producing a dashboard and a widget into dashboard
  • Helping the users to monitor in a simple manner the status of data sources

 

The dashboard wizard presents:

  • A map on which the selected sources are shown if they have a GPS location among their attributes. Please note that generic view and KPI may not be associated to a location immediately
  • A list of graphics icon representing widget for showing data sources: maps, trends, gauge, kiviat, tables, semaphore, images, selector, histograms, switch, speed limit, bars, etc.
  • A list of data sources, from POI to sensors, from web applications to external services, from KPI to web app and special data as Twitter data, civil protection, triage of hospitals, etc.

In the Dashboard Wizard all kind of data sources (High Level Type) are listed and may be selected (from POI to sensors, from external services to micro applications, etc.). This allows the user to immediately identify which kind of graphical views/widgets can be applied for rendering the data selected and vice versa: if the user select the graphic view (by clicking and icon in the “Single Data Widgets” area or “Multi Data Widgets” area), the data to be visualized are automatically identified/filtered. Moreover, the user may select one or multiple data (lines) in the table. When multiple selections are performed, the production of a Dashboard or Wizard is possible only using suitable Multi-Data widgets.

 

Thanks to the Km4City Ontology, the data are visualized in a taxonomy with the following meaning:

  • High Level Type:
    • Complex Event: traffic event, entertainment, critical event, civil protection, etc.
    • External Service: a web page including a third-party services for the dashboard
    • From Dashboard to IOT App: a button sending a command to an IOT Application
    • From Dashboard to IOT Device: a button sending a command to a IOT device
    • From IOT App to Dashboard: a visual rendering of an IOT application data into the Dashboard
    • From IOT Device to Dashboard: a visual rendering of a IOT device (from some broker) into the Dashboard
    • KPI: key index of the city, some quality index, some percentage of work, total energy consumed, total amount of money, etc.
    • MicroApplications: they are web pages exposing micro functionalities that can be part of more complex applications such as: parking and parking prediction, view on events, view on hospital near to me, etc.
    • POI: Point of interest, each POI category includes a list of services in the city such as: restaurants, museum, benches, parking, etc.
    • Sensors: they are sensors coming from IOT Directory and thus from the IOT brokers, taken directly or via some ETL
    • Special Widgets: are special micro-widget for rendering data in special manner such as: civil protection alert, weather forecast, first aid triage status,
  • Nature, such as the classification on ServiceMap (https://servicemap.snap4city.org ):
    • Accommodation
    • Advertising
    • Agriculture and Livestock
    • Assistance
    • Civil and Edil Engineering
    • Cultural Activity
    • Education and Research
    • Emergency
    • Entertainment
    • Environment
    • Financial
    • Time
    • Generated on the dashboard
    • Generic
    • Get list from personal APP
    • Government and Security
    • Government Office
    • HealthCare
    • Industry and Manufacturing
    • Infrastructure: KPI of the Smart City
    • IOT Actuator: acting to the physical world
    • IOT Sensor: taking data from the physical world
    • Km4City Application: HTML5 application
    • Mining and Quarrying
    • Mobility and Transport
    • Services POI and IOT
    • Shopping
    • Shopping and Services
    • Social: twitter, people monitoring, etc.
    • Tourism
    • Utilities and Supply
    • Wholesale
    • Wine and Food
  • SubNature: which is a classification of more than 500 subcategories of the former Nature classification
  • Value Type, the type of the data such as: temperature, humidity, etc.
  • Value name: the identified and/or name of the instance of the IOT device, sensor, POI, etc.
  • Data Type: the technical type of the data such as integer, float, status, etc.
  • Last Date: the date and time of the last measure obtained, if any
  • Last Value: the value of the last measure obtained, if any
  • Healthiness: a green/red semaphore describing the healthiness of the Sensor
  • Last Check: date and time of the last check of the data source

The Notificator menu item on the left, allows accessing the Notificator tool integrated in the new interface.

The IOT Applications menu item, allows to access to the link of IOT applications associated to the Developer User.

By clicking an IOT application icon, the corresponding IOT application is opened integrated in the new interface.

IOT Directory and Devices

The IOT Directory and Devices menu item contains three submenus:

 

The Service Map menu item open the service map tool integrated in the new interface. This allow the Developer User to perform geographic queries, without opening new external services.

 

The same for the Service Map 3D menu item. It allows to compare the trend geographically and at the same time instant of data coming from different sensors.

The Micro Applications menu item, allows the Developer User to enter in a list of preview of available micro applications. These micro applications are pre-configured web apps that allow to access to several pre-defined services.

By clicking a micro application preview icon, the corresponding web app is opened in a integrated view.

The External Services menu item allow to access to a list of the available external tools.

Data Gate, integrated in the new user interface

Resource Manager: Process Loader integrated in the new user interface. The Process Loader tool user Interface has been completely renew and uniformed to the others. Resource Manager: Process Loader presents the following submenus:

  • View resources, to view public resources;

 

  • Resources, to public a resource and view/modify all the personal uploaded resources

 

  • Process Models, to View/modify the Process Models associated to their Resources;

 

  • Processes in Execution, View Processes in execution on the DISCES scheduler;

 

  • Process execution Archive, View the Processes Execution Archive

Development Tools

The Development Tools menu item opens a number of submenu to access to technical tools for developers, and in particular:

  • ETL Development, to access to the Data Processing Development Environment (VM) that can be used for developing Snap4City Applications, ETL processes, Data Analytics Processes. It is a personal or shared SandBox for Developers;

 

  • Source Code Access, page with links to the source code of the Snap4City tools

Management

The Management menu item open a number of submenu linking different dashboards for developers to monitor Snap4City resources.

  • Traffic Analyzer: AMMA, for monitoring and analysing communications aspects in real-time
  • Data Analyzer, DevDash, for accessing to data collected (by means of ETL and IOT processes) in an interactive and faceted manner
  • Back Office Resource Analyzer: ResDash, showing the real-time status and history of resources consumed in the cloud in terms of VM (Virtual Machines), Containers, Hosts
  • Smart City API Monitoring, dashboard with information and statistics about the use of Service Map API

  • Web Server Monitoring, dashboard to monitor the status of Web servers

Help and Contact

Allows the user to access to the following webpages:

  • Help Desk page, with contact information to ask assistance to Snap4City team
  • Contact us online form
  • FAQ web page

Documentation and Articles

Links to specific webpages documenting the different tools

My Profile

The My Profile menu allows the user to access to its personal information and to manage its data and applications.

  • Privacy Policy, link to web page with the privacy policy terms
  • Cookies Policy, link to web page with the cookies policy terms
  • Terms and Conditions, link to web page with the terms and conditions

Snap4City portal

Direct access to the home page of the portal integrated in the solution. It is the main entry page after the user login.

 

  • Share