CSV-import

Raskeste måten å fylle en fersk organisasjon på er en CSV-import — selvbetjeningsveien de fleste nye kunder tar. Én opplasting kan bære produkter, serialiserte gjenstander, antallsbeholdning og måleravlesninger samtidig. Du kjører den fra Admin → Import; den krever tillatelsene products.create og items.create.

Én fil, en «kind»-kolonne

Hver rad starter med en kind-kolonne som sier hva den er — product, item, stock eller reading (flertallsformene fungerer også). Én fil kan blande alle fire. Importen kjører i to pass, så en gjenstands- eller beholdningsrad kan referere til et produkt definert hvor som helst i samme fil — før eller etter — via navn (og modell) eller en kort ref du tildeler. Produkter matches på navn + modell og er idempotente: et som allerede finnes, hoppes over med en advarsel, ikke duplisert.

De fire radtypene

Den nøyaktige overskriftsraden for hver type:

kind,name,manufacturer,model,category,tracking_mode,description,url,ref,department

kind,product,product_model,product_ref,serial_number,condition,location,purchase_date,purchase_price,currency,supplier,notes

kind,product,product_model,product_ref,location,quantity,min_quantity,unit

kind,asset_tag,meter,value,read_at,note

Last ned en mal

Fra Admin → Import bruker du Last ned mal-knappene for å få en ferdig CSV med overskriftsraden på plass — én hver for produkter, gjenstander og beholdning. Fyll den ut i et regneark, eksporter som CSV (UTF-8), og last opp. Samme skjerm tilbyr også et startbibliotek med maler for vanlig sceneutstyr, så en liten organisasjon kan hoppe over regnearket helt.

Lokasjoner og kategorier via navn

Legg inn lokasjoner og kategorier som navnestier med / mellom nivåene — f.eks. Hovedscene / Rack B. En sti som allerede finnes, matches (uten hensyn til store/små bokstaver); en ukjent sti er en feil med mindre du huker av for opprett manglende, som lager nodene forelder-først. Å opprette lokasjoner krever locations.manage; å opprette kategorier krever admin.taxonomy.manage.

Hvordan validering fungerer

• To steg. Du laster opp, får en rad-for-rad-rapport (hver rad merket ok, warning eller error), og bekrefter. Bekreftelsen kjører samme validering på serveren — ingenting endres før du bekrefter.
• Feil blokkerer filen. Ingenting importeres mens noen rad har feil, med mindre du velger å hoppe over feilrader og bare importere de rene.
• Advarsler importeres likevel — et duplikatprodukt som hoppes over, eller en sti som vil opprettes, er en advarsel, ikke en stopp.
• Opptil 2000 rader per fil (importer kjører synkront innenfor Workerens grenser). Del et større datasett over flere filer.

Feltregler