XYZ Components

This section describes each of the components in detail and explains the importing process.

The only way to configure XYZ-related data elements in ProTrack Warehouse is by building an import file, and importing the elements one at a time. This section refers to the spreadsheet, "SOP for XYZ Importing.xls". This is the official document containing import templates for each XYZ component. Each tab of the workbook must be completed prior to importing the data elements.

Coordinate System Origin - Coordinate values cannot be negative, thus the origin should be set with large enough to allow floors to grow in any direction. For example, the origin could be treated as (1000, 1000). When viewing a facility's layout in ProTrack Warehouse using the Facility Layout Java applet, the coordinate system axes are orientated such that the x-axis points to the right and the y-axis points downward. In other words, the x-coordinates ascend as you move to the right and the y-coordinates ascend as you move downward.

Location Data Element Naming Conventions - It is recommended that the following naming conventions be followed to so that the user easily knows where the data element is located on the Facility Layout.

Data Element	Naming Convention	Naming Convention Example	Comment
Facility	FAC	DC1	Facility ID must match EXACTLY what is configured in ProTrack Warehouse and being sent in the WMS extraction file.
Floor	FAC-FLR	DC1-FLR1
Aisle Path	FAC-FLR-AISLE	DC1-FLR1-04A	When two or more Aisle Paths are needed for a single rack (i.e. due to a non-passable barriers such as a security cage fence), append lowercase letters to the AISLE element.
Segment	FAC-FLR-AISLE-1	DC1-FLR1-04A-1	The '-1' suffix increments ('-2', '-3', etc.) with additional Segments on a single Aisle Path.
Location	FAC-LOC	DC1-032457	Must match the 'To Location' field EXACTLY being sent in the WMS extraction file.
Travel Path	FAC-FLR1-FLR2-1	DC1-FLR1-FLR2-1

^{Table 35. Naming Conventions}

Floor

A floor is the lowest level component of XYZ mapping. A facility can have multiple floors, which may or may not represent various actual floors in the warehouse. Floors can be used for this purpose (such as in mezzanine areas), or they may be used to simply divide a large single floor into multiple smaller sections. Any component added to the floor should be inside the floor.

Please refer to the Floor tab of the current "SOP for XYZ Importing" Excel spreadsheet.

Floor ID	Floor Name	Description	Start X	Start Y	End X	End Y	Width	Facility ID
1-FLR1	1-FLR1	Chicago - First floor	4000	2500	8000	5000	4000	1
2-FLR1	2-FLR1	Joliet - First floor	2000	2000	6600	5000	4600	2

^{Table 36. Floor Example}

Info

Commas ( , ) are not allowed in description fields for any .csv import file, as ProTrack Warehouse will treat the comma as a field separator and the file will error out.

Field	Description
Floor Name	Name of the floor.
Start X	X value of the start co-ordinate of the floor.
Start Y	Y value of the start co-ordinate of the floor.
End X	X value of the end co-ordinate of the floor. This value should be equal to start X.
End Y	Y value of the end co-ordinate of the floor.
Height	This is for future development, and thus not currently available in this version of ProTrack Warehouse.
Width	Width of the floor.
Description	Description of the floor.

^{Table 37. Floor Field Descriptions}

To view a floor in ProTrack Warehouse:

Access the Facility Layout screen, and click .
Select the facility name from the Facility list and floor name from the Floor list and click . The selected floor will be displayed.

^{Fig.189 Facility Layout Viewer - Floor}

Aisle Paths

An Aisle Path is a passable travel space over which equipment or people travel. An Aisle path resides on a floor and may have Segments around it. Nodes are created on the Aisle Path, at its intersections and end points. Multiple Aisle Paths can intersect.

Please refer to the Aisle Path tab of the current "SOP for XYZ Importing" Excel spreadsheet.

Aisle ID	Aisle Name	Start X	Start Y	End X	End Y	Floor ID	Numbering Direction	Numbering Scheme	Travel Rule	path_access_rule
1-FLR1-100	1-FLR1-100	4200	2800	4300	2800	1-FLR1	ALT_LR_ES	DUB_INC	DIRECT	BD
1-FLR1-101	1-FLR1-101	4200	3000	4300	3000	1-FLR1	ALT_LR_ES	DUB_INC	DIRECT	BD
1-FLR1-102	1-FLR1-102	4200	2800	4200	3000	1-FLR1	ALT_LR_ES	DUB_INC	DIRECT	BD
1-FLR1-103	1-FLR1-103	4250	2800	4250	3000	1-FLR1	ALT_LR_ES	DUB_INC	DIRECT	BD
1-FLR1-104	1-FLR1-104	4300	2800	4300	2900	1-FLR1	ALT_LR_ES	DUB_INC	DIRECT	BD
1-FLR1-104a	1-FLR1-104a	4300	2910	4300	3000	1-FLR1	ALT_LR_ES	DUB_INC	DIRECT	BD

^{Table 38. Aisle Path Examples}

Field	Description
Path ID	ID of the aisle path.
Path Name	Name of the aisle path.
Start X	X value of the start co-ordinate of the aisle path.
Start Y	Y value of the start co-ordinate of the aisle path.
End X	X value of the end co-ordinate of the aisle path.
End Y	Y value of the end co-ordinate of the aisle path.
Numbering Direction	This is for future development, and thus not currently available in this version of ProTrack Warehouse. This is a mandatory field, so populate with the default value from the table above.
Numbering Scheme	This is for future development, and thus not currently available in this version of ProTrack Warehouse. This is a mandatory field, so populate with the default value from the table above.
Travel Rule	This is for future development, and thus not currently available in this version of ProTrack Warehouse. This is a mandatory field, so populate with the default value from the table above.
path_access_rule	This is for future development, and thus not currently available in this version of ProTrack Warehouse. This is a mandatory field, so populate with the default value from the table above.

^{Table 39. Aisle Path Field Descriptions}

Tips

Aisle Path name and ID are recommended to be the same.
Aisle Paths 1-FLR1-104 and 1-FLR1-104a should be two Aisle Paths as they are divided by a non-passable fence, even though they are both vertical Aisle Paths with the same X coordinates.
Aisle Paths must be configured at 90-degree angles. Two aisle paths cannot converge at a single point and both be horizontal or both be vertical. In these cases, the two should just be treated as one Aisle Path.
Aisle Paths cannot be built on the edge of a Floor, so make sure the Floor is larger than the location of the Aisle Paths.

{anchor:

Site Navigation

Child pages

Floor

Aisle Paths