Screening widget

(Added at v2.5)

The Screening widget allows you to define an area of interest and analyze specified layers for potential impacts. The area of interest can be defined through a place name search, by drawing on the map, by uploading a shapefile, or by entering a traverse with coordinate and distance pairs. Analysis results can be inspected in the widget and, optionally, shared via a printed report, CSV file download, or feature download.

For examples of how to use this widget for your needs, please see Environmental Screening.

Configure the Screening 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.

  1. Hover over the widget and select Configure this widget button Configure this widget to open the configuration properties dialog box.
  2. Optionally click Change widget icon and replace the icon with your own image.

    A file explorer window appears, allowing you to select a local image file to use as the widget icon.

  3. Click Add Layer.
    Each added layer specifies a feature layer in the map to be analyzed by the widget. The Screening widget supports the following layer types:
    • Feature services
    • Map services
    • Analysis Tab
  4. On the Analysis tab, optionally add a label for each layer.
  5. Click the edit button Edit under Actions to select the fields for the analysis results.
  6. Under Actions, optionally change the order of layers or delete a layer.
  7. Choose which tools will be available to define the area of interest under AOI Tools and update the label.
  8. Optionally enable Allow uploading shapefiles to analysis.

    With this option, users will be able to optionally add an additional layer for analysis in the widget.

  9. Optionally, enable Do not analyze or report results for layers that are not visible.

    With this option, layers that are not visible, due to being turned off or are off because of scale visibility settings, will not be analyzed when the Report button is clicked. When layers are not analyzed because of layer visibility, they also will not be included in printed reports.

  10. For Show areas/lengths in, specify the default units in which areas and lengths will be shown by choosing one of the options.
  11. Specify Max features for analysis. This parameter limits the maximum number of features returned from the configured layers and used for analysis.
  12. Specify the Search tolerance in feet or meters depending on the default analysis results units.

    The search tolerance will be used to select features when the area of interest is a point or line shape.

  13. Click the Download tab, and under Download Settings, choose one of the following options:
    • Feature Layers—Choose the layers you want downloaded. This option supports CSV file and, when the layer is a feature service with sync enabled, file geodatabase downloads.
    • Extract Data Task—All layers are enabled for CSV file download, and feature data can be downloaded as file geodatabases or shapefiles with the Extract Data Task geoprocessing service.
    • Disable download—No data download is enabled with this option.
  14. Under Report Settings, do any or all of the following:
    • Update Print Service URL to use an alternate print service with the Export Web Map task enabled.
    • Use the Logo option to change the logo by clicking the image.

      A file explorer window appears, allowing you to select a local image file to use as the logo.

    • Change the default Report Title text.
    • Change the Color for column titles option. This color will be displayed as the background for column titles in the printed report.
    • Enter text in the Footnote text box that will be displayed as a footnote on the printed report.
  15. Check the General tab. Update the labels used in the widget for the Area of Interest and Report panels.
  16. Update the default buffer settings for the widget.
  17. Change the symbology used to depict the buffer in the map.
  18. Change the symbology used to depict the point, line, or polygon areas of interest in the map.
  19. Check the Search Source Settings tab. To configure the Search Source Settings section, see Configuring the Search widget. It follows the same configuration steps as the Screening widget.

Use the Screening widget

  1. Click the Screening widget icon to open it.

    The widget displays on the right side of the map.

    Screening widget icon

  2. Define an area of interest with one of the provided tools.
    • Placename—Search for a location in the map, and optionally apply a buffer.
    • Draw—Draw a point, line, or polygon on the map or select a feature from the map, and optionally apply a buffer. Use the Choose selectable layer list to define which layers are selectable in the map.

      Draw tab

    • Shapefile—Upload a zipped shapefile, and optionally apply a buffer.
    • Coordinates—Identify a starting point for a traverse by searching the map, entering a coordinate pair, or drawing a point on the map. Enter bearing and distance pairs to define the traverse.

      Enter coordinates

  3. Define a buffer.
  4. Click Start Over to remove the defined area of interest and create a new one.
  5. Click Report to analyze the configured layers within the area of interest.

    Analysis results are presented in the panel. Layers with data intersecting the area of interest report a total feature count, and results are presented by grouping unique attribute combinations with the following information:

    • Area of overlap when the area of interest is a polygon
    • Length of overlap when the area of interest is a polygon

    The areas and lengths are calculated by performing a clip analysis on the intersecting geometries in the coordinate system of the web map. If the underlying map or feature service has a spatial reference other than the web map's, the transformation of the data is handled by the service. If the web map is using the Web Mercator coordinate system, all geometry operations are performed using geodesic lengths and areas; otherwise planar lengths and areas are used.

Explore the results

  1. Expand the result details by clicking a layer. The layer details expand:

    Results of a layer

  2. Click the settings button to choose which fields are presented with the results.

    When all fields are disabled, the layer will be hidden in the printed report.

    Determine which fields are presented with results

  3. Optionally add an additional layer for analysis by clicking the Upload button.

    A file explorer window appears, allowing you to select a local zipped shapefile.

  4. Optionally change the units of the analysis results by clicking the Choose units for analysis button.

    A window will open allowing you to choose the length and area units for analysis results.

  5. Optionally refresh the analysis results for the current area of interest by clicking the Refresh report button.
  6. Download feature information in CSV file, file geodatabase, or shapefile format by clicking the Download button and choosing a format.
  7. Print a report of the analysis results by clicking the Print button and choosing a page size and orientation.

    A new window appears. Change the report title or comments.