Customize icons that show on the map in Dispatcher Workspace

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 1 min. de leitura

    • Administrators with the ability to code in javascript can change the icons that show on the map so they’re easier to see or represent different items in the resources table.

    Aviso:

    You must be experienced in coding javascript to follow this procedure. If you don’t know javascript and attempt to complete these tasks there is a good chance you will break your instance.

    The process to customize icons in the map in Dispatcher Workspace consists of designing and creating the icons, uploading them, and then modifying a number of script includes so that the icons represent what you want them to on the map.

    Keep the following information in mind to ensure you maintain all existing functionality while adding your customizations. When you see Overridden Methods in the icon customization documentation it means:

    1. Copy the entire method from the parent/base class.
    2. Paste it into your override file.
    3. Make specific modifications to the sections that need changes.
    4. Leave the rest of the method unchanged.

    How the different updates work together to customize map iconography:

    1. Data Retrieval: DispatcherWorkspaceMapBrokerImpl._getResourcesWithLocation() queries database for resources.

    2. Marker Creation: DispatcherWorkspaceMapUtil.getResourceMarkers() creates marker objects using inherited _getMarker().

    3. Icon Assignment (Server): DispatcherWorkspaceMapUtil.getMarkerIcon() sets proper resource icons.

    4. Icon Assignment (Client): DispatcherWorkspaceMapClientUtilSNC.setMarkerImage() uses correct resource icon names based on context (single resource vs multiple resources, and default/hover/selected states).

    5. Rendering: Markers display on map with custom resource icons.

    The icon naming convention is described below.

    Single Resource:

    • Default: resource-default.svg
    • Hover: resource-hover.svg
    • Selected: resource-selected.svg

    Multiple Resources (Co-located)

    • Default: resources-default.svg (plural)
    • Hover: resources-hover.svg
    • Selected: resources-selected.svg