Map Drawer symbology
The MapDrawerSymbology configuration defines the markers that Map Drawer shows for various types of records. Each type of record is identified by the moniker of its business object, such as Hansen.CRM.ServiceRequest for service requests. The markers are defined by nodes. You can set a single icon to use for all records for a given moniker, or you can define multiple icons that Map Drawer will select based on business object properties. For example, you can use the RequestType property of the ServiceRequest object to set different icons for different service request types.
CONFIG attributes
The root node has two attributes, which you can use to define the standard height and width of the icons in Map Drawer.
| Attribute | Description |
|---|---|
| iconheight | Height of Map Drawer icons. |
| iconwidth | Width of Map Drawer icons. |
Moniker attributes
The node has a collection of nodes as children. Each of these specifies the business object for a type of record for which you want to define one or more icons to use in Map Drawer. Each node has these attributes:
| Attribute | Description |
|---|---|
| label | Label of the tooltip that will be displayed when the user hovers over markers for records of this type in Map Drawer. You can use this attribute to set the label for all icons associated with this moniker. You can also set different labels for individual icons.
To include an identifier for individual records, specify the property that contains the value you want to show between brackets. For example, the standard label for parcels in Map Drawer is Parcel# [ParcelID]. This indicates that Map Drawer will show each parcel’s ID in the tooltip label. |
| name | Moniker of the business object. For example, to define icons to use for service requests, you would specify Hansen.CRM.ServiceRequest. |
Icon attributes
Each node has one or more nodes as children. If there is only one node, that icon will be used for all records of this type. You can also add multiple nodes, and use filters to indicate which icons to use for individual records based on selected properties. Each node can have these attributes:
| Attribute | Description |
|---|---|
| file | Name of the image file that you want to use for the icon. The image files are typically located in C:\Inetpub\wwwroot\[Operations and Regulations application directory]\client\Images\MapDrawer\MapIcons. |
| height | Height of the icon in Map Drawer. Images will be stretched or shrunk as required to match the height and width values. If no value is specified, then the default value will be used. |
| label | Label of the tooltip that will be displayed when the user hovers over markers for records of this type in Map Drawer. You can use this attribute to set the label for a single icon. You can also use the label attribute of the parent moniker set a label for all icons.
To include an identifier for individual records, enter the property that contains the value you want to show between brackets. For example, the standard label for parcels in Map Drawer is Parcel# [ParcelID]. This indicates that Map Drawer will show each parcel’s ID in the tooltip label. |
| width | Width of the icon in Map Drawer. Images will be stretched or shrunk as required to match the height and width values. If no value is specified, then the default value will be used. |
Filter attributes
Each node can have one node as a child. The node can have one or more nodes as children, each of which defines a key/value pair that Map Drawer will evaluate to determine whether to use the parent icon. A node has these attributes:
| Attribute | Description |
|---|---|
| key | Property of the parent object that Map Drawer will check to determine which icon to use. For example, if you’re defining symbology for building applications (Hansen.CDR.Building.BuildingApplication), you can use the ApplicationType property to set different icons for different application types. |
| type | Type of filter. For icons the type will always be compproperty, meaning the filter is based on the property specified in the key attribute. The parent icon will be used to show records where the value of that property matches the value attribute. |
| value | Value of the property specified in the key attribute for which Map Drawer will show the parent icon. |