Tool Behavior

The Tool Behavior page in Manager contains settings that define how the Identify, Buffer and Measurement Tools operate in each interface type of the HTML5 Viewer. In addition to controlling which layers are affected by the Identify tool, you can set the projection ID and default units to use for buffering and measuring distances and areas. It is also possible to set the type of calculation to use for measurement, and select whether or not to add the markup to the map automatically, or to enable prediction.

For information about configuring the toolbar for a viewer, see Toolbar.

Open the Tool Behavior Page

To open the Tool Behavior page for the HTML5 viewer in Manager:

In Geocortex Essentials Manager, edit the viewer that you want to configure—edit the site that the viewer belongs to, click Viewers in the side panel, and then click the Edit icon beside the viewer.
In the side panel, click Tool Behavior.

Identify Tool Settings

The Identify tool has the following behavior settings:

Pixel Tolerance: The maximum number of pixels away from a feature the user can click with a point-based Identify tool in order to identify the feature. The default is 5.

This does not apply to polygon-based identify operations, which can be manually modified via the polygonPixelTolerance property in the configuration file.
Visible Layers Only: To only include layers marked as visible in identify operations, select this checkbox. By default, this checkbox is selected.
Layers in Visible Scale Range Only: To only include layers within the visible scale range in identify operations, select this checkbox. By default, this checkbox is selected.

Buffer Tool Settings

The buffer tool performs geodesic buffering.

Buffering requires a geometry service from ArcGIS Server 10.3 or newer, including ArcGIS Enterprise 10.5.

The Buffer tool has the following behavior settings:

Projection WKID: Add the well-known ID (WKID) of the projection to use, or leave the field blank to disable projection. By default, projection is disabled.
Buffer Units: Select the distance units to be available for buffering. Possible values include: Feet (ft), Yards (yd), Meters (m), Kilometers (km), Miles (mi), and Nautical Miles (NM). By default, all units are selected except for Yards (yd).
Default Unit: Select the default unit of distance to use for buffering. The default is Kilometers (km).
Add as Drawing by Default: If this checkbox is selected, any buffering is added to the map as markup by default.

Measurement Tool Settings

The Measurement tool has the following behavior settings:

Projection WKID: Add the WKID of projection for the Measurement module to use, or leave the field blank to disable projection. By default, projection is disabled. This setting only applies if the Calculation Type is set to Planar.
Default Length Unit: Select the default unit of measurement to use for length. Possible values include Feet (ft), Yards (yd), Meters (m), Kilometers (km), Miles (mi), and Nautical Miles (NM).
Default Area Unit: Select the default unit of measurement to use for area. Possible values include Feet2 (ft2), Yard2 (yd2), Meter2 (m2), Kilometer2 (km2), Mile2 (mi2), Nautical Mile2 (NM2), Acres (ac), and Hectares (ha).
Calculation Type: Select the calculation type to use when calculating measurements.

Geodesic measurement requires a geometry service from ArcGIS Server 10.3 or newer, including ArcGIS Enterprise 10.5.
- Planar: Use Planar if you want to specify a particular WKID and you want to ensure that this projection is used no matter where in the world the measurements are taken. Planar strictly enforces a particular WKID. If you enter the incorrect WKID for a particular area, you can get inaccurate measurements. Planar measurements use 2D Cartesian mathematics to calculate area and length.
  
  If you select the Planar calculation type and do not specify a Projection WKID, no projection takes place and measurements are computed in the default spatial reference of the site.
  
  Essentials only allows a Projection WKID to be selected for the Planar calculation type. A Projection WKID is not required for the Geodesic or Preserve Shape calculation types.
- Geodesic: Use Geodesic if you intend to measure very long distances that require accounting for the curvature of the earth. The Geodesic calculation type computes distances, areas and perimeters using only the vertices of the polygon to define the lines connecting the vertices as geodesic segments, independently of the actual shape of the polygon. A geodesic segment is the shortest path between two points on an ellipsoid. The results, when you use a geodesic calculation type, are independent of the input spatial reference.
- Preserve Shape: Use Preserve Shape if you are unsure about which calculation type to use, as it will provide the most accurate results for most users. This calculation type computes distances, areas and perimeters on the surface of the Earth ellipsoid, while preserving the shape of the geometry in its coordinate system. This means that the true area and length will be calculated for the geometry that is displayed on the map. This is the default calculation type.
Add as Drawing: Defines whether or not markup is added to the map by default. The default is true.
Prediction Enabled: Defines whether or not the current segment length, total segment length, perimeter, and area are predicted when the cursor hovers over the map for one second. When set to false, it disables predictive measurements. The default value is true. Prediction makes it possible to see approximately what measurements you would get if you clicked to plot a vertex at a given point.