Modify Web.config Settings

Change the URL in that line to reflect the machine you are using as your server:

<add key="AGSRoot" value="http://yourservername:6080/arcgis" /> 

This is the name of your published map service. For example, in the earlier step Register Data in ArcGIS Server Data Store, it is Wavepoint_MapService.

<add key="AGSMapServicePath" value="Wavepoint_MapService" />

As an optional configuration, modify the Web.config to include the ArcGIS Server Manager user name and password as shown below. Then, see the topic Secure the Map Service to complete the procedure to secure the published map service.

<add key="AGSLogin" value="example_password" />
<add key="AGSPassword" value="example_password" />

The Web.config file comes pre-populated with wavelengths of 1310 and 1550 nanometers (nm).

<add key="ALoss" value="1310" />
<add key="ALoss" value="1550" />

You can add to the list of searchable layers referenced by the Wavepoint search tool.

By default, the following layers are searchable:

• Cables

• Circuits

• Patch Locations

• Racks

• Splice Points

To use this list of defaults, leave the SearchableLayers value null.

<add key="SearchableLayers" value="" />

To add an additional searchable layer, type its layer number as the value. If adding multiple layers, separate each layer number by a space.

<add key="SearchableLayers" value="8 9" />

To determine layer numbering, visit the REST URL page for the map service. The REST URL is located on the Capabilities menu for the map service itself.

Added layers are searchable by their Display Field set in the layer properties.

Example: Add Buildings and Parcels as Searchable Layers

As an example, here is how to add features such as buildings and parcels as searchable layers:

1. In ArcMap, access the Layer Properties > Display tab to ensure a useful field is chosen as the display field.

   

2. If you have made any changes to your map, including modifying the display field as described in the previous step, re-publish your map service.

3. In ArcGIS Server Manager, click your Service, then click Capabilities.

4. Click the REST URL to view the contents of the published service.

5. Locate the layers you want to add to the Wavepoint searchable layers. In the following image, Building is #8 and Parcel is #9.

   

6. In the Web.config, modify the SearchableLayers to include these layer numbers (multiple numbers should be separated by a space):

   <add key="SearchableLayers" value="8 9" />

7. Open or refresh Wavepoint in your browser.

8. Notice your layers are now searchable in the application:

   

9. Also notice you can search on the Display field set in the Layer Properties:

   

We strongly recommend you use the default value here, which is the ArcGIS Online locator service. You can, however, provide the URL of another locator service.

<add key="LocatorServiceUrl" value="http://tasks.arcgisonline.com/ArcGIS/rest/services/Locators/TA_Address_NA_10/GeocodeServer" />

<add key="LocatorServiceUrl" value="http://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer" />

Set this value to true if you want all of the ArcGIS Online basemaps to display. Set to false if you do not want to display ArcGIS online basemaps.

<add key="UseAGOLBasemaps" value="true" />

Set this value to true if you want all of the Bing basemaps to display.

<add key="UseBingBasemaps" value="true" />

If you set this value to true, you must supply a BingMapsApiKey. Refer to Microsoft's Bing maps help topic for guidance.

<add key="BingMapApiKey" value="123exampleAPIKey456" />

If you do not intend to use Bing Maps, change the value to false and set the API key to a dummy value. You can literally use the word dummy as the value.

<add key="UseBingBasemaps" value="false" />
<add key="BingMapApiKey" value="dummy" /> 

You may not want to include all Bing or all ArcGIS Online basemaps. It is possible to configure a subset of each individually or together to provide your own fully customized basemap. Read Configure Custom Basemaps (optional) to learn more about custom basemap configuration.

If you do opt to customize the list of basemaps, an example entry in the Web.config could look like the following:

<add key="basemap.1" value="{title:'My Streets', url:'', type:'OpenStreetMap', key:'', thumbnail:''}" />
<add key="basemap.2" value="{title:'Hybrid', url:'', type:'BingMapsHybrid', key:'', thumbnail:''}" />
<add key="basemap.3" value="{title:'Light Gray', url:'', type:'agol', key:'8b3b470883a744aeb60e5fff0a319ce7', thumbnail:''}" />
<add key="basemap.4" value="{title:'Imagery', url:'', type:'agol', key:'86de95d4e0244cba80f0fa2c9403a7b2', thumbnail:''}" />

When the application opens, the map centers on a specified geography. Enter the decimal degree location for the longitude (x) and latitude (y), separated by a comma. It is required to specify the longitude first, followed by the latitude. For example, for the map to open centered on Fort Collins, CO, USA, the entry looks like the following:

<add key="InitialMapCenter" value="[-105.0284,40.5690]" />

When the application opens, the map starts at a specified zoom extent. This extent is dictated by an integer value for the IntialMapZoom (decimal values are not permitted). The minimum is 0 and the maximum is 20. The lower the number, the farther the map is zoomed out upon opening the application. The higher the number, the closer the map is zoomed in. Think of it like a volume control on a radio, where you don’t choose an exact decibel value, but instead use a relative scale of low to high. Finding the best starting zoom is best tested with your end users.

For example, setting the value at 0 means the map opens essentially at a world-wide scale:

And, setting the value at 20 means the map opens at a parcel level scale:

The default value provided in the Web.config is 11.

<add key="InitialMapZoom" value="11" />

You can add this entry in the Web.config if you want the map to zoom on point features at a different zoom extent than the initial map zoom extent. This is an optional setting.

Just like the InitialMapExtent, the PointGeometryZoom is dictated by an integer value (decimal values are not permitted). The minimum is 0 and the maximum is 20. The lower the number, the farther the map zooms out when you click a point feature. The higher the number, the closer the map zooms in when you click a point feature.

For example, if the InitialMapExtent value is 11, typing in a value of 15 for the PointGeometryZoom means the map zooms in closer when navigating to point features.

<add key="PointGeometryZoom" value="15" />

This key is used to change the port colors visible in the Wavepoint rack view and in other views as well.

The following is the default value of this field:

<add key="PortStateColors" value="1(Circuit):#FF6600, 2(Reserved):#FF0000, 3(Damaged):#FFFF00, 4(Available):#9900FF, 5(Permanent - In Service):#000000, 6(Temporary - In Service):#0000CC, 7(Allocated - Not Installed):#FF6600, 8(Installed - Not In Service):#CC66CC, 9(Uncertain):#444455, -1(Other):#555555

Follow the same pattern when making modifications:

Coded value from a domain such as Port Status(optional name such as Circuit):Hex Color Code

Change this to the distance unit label you would like to see in the Wavepoint application.

For example, enter ft for feet:

<add key="DefaultLinearUnit" value="ft" />

Or, enter m for meters:

<add key="DefaultLinearUnit" value="m" />

As stated in the topic Configure Customer Basemaps (optional), you are allowed one projection for all basemaps. In other words, different basemaps cannot have different projections. So, if you have opted to include ArcGIS Online maps, you must enter the value for WGS Web Mercator, as that is the projection used by this service.

If you are not using the online service, this value should match the spatial reference of your company’s custom basemaps.

For more information, read the ArcGIS Resources topic Web Map Specification.

The following example uses the value for WGS Web Mercator:

<add key="DefaultSpatialReference" value="{wkid:102100}" />

By default, the Web.config provides a buffer of 10 as the search proximity when users attempt to identify a feature on the map. For usability purposes, this gives the user a small buffer around the click point when identifying features.

<add key="IdentifyBuffer" value="10" />
<add key="IdentifyTolerance" value="10.0" />

Normally Wavepoint defers to ArcGIS Server to acquire the display field for a given entity.  In that case, leave the entry as the default:

<add key="DisplayFieldOverrides" value="[]" />

If you need to override this and use a different column than the display field, DisplayFieldOverrides can be specified. This is a JSON field, so the value needs to be valid JSON. Otherwise, this value is ignored.

In the example, this key value tells the application to use PortName as the display field for layers with layerID 37 and layerID 40.

<add key="DisplayFieldOverrides" value="[{ 'layerId': 37, 'displayField': 'PortName' },{ 'layerId': 40, 'displayField': 'PortName']" />

Due to issues encountered with SQL Server 2008 R2 and its lack of support for pagination, you can set this Boolean value to DisableQueryPagination = true. If you do not encounter issues, this can safely be omitted.

<add key=”DisableQueryPagination” value=”true” />

By default, racks are numbered from bottom to top. If that is the desired numbering, no changes need to be made to the Web.config. However, if you require racks to be numbered from top to bottom, add the following:

<add key="UseAscendingRowNumbers" value="true" />

A value of “false” is the same as the default: the racks are numbered bottom to top.

Change the httpRuntime version number to match your current version:

<httpRunTime targetFramework="4.5"/>, or
<httpRunTime targetFramework="4.6.1"/>

There might be additional configuration steps that depend on your company’s version of Transport Layer Security (TLS) for web browsers, and your company’s version of httpRuntime (which is the .NET Framework for web applications):

• If using TLS 1.2 and httpRuntime 4.6.1, there are no additional configuration steps.

• If using TLS 1.2 and httpRuntime 4.5, there are additional configuration steps.

In short, TLS 1.2 works natively with httpRuntime 4.6.1, and you can change the httpRuntime version number in the Web.config to 4.6.1.

However, Wavepoint (and possibly other applications at your company) is configured to point to httpRuntime 4.5 by default, which does not natively work with TLS 1.2. If you cannot upgrade to 4.6.1, you can add registry key values to allow TLS 1.2 to work, even though the application is at httpRuntime 4.5.

Visit the myArcFM article Wavepoint - Enforce TLS 1.2 to download a registry updater script to quickly add the registry key values.

By default, the application writes logs to the following directory: C:\Logs\Wavepoint.txt. You can change the location of the log file within this portion of the Web.config:

<appender name="FileAppender" type="log4net.Appender.FileAppender">
   <file value="C:\Logs\Wavepoint.txt"/>

If you change the directory, ensure the file path has read and write permissions. Do not use a secured path, as the application is not able to write to it.