Moxi Media Inc.
<dynamic-feature-layer> Discussion Forum
IMF Developer's Guide » Layer Configuration » <dynamic-feature-layer>  

The <dynamic-feature-layer> element is used to set layer properties, and to organize layers into folders and groups.

Frequency Parent Elements (the <layer> element is valid within):
PO+ <folder>
PO+ <group>
PO+ <layer-config>
   

Frequency Child Elements (the <layer> element may contain):
RS1 <arcxml>
OS+ <field>
OS+ <identify-link>
OS+ <identify-report>
OS+ <layer-list-icon>
OS+ <layer-list-legend>
OS+ <property>
OS+ <select-menu-option>
OS+ <select-report>
OS+ <select-set-option>
OS+ <sql-query>
OS+ <sql-report>
   

Frequency Description (in this context)
PO+ The <layer> element may appear one or more times within the parent element in any order.
OS+ The child element may appear one or more times within the <dynamic-feature-layer> element in the specified order.
RS1 The <arcxml> element must appear once within the <dynamic-feature-layer> element in the specified order.
   

Attributes Description
active-identify Sets the layer to be the default identify layer when the application starts. Valid values are "true" or "false". The default is "false". Only one layer should be designated as active, but if more than one layer contains a true value, the last layer processed will be the active one. Optional.
active-select Sets the layer to be the default select layer when the application starts. Valid values are "true" or "false". The default is "false". This setting is only applicable to feature layers. Only one layer should be designated as active, but if more than one layer contains a true value, the last layer processed will be the active one. Optional.
alias Sets an alternate name to use when listing this layer in the layer list. Optional.
can-drill-identify Sets whether the layer appears on the drill identify report. Valid values are "true" or "false". The default is "true". Optional.
can-hide-labels Sets whether a checkbox will be displayed in the layers list for the layer to allow the user to hide the labels. Optional, valid values are "true" of "false". Defaults to false. Note that if the layer contains RASTERMARKERSYMBOLS, you must set the property spatialServer.AllowResponsePath to "true" in esrimap_prop. This property file is found in the same directory as the ArcIMS Servlet Connector. For more information on the location of esrimap_prop and its properties, see the ArcIMS Help.
can-identify Sets whether a layer can be identified. Valid values are "true" or "false". The default is "true". Layers that cannot be identified do not have the identify icon beside them in the theme list. Optional.
can-select Sets whether a layer can be selected using the select tool. Valid values are "true" or "false". The default is "false". Layers that cannot be selected do not have the select icon beside them in the theme list. Optional.
can-set-visibility Sets whether a layer can be turned on and off by the user. Valid values are "true" or "false". The default is "true". Layers that have can-set-visibility set to "false" show up in the layers list with the visibility checkbox disabled (grayed out). Optional.
can-set-visibility-beyond-scale Sets whether a layer can be turned on and off by the user if it is outside of the visible scale range. Valid values are "true" or "false". The default is "false". Optional.
can-symbolize Sets whether a layer can symbolized by the user. Note that show-symbolize-icon must also be set to true before the icon shows beside the layer name in the layer list. Valid values are "true" or "false". The default is "false", but the default for show-symbolize-icon is "true". Added at version 4.0.6.5. Optional. See also attribute symbolize-script.
can-zoom-to-layer Sets whether the user can zoom to the extent of a layer using the Zoom To Layer Extent routine. Valid values are "true" or "false". The default is "false". Optional.
hide-labels Sets whether the labels for the layer should be displayed when the application opens. Optional, valid values are "true" of "false". Defaults to true.. Note that if the layer contains RASTERMARKERSYMBOLS, you must set the property spatialServer.AllowResponsePath to "true" in esrimap_prop. This property file is found in the same directory as the ArcIMS Servlet Connector. For more information on the location of esrimap_prop and its properties, see the ArcIMS Help.
highlight-color The color for selected features in RGB values like "255,255,0". Defaults to yellow. Optional.
highlight-transparency A value indicating the transparency of the highlighted features. Acceptable values range from 0.0 for fully transparent to 1.0 for fully opaque. Defaults to 1.0. Optional.
highlight-type A value indicating the way that polygon features are highlighted. Acceptable values are "outline" and "fill". Defaults to "outline". Optional. Ignored for non-polygon layers.
identify-handler The name of a URL that is executed when the records have been located. Required for all identify types except "default".
identify-handler-suffix Used by the urlAppend reporting type. When the urlAppend identify type is used, the URL called is created by concatenating the text of the identify-handler value, the value of the first field specified in the identify-key-fields attribute, and the value contained in this attribute.
identify-key-fields A list of field names s used in the "urlTable", "urlFieldValues" or "urlMultipleFieldValues" identify types. For the "urlFieldValueAsQuery" or "urlAppend" identify types, only one field name should be used. Must match the FULL name of a field in a feature layer in the map service. In the case of SDE layers, the full name is the OWNER.TABLE.COLUMN format. The field names in the text string should be separated by commas with no extra spacing. Required for the above identify types.
identify-maximum-results The number of results that can be returned by an identify query. The default is 500. Optional.
identify-tolerance-pixels The search distance for selecting features when using the point select or identify tools, in pixels. Optional, the default is "1" for polygons, "6" for points, and "3" for lines.
identify-type The type of identify process that this layer uses. Valid values are "default", "tabular", "custom", "urlAppend", "urlTable", "urlFieldValues", "urlMultipleFieldValues" and "urlFieldValueAsQuery". Optional, the default is "default".
identify-window Sets whether the identify results for a layer are shown in a separate browser window. The default is "false" which means that the results are shown in the data frame. Valid values are "true" or "false". Optional.
immediate-refresh Sets whether the map should immediately refresh when the user changes the visibility of the layer. Valid values are "true" or "false". The default is "false".
max-scale Sets the maximum scale at which the layer will be displayed. Use numeric values, for example to set the scale to 1:10000, use 10000. Defaults to the maxscale setting in the map service, or 1.0E99 if no maximum scale is set for the layer in the map service.
metadata-handler Sets the URL for a dynamic page that describes the layer. The URL is called with parameters layer id, name, and the layer's object id. The URL can start with the special variable $IMF to specify that the document is relative to the IMF installation directory. Absolute URLs may also be used. URLs that don't start with http: or $IMF are resolved relative to the location of the XML file. Optional. By default, there is no metadata.
metadata-url Sets the URL for a metadata page that describes the layer. By default, there is no metadata. Optional.
min-scale Sets the minimum scale at which the layer will be displayed. Use numeric values, for example to set the scale to 1:10000, use 10000. Defaults to the minscale setting in the map service, or 0 if no minimum scale is set for the layer in the map service.
position Sets the drawing order of the layer. Valid values are "top", "bottom", or the desired indexed position between 0 (bottom) and one less than the layer count (top).
select-handler The name of a URL that is executed when the records have been located. Required for all select types except "default".
select-handler-suffix Used by the urlAppend reporting type. When the urlAppend select type is used, the URL called is created by concatenating the text of the select-handler value, the value of the first field specified in the select-key-fields attribute, and the value contained in this attribute.
select-highlight A boolean value indicating whether the selected features should be highlighted on the map. Valid values are "true" and "false". The default is "true". Optional.
select-key-fields A list of fields used in the select type routines. The field names in the text string should be separated by commas with no extra spacing. Required for the select types that need it.
select-maximum-results The number of results that can be returned by an select query. The default is 500. Optional.
select-shape The type of selection shape used for the layer. This affects the action of the select tool in the application. Valid values are "point", "polygon" and "box". The default is "point". Optional.
select-type The type of select process that this layer uses. Valid values are "default", "tabular", "custom", "urlTable", "urlEnvelope", and "urlShape". The default is "default". Optional.
select-window Sets whether the select results for a layer are shown in a separate browser window. The default is "false" which means that the results are shown in the data frame. Valid values are "true" or "false". Optional.
selected-set Specifies whether the layer uses selected set routines. Valid values are "true" or "false". The default is "false". Optional.
show-legend Sets whether the layer will show in the legend. Valid values are "true" or "false". The default is "true".
show-symbolize-icon Sets whether a the symbolization icon is displayed beside the layer name in the layers list. Note that can-symbolize must be set to true in order for this to have any effect. Valid values are "true" or "false". The default is "true", but the default for can-symbolize is "false". Added at version 4.0.6.5. Optional.
symbolize-script Sets the script called when the user selects the symbolize tool for a layer. The script should be a file name of a JSP script inside the IMF directory structure. Optional, defaults to "imfSymbolizeLayerForm.jsp". Added at 4.0.6.12. See also attribute can-symbolize.
zoom-extent-buffer Sets the buffer distance for zooming to selected features. The map extent will have at least this distance away from the feature on all sides. Numeric value in map units, no default. Optional.
   

Example:

<dynamic-feature-layer can-identify="true">
    <arcxml>
        <![CDATA[
            <LAYER type="featureclass" name="Accurate Streets 2" visible="true" id="Accurate Streets 2">
                <DATASET name="ubob" type="line" workspace="shp_ws-18" />
                <COORDSYS id="26910" />
                <GROUPRENDERER>
                    <VALUEMAPRENDERER lookupfield="RD_CLASS">
                        <EXACT value=" " label=" ">
                            <SIMPLELINESYMBOL width="1" captype="round" color="127,27,27" />
                        </EXACT>
                        <EXACT value="local_curb" label="local_curb">
                            <SIMPLELINESYMBOL width="1" captype="round" color="27,27,27" />
                        </EXACT>
                    </VALUEMAPRENDERER>
                    <SIMPLELABELRENDERER field="LABEL" linelabelposition="placeontop">
                        <TEXTSYMBOL antialiasing="true" font="Arial" fontstyle="regular" fontsize="10" />
                    </SIMPLELABELRENDERER>
                </GROUPRENDERER>
            </LAYER>
        ]]>
    </arcxml>
</dynamic-feature-layer>

Valid HTML 4.01!