Interactive SVG Map Component

Overview

The possibility to highlight business KPIs with colors on tailored custom maps and to drill down into details from that is a common need in several sectors such as:

  • Retail for stores
  • Public Sector for geographical area
  • Logistic for warehouses
  • Office Space design/allocation
  • and many others

Leveraging an SVG integration, we provide a way to customer to use their own svg maps into Appian SAIL.

Key Features & Functionality

The interactiveSvgMapComponent allows customers to:

  • Provide a custom SVG map image
  • Specify a list of areas as a parameter for which a different color (standard Appian colors or hex code) can be applied, show a custom tooltip, decide the best way to highlight the area on mouse hover, and optionally allow a click event on the area itself
  • Zoom in and out on the map using the mouse, buttons, or icons
  • Pan the map within the component area
  • Use Appian document generation template format to populate a text field in the map image with Appian values
  • As a result, the component will return the index of the selected area (across the ones specified as a parameter), which can be used in SAIL to show the details data related to that area
  • By leveraging the Rich Text Editor image upload connected system, it is also possible to convert the resulting map into a PNG image document for reporting purposes or for use in SAIL interfaces for read-only users.
Anonymous
  • NEW TRY NOW BUTTON AVAILABLE

    With the "Try Now" button below the Download link you can see the component in action before actually installing it in your cloud instance or local environment

  • Looks like I have different phone layout (I m on Android) btw in your video components stack usually the behavior you are observing should happen when you pan up and down outside the component area, while it should not if you do that within the component, unless there is a different behavior on iphone web engine. May you try on another phone or via browser on the mobile device?

    We overlapped our answer then maybe you need to open a support case

  • Looks like I have different phone layout (I m on Android) btw in your video components stack usually the behavior you are observing should happen when you pan up and down outside the component area, while it should not if you do that within the component, unless there is a different behavior on iphone web engine. May you try on another phone or via browser on the mobile device?

  • Hi  , I attached a video of the behavior I'm experiencing on my iPhone 12. Zooming and pan left/right work just fine. The issue is that when I try to move up or down, the whole page scroll is moving as well.

    EDIT: I tested both an iPhone and an Android. It appears that only the native iOS mobile app has the issue described above. The Android app, and using the web browser on both devices allowed the SVG image to be moved independently of the rest of the page

  • I don't see the issue on mobile you need to hold a finge and move it to pan and  use 2 fingers to zoom in and out

  • Hello,

    We noticed that trying to zoom/pan the SVG component on the native Appian mobile app causes the entire page to scroll. Is it possible to lock the entire screen when attempting to move around the svg image via touch controls?

  • Have you tried to play with the column width attribute of the column layout component ? 

  • Hi  , I am trying to understand if this plugin can be used to show SVG inline in a grid.

    I created a fake grid with columnsLayout and columnLayout, and inserted the following SVG:

    <svg width='45px' height='45px' viewBox='0 0 15 15' fill='none' xmlns='http://www.w3.org/2000/svg'> <path d='M0 7.49996C0 3.52583 3.09098 0.27365 7 0.0163574V4.0354C5.30385 4.27801 4 5.73672 4 7.49996C4 9.43295 5.567 11 7.5 11C8.28618 11 9.01181 10.7407 9.5961 10.3031L12.438 13.1451C11.1188 14.3 9.39113 15 7.5 15C3.35786 15 0 11.6421 0 7.49996Z' fill='#000000'/> <path d='M13.1451 12.438C14.3001 11.1187 15 9.39107 15 7.49996C15 6.46644 14.7909 5.48175 14.4128 4.58586L10.7552 6.21147C10.9132 6.61024 11 7.04496 11 7.49996C11 8.28611 10.7408 9.01174 10.3032 9.59602L13.1451 12.438Z' fill='#000000'/> <path d='M8 4.0354V0.0163574C10.5416 0.183645 12.7373 1.61699 13.9626 3.69166L10.2541 5.33986C9.71063 4.64791 8.91203 4.16585 8 4.0354Z' fill='#000000'/> </svg>

    In the interface, it seems that to the right of the viewbox there is some whitespace that I'm not sure if it can be removed:

    Here you can see the viewbox as 0, 0, 10, 10. It doesn't seem to me like a problem with viewbox

  • v6.0.2 Release Notes
  • v6.0.1 Release Notes
    • Component Height now properly fit to content when the SVG source is dynamically changed from SAIL
    • Description of mapAreaParameters parameter in designer now reflect the latest updates of the plugin