---
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


---

# Path Search function

# Path Search 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 Path Search function

The Path Search function in the Telecommunications Network Inventory application allows users to compute paths between network sites, aiding in network inventory design and assignment.
It identifies possible paths and, if none are found, establishes a logical connection without adding new elements.
If the end equipment is not specified, the function automatically selects compatible equipment based on the Type attribute.
Show full answer Show less  

## Key Features

* **Path Computation:** Computes connections based on defined start and end sites and equipment.
* **Workflow Integration:** Can be utilized as an action within Workflow Studio for inventory operations.
* **Dynamic Interface Selection:** Automatically selects interfaces if not specified, ensuring a logical connection is created.
* **Admin Role Access:** Only users with the admin role can configure the flow details for this function.

## Input Fields

The Path Search function requires various input fields, including:

* **Start Site:** sysid of the starting site.
* **End Site:** sysid of the ending site.
* **Start Equipment:** sysid of the starting equipment.
* **End Equipment:** sysid of the ending equipment.
* **Start Interface:** sysid of the starting interface (optional auto-selection).
* **End Interface:** sysid of the ending interface (optional auto-selection).
* **Logical Connection Model:** sysid of the model used.
* **Bandwidth:** sysid of the connection bandwidth.
* **Fail Action:** Defines actions upon failure, defaulting to creating a logical connection without path elements.

## Key Outcomes

By using the Path Search function, ServiceNow customers can effectively manage their telecommunications network inventory, ensuring optimal path computation and logical connections. This leads to improved network design and efficiency in operations.  
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.
You can use the Path Search function to identify the possible paths between your network sites.

If no path is found, the Path Search function uses the available input to create a logical connection without adding any connection elements. If you don't enter the end equipment, it selects any equipment that matches the Type
attribute that belongs to the end site. The function uses the start and end interfaces in the input to set the Port A and Port Z of the logical connections. Otherwise, it selects any interface in the Availability field, which is
marked as Available.

You can use this function as a Workflow Studio action in the Telecommunications Network Inventory workflow.

## Roles and availability {#path-compute-action__section_kfd_fdk_x5b}

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 {#path-compute-action__section_klp_yzq_x5b}

The following table lists the input fields in the Path Search function and their description.
{#path-compute-action__table_w3g_2fm_1vb__entry__3}

| Name | Description | Data Type |
|-|-|-|
| Start Site | sys_id of the starting network site where this connection is configured. | String |
| End Site | sys_id of the ending network site where this connection is configured. | String |
| Start Equipment | sys_id of the starting network equipment where this connection is configured. | String |
| End Equipment | sys_id of the ending network equipment where this connection is configured. | String |
| Start Interface | sys_id of the starting network interface where this connection is configured. Note: If this field is left empty, it automatically selects the interface by using the path computation to create a logical connection. | String |
| End Interface | sys_id of the ending network interface where this connection is configured. Note: If this field is left empty, it automatically selects the interface by using the path computation to create a logical connection. | String |
| End Equipment Type | sys_id of the ending network equipment type where this connection is configured. | String |
| Logical Connection Model | sys_id of the logical connection model where this connection is configured. | String |
| Bandwidth | sys_id of the bandwidth of the connection. | String |
| Allowed Logical Connection Model | sys_id of the supported models for the logical connection. Click the add icon (![Add icon.]()) to add a logical connection model. | Array.String |
| Allowed Physical Connection Model | sys_id of the supported models for the physical connection. Click the add icon (![Add icon.]()) to add a physical connection model. | Array.String |
| Fail Action | Option to select the action when the function fails. You can select an action from the list. By default, the Create logical connection without path elements is selected. | Choice |
[Table 1. Input fields of Path Search function]

{#path-compute-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 {#path-compute-action__section_rnx_nxn_dvb}

The following table lists the information about the function's output.
{#path-compute-action__table_snx_nxn_dvb__entry__3}

| Name | Description | Data Type |
|-|-|-|
| Connection id | Returns the sys_id of the logical connection record. | String |
[Table 2. Output of function]

{#path-compute-action__table_snx_nxn_dvb}
**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.")
* [Lookup Next Hub function](https://servicenow-prod.fluidtopics.net/ZzBLvcSLnnYarEgYkudhZQ "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.")