Web AppBuilder for ArcGIS (Developer Edition)

Situation Awareness widget

(Added at v1.3)

The Situation Awareness widget allows you to specify a location on a map and analyze information from feature layers within the specified area.

Configure the Situation Awareness widget

This widget can be set to open automatically when an app starts. To enable this feature, click the Open this widget automatically when the app starts button Open this widget automatically when the app starts on the widget, which turns it dark green.

Note:
Feature collections (such as CSV files, shapefiles, and map notes that can be added as feature collections) are not supported in this version of the widget.

  1. Hover over the widget and click the Configure this widget button Configure this widget to open the configuration properties dialog box.
  2. Optionally click the Change widget icon button and replace the icon with an image of your own.
    A file explorer window appears, allowing you to choose a local image file to use as the widget icon.
  3. On the Analysis tab, click Add Tab.

    Each tab allows you to specify a feature layer in the map, as well as the type of analysis, using one of the following options:

    • Summary—A summary of numeric fields from the selected layer
    • Proximity—A list of features from the layer that are within the specified area
    • Closest Feature—The closest feature to the location
    • Grouped Counts—A count of features within the specified area, grouped by a specified field
      Note:

      If you choose the Grouped Counts option, Group By Field is required. Click the Edit button under Actions to define Group By Field.

  4. Optionally specify a label for each tab.
  5. Click the Edit button under Actions to specify the fields to include in the analysis in the Select Fields window.
  6. Optionally check Display feature count to add a count to each tab in the panel.
    Feature count
  7. Optionally change the order of the tabs or delete a tab under Actions.
  8. Specify the following options in the General Settings section of the configuration window:
    • Tab label—A label for the tab in the widget.
    • Area of interest label—A label for the area under the tab.
      Labels for the tab area
    • Buffer label—An optional label for the buffer distance.
    • Minimum buffer distance—The minimum distance allowed to buffer.
    • Default buffer distance—The buffer distance set by default.
    • Maximum buffer distance—The maximum distance allowed to buffer.
    • Closest feature maximum distance—The maximum distance to use when searching for the closest feature.
    • Enable routing—Enable routing from the location to the feature. The Directions widget is also required to generate routes.
    • Disable layer visibility management—Avoid automated control of layer visibility for the layers used by the widget. When this option is enabled, the layer visibility will not be altered when the widget is turned on.
    • Display summary features—Display the map features for a tab that uses a summary analysis.
    • Distance units—The units used for proximity and closest feature analyses, as well as when providing a buffer distance for analysis.
  9. Note:

    The weather option is no longer available in the Situation Awareness widget.

  10. Choose the data output settings and report settings on the Output tab.

    • Under Data Output Settings, check the Enable Save check box to allow the addition or deletion of features from the feature service. Check Save points, Save lines, or Save polygons, and specify the layer for the selected type.
      Note:

      The feature service must be editable for this option to function.

    • The Enable snapshot option allows the creation of a snapshot of the situation at a specific moment in time. This behavior requires specific permissions as shown in the following screen capture:
      Snapshot permissions
    • The Export all fields option, which includes all fields in the layer when exporting to a CSV file, is checked by default. To only include the fields configured in the Select Fields window for summary, grouped counts, or proximity analyses, uncheck this check box.
    • Under Report Settings, check the Enable report check box to create a report of the map and summarized information from the configured tabs. Optionally click the image button to specify a logo image for the report. You can also provide text to be displayed in the footnote of the report, or choose a color for the column headers. The printed report will contain a map and a series of tables displaying the analysis results. Fields that are visible in the layer’s pop-up are the fields reflected in the detailed information table for each tab.

Use the Situation Awareness widget

  1. Click the Situation Awareness widget button to open it. The widget displays at the bottom of the map.

    When the widget opens, visibility is turned off for all map layers that have been configured as source layers for the widget unless Disable layer visibility management was enabled. The layers become visible when used by the widget. When the widget is turned off, layer visibility returns to its original state.

    Display information about an incident

    The Incident tab is selected by default.

  2. Define a location in one of the following ways:
    • Click an existing feature to show its pop-up. Then click the more information button to see a list of feature actions, and choose Set Location.

      Set Location

    • Use the drawing tools on the widget's Incident tab to create a location to analyze.

      Buffer Distance

      Optionally specify a buffer distance to the location.

      • To download the summarized information, click the Download all button Download all.
      • To save the location to the feature service, click Save Save.
      • To create a snapshot of the location and analyzed information, click the Create snapshot button Create snapshot.
      • To create a report of the location and analyzed information, click the Create report button Report.
    • To see map features in the generated report, use the Disable layer visibility management configuration setting and enable or disable appropriate layer visibility using other widgets such as the Layer List widget before generating the report.
  3. Click the individual Layer tabs to view the analyzed information for specified layers. You can scroll the widget panel horizontally to view additional results.
    • Optionally click Download Download to download analyzed data as a CSV file.
    • Optionally, if routing is enabled and the Directions widget has been added to the app's header controller, click the Directions button Directions button to get directions from the incident to the feature. For line and polygon incidents, specify an appropriate starting point directly in the Directions widget.
      Note:

      The directions button can be found in the tab of the widget.

    • To clear the active location, click the Start Over button.
  4. Click the close button in the upper right corner of the widget.