Wie suche und filtere ich Assets?

Ab Tarif Basic

Kurzantwort

In der Asset-Übersicht tippst du einfach ins Suchfeld. Die Liste filtert live über Name, Seriennummer und Hersteller. Über „Filter” grenzt du zusätzlich nach Typ, Status und Abteilung ein. Per API übergibst du dieselben Kriterien als Query-Parameter an GET /api/v1/assets.

Voraussetzungen

Das Asset-Modul ist im Kern enthalten und in allen Tarifen verfügbar.

Suchen. Öffne Assets und tippe in das Suchfeld. Die Liste aktualisiert sich während der Eingabe (leicht verzögert). Gefunden wird über Name, Seriennummer und Hersteller. Groß-/Kleinschreibung spielt keine Rolle, Teiltreffer genügen.

Screenshot ausstehend assets-suchen-01 Asset-Übersicht mit Suchfeld und der Schaltfläche 'Filter'

Das Suchfeld filtert die Liste live; daneben die Schaltfläche 'Filter'.
Filter setzen. Klicke auf „Filter”. Es öffnen sich die erweiterten Filter: Typ (Hardware, Software, Netzwerk, Zertifikat, Lizenz, Peripheriegerät), Status (Aktiv, Inaktiv, Wartung …) und Abteilung. Alle Kriterien wirken kombiniert. „Filter zurücksetzen” löscht alles auf einmal.

Screenshot ausstehend assets-suchen-02 Geöffnete erweiterte Filter mit Auswahllisten für Typ und Status sowie dem Feld Abteilung

Die erweiterten Filter: Typ, Status und Abteilung, kombinierbar mit der Suche.
Ergebnis nutzen. Ein Klick auf eine Zeile öffnet die Detailansicht. Über die Kontrollkästchen wählst du mehrere Assets aus und kannst sie gesammelt exportieren oder löschen. Am Tabellenende blätterst du durch die Seiten und stellst die Seitengröße ein.

Alle Kriterien sind Query-Parameter von GET /api/v1/assets (Scope read):

Parameter	Wirkung
`search`	Teiltreffer über Name, Seriennummer, Hersteller (Groß-/Kleinschreibung egal)
`asset_type`	exakter Typ: `hardware`, `software`, `network`, `certificate`, `license`, `peripheral`
`status`	exakter Status: `active`, `inactive`, `maintenance`, `retired`, `disposed`
`department`	exakte Abteilungsbezeichnung
`location`	Teiltreffer im Standort
`page`, `page_size`	Seitenblätterung (Standard 25, Maximum 100 pro Seite)

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/assets?search=thinkpad&asset_type=hardware&status=active&page=1&page_size=50"

{
  "items": [
    {
      "id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
      "name": "ThinkPad T14 – Vertrieb",
      "asset_type": "hardware",
      "status": "active",
      "serial_number": "PF-3X9K2L",
      "manufacturer": "Lenovo"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 50,
  "total_pages": 1
}

Das gefilterte Ergebnis lässt sich auch direkt exportieren, als CSV oder JSON (Filter asset_type und status werden unterstützt):

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/assets/export?fmt=csv&asset_type=hardware&status=active" \
  --output assets.csv

Mögliche Fehler: 422 (ungültige Parameter, z. B. page_size über 100), 401 (Token fehlt/ungültig).

Was passiert dabei?

Suchfelder: Die Volltextsuche greift auf Name, Seriennummer und Hersteller (Teiltreffer, unabhängig von Groß-/Kleinschreibung). Abteilung filtert exakt, Standort per Teiltreffer.
Papierkorb bleibt außen vor: Gelöschte (im Papierkorb liegende) Assets tauchen in Suche, Filterung und Export nicht auf.
Sortierung: Die Liste ist standardmäßig nach Erstellungsdatum sortiert: neueste zuerst. In der Weboberfläche kannst du per Klick auf die Spaltenköpfe umsortieren.
Seitenblätterung: Die API liefert total, page, page_size und total_pages mit, damit lassen sich alle Seiten sauber abarbeiten.
Mandanten-Isolation: Du siehst ausschließlich Assets deines Mandanten.