Skip to content
Peter Girard edited this page Apr 29, 2017 · 11 revisions

The GPVSetting table contains instance-level settings for the GPV. Prior to version 5.0 these settings were in the <appSettings> section of the Web.config file. Each setting is a row in this table.

Columns

  • Setting - A unique identifier for this setting (not null).
  • Value - The value of this setting.
  • Required - Notes whether a value for this setting is required (yes or no).
  • Note - Explanatory note for this setting, such as units or valid values

Settings

Instance

  • AdminEmail - The email address of the GPV administrator. The Help page directs users to this address if they have questions regarding the configuration of the GPV.
  • AllowShowApps - Valid values are "yes" and "no". If set to "yes", the showapps function will be available in the GPV URL. Defaults to "no".
  • DefaultApplication - The application to start if none is specified in the GPV URL.

Map

  • FullExtent - A comma separated list of four numbers (left, bottom, right, top) defining the full extent for the GPV in MeasureProjection coordinates (see below). This extent sets the initial zoom level and is accessible via the Full View button.
  • ZoomLevels - The number of zoom levels to provide in the zooming controls on the map. Level 1 shows the entire world and each level is a 2x zoom in from the previous one.
  • ShowScaleBar - Valid values are "yes" and "no". If set to "yes", a one-inch scale bar, labeled in feet, will display at the lower-left corner of the map.
  • New at 5.0 MapProjection - A Proj4 string specifying the projection of map services accessed by this GPV instance. The default is the standard Web Mercator projection. If your map services are in Web Mercator this setting should be set to null.
  • New at 5.0 MeasureProjection - A Proj4 string specifying the projection to be used for coordinate display, calculating measurements, proximity distances, and the FullExtent setting (see above). If set to null, this will default to MapProjection.
  • MeasureUnits - The units that will be displayed by the measurement tools. Valid values are "feet", "meters" or "both".

Shift Compensation

ArcGIS Server's definition of Web Mercator varies slightly from Leaflet's, the mapping control used by the GPV. This can result in small but noticeable offsets between features on tiled basemaps compared to those from ArcGIS Server. Use these optional settings to compensate for such shifting. All shifts are specified in Web Mercator meters. These settings are not intended for use in other map projections.

  • DynamicMapImageShiftX, DynamicMapImageShiftY - Shifts dynamic map images returned from ArcGIS Server relative to tiled basemaps.
  • MarkupShiftX, MarkupShiftY - Shifts markup relative to tiled basemaps. Note that markup from previous versions converted by UpdateMarkup.ashx will have this shift applied. See Transition to Tiles in Version 5.0 for details on markup conversion.
  • SelectionShiftX, SelectionShiftY - Shifts selection highlights relative to tiled basemaps.

Selection Symbology

Color values are specified as HTML colors. Opacity is specified as a real number from zero to one where zero is completely transparent and one is completely opaque.

  • ActiveColor - The color used to highlight the single feature for which detailed data is displayed in the Data Tab panel. This color also highlights the one selected row in the data grid.
  • ActiveOpacity - The opacity of the active feature.
  • ActivePolygonMode - The method for drawing active polygons. Valid values are "fill" or "outline".
  • ActivePenWidth - The width in pixels for active linear features.
  • ActiveDotSize - The size of the circle, in pixels, for active point features.
  • TargetColor - The color used to highlight target features. This color is also the background of the Pick Target Features tool.
  • TargetOpacity - The opacity of target features.
  • TargetPolygonMode - The method for drawing target polygons. Valid values are "fill" or "outline".
  • TargetPenWidth - The width in pixels for target linear features.
  • TargetDotSize - The size of the circle, in pixels, for target point features.
  • SelectionColor - The color used to highlight selection features. This color is also the background of the Pick Selection Features tool.
  • SelectionOpacity - The opacity of selection features.
  • SelectionPolygonMode - The method for drawing selection polygons. Valid values are "fill" or "outline".
  • SelectionPenWidth - The width in pixels for selection linear features.
  • SelectionDotSize - The size of the circle, in pixels, for selection point features.
  • FilteredColor - The color used to highlight target features that do not pass the criteria of the current query filter.
  • FilteredOpacity - The opacity of filtered features.
  • FilteredPolygonMode - The method for drawing filtered polygons. Valid values are "fill" or "outline".
  • FilteredPenWidth - The width in pixels for filtered linear features.
  • FilteredDotSize - The size of the circle, in pixels, for filtered point features.
  • BufferColor - The color used to fill the buffer generated around the selection features.
  • BufferOpacity - The opacity of the filled buffer.
  • BufferOutlineColor - The color of the buffer outline.
  • BufferOutlineOpacity - The opacity of the buffer outline.
  • BufferOutlinePenWidth - The thickness in pixels of the buffer outline.

Legend

All legend symbol swatches for all of the layers in a map service dataframe are compiled into a single image which is then referenced by the GPV interface. The swatch images are laid out on the compiled image in a grid with each layer as a column and each classification in a layer as a row. The swatch tile settings below specify the maximum width and height of the legend swatches. If your legend swatches appear truncated or show strange artifacts, set these values higher. Setting these values too high will create a compiled image with excessive white space, wasting bandwidth.

  • SwatchTileWidth - The maximum width of legend swatches in pixels.
  • SwatchTileHeight - The maximum height of legend swatches in pixels.
  • LegendExpanded - Valid value are "yes" and "no". If set to "yes", all legends are fully expanded when they first displayed. If set to "no", all legends are collapsed when first displayed showing only major groups and top-level layer names.

Functionality

  • ExportFormat - The format of spreadsheets generated from the Selection tab. Valid values are "csv" for comma-separated value text files and "xls" for Excel 2003 files.
  • PreserveOnActionChange - Either "target" or "selection". Defaults to "selection" if not present in the Web.config. Use "target" if you want the currently selected target features to be preserved when the action is changes (how it worked prior to version 4.0). Use "selection" if you want the target features to become selection features (and vice-versa) when you change the action.
  • New at 5.0 SearchAutoSelect - Valid value are "yes" and "no". If set to "yes", the Search command will automatically select and zoom to a feature if only one was found.

Customization

  • CustomStyleSheet - A URL pointing to a custom stylesheet containing styles for the header and footer on the viewer page. Can be left blank if no custom styling is required. See Stylesheet Customization. New at 5.0 Share panel fonts can be changed via the Customize.CSS

Timeouts

  • MarkupTimeout - The time, in days, that markup group will remain in the markups list since it was last viewed or edited. Markup groups that are not accessed for this many days are no longer accessible in the GPV but remain in the database.
  • ServerImageCacheTimeout - The time, in seconds, for the GPV to cache images acquired from ArcGIS Server and ArcIMS. Cached images are used on map refreshes when the map tab and extent has not changed. Increasing this value improves the performance of the GPV on the browser at the expense of requiring more memory on the server. Reasonable values are between 30 and 180 seconds. Setting this to zero will force the GPV to get its image from the map server every time the map refreshes.
  • BrowserImageCacheTimeout - The time, in seconds, for the GPV to cache images destined for display on the browser. The GPV copies images from the map server cache, potentially highlights selected features on these images, and places these in the browser cache for the client-side code to access. Reasonable values are between 10 and 60 seconds. Setting this to less than 10 seconds could potentially cause the map not to update properly. Do not set this value to zero.

Changes

  • Removed at 5.0 MapUnits, Projection, Spheroid, CentralMeridian, OriginLatitude, StandardParallel1, StandardParallel2, ScaleFactor, FalseEasting, and FalseNorthing - Now specified with MapProjection and MeasureProjection.
Clone this wiki locally