You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/infrastructure-management/parts-and-parts-slots/importing-part-models.mdx
+76-35Lines changed: 76 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,70 +3,111 @@ title: "Importing Part Models"
3
3
sidebar_position: 1
4
4
---
5
5
6
-
This document explains how to import part models using API Imports. For detailed explanation of Part Models and Parts, please see: [infrastructure-management/parts-and-parts-slots/part-model-templates.md](infrastructure-management/parts-and-parts-slots/part-model-templates.mdx)
6
+
importThemedImagefrom'@theme/ThemedImage'
7
+
importuseBaseUrlfrom'@docusaurus/useBaseUrl'
7
8
8
-
### Data example
9
+
This document explains how to import part models using API Imports. For a detailed explanation of part models and parts, see the [Part Model Templates](infrastructure-management/parts-and-parts-slots/part-model-templates.mdx).
The sample data in the spreadsheet (pictured above) is our starting point for this import. This data was exported from a legacy system into .csv format.
13
+
The sample data in the spreadsheet below is our starting point for this import. This data was exported from a legacy system into CSV format.
13
14
14
-
### Download sample spreadsheet
15
+
Create or update spare parts models - Download Sample Excel File
20
-
Open the sample file
19
+
Navigate to **Tools > Imports/Exports (xls)**, find **Part Models - Create/Update Part Models**, and click **Download Sample Excel File**. Open the sample file to begin the import process.
Note: hover-over column heading to reveal comments that specify usage, e.g.: required, optional or details (pictured below)
31
+
Hover over the upper-right corner of the heading cell in each column to see details about the field. These tooltips indicate whether fields are required, optional, or provide additional context.
Note: the additional Part model type parameters for CPU, RAM, and HDD. Note: typeis required.
35
+
The spreadsheet includes additional part model type parameters specific to CPU, RAM, and hard disk components. The `type` field is required for all part models.
31
36
32
-
### Populating the sample sheet
37
+
33
38
34
-
39
+
## Populating the Sample Sheet
35
40
36
-
The image above shows the sample spreadsheet that has been updated to include the data from our .csv export. These being new part models, only typeis required. The parameters not being used have been deleted from the sheet (alternatively they can be left blank).
41
+
Update the sample spreadsheet with your part model data from the CSV export. Since these are new part models, only the `type` field is required. You can delete unused parameters from the sheet or leave them blank.
37
42
38
-
Note the additional parameters added for CPU and RAM models
43
+
39
44
40
-
Save the file.
45
+
Notice the additional parameters that have been added for CPU and RAM models.
41
46
42
-
###Choose file and import
47
+
## Choose File and Import
43
48
44
-
49
+
Navigate to **Tools > Imports/Exports (xls)**, browse to your populated file, and select **Import** to begin the import process.
45
50
46
-
Go to: Tools>Imports/Exports (.xls) - choose the file and select Import.
Device42 displays the status of the import. If there are any issues, the results will show "The following were not added..." with specific error details. Review the results carefully, as any problems (such as missing required parameters) are usually clearly stated.
51
62
52
-
Results of parts model import. If there is a problem with the import the results will show "The following were Not added..." Should there be a problem, be sure to review the body of the results as the cause is usually stated clearly, e.g.: missing parameter
Copy file name to clipboardExpand all lines: docs/infrastructure-management/parts-and-parts-slots/importing-parts.mdx
+70-36Lines changed: 70 additions & 36 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,73 +3,107 @@ title: "Importing Parts"
3
3
sidebar_position: 2
4
4
---
5
5
6
-
This document explains how to import parts using the Spreadsheets Import tool found in the Tools menu.
6
+
importThemedImagefrom'@theme/ThemedImage'
7
+
importuseBaseUrlfrom'@docusaurus/useBaseUrl'
7
8
8
-
### Importing part models vs. importing parts
9
+
This document explains how to import parts using the Spreadsheets Import tool found under **Tools > Imports/Exports (xls)**.
9
10
10
-
11
+
## Importing Part Models vs. Importing Parts
11
12
12
13
Please see [Managing Spare Parts](infrastructure-management/parts-and-parts-slots/part-model-templates.mdx) for an explanation of part models vs. parts in Device42.
13
14
14
-
Part models can be created using the create or update spare parts import. The parts import can do both models and parts. The create or update spare parts models import can only create models.
15
+
Both parts and part models can be created using the **Parts - Create/Update Parts**import, whereas the **Part Models - Create/Update Part Models**import only creates models.
25
+
## Download Current Data
19
26
20
-
This document will demonstrate adding parts to existing part models - building on the imported models covered in the [Importing Part Models document](infrastructure-management/parts-and-parts-slots/importing-part-models.mdx).
27
+
This document demonstrates how to add parts to existing part models, building on the imported models covered in the [Importing Part Models document](infrastructure-management/parts-and-parts-slots/importing-part-models.mdx).
21
28
22
-
Tools>Imports/Exports (.xls) - download current data for spare parts models as highlighted above
29
+
Go to **Tools > Imports/Exports (xls)** and download the current data for spare part models as highlighted below.
We will use the data from the current data export to help populate the parts import.
59
+
## Populate the Sample Sheet
41
60
42
-
### Populating the sample sheet
61
+
Add a column for `partmodel_id` and populate the sample spreadsheet to add new parts to two of the existing part models you created. Add the serial numbers manually or using a laser handheld scanner (see below).
43
62
44
-
63
+
This import creates the following:
45
64
46
-
Using the current data export, we have copied the partmodel\_id for the new parts we are going to create
65
+
- For `partmodel_id``211` (name `3.5" 2TB Dell Drives`): Four line items with assignments and serial numbers (unique line items are required to track serial numbers)
47
66
48
-
- Name or partmodel\_id is required. Type is optional. part\_id is required for updating existing parts
49
-
- Added the serial numbers - this can be accomplish manually or via laser handled scanner (see below)
67
+
- For `partmodel_id``219` (name `4GB PC3 8500R`): Two line items with assignments (since you don't need to track serial numbers for these items, you are only tracking room assignment and count)
50
68
51
-
This import will create the following:
69
+
Save the file and import it.
52
70
53
-
ID 39 (3.5" 2TB Dell Drives) 4 line items with assignments and serial numbers. Unique line items are required to track serial numbers.
71
+
54
72
55
-
ID 47 (4GB PC3 8500R) 2 line items with assignments. Since we don't care about serial numbers for these items, we are only tracking room assignment and count.
73
+
## Handheld Scanner
56
74
57
-
Save the file and import.
75
+
You can use a DBPOWER scanner purchased on Amazon, which works well for this purpose. It comes with a USB receiver and can be programmed to automatically go to the next row in Excel, making it very quick and easy to capture serial numbers or other bar codes.
58
76
59
-
Re: handheld laser scanner. We have been using a DBPOWER scanner that we purchased on amazon for $60 (link below) - we think it works great. It comes with USB receiver and can be programmed to automatically go to the next row in Excel, making it very easy and quick to grab serial numbers or other bar codes.
77
+
## Import Results
60
78
61
-
### Importresults
79
+
Go to **Tools > Imports/Exports (.xls)**, choose your file, and click **Import**. The results of the import are shown below.
The new parts on separate line items - again these are unique line items as we are tracking serial numbers.
101
+
The new parts appear on two lines. Since you're not tracking serial numbers, you only need two lines to track the room assignments for these RAM modules.
0 commit comments