Editing a map in the Map Editor context does not mean changing the shapes, style or layout of the graphic elements, but rather it means mainly configuring the data and interactions of specific areas of the map in the visual, and some of the information on the map itself.
Map
This section displays the selected SVG interactive map. You can click on specific area, highlighting it and automatically selecting the corresponding node in the Selection Tree. Similarly, selecting a node in the Selection Tree highlights the corresponding area in the map.
Matched areas are displayed in green when the “Map Colors” is set to “Matching,” which can be toggled using the Map Colors Icon(3) at the bottom of the preview.
You can zoom in and out of the map, pan around the map, and reset the view to the default zoom level by click the Reset Zoom Icon(2) in the zoom toolbar.
In the bottom right corner, you could find the dropdown list(4) to assign a Map Selector reference to the current map.
SVG button(1) on the top right corner will open a code editor with the SVG raw content of the map, which can be useful for advanced users who want to make manual changes to the SVG code.
Selection Tree
To ensure easy identification and selection of each area , the Selection Tree on the right provides a hierarchical tree view of the SVG map structure. Each node in the tree represents an area in the map, and its name corresponds to the <id>
attribute of the respective SVG element.
All areas will be identified with an id. Read more on Auto Id Assignment.
Nodes will be styled according to the Data Binding status of the corresponding area:
- Matched will have green text.
- Strong Matched are displayed with green text and an additional green dot on the right end of the tree element. For Inherited areas (areas that are children of a
element with this status), both the dot and the text will appear slightly lighter green. - Unbound are displayed with only a red dot on the right end of the tree element. For Inherited areas (areas that are children of a
element with this status), the dot will appears slightly lighter red. - Unmatched will remain unchanged, as this is the default status.
You can also filter nodes by their binding status, search nodes by name, hide map areas, collapse nested nodes or just hovering them to the display binding information.
Interaction Pane
Once you select an area in the map or a node in the Selection Tree, the Interaction Pane will display its properties.
Area name is preceded by an icon that indicates the Shape of the selected area. You can hover the icon to see the shape type.
In the top right dropdown, you can choose the type of Interaction to apply to the selected element.
Area
This is the default value. Selecting this option means that selected area will keep the the default behavior, it can be bound to data and it will follow all the areas’ visual options (as colors, data label, positioning). In this section you will see two tabs:
-
General: here you can configure the data binding and the display name of the selected area. It consists of two key elements:
-
Data Point Dropdown This dropdown enables you to link the selected area to a specific data point in your dataset. By default, the option is set to (Auto Bind), which applies the Automatic Binding rules.
- You can also manually assign a specific data point by selecting a value from the dropdown.
- To remove the binding, select the ”(Do Not Bind)” option, leaving the area unbound.
-
Title Input Field This allows you to customize the name of the area as it appears in category labels when the the relative Display Value is set to “Title” in the visual settings.
- By default, the field is set to ”(Auto)”, meaning that if the corresponding SVG element contains a
<title>
tag, its content will automatically be used as the label. - If no
<title>
tag is present, you can manually input a custom value to serve as the label for the area.
- By default, the field is set to ”(Auto)”, meaning that if the corresponding SVG element contains a
-
-
Drill To: here you can insert the URL of a map that must be loaded when the user drill down on this area. This means basically that you are adding a Child Map to the current map, and the user will be able to navigate to it by clicking on the area.
Link
If this option is selected, the selected area will be treated as a hyperlink and will be excluded from the data binding and some visual options. This area can be used for one of the following purposes:
-
Switch to Map: clicking on this area will bring the user to the map selected in the dropdown list.
Note that you can only select maps that has been added on the same Drill Path of the current map.
-
Go to URL: clicking on this area will open the external URL provided in the text box.
Header
The header section contains the following elements:
- Maps(1): button to go back to the Map List.
- Map Title(2): the name of the map currently edited.
- Metadata(3): button to edit the following map information:
- Author: the author of the map.
- Attribution: attribution or copyright information for the map.
- Export(4): button to export the map as a file in the format:
- Map (XML/SVG): the map will be exported as XML file containing only the original SVG code.
- Map with Binding: the map will be exported as a JSON file containing the SVG code and all maps and data binding information.
Save Changes
All changes made in the Map Editor are not automatically saved in the visual. To apply the changes, you need to click the Save & Close or Save & Back buttons in the bottom right corner of the visual toolbar. If you want to discard the changes, you can click the Close button. Any time you close the Map Editor with unsaved changes, a confirmation dialog will appear to prevent accidental loss of data.
If you are saving changes made to a MyStorage Map you will be prompted to select:
- Save on My Storage: the map will updated in the MyStorage and the changes will be applied to all users and reports that use this map.
- Save as Local Copy: My Storage map will not be updated. A local copy of this map will be created with current changes.