Hilfe & Dokumentation
Offline-fokussierte Hinweise für sichere Equipment-Listen.
Barcode-Scanning
Kamera- und HID-Scanning bei Untervermietungs-Übergaben, in der Vorbereitungs-Checkliste, beim Hinzufügen von Equipment und beim Label-Druck
Barcode-Scanning ist eine Funktion, keine eigenständige Seite. Es steckt in der Untervermietungs-Scanner-Ansicht und den Liefer- und Rückgabescheinen (Ein-/Auschecken bei der Übergabe), in der Vorbereitungs-Checkliste des Projekts, und in „QR scannen zum Hinzufügen“ einer Gerätelisten-Kategorie; die QR-Etiketten, die es liest, werden an einem eigenen Gerät oder Geräteset gedruckt. Im Browser liest die Kamera des Geräts die Codes; die iPhone- und Android-App nutzen den Scanner des Telefons; USB-/Bluetooth-Scanner, die wie eine Tastatur tippen, werden überall auf der Seite erkannt.
Wo Scanning verfügbar ist
Scanning ist in bestimmte Flows verdrahtet. Es gibt keine globale 'Tracker'-Seite.
- Untervermietungs-Scanner-Ansicht — Equipment gegen die Items der Transaktion ein-/auschecken.
- Liefer- und Rückgabescheine der Untervermietung — „Geräte scannen“ über der Übergabe-Checkliste hakt die Zeile ab, zu der ein gescannter QR-Code oder eine Seriennummer gehört; „Scan füllt“ wählt, welche Spalte ein Scan abhakt.
- Vorbereitungs-Checkliste des Projekts — „Scannen zum Abhaken“ hakt den Vorbereitungspunkt des gescannten Geräts ab.
- Gerätelisten-Kategorie → „QR scannen zum Hinzufügen“ — die Kamera liest ein Geräte-QR-Etikett und fügt das Gerät (oder nach Bestätigung ein ganzes Geräteset) der Kategorie hinzu. Das geht nur mit der Kamera.
- QR-Etiketten selbst werden einzeln gedruckt: „Etikett drucken“ im Editor eines eigenen Geräts oder „Set-Etikett drucken“ im Editor eines Gerätesets.
- Scanner-Ansicht, die Scan-Leisten der Scheine und die Vorbereitungs-Checkliste teilen sich dieselbe Eingabe für Hardware-Scanner und Kamera — das Verhalten ist überall gleich.
- Drei Eingaben, ein Vokabular: Diese drei Oberflächen bieten einen Hardware-/Keyboard-Wedge-Scanner, die Telefonkamera und das Antippen eines NFC-Tags. Alle drei speisen denselben Abgleich, ein Tag, ein Barcode und ein getippter Code werden also identisch aufgelöst. Die NFC-Schaltfläche erscheint nur dort, wo Web NFC existiert — Android Chrome über https — und fehlt auf Desktop, unter iOS und über einfaches http schlicht, statt als tote Schaltfläche angezeigt zu werden. Wird die NFC-Berechtigung abgelehnt, gilt das als Abbruch, nicht als Fehler. NFC liest ein Tag pro Antippen aus wenigen Zentimetern; einen geschlossenen Flightcase liest es nicht im Bulk.
Tipps
- Wer eine 'Tracker'-Seite sucht, nutzt das Scannen innerhalb einer Untervermietungs-Transaktion — das ist das nächste Äquivalent.
- Es gibt keinen 'Scan-um-irgendein-Gerät-zu-finden'-Lookup — Scanning ist immer auf eine Transaktion, eine Checkliste, eine Gerätelisten-Kategorie oder ein Label begrenzt.
Kamera, HID und native Scanner
Drei Eingabewege decken Desktop und Mobile ab.
- Kamera-Scanner
- Vollbild-Sucher. Bevorzugt die rückseitige Kamera.
- Hardware-Scanner (USB / Bluetooth)
- Hört auf USB-/Bluetooth-Scanner, die als Tastatur erscheinen. Der Fokus muss nicht in einem Textfeld liegen — aber Tippen in einem anderen Eingabefeld hat Vorrang.
- Nativer Scanner (nur iPhone- und Android-App)
- Die iPhone- und die Android-App nutzen den Barcode-Scanner des Telefons; das ist schneller und schont den Akku.
Tipps
- Die Kamera fragt beim ersten Öffnen nach Berechtigung — annehmen, sonst bleibt die Vorschau schwarz.
- USB-Scanner mit Tastenanschlag funktionieren überall auf der Seite — solange kein anderes Eingabefeld aktiv ist.
- Haptisches Feedback feuert pro Scan (Erfolg / Warnung / Fehler) auf Geräten, die die Vibration-API unterstützen.
Wie ein Scan auflöst (Untervermietungs-Check-In)
In der Untervermietungs-Scanner-Ansicht wird ein gescannter Code in dieser Reihenfolge nachgeschlagen — der erste Treffer gewinnt.
- Doppelt-gescannt-Schutz: Der gescannte Code wird zuerst getrimmt und dann mit dem verglichen, was in der Transaktion schon eingecheckt ist — ein zusätzliches Leerzeichen aus dem Prefix/Suffix eines Scanners gilt nicht mehr als anderes Label. Dieselbe Einheit erneut zu scannen wird daher mit 'bereits gescannt' abgelehnt, statt einen zweiten Platz zu belegen.
- Ein von der App gedrucktes QR-Etikett nennt sein Gerät direkt — aktuelle Etiketten als Link, Etiketten aus älteren Versionen als Code der Form 'cpp:gear:…'.
- Jeder andere Code wird mit Inventarnummer, RFID-Tag-ID und Seriennummern deiner eigenen Geräte verglichen. Die am Gerät eingetragene Inventarnummer (Asset Tag) ist damit scanbar — trage dort die Nummer deines Inventaraufklebers ein. Ein am Gerätedatensatz leer gelassenes Feld trifft nie zu — eine fehlende Seriennummer ist kein Code.
- Das so gefundene Gerät wird mit den Items der Transaktion abgeglichen (nur mit Items, die noch nicht vollständig eingecheckt sind).
- Kein Treffer? Der Code wird mit dem Barcode verglichen, der an jedem Item der Transaktion gespeichert ist.
- Immer noch kein Match? Den Dialog 'Unbekannter Code' öffnen, um den Barcode manuell einem Item zuzuordnen.
Tipps
- Etiketten aus älteren Versionen ('cpp:gear:…') lassen sich weiter scannen; neue Etiketten tragen einen Link.
- Mit „Etikett drucken“ gedruckte QR-Etiketten kodieren bereits einen Deep-Link — kein manuelles Mapping nötig. Die Avery-Bögen aus „Geräte-Labels drucken“ tragen keinen QR-Code.
- Bulk-Items (keine Seriennummern, Menge > 1) werden per Zähler verfolgt. Serialisierte Items speichern den gescannten Barcode für die Audit-Spur in der Fulfillment-Zeile.
- Eine leere Lesung wird ignoriert. Ein Hardware-Scanner sendet ein Leerzeichen wie jedes andere Zeichen, eine Fehllesung kann also nur Leerraum liefern; dieser wird verworfen und nicht gegen den ersten Eintrag im Katalog aufgelöst.
Einen unbekannten Code zuordnen
Scannt man einen Code, den der Resolver nicht erkennt, öffnet sich das Modal 'Unbekannter Code' zur manuellen Zuordnung.
- Einen unbekannten Code scannen.
- Das Modal listet die Manifest-Items der Transaktion.
- Das Item auswählen, zu dem der Code gehört.
- Das Item wird für diesen Scan eingecheckt („Zugeordnet und eingecheckt“): Ein serialisiertes Item speichert den gescannten Code in seiner Fulfillment-Zeile, ein Bulk-Item zählt um eins hoch.
Tipps
- Die Zuordnung wird nicht als Regel gemerkt — der nächste Scan desselben unbekannten Codes öffnet den Dialog erneut. Damit ein Code von selbst auflöst, trage ihn als Asset-Tag oder Seriennummer am eigenen Gerät ein oder drucke ein QR-Etikett dafür.
- Der Check-in selbst wird mit der Transaktion gespeichert und synct wie jede andere Änderung.
Labels drucken
Zwei Arten von Etiketten: ein scanbares QR-Etikett pro Gerät oder Geräteset und Avery-Bögen mit Text-Etiketten aus dem Fenster „Geräte-Labels drucken“.
- QR-Etikett: ein eigenes Gerät öffnen und „Etikett drucken“ nutzen (oder „Set-Etikett drucken“ in einem Geräteset). Der QR-Code kodiert die Deep-Link-URL des Datensatzes, ein späterer Scan löst also ohne manuelles Mapping auf. Das Equipment eines Verleihs hat dasselbe QR-Etikett.
- Avery-Bögen: „Etiketten drucken“ im Kopf von Eigenes Equipment (mit den Geräten, die deine aktuellen Filter zeigen), im Miet-Tab eines Projekts oder beim Equipment eines Verleihs öffnet „Geräte-Labels drucken“. Schritt 1, Auswählen: Geräte anhaken — „Alle auswählen“, „Löschen“ oder „Nur Cases“. Schritt 2, Anpassen: Produktionsname, Kamerabuchstabe und seine Farbe, Eigentümer*in, Telefonnummer und Avery-Vorlage. Diese Etiketten tragen keinen QR-Code.
- Beide drucken über den Standard-Druckdialog des Browsers — an einen Drucker senden oder als PDF speichern.
Tipps
- Jede physische Einheit des eigenen Equipments mit einem gedruckten QR-Etikett paaren — so hat jedes Gerät beim Untervermietungs-Check-in eine scanbare Identität.
- Label-Papier im Kit einheitlich halten — Größenunterschiede stören das Druck-Layout.
Offline-Verhalten
Scannen funktioniert vollständig offline. Auflösungsdaten — Items der Transaktion, Owned-Gear-Datensätze — stammen aus den lokalen IndexedDB-Caches.
- Kamera-Dekodierung läuft im Browser (bzw. im Scanner des Telefons in der iPhone- und Android-App) — kein Netzwerk-Call.
- Check-ins, auch die über den Dialog „Unbekannter Code“, speichern lokal und syncen in die Cloud, sobald Verbindung besteht.
- Ein auf einem anderen Gerät eingetragener Asset-Tag oder eine Seriennummer löst hier erst auf, wenn diese Änderung gesynct ist.
Scanning ist eine Funktion des Untervermietungs-Check-Ins, der Vorbereitungs-Checkliste und von „QR scannen zum Hinzufügen“, gespeist von gedruckten QR-Etiketten. Es gibt absichtlich keine globale 'Tracker'-Seite — jeder Scan braucht eine Transaktion, eine Checkliste oder eine Kategorie als Kontext.
Verwandte Themen
Siehe auch
