Network Map

Overview

The Network Map tab shows the selected panel and its related devices and modules in a tree map. Use this tab to review how equipment items are connected, inspect individual items, and identify devices that need attention.

Users typically open this tab from the Equipment hub after selecting a panel on the Equipment page. The map helps users understand the relationship between the panel, devices, and modules without opening each item separately.

Use the Network Map tab to:

• View the selected panel in context with its devices and modules.
• Review parent-child relationships between equipment items.
• Open item details and available actions from the right-side modal.
• Find devices with trouble conditions by looking for the warning icon.
• Change the map orientation, zoom level, and position.

Before you begin

Required permissions

• You must have permission to view equipment.
• You must have permission to view panels.
• You must have permission to open the Equipment hub for a selected panel.
• You must have permission to view devices and modules related to the selected panel.
• Additional permissions may be required for actions shown in the right-side modal.

info

Access to the Equipment page, Equipment hub, and Network Map tab is controlled by equipment-related role permissions.

Preconditions

• At least one panel must exist on the Equipment page.
• You must select a panel from the Equipment page to open the Equipment hub for that panel.
• The selected panel must have related device or module data to show a complete map.
• The browser must support interactive map controls such as drag, zoom, and item selection.

Dependencies

• The Network Map depends on panel, device, and module data available in the system.
• Trouble indicators depend on current device status data.
• Actions in the right-side modal depend on the selected item type and your role permissions.

Important limitations

warning

• The Network Map tab is available from the Equipment hub for a selected panel. It is not opened directly from the main navigation.
• The tree map shows relationships that are available for the selected panel. Missing or incomplete equipment data can affect what appears on the map.
• Selecting an item opens the right-side modal for that item. The available actions can differ for panels, devices, and modules.
• Devices with trouble conditions are marked with a warning icon. The map does not replace detailed troubleshooting tools or device diagnostics.

Page layout

Equipment hub navigation

The Equipment hub navigation shows tabs for the selected panel. Select Network Map to view the panel relationship map.

Callout	UI element	Description	When to use
1	Selected panel context	Shows that the Equipment hub is opened for a specific panel selected from the Equipment page.	Use to confirm that you are reviewing the correct panel.
2	Network Map tab	Opens the tree map for the selected panel and its related devices and modules.	Use to review equipment relationships and open item details.
3	Other Equipment hub tabs	Provide access to other panel-specific views in the Equipment hub.	Use when you need information that is not shown on the Network Map tab.

Network map canvas

The network map canvas is the main area of the tab. It shows the selected panel, related devices, and modules as a tree.

Callout	UI element	Description	When to use
1	Panel node	Represents the selected panel. The panel is the root item of the tree map.	Use to open panel details and available panel actions in the right-side modal.
2	Device node	Represents a device related to the selected panel.	Use to review device placement in the map or open device details and actions.
3	Module node	Represents a module related to the selected panel or device.	Use to review module relationships or open module details and actions.
4	Relationship lines	Connect nodes to show relationships between the panel, devices, and modules.	Use to understand how items are related within the selected panel network.
5	Warning icon	Marks a device that has a trouble condition.	Use to identify devices that need review or troubleshooting.
6	Map drag area	Allows you to move the tree map with the mouse.	Use when part of the tree is outside the visible area or when you need to focus on a specific branch.

note

The default orientation is horizontal. Use Change orientation to switch the tree to vertical orientation.

Right-side item modal

The right-side modal opens when you select a panel, device, or module in the tree map. It shows information and available actions for the selected item.

Callout	UI element	Description	When to use
1	Modal title	Shows the selected item name or item type.	Use to confirm which map item is open.
2	Item information	Shows available details for the selected panel, device, or module.	Use to inspect the selected item without leaving the Network Map tab.
3	Available actions	Shows actions supported for the selected item and allowed by your permissions.	Use when you need to manage or review the selected item.
4	Close control	Closes the right-side modal and returns focus to the map.	Use after reviewing item details or when you want to select another map item.

note

Available actions are context-specific. A panel, device, and module can show different actions.

Map controls

The map controls appear in the bottom-right corner of the page. Use them to change the map view.

Callout	UI element	Description	When to use
1	Change orientation	Switches the tree between horizontal and vertical orientation.	Use when another layout makes the panel, devices, or modules easier to review.
2	Center	Returns the tree map to the center of the visible area.	Use after dragging or zooming the map away from the main view.
3	Zoom In	Increases the zoom level of the tree map.	Use to inspect nodes or labels more closely.
4	Zoom Out	Decreases the zoom level of the tree map.	Use to see more of the tree map at one time.

How to use this page

Open the Network Map tab

Goal:

• Open the network map for a specific panel.

Steps:

1. Open the Equipment page.
2. Select the panel you want to review.
3. Wait for the Equipment hub to open for the selected panel.
4. Select the Network Map tab.

Expected result:

• The Equipment hub shows the Network Map tab for the selected panel.
• The map displays the panel and available related devices and modules.

Review equipment relationships

Goal:

• Understand how the selected panel, devices, and modules are related.

Steps:

1. Open the Network Map tab for a selected panel.
2. Review the panel node as the root of the tree.
3. Follow the relationship lines from the panel to connected devices and modules.
4. Drag the map with the mouse if part of the tree is outside the visible area.
5. Use Zoom Out if you need to see more of the map.
6. Use Zoom In if you need to inspect a specific node.

Expected result:

• You can see the relationship structure for the selected panel.
• You can identify which devices and modules are associated with the panel.

Open details for a panel, device, or module

Goal:

• View information and available actions for an item in the tree map.

Steps:

1. Open the Network Map tab.
2. Select a panel, device, or module node in the tree.
3. Review the right-side modal that opens for the selected item.
4. Use any available action if needed.
5. Close the modal when you finish reviewing the item.

Expected result:

• The right-side modal opens for the selected item.
• The modal shows the information and actions available for that item.

note

If an expected action is not shown, your role may not include permission for that action, or the action may not apply to the selected item type.

Identify devices with trouble conditions

Goal:

• Find devices that require attention.

Steps:

1. Open the Network Map tab.
2. Look for device nodes marked with a warning icon.
3. Select the marked device node.
4. Review the right-side modal for available details and actions.
5. Use related troubleshooting or device pages if more information is required.

Expected result:

• Devices with trouble conditions are visible on the map.
• Selecting a marked device opens its right-side modal.

warning

A warning icon indicates that the device has a trouble condition. Review the device details before taking action.

Change the map orientation

Goal:

• Switch the tree layout between horizontal and vertical orientation.

Steps:

1. Open the Network Map tab.
2. Select Change orientation in the bottom-right map controls.
3. Review the updated tree layout.
4. Select Change orientation again if you want to return to the previous orientation.

Expected result:

• The tree switches from horizontal orientation to vertical orientation, or from vertical orientation back to horizontal orientation.

Center the map

Goal:

• Return the tree map to the center of the page.

Steps:

1. Drag or zoom the map as needed.
2. Select Center in the bottom-right map controls.

Expected result:

• The tree map returns to the center of the visible area.

Zoom in or out

Goal:

• Adjust the map scale to inspect details or view more of the tree.

Steps:

1. Open the Network Map tab.
2. Select Zoom In to increase the map scale.
3. Select Zoom Out to decrease the map scale.
4. Select Center if the map moves away from the visible area.

Expected result:

• The tree map scale changes based on the selected zoom control.
• You can inspect nodes more closely or view more of the tree at once.

Field and option reference

Network map items

Name	Description	Accepted values	Behavior	Restrictions	Default value
Panel node	Represents the panel selected from the Equipment page.	Existing panel.	Appears as the root item in the tree map. Selecting it opens the right-side modal.	The Equipment hub must be opened for a selected panel.	Selected panel.
Device node	Represents a device related to the selected panel.	Device associated with the selected panel.	Appears in the tree map according to its relationship. Selecting it opens the right-side modal.	Only devices available in the selected panel relationship data are shown.	Not applicable.
Module node	Represents a module related to the selected panel or device.	Module associated with the selected panel structure.	Appears in the tree map according to its relationship. Selecting it opens the right-side modal.	Only modules available in the selected panel relationship data are shown.	Not applicable.
Warning icon	Indicates that a device has a trouble condition.	Shown or hidden by the system.	Appears on devices with trouble conditions.	Applies to devices. Exact trouble details depend on device status data.	Hidden when no trouble condition is detected.

Map controls

Name	Description	Accepted values	Behavior	Restrictions	Default value
Orientation	Controls the direction of the tree layout.	Horizontal or vertical.	Changes when you select Change orientation.	Applies to the visible tree map only.	Horizontal.
Center	Returns the map to the center of the visible area.	System-controlled position.	Repositions the map after dragging or zooming.	Does not change orientation or zoom level unless the system adjusts the view to center the map.	Centered on initial load.
Zoom In	Increases the map scale.	System-supported zoom levels.	Makes nodes and labels appear larger.	Maximum zoom level is not specified.	Default map scale.
Zoom Out	Decreases the map scale.	System-supported zoom levels.	Shows more of the tree map at one time.	Minimum zoom level is not specified.	Default map scale.

Tips

tip

• Start by confirming that the Equipment hub is open for the correct panel.
• Use Zoom Out before dragging when the map has many devices or modules.
• Use Center after several drag or zoom actions to return to the main view.
• Switch orientation when node labels overlap or when the tree is wider than the visible area.
• Select warning-marked devices first when you are reviewing panel health.

Troubleshooting

The Network Map tab is not visible

Possible causes

• You are not in the Equipment hub for a selected panel.
• Your role does not include permission to view the Network Map tab.
• The selected panel page did not load correctly.

What to do

1. Open the Equipment page.
2. Select a panel to open the Equipment hub.
3. Check whether the Network Map tab is available.
4. Confirm that your role includes the required equipment permissions.
5. Refresh the page if the Equipment hub does not load correctly.

The map is empty or incomplete

Possible causes

• The selected panel has no related devices or modules.
• Equipment relationship data is incomplete.
• The map did not finish loading.
• You do not have permission to view some related equipment items.

What to do

1. Confirm that you opened the Equipment hub for the expected panel.
2. Refresh the page.
3. Review the panel from other Equipment hub tabs, if available.
4. Confirm that devices and modules are configured for the panel.
5. Contact an administrator if expected items are still missing.

A device shows a warning icon

Possible causes

• The device has a trouble condition.
• Device status data reports an issue that requires review.

What to do

1. Select the device node with the warning icon.
2. Review the right-side modal for available details.
3. Use available actions or related troubleshooting pages to investigate the device.
4. Escalate the issue if the condition cannot be resolved from the available controls.

Selecting a map item does not show expected actions

Possible causes

• The selected item type does not support the action.
• Your role does not include permission for the action.
• The item state does not allow the action.

What to do

1. Confirm whether you selected a panel, device, or module.
2. Review the actions shown in the right-side modal.
3. Check your role permissions.
4. Open the related equipment page if the action is available elsewhere.
5. Contact an administrator if you need additional access.

The map is difficult to navigate

Possible causes

• The tree contains many devices or modules.
• The current zoom level is too high or too low.
• The current orientation does not fit the visible area.

What to do

1. Select Zoom Out to show more of the tree.
2. Drag the map to the area you need to review.
3. Select Change orientation to switch the layout.
4. Select Center to return the map to the main view.

The map is not centered after navigation

Possible causes

• The map was moved by dragging.
• The map was moved while zooming.

What to do

1. Select Center in the bottom-right map controls.
2. If needed, adjust the zoom level.
3. Select Center again after changing the zoom level.

Related pages

info

• Equipment
• Equipment hub
• Panel details
• Device details
• Module details
• Troubleshooting or alarms pages
• Role permissions