Lookup Next Hub function

The Lookup Next Hub function enables you to take the network interface record as input and return the details of the related physical connection record. You can automatically get the details of the physical connection and interconnected ports of the equipment in the Telecommunications Network Inventory application when you use the Flow Designer application.

Overview

You can use the Lookup Next Hub function to return the following:

• Physical connection that is related to the port.
• Empty response if no physical connection is related to the port.
• sys_id of the front and back ports, and the port name, if there’s a configuration item (CI) relationship between the front and back ports.
• NextHub interface and the interfaces that are connected to the other end of the physical connection.
• NextHub interconnected interface and the interconnected interfaces that are connected to the other end of the physical connection.

You can use this function as a Flow Designer action in the Telecommunications Network Inventory workflow.

Roles and availability

Users with the admin role can add an action to a flow and define the configuration details of the flow. This function is available as a Flow Designer action in the Telecommunications Network Inventory application so that you can perform inventory-related data operations.

Input fields

The following table lists the input fields in the Lookup Next Hub action and their descriptions.

Table 1. Input fields of next hub action

Field Name	Description	Data Type	Mandatory?
Network Interface	Network interface record.	Reference.Network Interface	No
If multiple records are found action	Option to select the action when multiple records are found. You can select Return only the first record from the list to return the details of the first physical connection record.	Choice	No

To learn more about the variable data types, see Flow Designer input and output data variables.

Output

The following table lists the information about the function output.

Table 2. Output of function

Name	Description	Data Type
Physical Connections	Returns the list of sys_ids of the physical connection records that are related to the network interface.	Array.String
Interconnected Port	Returns the list of sys_ids of the ports that are interconnected to the network interface.	Array.String
NextHub Interface	Returns the list of sys_ids of the interfaces that are connected to the other end of the physical connection.	Array.String
NextHub Interconnected Interface	Returns the list of sys_ids of the interconnected interfaces that are connected to the other end of the physical connection.	Array.String

Example

Use Case 1

If the input is passed as Interface-1 of Equipment-1 as shown in the following example, the function returns empty records, because the network inventory has no physical or internal connections in the network inventory.

Use Case 2

If the input is passed as Interface-1 of Equipment-1 as shown in the following example, the function returns the network interface record of Interface-2.

Use Case 3

If the input is passed as Interface-1 of Equipment-1 as shown in the following example, the function returns the network interface record of Interface-2 and the physical connection record of PC-1.

Use Case 4

If the input is passed as Interface-1 of Equipment-1 as shown in the following example, the NextHub Interface is 3 and the NextHub Interconnected Interface is 4.

Related concepts

• Allocate Free Number function
• Create CI From Template function
• Cascade Update function
• Create and Assign Range/Single Number function
• Create Logical Interface function
• Create Logical Connection function
• Create Physical Connection function
• Create IP subnetwork function
• CIDR to IP range function
• Get Interface Summary function
• Path Search function