...
While the Service ID and the Location are optional, at least one of these must be provided to give the Path a valid location.
Service ID
Conditionally Required
Datatype is String.
...
If the lookup fails, it causes an error.
Location
Conditionally Required
Datatype is Hierarchical String.
Either a Service ID or a Location must be provided. If both are provided, the Import uses both.
...
If the lookup fails, it causes an error.
Location Type
Datatype is String.
Permitted values are from the LOCATION_TYPE List Values.
...
Individual Legs of the Path can be Imported onto the Cable Path.
Cable Name
Datatype is String.
This must be a valid preexisting Cable.
Path Status
Datatype is String.
Default Value is blank.
Permitted values are LEFT_IN, blank, or any value added in List Values by your organization.
Pair/Strand Number
Datatype is String.
This must be a valid, existing Pair/Strand Number. If the User needs to INSERT a Pair/Strand, use the Pair/Strand Import or manually create the record.
If the Cable and Pair/Strand are provided and the From or To Equipment and Port are not provided, the From or To Equipment and Port will be copied from the From or To Equipment and Port from the Pair/Strand.
From Equipment ID
Datatype is String.
This must be a valid, existing Equipment ID.
...
If the lookup fails, it causes an error and the Path does not INSERT.
From Equipment Location
Datatype is Hierarchical String.
This field expects the full Location hierarchy in a single string with individual parts of the Location Hierarchy separated by the HIERARCHYPATH_CONCATENATOR.
The From Equipment Location is only used to find the correct From Equipment. It is only needed if there are more than one From Equipment with the same Equipment ID in different Locations.
From Equipment Location Type
Datatype is String.
Permitted values are from List Values of type LOCATION_TYPE: Site, Building, Floor, Room, Cube, Truck, Closet, Rack, Elevation, or Manhole.
...
User entered values to the LOCATION_TYPE list may also be used.
From Ports Pins Len
Datatype is String.
The Cable Path Import will NOT INSERT Port/Pin/Lens records. This must be done with the Ports/Pins/Lens (PPL), API, or manually create the PPL record.
...
If the lookup fails, it causes a warning. The Path is created with blank Port/Pin/Len values.
From Port Pin Len Side
Datatype is String.
This optional value is used to help identify a Port, in case an Equipment has multiple ports with the same port number, on different sides.
To Equipment ID
Datatype is String.
This must be a valid preexisting Equipment ID.
The Cable Path Import will NOT INSERT Equipment IDs. This must be done with the Equipment Import, API, or manually create the Equipment record.
To Equipment Location
Datatype is Hierarchical String.
This field expects the full Location hierarchy in a single string with individual parts of the Location Hierarchy separated by the HIERARCHYPATH_CONCATENATOR.
The To Equipment Location is only used to find the correct To Equipment. It is only needed if there are more than one To Equipment with the same Equipment ID in different Locations.
To Equipment Location Type
Datatype is String.
Permitted values are from List Values of type LOCATION_TYPE: Site, Building, Floor, Room, Cube, Truck, Closet, Rack, Elevation, or Manhole.
...
User entered values to the LOCATION_TYPE list may also be used.
To Ports Pins Len
Datatype is String.
The Cable Path Import will NOT INSERT Port/Pin/Lens records. This must be done with the Ports/Pins/Lens (PPL), API, or manually create the PPL record.
...
If the lookup fails, it causes a warning, but the Path is created with blank Port/Pin/Len values.
To Port Pin Len Side
Datatype is String.
This optional value is used to help identify a Port, in case an Equipment has multiple ports with the same port number, on different sides.
Backbone Service ID
Datatype is String.
If provided, the value is used to look up an existing Service record. The Import will not INSERT this Service record. See the Services Import to INSERT Services.
If the lookup fails, it causes an error.
Leg Location
Datatype is Hierarchical String.
This is optional and used to assign the location of the Path Leg. Usually, this is not needed, and the location of the leg will match the location of the Path or the Path's Service. This is usually used to differentiate Path Legs for Services that have multiple Locations.
Leg Location Type
Datatype is String.
Permitted values are from the LOCATION_TYPE List Values.
...
"pathLegCableName"
"pathLegPairStrand"
"pathLegBackbonebackboneServiceId"
"FROM_EqpId"
"FROM_EqpLocation"
...
| Code Block | ||
|---|---|---|
| ||
///// begin Conditional Logic /////
// Values for first leg
$cl_cable_1 = [5];
$cl_pair_1 = [6];
$cl_location_1 = [7];
$cl_backbone_1 = [8];
$cl_from_eqp_1 = [9];
$cl_from_port_1 = [10];
$cl_from_side_1 = [11];
$cl_to_eqp_1 = [12];
$cl_to_port_1 = [13];
$cl_to_side_1 = [14];
// Values for second leg
$cl_location_2 = [15];
$cl_cable_2 = [16];
$cl_pair_2 = [17];
$cl_backbone_2 = [18];
$cl_from_eqp_2 = [19];
$cl_from_port_2 = [20];
$cl_from_side_2 = [21];
$cl_to_eqp_2 = [22];
$cl_to_port_2 = [23];
$cl_to_side_2 = [24];
[PATHS.LEGS_ARRAY] = array(
// first leg
array(
"pathLegLocationName" => $cl_location_1,
"pathLegCableName" => $cl_cable_1,
"pathLegPairStrand" => $cl_pair_1,
"pathLegBackbonebackboneServiceId" => $cl_backbone_1,
"FROM_EqpId" => $cl_from_eqp_1,
"FROM_EqpPPLPort" => $cl_from_port_1,
"FROM_EqpPPLSide" => $cl_from_side_1,
"TO_EqpId" => $cl_to_eqp_1,
"TO_EqpPPLPort" => $cl_to_port_1,
"TO_EqpPPLSide" => $cl_to_side_1,
),
// second leg
array(
"pathLegLocationName" => $cl_location_2,
"pathLegCableName" => $cl_cable_2,
"pathLegPairStrand" => $cl_pair_2,
"pathLegBackbonebackboneServiceId" => $cl_backbone_2,
"FROM_EqpId" => $cl_from_eqp_2,
"FROM_EqpPPLPort" => $cl_from_port_2,
"FROM_EqpPPLSide" => $cl_from_side_2,
"TO_EqpId" => $cl_to_eqp_2,
"TO_EqpPPLPort" => $cl_to_port_2,
"TO_EqpPPLSide" => $cl_to_side_2,
),
);
///// end Conditional Logic ///// |
...