# Prüflinge

## Was ist das?

Prüflinge (DUTs, "Devices under Test") sind die physischen Objekte, die in
Testsequenzen geprüft werden — mit Typ, Status, Teile-/Seriennummer und
optional Barcode-Scan über die Chain of Custody. Die Übersicht listet alle
Prüflinge der Organisation.

## So benutzt man es

- **Anlegen:** *Neuer Prüfling* oben auf der Seite. Typ wählen; die
  Eigenschaften des Typs (Einstellungen → Prüfling-Typen) werden zum Ausfüllen
  angeboten.
- **Projekt-Spalte:** Zeigt, in welchen Projekten der Prüfling über seine
  Testsequenzen tatsächlich verwendet wird (bei mehreren: die ersten, danach
  zusammengefasst als „+N weitere", vollständige Liste im Tooltip). Ein
  Prüfling ohne zugeordnete Testsequenz zeigt hier „–".
- **Filtern:** Über die Auswahlmenüs oberhalb der Tabelle lässt sich nach
  Projekt und nach Prüfling-Typ filtern, zusätzlich zur Freitextsuche.
- **Zusätzliche Spalten:** Der Button „Spalten" öffnet eine Auswahl aller
  Typ-Eigenschaften über alle Prüflingstypen der Organisation hinweg. Jede
  ausgewählte Eigenschaft erscheint als eigene Spalte; Prüflinge, deren Typ
  diese Eigenschaft nicht kennt, zeigen dort „–". Die Auswahl gilt nur für
  den eigenen Account.
- **CSV-/Excel-Import und -Export:** „Exportieren" oben auf der Seite liefert
  alle Prüflinge als CSV oder Excel (.xlsx), inklusive Typ und aller
  definierten Eigenschaften (Typ- und globale Eigenschaften, je eine Spalte
  `property_<Schlüssel>`). „Importieren" liest dieselbe Struktur wieder ein.
  Der Typ wird über die Spalte `type` per Namensvergleich aufgelöst
  (Groß-/Kleinschreibung egal); ein nicht gefundener Typname führt zu einer
  Warnung nach dem Import, der Prüfling wird trotzdem ohne Typ angelegt.
  Zeilen ohne Namen werden übersprungen. Pflichteigenschaften werden beim
  Import nicht erzwungen.
- **Import-Vorschau:** Nach der Dateiauswahl öffnet sich zunächst eine
  Vorschau — es wird noch nichts gespeichert. Sie zeigt je Zeile, ob ein
  neuer Prüfling angelegt oder ein vorhandener aktualisiert wird (oder die
  Zeile übersprungen wird), sowie Auffälligkeiten wie ungültiger Status,
  unbekannter Typ, ungültige Eigenschaftswerte oder unbekannte ID. Bei einer
  Aktualisierung listet die Vorschau zusätzlich jedes tatsächlich geänderte
  Feld einzeln auf (alter Wert → neuer Wert, inklusive Eigenschaften) — Felder
  ohne Änderung erscheinen nicht. Bei sehr grossen Dateien zeigt die Vorschau
  nur die ersten 200 Zeilen im Detail; die
  Summenzahlen oben gelten trotzdem für alle Zeilen. Erst ein Klick auf
  „Einträge importieren" schreibt die Daten; „Abbrechen" verwirft die Datei
  ohne Änderungen.
- **Bearbeiten per Export → Import (kein Duplikat):** Die exportierte Datei
  enthält in der ersten Spalte die ID jedes Prüflings. Wird eine so
  exportierte Datei bearbeitet — Werte geändert, neue Zeilen mit leerer
  ID-Spalte angehängt — und wieder importiert, aktualisiert der Import Zeilen
  mit bekannter ID den vorhandenen Prüfling, statt einen zweiten anzulegen;
  nur Zeilen ohne (oder mit unbekannter) ID legen einen neuen Prüfling an.
  Damit lässt sich der komplette Datenbestand als Tabelle pflegen. Eine
  unbekannte ID (z. B. aus einer anderen Organisation oder ein bereits
  gelöschter Prüfling) wird als neuer Eintrag angelegt und in der
  Erfolgsmeldung gemeldet.
- **Status ändern:** Auf der Detailseite ein Klick auf das Status-Badge neben
  dem Namen öffnet die Statusauswahl direkt — ohne den Umweg über das
  Bearbeiten-Formular. Für mehrere Prüflinge gleichzeitig über die
  Mehrfachauswahl in der Tabelle.
- **Automatischer Status:** Sobald ein zugeordneter Prüfschritt beginnt, wechselt
  der Prüfling zu „In Prüfung“. Sind alle Prüfschritte über alle aktiven
  Sequenzen terminal (bestanden, fehlgeschlagen, übersprungen oder abgebrochen),
  wechselt er zu „Geprüft“. „Archiviert“ wird nie automatisch überschrieben.
- **Barcode-Scan / Nachweiskette:** Siehe `chain-of-custody`.
- **Fotos:** Auf der Detailseite lassen sich bis zu 2 Fotos hochladen (PNG
  oder JPG, je maximal 5 MB). „Foto auswählen" öffnet einen Dialog mit Titel
  (Pflicht), optionaler Beschreibung und Dateiauswahl — hochgeladen wird erst
  beim Bestätigen im Dialog. Diese Fotos erscheinen automatisch auf der
  Prüflingsseite jedes Projektberichts, der diesen Prüfling verwendet (siehe
  `berichte`).

## Typische Probleme

- **„Ein Prüfling zeigt kein Projekt, obwohl er benutzt wird."** Die Spalte
  liest nur *nicht-archivierte* Testsequenzen (keine Vorlagen); prüfen Sie, ob
  die betreffende Sequenz einem Projekt zugeordnet ist.
- **„Der Projekt-Filter findet einen Prüfling nicht."** Der Filter grenzt auf
  Prüflinge ein, die mindestens eine aktive (nicht gelöschte) Testsequenz in
  diesem Projekt haben — reine Vorlagen zählen nicht.
- **„Maximale Anzahl Fotos erreicht."** Ein Prüfling erlaubt maximal 2 Fotos.
  Erst ein vorhandenes Foto entfernen, dann das neue hochladen.
- **„Nur gültige PNG- und JPEG-Dateien werden unterstützt."** Ein anderes
  Dateiformat (z. B. PDF, HEIC) wurde ausgewählt — als PNG oder JPG
  exportieren und erneut hochladen.
- **„Beim Import wurden weniger Prüflinge angelegt als erwartet."** Zeilen
  ohne Namen werden übersprungen — die Anzahl steht in der Meldung nach dem
  Import.
- **„Eine Eigenschaft aus meiner Import-Datei fehlt am importierten
  Prüfling."** Entweder war der Wert für den Feldtyp ungültig (z. B. Text in
  einer Zahlen-Eigenschaft) — das meldet der Import als „Eigenschaftswerte
  ungültig" — oder die Spalte ist keine bekannte Eigenschaft dieses Typs bzw.
  keine globale Eigenschaft; dann taucht sie unter „Unbekannte Spalten
  ignoriert" auf.
- **„Datei konnte nicht gelesen werden."** Entweder ist die Datei beschädigt
  oder trotz .xlsx-Endung keine echte Excel-Datei, oder sie enthält ungültige
  Zeichen (z. B. durch einen fehlerhaften Export/Encoding) — in beiden Fällen
  wird nichts importiert.
- **„Nach dem Re-Import gibt es den Prüfling doppelt."** Prüfen Sie, ob die
  ID-Spalte in der bearbeiteten Datei erhalten geblieben ist — wird sie
  gelöscht oder geleert, behandelt der Import die Zeile als neuen Prüfling.
- **„Eine Änderung an einem leeren Status-Feld hat den Status
  zurückgesetzt."** Bei einer Zeile mit bekannter ID bleibt ein leeres
  Status-Feld unangetastet; ein *ungültiger* Wert (z. B. ein Tippfehler) wird
  ebenfalls nicht übernommen, aber als „ungültiger Status" gemeldet — nur ein
  gültiger neuer Status wird tatsächlich gesetzt.

---

Quelle: https://www.testlabiq.com/hilfe/pruefling