IMF Developer's Guide

<identify-link>

IMF Developer's Guide » Layer Configuration » <identify-link>

Identify-link elements can be defined within a layer element to create titled hyperlinks in the default identify, drill identify and selection reports. Links appear above all other field values in the report. Multiple links are permitted.

Frequency	Parent Elements (this element is valid within):
PO+	<layer>

Attributes	Description
handler	The name of a URL that is executed when the user clicks the link. 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. Required.
handler-suffix	Used by the urlAppend reporting type. When the urlAppend reporting type is used, the URL called is created by concatenating the text of the handler value, the value of the first field specified in the key-fields attribute, and the value contained in this attribute.
key-fields	A list of fields used in the routine specified in the type attribute. The field names in the text string should be separated by commas with no extra spacing. Must match the FULL name of the fields in the feature layer. In the case of SDE layers, the full name is the OWNER.TABLE.COLUMN format. Required.
text	The text that appears in the report. Required.
type	The process by which the link is built from the attributes. Valid values are "urlFieldValues" or "urlAppend". Optional, defaults to "urlFieldValues".
window	Sets whether the document opened by the link is 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".

Frequency	Description (in this context)
PO+	The <identify-link> element may appear one or more times within the <layer> element.

Examples:

<!-- urlAppend example: -->
<layer name="1:20K Map Grid" can-identify="true">
  <identify-link text="Map Grid Report"
                 type="urlAppend"
                 key-fields="SDE.GRID_20K.TILE_NAME"
                 handler="http://someserver.com/mapgrid_rpt_"
                 handler-suffix=".html"/>
</layer>
<!-- example URL: http://someserver.com/mapgrid_rpt_93F020.html -->

<!-- urlFieldValues example: -->
<layer name="1:20K Map Grid" can-identify="true">
  <identify-link text="Map Grid Report"
                 type="urlFieldValues"
                 key-fields="SDE.GRID_20K.TILE_NAME"
                 handler="http://someserver.com/mapgrid_rpt.asp"/>
</layer>
<!-- example URL: http://someserver.com/mapgrid_rpt.asp?SDE.GRID_20K.TILE_NAME=93F020 -->

<!-- urlFieldValues example with field aliasing: -->
<layer name="1:20K Map Grid" can-identify="true">
  <field name="SDE.GRID_20K.TILE_NAME" identify-link-alias="tname"/>
  <identify-link text="Map Grid Report"
                 type="urlFieldValues"
                 key-fields="SDE.GRID_20K.TILE_NAME"
                 handler="http://someserver.com/mapgrid_rpt.asp"/>
</layer>
<!-- example URL: http://someserver.com/mapgrid_rpt.asp?tname=93F020 -->