Create Physical Connection function

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 2 minutes to read
    • Summarize
    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 Create Physical Connection function

    The Create Physical Connection function within the Telecommunications Network Inventory application allows users to establish a physical connection record based on inventory inputs. This function is essential for creating physical port connections on network interface cards by automatically retrieving related data for specified interfaces and their associated sites and equipment.

    Show full answer Show less

    Key Features

    • Automatic Data Retrieval: Inputs for Interface A and Interface Z trigger automatic retrieval of related data, including Site, Equipment, and Port information.
    • Bandwidth Retrieval: Bandwidth data for both ends of the connection (AtoZ and ZtoA) is also automatically fetched.
    • Flow Designer Integration: This function is available as an action in Flow Designer, facilitating easy integration into inventory workflows.
    • Input Fields: Key fields include Interface A, Interface Z, Bandwidth, Connection Type, and optional elements such as Physical Connection Elements and Strand Number.

    Key Outcomes

    By utilizing the Create Physical Connection function, ServiceNow customers can efficiently manage physical network connections, streamline data operations, and maintain accurate inventory records. The output of the function returns a glide record of the created physical connection, enabling seamless tracking and management of network resources.

    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.

    Overview

    You can use the Create Physical Connection function to create a physical port connection on the interface cards in your networks.

    When you enter the Interface A, this function automatically retrieves the data for related Site A, Equipment A, and Port A. Similarly, after passing input Interface Z, the function retrieves the data for associated Site Z, Equipment Z, and Port Z. This function also retrieves the data for Bandwidth AtoZ and Bandwidth ZtoA from the Bandwidth field.

    This function also creates the connection elements and associates them to the physical connection.

    If you pass a physical connection element, this subflow creates the corresponding connection element and associates it to 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 Create Physical Connection function and their description.

    Table 1. Input fields of physical connection action
    Field Name Description Data Type Mandatory?
    Interface A Starting network interface where this logical connection is configured. Reference.Network Interface Yes
    Interface Z Ending network interface where this logical connection is configured. Reference.Network Interface Yes
    Bandwidth Bandwidth of the logical connection. Reference.Bandwidth Yes
    Connection Type Type of connection. This field information updates the Product Model that is associated with the physical connection. Reference.Physical Connection Model Yes
    Physical Connection Elements sys_id of the connection elements that are added for the physical connections. If the physical connection has the Connection Type attribute as Cable, you can add the connection element. Click the add icon (Add icon.) to add a connection element. Array.String No
    Strand Number Cable number of the physical element.
    Note:
    The strand number must be less than or equal to the strand count in the physical connection.
    		 Integer No
    Allocate Pair Option to create two physical connection elements.

    If you give the strand number and select Allocate Pair, the cable uses two strands. One of the strands is strand number and the other, strand number +1.

    		 True/False 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 Connection Returns a glide record of the physical connection. Record