Web Application Help

Layer List

The Layer List widget provides a list of operational layers and their symbols, and allows you to turn individual layers on and off. Each layer in the list has a check box that allows you to easily control its visibility. Layers having expansion arrows indicate that they contain sublayers or subtypes.

The order in which layers appear in this widget corresponds to the layer order in the map. This widget provides functionality allowing you to change the order of layers in the map.

Using the Layer List widget

• Clicking the Layer List widget in your application displays the layer list or table of contents window.
• If the Show Legend option is checked, clicking an individual layer shows its symbols.
• Clicking the down arrow on the right side of a layer displays the layer menu, which includes the following functions:
  • Zoom to—Sets the map extent to the extent of the layer.
  • Transparency--Sets the transparence for the layer.
  • Enable Pop-up / Remove Pop-up — Enables or disables Pop-up for the feature layer. If a feature layer does not have pop-up configured in the map, clicking Enable Pop-up shows all field values from the feature layer.
  • Move up—Moves the layer one level up.
  • Move down—Moves the layer one level down.
  • Open attribute table—Opens the attribute table for the feature layer.
  • Description / Show Item Details—Opens the service description or the item details page for the service or the item associated with the layer, if available.
• Clicking the X button in the upper right corner of the Layer List window closes it.

Back to Top

Legend

The Legend widget displays labels and symbols for layers in the map. It supports dynamic, tiled, image, feature, KML layer types, and WMS layers with an associated legend URL. The Legend widget can be set to automatically update when the visibility of a layer or sublayer changes. When no operational layers are rendered in the map, the Legend widget is blank.

Basemaps are not shown in the Legend widget by default. The order in which layers appear in the Legend widget corresponds to the layer order in the map. The widget can also be set to respect the scale dependencies of the layers in the map. This can be a useful indicator to map readers that additional data layers are present in the map but currently not displayed in the map because of scale dependencies.

Using the Legend widget

When the application starts, the Legend widget is automatically enabled. Clicking the Legend widget displays the legend window. Clicking the X button in the upper right corner of the legend window closes it.

Back to Top

Basemap Gallery

Clicking the Basemap Gallery widget displays all the basemaps configured for this widget. Clicking one of the basemap thumbnails sets it as the active basemap for the application. Click the X button in the upper right corner of the Basemap Gallery window to close it.

Back to Top

Bookmark

Clicking the Bookmark widget displays all pre-defined bookmarks, including bookmarks specified using the widget configuration window, and bookmarks defined in the web map used in the application. Clicking one of the bookmark thumbnails in the list sets the map extent to the bookmark area. You can also add additional bookmarks by zooming to your desired location and clicking the + icon next to the text box. To delete a bookmark defined at run time or configured using the widget configuration window, click the bookmark icon to highlight it first, and click the Delete button to delete it. If the bookmark is inherited from the web map, the Delete button is greyed out.

Clicking the X button in the upper right corner of the Bookmark window closes the bookmark window.

Back to Top

Draw

1. Select the desired drawing mode by clicking the symbol type.
2. Optionally, change the symbol for the feature using the symbol picker in the Draw widget.
   • For point symbols, select the marker category (different symbols are available in each category), size, color, transparency, outline color, and outline width of the symbol. Only the size is available for the picture marker symbols.

   

   

   • For line symbols, select a pre-defined symbol from the box. You may also customize the color, style, transparency, and width of the symbol. Click Show Measurements and select the Distance Units to display the measurement with the line.

   

   • For polygon symbols, select a pre-defined symbol from the box. You may also customize the fill color, transparency, outline color, and outline width of the symbol. Click Show Measurements and select the Area Units and Distance Units to display the measurement with the polygon.

   

   • For text symbols, enter the Text to be drawn, and select a font color and size for the symbol.

   

3. Draw features and texts on the map.
4. If the Add the drawing as an operational layer of the map option is checked, open Layer List widget, you will see Draw_Results layer.
5. Click Undo or Redo to undo or redo the drawing features. Click Clear to remove all of them.
6. Click Select to select features from the currently selected layer in the Search widget. The results of the selection will appear on the "Results" tab of the Search widget. (Note: This is a configurable option that may be turned off.)

Back to Top

Measure

Click the widget icon to open the Measurement widget.

Measure by Point

Click the point measurement iconand click a point on the map. The Measurement widget displays the coordinates for the point in Degrees (decimal). You may change the coordinate display format to degrees/minutes/seconds by changing the Degrees drop-down to DMS.

Polyline

Click the polyline measurement iconand draw a polyline on the map by clicking two or more points. Double-click to finish drawing the polyline. The Measurement widget displays the total length of the polyline, using the defined Default Length Unit. To change the length unit, select the applicable unit of measure from the Miles drop-down menu.

Polygon

Click the polygon measurement iconand draw a polygon on the map by clicking three or more points. Double-click to finish drawing the polygon. The Measurement widget displays the total area of the polygon, using the defined Default Area Unit. To change the area unit, select the applicable unit of measure from the Acres drop-down menu.

Back to Top

Print

1. Click the print icon to open the Print widget.
2. Enter a title for the map in the Map Title text box.
3. Select the applicable Layout and Format for the exported map.
   📓   Note — The MAP_ONLY format prints only the map, omitting any marginal information from the output.
   📓   Note — Print widget may not print the legend for the layers using the new styles, such as Heat Map, from the February 2015 update of ArcGIS Online, This is a known issue.
4. Click Advanced to open a menu with advanced print options. The Map scale/extent section defines the method that the print service should use to calculate the printed extent of the map. Preserving map scale may cause the printed map to maintain its scale while recalculating the extent around the existing center point, while preserving the map extent may cause the scale to adjust to fit the current map extent into the printed map. You may also force a specific scale by checking the Force scale option and entering a scale. Click current to populate the value with the present scale of the map.The Layout metadata allows you to override the default values set by the configuration. Enter values for the Author and Copyright fields to provide current information to the print service. Check the Include legend check box to display the legend on the printed map.If the MAP_ONLY format is selected, you may provide dimensions for the Width and Height in pixels. Otherwise, these values are ignored.The Print quality section allows you to update the resolution of the printed map. Provide an updated value for the DPI (dots per inch) in the text box.
   📓   Note — The widget supports custom text element as layout metadata if the custom task is named as Get Layout Templates Info.
5. After all options have been set with the applicable values, click Print to submit all information to the print service. A progress bar displays next to the executing task.
6. Upon the completion of the print job, a link to the print output displays. Click the task to open the file in a new window.
7. Click Clear Prints to clear the print history.

Back to Top

Search

The Search widget allows you to retrieve information from source data by executing a predefined query(s).The Search widget serves as a query builder during configuration, allowing you to define the query by specifying the map service layer url, filter expression, and displaying fields in query results. Each Search works with a single layer. However, you can define multiple searches for a single application, and data layers can be from multiple sources.

Using the Search Widget

Clicking the Search widget in your application displays the widget. Depending on the Initial View choice that was made during configuration the By Value or the By Shape view will be visible.

Value

The "Value" view has a dropdown list of predefined search layers. Selecting a search layer updates the dropdown list of search aliases for that layer (search expressions):

• If the search was configured to use Unique then a dropdown list will be presented of all unique values for the configured field. A progress indicator will be presented to show that the widget is busy working with the unique values as highlight in the image above.
• If Ask for values is specified at configuration time, a text box displays prompting you for new value for the parameter. The default value shows in the box initially.
• If the configured search uses a field that has a domain then a dropdown with all coded values will be presented.
• If the configured search was a range then two textboxes or date selectors will be presented.
• If you check the Limit results to maps extent. then the search results will be limited to features that intersect the maps current extent.
• If you checked the Value is required to be entered to enable search then the required expression value will be indicated with "*Required".
• If the expression value is defined as unique values or the field has a coded domain then the drop down list will not contain a blank value like it does when the field is not required.
• Date ranges can be searched on as follows:

By default all searches create a new result set. But to change the selection dropdown to Add or Remove the search results from the current result set.

Shape

The "Shape" view has a dropdown list of predefined search layers and draw tools for drawing on the map to search for features that intersect the drawn graphics.

• If you check on the enable multi-part graphics then when you complete drawing on graphic you and can continue to draw the same geometry type and once you have drawn all the graphics you wish to search by then you can click Search to execute the search.
• If you don't check on the enable multi-part graphics then when you complete drawing on graphic the search is automatically executed.
• If you check the "Draw Graphics Without Selecting" you can draw one or more graphics. Press "Search" to do a graphics selection of all features intersected by the graphics.
• If you choose to add or remove from the current search results using graphical searches as well as by Value searches.

Buffer

The Buffer tab has a buffering options, a dropdown list of predefined search layers and search options. buttons.

If have already completed an Value or Shape search then you can use buffer the selected feature(s).

If you click the Apply Buffer button than a buffer will be added around your existing search results.

Check the "Select features in buffer" to select features intersected by the buffer.

Choose "On Selected Features" to buffer the selected feature(s) or choose "On Graphic" to buffer the graphic(s) created in the Shape tab.

Spatial

The Spatial tab has a dropdown list of predefined search layers and spatial operation buttons.

If have already completed a value or shape search then you can use the adv(anced) search to search for other features that have a spatial relationship to your previous search results.

Choose the layer that you will search for the spatial relationship with your existing search results or buffer.

Choose whether you want to have the features that are "Intersected By" or "Entirely Contained In" the "Selected features" or "Buffer graphic".

A common workflow for using the Adv search would be to search for a road, buffer it by 500 feet and determine the parcels that are intersected by this road buffer. To do this you would follow these steps:

1. Go to the "Value" tab, select the Roads layer and search a road by name.
2. Go to the "Buffer" tab and the selected road feature(s) by 500 feet.
3. Go to the "Adv" tab, select the parcel layer from the drop down layer list, click the "Intersected By" radio button and click the "Buffer graphic" radio button.

Report

The Rpt tab has a dropdown list of predefined reports.

Choose a report from the Report dropdown.

Follow the directions for the specified report and press "Print".

Depending on the report, this will open the Print widget and display the print results.

Results

The Results view displays the features returned from the search, and use an alternating color scheme.

• The Zoom link will zoom the map to the extent of all the returned results.
• Click on an individual search result will zoom the map to that result and display the popup for that result.
• The Clear link will remove all the returned results from the map and the widget.
• If the results layer has links configured than the link text or link image will appears in the results. Back to Top