curate shipped catalog and clarify subtype import docs
Rework the seed catalog from the cleaned live DB: dedupe Dell vendor/model rows, strip vendor names out of model numbers, add missing models, assign model types across printer and equipment lines, add a Controller type, and split a mashup HP LaserJet row into six real models. Now 44 vendors, 172 models, 173 modelsupplies. Also document that assets.csv needs its subtype file to appear in typed list views, and ignore devnotes/ scratch.
This commit is contained in:
3
.gitignore
vendored
3
.gitignore
vendored
@@ -83,3 +83,6 @@ scripts/site_imports/wjf/idmap.json
|
||||
|
||||
# work-PC publication clone: bundle drop folder for the transfer pipeline
|
||||
_transfer/
|
||||
|
||||
# Local developer scratch notes and chat handoffs - never committed
|
||||
devnotes/
|
||||
|
||||
@@ -4,6 +4,24 @@ Short version: one CSV per table, a header row of exact column names, one record
|
||||
per row. The importer matches on natural keys, so re-importing updates instead of
|
||||
duplicating.
|
||||
|
||||
## IMPORTANT: assets.csv alone will NOT show up in the lists
|
||||
|
||||
An `assets.csv` row only creates the base asset record. A computer, machine, or
|
||||
measuring tool does NOT appear in its list view (PCs, Machines, Measuring Tools)
|
||||
until its matching subtype row is also imported:
|
||||
|
||||
- A computer asset needs a row in `computers.csv` (`assetid` = the asset's
|
||||
`assetnumber`) before it shows under PCs.
|
||||
- A machine asset needs a row in `machines.csv` before it shows under Machines.
|
||||
- A measuring-tool asset is managed by the Measuring Tools plugin, not the native
|
||||
subtype importer, so it will exist as an asset but will not appear in the
|
||||
Measuring Tools list from `assets.csv` alone.
|
||||
|
||||
So always import the subtype file (`computers.csv` / `machines.csv`) right after
|
||||
`assets.csv`. Importing only `assets.csv` leaves the records invisible in the
|
||||
typed lists even though they are in the database. (The Azure and Thor imports do
|
||||
both steps automatically, which is why Azure/Thor PCs appear immediately.)
|
||||
|
||||
## Rules for hand-built native CSVs
|
||||
|
||||
1. First row is the header. Use the exact column names below, lowercase, no spaces.
|
||||
@@ -26,7 +44,8 @@ machinetypes, businessunits, locations, vendors, models, operatingsystems, asset
|
||||
computers, machines.
|
||||
|
||||
An asset row must exist before its `computers`/`machines` subtype row: the subtype
|
||||
links back with `assetid` (the asset's `assetnumber`).
|
||||
links back with `assetid` (the asset's `assetnumber`). Import the subtype file in
|
||||
the same session so the item appears in its list (see the IMPORTANT note above).
|
||||
|
||||
## Columns (REQUIRED in bold)
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user