Wie importiere ich Assets aus einer CSV-Datei?

Ab Tarif Basic

Kurzantwort

Lade unter Import & Export die Beispiel-CSV herunter, fülle sie mit deinen Assets und lade sie wieder hoch. Pflicht sind nur die Spalten asset_type und name; alle weiteren Spalten sind optional. Notory prüft jede Zeile einzeln, überspringt ungültige und importiert den Rest. Die Spaltenüberschriften müssen den Feldnamen entsprechen (asset_type, serial_number, … aber nicht „Typ” oder „Seriennummer”).

Voraussetzungen

Import ist im Basic-Tarif enthalten. Beachte das Asset-Limit deiner Lizenz.

Vorlage herunterladen. Öffne den Bereich Import & Export (Route /data) und klicke auf „Beispiel-CSV herunterladen”. Die Vorlage enthält alle unterstützten Spalten und eine Beispielzeile. So siehst du die exakten Feldnamen.

Screenshot ausstehend import-export-csv-01 Import-Bereich mit Schaltfläche 'Beispiel-CSV herunterladen' und Upload-Feld

Der Import-Bereich mit Vorlagen-Download und Datei-Upload.

CSV befüllen. Trage deine Assets ein. Ein minimales, gültiges Beispiel:

asset_type,name,serial_number,manufacturer,model,status,location,department
hardware,ThinkPad T14 – Vertrieb,PF-3X9K2L,Lenovo,T14 Gen 4,active,Büro München / Raum 2.14,Vertrieb
network,Core-Switch 01,SG-88213,Cisco,Catalyst 9300,active,Rechenzentrum / Rack A1,IT
software,Adobe Photoshop,,Adobe,2026,active,,Marketing

asset_type (Pflicht): einer von hardware, software, network, certificate, license, peripheral.
name (Pflicht): darf nicht leer sein.
status (optional): Standard ist active.

Datei hochladen. Ziehe die CSV in das Upload-Feld („Datei hierher ziehen oder klicken zum Durchsuchen”) oder wähle sie aus. In der Vorschau siehst du die erkannten Zeilen.
Import starten. Klicke auf „Import starten”. Nach Abschluss meldet Notory, wie viele Datensätze importiert und wie viele übersprungen wurden.

Screenshot ausstehend import-export-csv-02 Import-Ergebnis mit Anzahl importierter und übersprungener Datensätze

Das Import-Ergebnis: importierte und übersprungene Datensätze.

Zuerst die Vorlage ziehen (zeigt alle importierbaren Spalten):

curl -H "Authorization: Bearer inv_dein_token" \
  https://demo.notory.io/api/v1/assets/import/template.csv \
  --output asset-import-template.csv

Dann die ausgefüllte CSV als Datei-Upload (multipart/form-data, Feld file) hochladen:

curl -X POST https://demo.notory.io/api/v1/assets/import \
  -H "Authorization: Bearer inv_dein_token" \
  -F "file=@assets-import.csv"

Antwort HTTP 200 mit der Anzahl erfolgreich angelegter Assets:

{
  "message": "Successfully imported 2 assets",
  "data": { "count": 2 }
}

Notory erkennt CSV an der Endung .csv. Ungültige Zeilen zählen nicht mit. Im Beispiel wurde eine dritte Zeile übersprungen, weil sie die Validierung nicht bestand.

Mögliche Fehler: 401 (Token fehlt/ungültig). Einzelne fehlerhafte Zeilen führen nicht zu einem Fehlercode, sondern werden still übersprungen.

Was passiert dabei?

Zeilenweise Validierung: Jede Zeile wird gegen das Asset-Schema geprüft. Schlägt sie fehl, wird nur diese Zeile übersprungen (protokolliert), der Rest läuft durch. Die Antwort nennt die Zahl der erfolgreich importierten Assets.
Pflichtfelder: asset_type (gültiger Typ-Wert) und name (nicht leer). Fehlen sie oder sind ungültig, wird die Zeile verworfen.
Vorsicht bei leeren Zellen in typisierten Spalten: Optionale Datums- (purchase_date, warranty_expiry), Zahlen- (purchase_cost) und Auswahlfelder (status, data_classification) vertragen keine leeren Zeichenketten. Lass solche Spalten lieber ganz weg, statt die Zelle leer zu lassen, sonst kann die ganze Zeile übersprungen werden. Leere Textfelder (z. B. serial_number) sind unproblematisch.
Spaltennamen = Feldnamen: Die Kopfzeile muss die technischen Feldnamen tragen (asset_type, serial_number, …). Unbekannte Spalten werden ignoriert. Du kannst daher auch eine zuvor exportierte Datei erneut einlesen (die Spalte id wird dabei ignoriert).
Keine Dublettenprüfung: Jede gültige Zeile wird als neues Asset angelegt. Importierst du dieselbe Datei zweimal, entstehen Duplikate. Es gibt keinen Abgleich über Name oder Seriennummer.
Kodierung: UTF-8 wird erwartet; ein vorangestelltes BOM wird automatisch entfernt. Umlaute in Werten sind erlaubt.