Traffic Light Map Widget

<< Click to Display Table of Contents >>

Traffic Light Map Widget

The Traffic Light Map widget displays good/bad summary data from a report. This widget shows report data as four states: Alert (Ent-Traffic_Light_Widget_Alert-Icon), Warning (Ent-Traffic_Light_Widget_Warning_Icon), OK (Ent-Traffic_Light_Widget_OK_Icon), and Unknown (Ent-Traffic_Light_Widget_Unknown_Icon). This widget is normally used for analyte exceedances, but can be used for any other type of data by configuring the conditions for each of the breaks.



The Traffic Light Map widget has the following functions in the user interface that can be set within the User Interface tab in the widget properties:

Zoom In and Zoom Out – Although the default view extents for the map can be set, the user can always change how much of the map is displayed. Click either the Zoom In (Ent-Map_Zoom_In-Icon) or Zoom Out (Ent-Map_Zoom_Out-Icon) buttons to view the page as needed. These buttons are located on the top-left of the widget. Users can also zoom in and out by using the scroll button on the mouse.

Fullscreen – Click the Enter Fullscreen Ent-Map_Widget_Full_Screen_Button button to expand the map to the extent of the user's screen. Selecting the button again, hitting escape on the keyboard, or hitting F11 on the keyboard will return the map to the original size of the widget.

Basemap Gallery – A variety of map types are available within Enterprise. Select the Basemap Gallery Ent-Map_Widget_Basemap_Gallery_Button button to open the drop-down selection of map types. The current options are ArcGIS defaults types. Click on the CollapseEnt-Map_Collapse_icon2 icon to close the drop-down menu. The default basemaps are stored in the ST_CONFIG table. Acceptable entries for the default basemaps are as follows:

Basemap Gallery Name

ST_CONFIG Table Entry



Imagery with Labels






Dark Gray Canvas


Light Gray Canvas


National Geographic


Terrain with Labels






USA Topo Maps


USGS National Map


Legend – When a layer is added to the map, the Expand LegendEnt-Map_Widget_Legend_Button button can be selected to view a drop-down list of map symbols. Click on the CollapseEnt-Map_Collapse_icon2 icon to close the drop-down menu.



Widget Properties


The Traffic Light Map widget is empty when added to a dashboard and must be configured to show report results. The editor for this widget allows the user to select a report, and then configure the widget appearance. To add data (select a report) or change properties of this widget, open the Widget Editor by selecting the More Options Ent-More_Options-Icon icon in the upper right corner of the widget to display the drop-down menu and then select the Edit menu option. The widget properties are divided into three tabs: General, Extents, and User Interface.




General Tab


The properties for this widget are the same as those in the Traffic Light widget, with the following exceptions:

Tooltip Template – Sets the template for the tooltip, which is shown when a user clicks on an icon. The template can make use of the report columns in the following way: ${SYS_LOC_CODE}: ${REPORT_RESULT_VALUE}, or ${SYS_LOC_CODE}-${REPORT_RESULT_VALUE}. The column name must be enclosed in { }.



Additional formatting options are available in the ArcGIS API for JavaScript. For example, the user could format a date column as follows:




Extents Tab

This tab sets the default extent for the widget. The options are:

Application Default – Refers to the value set in ST_CONFIG.

Selected Report – Refers to the calculated extent of the report used in the widget.

Custom Extent – JSON string defining an extent object. Example: { "xmin": -81.435, "ymin": 39.3, "xmax": -77.0, "ymax": 41.7, "spatialReference": { "wkid": 4326 } }.



User Interface Tab

This tab lets the user customize the visibility and location for the display of the legend, basemap gallery, and fullscreen mode.