Add New Ports/Pins/Lens Form example

There are only two required fields on the Ports/Pins/Lens form, the 'Port/Pin/Len' field, and the 'Status' field.

The valid Statuses that can be set are 'Left In', 'Spare', 'Assigned', 'Reserved', 'PDPC', 'Pending Disconnect', 'Pending Connect', 'Bad', and 'Unknown'. More information about what the intended usage of the various Statuses can be found on the PPL and Pair Status page.

Port Alias

Users can specify a 'Port Alias' for a given PPL. The Port Alias Port Alias field will override the PPL field on Grids and Reports to display the Port Alias. This is useful when a unique field is needed in the Port/Pin/Len field to specify the PPL record when interfacing with external systems. The Port Alias will only display internally and makes it easier to identify the PPL record without having to memorize the unique value that is stored in the PPL field.

For this example, the Port/Pin/Len field is set to "Unique PPL" and the Port Alias field is set to "Generic Alias".

Port/Pin/Len Alias Usage Example

Grid behavior

When the User looks at the Ports/Pins/Lens tab of the Equipment record that this Port/Pin/Len is attached to, Users will only see the value Generic Alias displayed in the grid. The unique value in the Port/Pin/Len field will not display so long as there is a Port Alias value.

Ports/Pins/Lens Alias Usage example in the grid

Picker behavior

It is important to note that the Picker behavior will also be overridden by the Port Alias field.

For example, if the User searches for "Generic Alias" in the Origination Port/Pin/Len Picker of the Path Leg form then the PPL will be found and values will be populated like normal.

Origination section of Ports/Pins/Lens Form

However, if the User were to search for the "Unique PPL" in the Origination Port/Pin/Len Picker, no value will be found as a match. The "Unique PPL" value will only be used for connections with external systems.

Port/Pin/Len Selection Form, Alias example

View Path behavior

This overriding behavior will carry through to the View Path Report and display the Port Alias there as well. In this example, the button has been clicked and the resulting report is displaying the Port Alias of "Generic Alias" in the report.

Alias on View Path Report example

Other Fields

The 'Multiple Paths?' checkbox will allow the Ports/Pins/Lens record to exist on multiple Path Legs. The default behavior is one Port/Pin/Len connection per Path Leg. Selecting the Multiple Paths? checkbox will override this default behavior to allow the specified PPL record to be selected in multiple Path Legs.

The User can also designate the following:

Type: This is the type of the Port the PPL is in the record. The values in this list come from the List Values of the Type: PORT_TYPE
Tx/Rx: Shorthand for Transmit/Receive, denotes if the Port transmits, receives data, or if it both transmits and receives. The values in this list come from the List Values of the Type: PORT_TX_RX
Side: Designates if the Port is on the Front, Back, or Cross-Connected on the Equipment. The values in this list come from the List Values of the Type: PORT_SIDE
Speed: How fast the Port transmits data. The values in this list come from the List Values of the Type: PORT_SPEED

IP Address

From the Ports/Pins/Lens form, the User can assign IP Addresses to the PPL in either 'IPv4 Address' or 'IPv6 Address' formats.

IP Address fields

Back Connect

Users can specify that a Port/Pin/Len is set to 'Back Connect'. Back Connect is a method to connect two pieces of Equipment together, without having the connection appear in the Cable Path. This is useful for connecting two pieces of Equipment like a Switch to a Patch Panel. When a User attempts to disconnect the Cable Path this Back Connect will remain in place. When ports are transferred, any Back Connects are transferred along with the port.

Back Connect fields

In the Back Connect section, there are two fields; the 'Destination Equipment' and the 'Destination Port/Pin/Len' Pickers. Neither field will be Required until the other Picker has a value.

Setting Back Connection

To set a Port/Pin/Len (PPL) to 'Back Connect' follow these steps:

Open the Equipment record that should have a Back Connection set up. In this example, a Switch with an Equipment ID of "Back Connection One" will be used.
In the Destination Equipment Picker the Patch Panel "Back Connection Two" will be selected. In this example, Back Connection Two is selected.
This makes the Destination Port/Pin/Len picker Required
Click on the Destination Port/Pin/Len Picker and select a PPL.
- A User could instead select the Destination Port/Pin/Len record and have the Destination Equipment picker automatically fill in.
Save the PPL record.
The Switch Back Connection One will now reflect the Back Connection in the Ports/Pins/Lens tab of the saved PPL record.
The Port/Pin/Len (PPL) records for both pieces of Equipment reflect the 'Back Connection'.
- On the PPL tab of the Patch Panel Back Connection Two in the grid.
- Also on the opened PPL record.

The two pieces of Equipment are now linked with a Back Connection.

Remove a Back Connection

Back Connects prevent deleting a PPL because both pieces of Equipment need that Back Connect reference. In order to Delete a PPL, clear the Back Connect Equipment from the PPL form for one of the two pieces of Equipment. This will remove the Back Connection, allow the User to delete the PPL, create a new one, and then apply the Back Connection to it instead. When you remove a back connect from one PPL it will remove the Back Connect from both PPLs.

Remove Single Back Connect Example

If there is a range of Back Connects to remove from a single piece of Equipment, it can be done using thebutton on the PPL grid, found on the Manage Equipment Form. From the PPL Range Form, there is abutton.

Remove Back Connect Range Example

Path Leg Usage

Linking Equipment with a Back Connection will only store on the relevant Equipment records and serves as a method to track the two link pieces of Equipment together. However, Path Legs can be easily generated to include these two pieces of Equipment in a Path. This can be done from the Service Desk or the Cable Paths form. If a User attempts to select a piece of Equipment with this Back Connect set up, the other piece of Equipment will automatically pull into the relevant fields of the Ports/Pins/Lens form.

To quickly create a Path Leg with Back Connected Equipment follow these steps:

Begin a new Path.
- Either by clicking the button on the Service Desk > Cable tab.
- Or by clicking the button on the Cable Paths form.
Both methods will open the 'Add New Path Legs' form.
In the 'Origination Equipment' Picker select the Switch Back Connection One:
- Note that since an Origination PPL is not yet selected only the fields relevant to the Origination Equipment are filled in.
Now in the Origination Port/Pin/Len picker select the Port 'A-01' which was set as a Back Connected piece of Equipment previously.
- Note that the entire set of fields for the Destination autofill with the data for Patch Panel Back Connection Two because of the Back Connection.
- At this point if a User wants to edit data in the Destination, that data could be edited to create a different Path Leg. There is no enforced link between the Back Connected Equipment and what exists on the Path Leg. The autofill is for convenience only.
Click the button to save this Path Leg.
For this example, a Jack is also selected for Path Leg 200.
Close the Add New Path Legs form.
- From the Service Desk > Cable tab click the button to see the View Path report.
- From the Cable Paths form click the button to see the View Path report.

The View Path should look something like this:
View Cable Path example

Back Connect Path Leg Deletion

Even though Back Connect Equipment can help to create a Path Leg, the two Back Connected Equipment records will maintain their respective associations even if the Path Leg is deleted.

Select Path Leg #100 and click the Delete Selected button.
Click the button to see the Path Leg 200.
In the View Path report the Patch Panel Back Connection Two is still the first part of the Cable Path.
- Note that even though the Patch Panel is Back Connected to the Switch Back Connection One that connection does NOT show in the Path Leg, unless it is specifically selected as in the previous example.
With the Path Leg still deleted the User can confirm the Equipment records still have their respective Back Connect pickers having set values.

VLANs

An additional feature of the Ports/Pins/Lens form is the ability to add a VLAN if one does not yet exist on the VLANs tab.

Browser not supported