The Map Policy determines options for configuring the Map Interface.

Property Name Description
Projections Coordinate Reference Systems to use (such as EPSG-3857) when displaying a map (see https://en.wikipedia.org/wiki/Map_projection).

Available Projections must be defined as a Reference Value in the "Projection" Reference Type. You can define two types of Projections: Alias (define a Projection using another name) or Conversion (define a conversion string to convert one reference system to another).

Different Projections provide different accuracy in different regions. Projections defined with conversion strings lets LabVantage know how to convert between the different Projections.

Property NameDescription
ProjectionProjection to be configured ("Projection" Reference Type).
Number of DecimalsNumber of Decimals used to define the Coordinates. This defines the accuracy of the coordinates (such as when selecting a point on the map).
TypeWhether the Projection is an Alias or a Conversion.
Property NameDescription
AliasThe Projection is configured as an Alias of another Projection.

For example, EPSG:3067 is also known as ETRS-TM35FIN (Alias). Add "ETRS-TM35FIN" as a Reference Type, then also add it as a Projection (ETRS-TM35FIN), then define it as an "Alias Of" EPSG:3067.

Define the Alias in the "Alias Of" field below.

ConversionThe Projection converts point coordinates from one coordinate system to another.

For example, to support the coordinate system EPSG:3067 first add "EPSG:3067" as a Reference type, then also add it as a Projection (EPSG:3067), then define the Conversion string.

The EPSG:3067 conversion string is:

+proj=utm +zone=35 +ellps=GRS80 +units=m +no_defs

Define the conversion string in the "Conversion" field below.

Alias OfThe Projection (Reference Type) for which you want to define the Alias.
ConversionThe Conversion string.
Sources The source of the Map.

"Open Street Maps" is provided OOB. "Bing Maps" are configured, but disabled (Visit https://www.microsoft.com/maps/Licensing/options.aspx or https://msdn.microsoft.com/en-us/library/ff701702.aspx to learn about obtaining a Bing Maps REST Service API for the Imagery API). Optionally define maps using a Web Map Tile Service (WMTS).

These properties configure the maps based on the source.

Property NameDescription
SourceDefine map properties by source.
Property NameDescription
IdIdentifies a map configuration based on the source.
TypeThe source (such as Open Street Maps or Bing Maps).
WMTS PropertiesProperties for defining a Web Map Tile Service.
Property NameDescription
URL to Capabilities.xmlThe URL to the WMTS definition capabilities.xml which defines the layers.
Replace string propertiesIt is possible to replace strings in the URL to the capabilities.xml, such as pointing out to a proxied server.
Property NameDescription
FromOriginal String.
ToString to replace.
Bing OptionsWhen using Bing Maps as the source enter the API key.
Open Street MapsProperties for Open Street Maps.
Property NameDescription
OpaqueWhether or not the layer is Opaque. The default is true.
Max ZoomThe maximum zoom. The default is 19.
Custom URL templateThe URL template. Must include {x}, {y} or {-y}, and {z} placeholders. The default is https://{a-c}.tile.openstreetmap.org/{z}/{x}/{y}.png
LayersEach map provider can provide multiple layers. For example, Bing Maps supports different Imagery Sets which can be configured as different layers (such as Streets, Satellite).

Define layer properties based on provider (source).

Property NameDescription
titleSource for which properties are defined.
ActiveWhether or not Layers are active.
OpacityThe opacity of the layer, defined by a number between 0 (not visible) and 1.
Imagery Set for BING mapsChoose the Imagery Set to use when displaying Bing Maps. Choose:
Property Name
Aerial
Aerial with Labels
Road
WMS SourceDefine the source for a WMS (Web Mapping Service). For more information, see http://openlayers.org/en/latest/apidoc/ol.source.TileWMS.html
Property NameDescription
UrlSpecify the WMS URL.
AttributionsAttributions test shown in the map.
Cache SizeCache size. The default is 2048.
Cross OriginThe Cross Origin attribute for loaded images.
ProjectionProjection used.
Serve TypeThe type of remote WMS server. Currently only used when hidpi is true. The default is undefined.
Wrap XWhether or not to wrap the world horizontally. When set to "False", only one world will be rendered.
Parameters

WMS request parameters.

Root Properties
KeyKey for parameter.
ValueValue for parameter.
ViewProperties that determine how the Map displays when loaded.
Property NameDescription
Auto Zoom on loadWhether or not to zoom the view to all points when the map loads.
Base ProjectionThe Projection on the map on which conversions are based.
Minimum ZoomThe minimum zoom level used to determine the resolution constraint. The default is 0.
Maximum ZoomThe maximum zoom level used to determine the resolution constraint. The default is 28.
RotationThe initial rotation for the view in radians (positive rotation clockwise) The default is 0.
Zoom FactorThe zoom factor used to determine the resolution constraint. The default is 2.
Default Zoom levelZoom level used to calculate the initial resolution for the view.
CenterThe initial center for the view. The coordinate system for the center is specified with the projection option.
ResolutionsResolutions to determine the resolution constraint.
Geolocate ModeWhether or not Geolocation is available:
Property NameDescription
EnabledGeolocation is always available.
DisabledGeolocation is never available.
AutomaticIs available and turned on or off using an icon displayed in the Map.

In this mode the geolocation is disabled when using Google Chrome and when the connection is not secure. This is due to Chrome not supporting geolocation on nonsecure connections.

Default icon sizeIcon size for Icons coming from LabVantage Image Library.
Pins Pin style properties. To define a new Pin style you must first add the Pin style as a Reference Value in the "Pinstyle" Reference Type.
Property NameDescription
Pin stylesConfigure different pin styles as Map Markers. Different pin styles can represent the status of a particular column (such as Specification, Failure). Define properties for each Pin style Reference Type.
Property NameDescription
IdThe "Pinstyle" Reference Type you want to configure.
titletitle to display in the map legend (Specification).
EnabledWhether or not this pin style is enabled.
Column IdThe specific Column id represented by the pin. The column is one either already configured on the List Element or added using the Extra Column configuration (below).
Default IconDefines a default pin style.

If no value is defined in the Column Id the Default Icon displays.

The Default Icon also displays if there is no Column Value match in the Icons collection (below).

Property NameDescription
title in Legendtitle to display in the map legend.
Default IconIcon to display as the default marker.
Default Selected IconIcon to display when the pin is selected.
OpacityOpacity of the icon. Default is 1. Values between 0 and 1.
Anchor X positionThe X-position for the anchor point. This value is in the units defined in the setting "Anchor X units". Defaults to the center of the icon.
Anchor X unitsUnits in which the anchor x value is specified. A value of "Fraction" indicates the x value is a fraction of the icon. A value of "Pixels" indicates the x value in pixels. The default is "Fraction".
Anchor Y positionThe Y-position for the anchor point. This value is In the units defined in the setting "Anchor Y units". Defaults to center of icon.
Anchor Y unitsUnits in which the anchor y value is specified. A value of "Fraction" indicates the y value is a fraction of the icon. A value of "Pixel"' indicates the y value in pixels. The default is "Fraction".
Anchor Origin Origin of the anchor: bottom-left, bottom-right, top-left or top-right. The default is top-left.
IconsDefine properties for configured pins.

Configuring pins based on a Column Value allows LabVantage to match a Column Value (failed spec) with a specific pin Icon (red).

Property NameDescription
Column ValueColumn value associated with this Icon (failed, pass).
title in Legendtitle to display in the map legend.
IconIcon to display as the pin.
Selected IconIcon to display when the pin is selected.
OpacityOpacity of the icon. Default is 1. Values between 0 and 1.
Anchor X positionThe X-position for the anchor point. In the units defined in the setting "Anchor X units". Defaults to the center of the icon.
Anchor X unitsUnits in which the anchor x value is specified. A value of "Fraction" indicates the x value is a fraction of the icon. A value of "Pixels" indicates the x value in pixels. The default is "Fraction".
Anchor Y positionThe Y-position for the anchor point. In the units defined in the setting "Anchor Y units". Defaults to center of icon.
Anchor Y unitsUnits in which the anchor y value is specified. A value of "Fraction" indicates the y value is a fraction of the icon. A value of "Pixel"' indicates the y value in pixels. The default is "Fraction".
Anchor Origin Origin of the anchor: bottom-left, bottom-right, top-left or top-right. The default is top-left.
Extra Columns Additional columns to be represented by a pin style. Extra Columns must first be defined as a Reference Value in the "MapExtraColumns" Reference Type. Configure the Extra Columns you would like to represent with a Pin style.

To determine which pin style to display, the system will fetch one SDI (via a reverse foreign key relationship) by doing a query to the database for every main SDI. The default configuration includes fetching the latest collected Sample for every Sample Point. This enables LabVantage to show the pin style for each Sample Point based on the latest Sample taken from that Sample Point.

Property NameDescription
IdUnique identifier for the "Extra Column" you want to represent with a Pin style.
Primary SDCThe Primary SDC with which the Extra Column is associated. For example, if you want a Pin style to represent Sample Points, containing Samples with Failed Specifications, "Sample Point" is defined as the Primary SDC and "Sample" is defined as the Extra Column SDC (below).
Extra Column SDCThe SDC with which the Extra Column is associated.
Link IdThe foreign key link id in SDC Link.
Restrictive WhereThe restrictive where can be used to limit SDIs to be fetched. For example, limit to samples that have been collected.
Order ByThe order by columns that define which SDI is selected.
ColumnsColumns to display when the Pin is clicked (or on hover).
Property NameDescription
IdentifierUnique identifier for this item.
ColumnThe Column to display.
titleText displayed on the column header.
ModeWhether or not the column is displayed.
TipTooltip for the column value. This supports value substitution.
WidthWidth of the column in pixels.
AlignmentHorizontal position within the SDI list column (left, middle, or right).
Return ValueUse this only if you are using this page as a Lookup Page. A value of Yes returns the key value of the selected column. For example, when you choose a Sample on a Lookup Page, this would return the keyid1 (sampleid).
LinkIf you are using this page as an SDI List Page and want items in the column to be hyperlinks, specify these values:
Property NameDescription
Toolbar Button Id This enables the hyperlink to provide the option to edit by linking the hyperlink to the specified toolbar button. When set, this enables editing using the toolbar button rather than the link. This allows the hyperlink to inherit all aspects of the referenced toolbar button. If the button is hidden for security reasons, the hyperlink is not functional. This allows the OOB setting for all view KeyId hyperlinks to reference the Edit button rather than the popup View button. Use of the Edit button is more functional then simply viewing a readonly page. If the button uses Departmental Security and the security check fails, editing defaults to the hyperlink.
HRefDestination of the link, specified as a call to the Request Controller. For syntax rules and guidelines, see Request Controller and Variables.
Target Name of the window in which the linked page opens. You can enter any name here, and the new window (browser instance) will automatically assume that name. If you do not specify a target, the linked page opens in the current window.
TipPopup text displayed on mouseover.
New Window WidthOverrides the default window width of 800px. If the target is _blank or view, this opens a new window.
New Window HeightOverrides the default window height of 600px. If the target is _blank or view, this opens a new window.
Open In Sapphire DialogOpens a LabVantage dialog rather than a browser window. If the target is _blank or view, this opens a new window.
Display ValueValues displayed in place of the corresponding retrieved values. Separate each with a semicolon. For example, if you retrieve values from the createby column, you could specify JDrake=JD. All values retrieved as JDrake would then be displayed as JD. This works only if you replace the entire retrieved string (it does not work on partial strings).
Pseudo ColumnA "pseudocolumn" is a column that is rendered on the page, but does not exist in the SDC. Do not choose a database columnid when specifying a pseudocolumn. If you want to access this pseudocolumn using a JavaScript function or another pseudocolumn, specify an identifier of your own choice.

This value you enter can be HTML or a Variable. For example:

If you enter an HTML image tag, then specify a link (using the Link URL property above), the image becomes a hyperlink.
If you use a variable, the variable must point to one of the columns defined by the Column Id property. In this case, you can hide the actual column so that only the pseudocolumn is displayed. For example, you could specify Date: [moddt] to display the date and time a Sample was last modified (such as Date: 8/1/2003 15:36:24), but only if you have previously chosen moddt as one of the columns to be rendered.
Date FormatThe format in which to display the date.
Translate ValueWhether or not to translate the value to the User's language.