Wie importiere und exportiere ich Daten?

Ab Tarif Basic

Kurzantwort

Über Import & Export (Route /data) legst du viele Assets auf einmal an oder ziehst deinen Bestand heraus. Der Import akzeptiert CSV und JSON; als Vorlage gibt es eine Beispiel-CSV mit allen unterstützten Spalten. Der Export liefert deine Assets als CSV oder JSON, optional gefiltert nach Typ und Status. Pflicht beim Import sind nur Typ (asset_type) und Name.

Voraussetzungen

Benötigte Rolle Angemeldeter Benutzer (typischerweise Administrator oder Asset-Manager)

Import und Export stehen jedem angemeldeten Benutzer offen; in der Praxis sind es Aufgaben eines Administrators oder Asset-Managers. Programmatisch genügt ein gültiger Bearer-Token.

Import/Export sind Teil des Assets-Kerns und in allen Tarifen enthalten. Zu beachten ist das Asset-Limit deiner Lizenz: Ein sehr großer Import kann es überschreiten.

Überblick

GUI (Weboberfläche)

1. Bereich „Import & Export” öffnen. Wähle in der linken Navigation den Bereich für Daten (Route /data). Hier findest du das Hochlade-Feld für den Import und die Schaltflächen zum Export.

   Screenshot ausstehend import-export-uebersicht-01 Import-/Export-Seite mit Datei-Upload und Export-Schaltflächen

   Die Import-/Export-Seite mit Upload-Bereich und Export-Optionen.

2. Richtung wählen. Zum Importieren lädst du eine CSV-/JSON-Datei hoch; zum Exportieren wählst du das Format und lädst die Datei herunter. Die Details stehen in den verlinkten Anleitungen unter Verwandte Themen.

API (curl)

Die Endpunkte liegen unter dem Assets-Präfix /api/v1/assets:

• Import: POST /api/v1/assets/import (Datei-Upload, CSV oder JSON)
• Vorlage: GET /api/v1/assets/import/template.csv
• Export: GET /api/v1/assets/export?fmt=json|csv

Bestand als JSON exportieren

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/assets/export?fmt=json" \
  --output assets.json

Was passiert dabei?

• Kein eigenes Lizenz-Gate: Import/Export hängen an den Assets und sind nicht extra gestaffelt. Sie funktionieren ab Basic.
• Import legt neu an: Jede gültige Zeile wird als neues Asset gespeichert. Es gibt keine automatische Dublettenprüfung: Ein zweiter Import derselben Datei erzeugt Duplikate. Details unter CSV-Import.
• Fehlertoleranz: Ungültige Datensätze werden übersprungen, die übrigen importiert. Der Import bricht nicht komplett ab.
• Nur eigener Mandant: Export liefert ausschließlich Assets deines Mandanten (ohne Papierkorb); Import legt in deinem Mandanten an.

Verwandte Themen

• Assets aus einer CSV-Datei importieren
• Per JSON importieren & exportieren
• Bestand für ein Backup exportieren
• Wie lege ich ein Asset an?: einzelnes Asset über die Oberfläche
• API-Einstieg