(v1) .Cable Ports/Pins/Lens v2020.3

What is a Port, Pin, and Lens?

A port, pins, or lens is a physical area one would plug into on a piece of equipment in order to connect another device. The most common use of a Ports/Pins/Lens is a switch. A home router is is simple switch and the individual holes on the back where an ethernet cable can be plugged in are called ports.

Where Can I find Ports/Pins/Lens?

The Ports/Pins/Lens (PPL) grid is located in a few separate places in the application.

Menu Location	Description	More Information
Main > Cable > Ports/Pins/Lens	A grid displaying all PPL present in the system, the equipment each PPL originates from, and the equipment (if any) to which each PPL is connected. The PPL grid will allow the User to review any of the Ports, Pins, or Lens (PPL) that are associated with a given Cabling Equipment record. Since Ports/Pins/Lens (PPL) must be associated with an Equipment record they cannot be added from this grid and must be added to the Equipment record on the Ports/Pins/Lens tab instead.	(v1) Ports/Pins/Lens Grid
Main > Inventory > Equipment > Ports/Pins/Lens	If a piece of Equipment has an Equipment Catalog that has the Cabling Equipment flag checked, then it will also have a tab labelled Ports/Pins/Lens. This shows all PPL originating from the equipment and the equipment (if any) to which each PPL is connected. From this tab new PPLS may be added, edited, or removed. The software provides functionality for bulk PPL creation, editing, removal, copying, and transferring of PPL.	Ports/Pins/Lens Equipment Grid
Main > Inventory > Equipment > Ports/Pins/Lens > Add or Edit	The PPL form allows for adding and editing of individual PPLs.	(v1) Ports/Pins/Lens Form

What do Ports/Pins/Lens statuses mean?

More information on PPL statuses is available here

Replacing a Full Path:

When the RECREATE_EXISTING_PATH flag on the Import is set to True, then If a Cable Path already exists on the indicated Service or Location, then the process will UPDATE all existing Paths with the Path value in the Import File. This makes setting this flag an important part when trying to Remove/Disconnect/Retire an older Cable Path with a new one. It is important that the Path records ( 'Path', 'Path Legs', 'Locations', 'Equipment' (from and to, each leg), 'Services', 'Ports/Pins/Lens' (from and to, each leg) and 'Vlans') already exists, otherwise the Import will attempt to create the new records, but could generate errors based on the Imported values.

How to Replace a Cable Path

Create the Import File for what to update.
Set the RECREATE_EXISTING_PATH flag in the file.
Run the Import to replace the old path with the new.

Alternate Method: using the Cable Path Import

Create any new Cables/Ports/Pins/Lens/Pairs/Strands for the new Cable Path using their associated Imports.
Run the Imports to create the new Cabling records for the new Path.
Create the the Import File for the Cable Path.
Set the RECREATE_EXISTING_PATH flag in the file.
Run the Cable Path Import to update the old Path.

PCR-360 (Cloud-Archive)