Interface Map¶
The Interface Map provides an interactive visualization of your application integration landscape. Applications appear as nodes and interfaces as connecting edges, giving you a bird's-eye view of how data flows across your systems.
Where to find it¶
Navigate to IT Landscape → Interface Map to open the visualization.
Permissions: You need at least applications:reader to view the map.
Understanding the visualization¶
The map uses a force-directed graph layout where:
- Nodes represent applications
- Edges represent interfaces between applications
- Node size reflects the number of connected interfaces
- Edge labels display the interface identifier along each connection
Business vs Technical view¶
Business View (default):
- Hides middleware applications
- Shows direct source-to-target relationships
- Best for understanding business data flows
Technical View:
- Shows middleware platforms as intermediate nodes (displayed as diamond shapes)
- Displays the actual data path (Source → Middleware → Target)
- Best for understanding technical architecture
Toggle between views using the Show middleware switch in the toolbar.
Filters¶
All filters are located in the toolbar above the map.
Environment¶
Filter interfaces by deployment environment:
- Production, Pre-Prod, QA, Test, Development, Sandbox
The default is Production.
Lifecycle¶
Multi-select filter for interface lifecycle status. Choose which statuses to include in the visualization (e.g., Active, Planned, Deprecated). The default selection is Active.
Applications¶
Focus the map on specific applications or services:
- Click the Applications dropdown
- Select one or more applications (grouped by type: Applications vs Infrastructure services)
- The map filters to show only interfaces connected to your selection
When you select applications here, the Depth filter automatically switches from "All" to "1" so you see only the immediate neighborhood.
Depth¶
Limit how many hops from selected applications to display:
- All: Show all connected nodes (no limit)
- 1–5: Show only nodes within N hops of the selected applications
Middleware nodes do not count as a hop -- the depth counter only increments when traversing through a primary application node.
This filter is automatically enabled when you select applications in the Applications filter.
Graph controls¶
The control panel on the left side of the map provides these tools:
| Icon | Action | Description |
|---|---|---|
| Pause / Play | Freeze / Unfreeze | Pause the force simulation so you can manually position nodes |
| Center | Auto-center | Toggle automatic centering when selecting nodes (highlighted when enabled) |
| Zoom + | Zoom in | Increase zoom level |
| Zoom − | Zoom out | Decrease zoom level |
| Grid | Snap to grid | Align all nodes to a grid for cleaner layouts |
| SVG | Export SVG | Download the current view as a vector image |
| PNG | Export PNG | Download the current view as a raster image |
The freeze and auto-center buttons change color when active, so you can tell at a glance whether they are on or off.
Interacting with the map¶
Selecting nodes¶
Click an application node to highlight its connections and open a detail panel on the right.
Selecting edges¶
Click an interface edge to see interface details in the side panel. Edges have a wider invisible hit area, so you do not need to click the line precisely.
Dragging nodes¶
Drag any node to reposition it manually. While the simulation is running, the layout continues to adjust around the moved node. When the simulation is frozen, the node stays exactly where you place it.
Clearing the selection¶
Click the empty background area of the map to dismiss the detail panel and clear any selection.
Deep linking¶
The map supports URL parameters for sharing specific views:
| Parameter | Description | Example |
|---|---|---|
environment |
Pre-select an environment | prod, dev |
lifecycles |
Pre-select lifecycle filters (comma-separated) | active,planned |
focusInterfaceId |
Highlight a specific interface | UUID |
rootIds |
Pre-select applications to focus on (comma-separated) | UUIDs |
depth |
Set the depth limit | 1, 2, all |
Example: /it/interface-map?environment=prod&rootIds=abc123&depth=2
The detail panel¶
When you select a node or edge, a side panel opens on the right with details.
Application panel¶
- Description: What the application does
- Publisher: Software publisher
- Criticality: Business importance (Business critical, High, Medium, Low)
- Servers: Servers hosting this app, grouped by environment. Click a server name to open its workspace.
- Business owners: Responsible business contacts
- IT owners: Responsible technical contacts
- Support information: Support contacts with their roles. Click a contact name to navigate to the application's Technical tab.
- Edit application: Opens the application workspace
Interface panel¶
- Criticality: Business importance level
- Route: Integration route type
- Bindings: Number of environment bindings
- Via middleware: Whether the interface routes through middleware
- Endpoints: For the selected environment, shows source and target applications, job names, and endpoint URLs
- Infra connections: Infrastructure connections linked to this interface for the current environment. Each connection card shows source, destination, and protocols. From here you can:
- Click Edit to open the connection workspace
- Click View in Connection Map to see the infrastructure topology
- Edit interface: Opens the interface workspace
Tips¶
- Start with Production: Select the Prod environment to see your most critical integrations first.
- Focus on specific apps: Use the Applications filter with depth 2 to see just one application's neighborhood without the full landscape.
- Export for documentation: Use the SVG export to create architecture diagrams for documentation or presentations. Use PNG when you need a raster image.
- Snap for clarity: After dragging nodes into position, use Snap to Grid to create cleaner, more aligned layouts.
- Deep link for sharing: Copy the URL after setting filters to share specific views with colleagues.
- Switch to Technical view: When troubleshooting, enable middleware visibility to see the actual data path through integration platforms.