--- sourceDocument: Australia Telecommunications Network Inventory sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/telecom-network-inventory Release : - australia ft:locale : - en-US ft:publication_title : - Australia Telecommunications Network Inventory ft:clusterId : - telninv bundleId : - telninv workflow : - Customer and Industry --- # Lookup Next Hub function # Lookup Next Hub function {#ariaid-title1} Release version: Australia Updated March 12, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Lookup Next Hub Function The Lookup Next Hub function allows users to retrieve details related to physical connection records based on a network interface record input. This function is particularly useful for obtaining information about physical connections and interconnected ports within the Telecommunications Network Inventory application when utilized in the Workflow Studio application. Show full answer Show less ## Key Features * Returns physical connections related to a specified port, or an empty response if none exist. * Provides sysid and names of front and back ports if there is a CI relationship. * Delivers details about the NextHub interface and interconnected interfaces at the other end of the physical connection. * Available as an action in Workflow Studio for inventory-related data operations. ## Roles and Availability The function is accessible to users with admin roles, allowing them to add the action to workflows and configure the necessary details. ## Input Fields The key input fields include: * **Network Interface:** The network interface record to be referenced. * **Action Option:** Allows selection of an action when multiple records are found, such as returning only the first record. ## Output The function outputs various data types, including: * **Physical Connections:** List of sysids for physical connection records related to the network interface. * **Interconnected Port:** List of sysids for ports interconnected with the network interface. * **NextHub Interface:** List of sysids for interfaces connected to the physical connection's other end. * **NextHub Interconnected Interface:** List of sysids for interconnected interfaces at the other end of the physical connection. ## Example Use Cases * **Use Case 1:** Inputting a network interface with no connections returns empty records. * **Use Case 2:** Inputting a network interface returns the record of another interface. * **Use Case 3:** Inputting a network interface returns related network interface and physical connection records. * **Use Case 4:** Inputting a network interface provides information about NextHub and interconnected interfaces. 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 Workflow Studio application. 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. {#lookup-next-hub-action__ul_tkd_c2h_bvb} You can use this function as a Workflow Studio action in the Telecommunications Network Inventory workflow. ## Roles and availability {#lookup-next-hub-action__section_dv3_wrd_1vb} 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 Workflow Studio action in the Telecommunications Network Inventory application so that you can perform inventory-related data operations. ## Input fields {#lookup-next-hub-action__section_ltb_bcr_x5b} The following table lists the input fields in the Lookup Next Hub action and their descriptions. {#lookup-next-hub-action__table_w3g_2fm_1vb__entry__3} | Field Name | Description | Data Type | |-|-|-| | Network Interface | Network interface record. | Reference.Network Interface | | 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 | [Table 1. Input fields of next hub action] {#lookup-next-hub-action__table_w3g_2fm_1vb} To learn more about the variable data types, see [Flow Designer input and output data variables](https://www.servicenow.com/docs/access?context=action-inputs-outputs&version=australia&pubname=australia-build-workflows&ft:locale=en-US). ## Output {#lookup-next-hub-action__section_rnx_nxn_dvb} The following table lists the information about the function output. {#lookup-next-hub-action__table_snx_nxn_dvb__entry__3} | 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 | [Table 2. Output of function] {#lookup-next-hub-action__table_snx_nxn_dvb} ## Example {#lookup-next-hub-action__section_otn_zrd_1vb} 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. ![Display of use case 1 where Interface-1 is connected to Equipment-1.]() 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. ![Display of use case 2 where Interface-2 and Interface-1 are connected to Equipment-1.]() 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. {#lookup-next-hub-action__dl_fvj_bsd_1vb} **Related concepts** * [Allocate Free Number function](https://servicenow-prod.fluidtopics.net/PuuJW2JxrgTywUnIAXcLeg "The Allocate Free Number function enables you to assign free numbers from the Telecommunications Network Inventory number record. You use this function to allocate a quantity of numbers from a specified range to add against the configuration item (CI) in a number element.") * [Create CI From Template function](https://servicenow-prod.fluidtopics.net/LL~zoSfWRCAzN6vgmL65sw "The TNI Create CI From Template function enables you to create the inventory instance in the designated site or equipment holder in the Telecommunications Network Inventory application. This occurs when you instantiate an inventory with the inventory template. You can automatically create the inventory when you instantiate the network inventory design and assign process.") * [Cascade Update function](https://servicenow-prod.fluidtopics.net/W97Jp~xw_w8ibvUCGhteRw "The Cascade Update function enables you to update a configuration item (CI) attribute in the Telecommunications Network Inventory application and cascade the change in all related CIs. You can use this function to automatically cascade the field values in related CIs when you use Workflow Studio.") * [Create and Assign Range/Single Number function](https://servicenow-prod.fluidtopics.net/gjw3tsjWew5ep25EHTlyEA "The Create and Assign Range/Single Number function enables you to create the inventory number records for a number range when you process the network inventory workflow.") * [Create Logical Interface function](https://servicenow-prod.fluidtopics.net/2nX46P9be0B6QeJSId3OKA "The Create Logical Interface function enables you to create logical interfaces in the Telecommunications Network Inventory application.") * [Create Logical Connection function](https://servicenow-prod.fluidtopics.net/DgjILFpYXEo~QjRh9KK9ZQ "The Create Logical Connection function enables you to create a logical connection record in the Telecommunications Network Inventory application based on the input (interfaces) that you receive when you instantiate an inventory.") * [Create Physical Connection function](https://servicenow-prod.fluidtopics.net/7ieQdTkzr9dlznGE7OWaYw "The Create Physical Connection function enables you to create a physical connection record in the Telecommunications Network Inventory application based on the input that you receive when you instantiate an inventory.") * [Create IP subnetwork function](https://servicenow-prod.fluidtopics.net/A5Gcil3U92nQAk1e9LyYJQ) * [CIDR to IP range function](https://servicenow-prod.fluidtopics.net/2zW3eRjGoF3fvMBCMr30Ww "Classless Inter-Domain Range (CIDR) to IP range flow action enables you to create a set of IP addresses using the Classless Inter-Domain Range (CIDR) using Telecommunications Network Inventory application based on the input that you receive when you instantiate an inventory.") * [Get Interface Summary function](https://servicenow-prod.fluidtopics.net/eBCtV3e6ngo0JOIWyFGiJw "The Get Interface Summary function enables you to retrieve all the network interface records that are associated with the input. You can use this function to automatically get the details of the available interface, connected interface, and the physical connection of the equipment in the Telecommunications Network Inventory application when you use Workflow Studio.") * [Path Search function](https://servicenow-prod.fluidtopics.net/Y0XR1w7cHadZ_06YQjXcOQ "The Path Search function enables you to execute the path computation function between the starting and ending sites in the Telecommunications Network Inventory application. You can use this function for the path computation when you process the network inventory design and assign.")