Bearbeiten von „RFID-Chip-Tool“

[[Kategorie:Dokumentation]]

= RFID-Chip-Chargen anlegen und in Kentix importieren =
Diese Dokumentation erklärt Schritt für Schritt, wie Sie mithilfe der '''RFID-Chip-Verwaltungswebsite''' Chargen anlegen, Chips konfigurieren und diese nahtlos in Kentix über eine CSV-Datei importieren können. Besonderer Fokus liegt auf dem '''Ablauf''' und der Unterscheidung zwischen '''automatischem''' und '''individuellem''' Benennungsmodus.

== Einführung ==
Die Website dient zur Verwaltung von RFID-Chip-Chargen. Jede Charge enthält eine Gruppe von Chips, die mit folgenden Eigenschaften konfiguriert werden:

'''Name''' (automatisch oder individuell vergeben)
'''Chip-Wert''' (erzeugt durch Auflegen des Chips auf das Kartenlesegerät)
'''PIN''' (optional, zufällig oder individuell anpassbar)
'''Chargenzugehörigkeit'''

Die generierte CSV-Datei kann direkt in Kentix importiert werden, um Zugangsberechtigungen zu verwalten.
=== Eindeutigkeit der Daten ===

'''Chipname''': Muss '''global einzigartig''' sein. (über alle Chargen hinweg nur einmal vergeben.)
'''RFID-Wert''': Muss nur '''innerhalb der Charge''' einzigartig sein
** Mehrere Einträge für denselben Chip können in verschiedenen Chargen unter verschiedenen Namen angelegt werden

== Chargenverwaltung ==
=== Neue Charge erstellen ===
'''Feld "Charge wählen"''': Geben Sie im Textfeld einen Namen für die neue Charge ein (z. B. <code>QFD_2024</code>)
'''Klicken Sie auf''' ''„Neue Charge erstellen"''
#* Die Charge wird angelegt, und Sie werden automatisch weitergeleitet
=== Bestehende Charge auswählen ===
'''Dropdown-Menü''': Wählen Sie eine vorhandene Charge aus der Liste
'''Klicken Sie auf''' ''„Auswählen"''
=== URL-Parameter für Chargenauswahl ===
Sie können Chargen auch direkt über URL-Parameter auswählen:

'''Bestehende Charge''': <code>chip.php?Charge=ChargenName</code>
'''Nicht-existierende Charge''': Wird automatisch als Name für eine neue Charge vorgeschlagen
** Ermöglicht das direkte Verlinken und Bookmarking von Chargen

== Benennungsmethoden ==
'''Wichtig''': Die Auswahl der Benennungsmethode ist der '''erste Schritt''' bei der Chip-Anlage und bestimmt den gesamten Workflow.
=== Automatischer Modus ===

'''Funktionsweise''':
** Der Name setzt sich aus '''Basisname + Index''' zusammen. (z. B. <code>Büro-1</code>)
** Der Index erhöht sich nach jedem Eintrag automatisch um 1 und der Basisname bleibt bestehen.
** '''Autofokus''' springt nach erfolgreichem Eintrag automatisch auf das Chip-Einlesefeld.
'''Vorteile''':
** Ideal für Serien von Chips mit einheitlicher Benennung.
** Ermöglicht schnelles, sequenzielles Einlesen ohne manuelle Namenseingaben.
** Workflow: ''Basisname + Index festlegen → Chips nacheinander einlesen''

=== Individueller Modus ===

'''Funktionsweise''':
** Für jeden Eintrag gibt es nur ein '''Namensfeld''', welches nach jedem Eintrag geleert wird.
** Jeder Chip erhält einen '''einmaligen Namen''' (z. B. <code>Haupteingang</code>, <code>Lager</code>)
** '''Autofokus''' springt nach erfolgreichem Eintrag auf das Namensfeld für den nächsten Chip
'''Vorteile''':
** Flexibel für individuelle Anforderungen
** Entsprechende Namen für spezifische Anwendungsfälle
** Workflow: ''Name eingeben → Chip einlesen → Name für nächsten Chip eingeben''

=== Modus wechseln ===

Klicken Sie auf ''„Typ wechseln"'', um zwischen den Modi zu wechseln.
Sie können jederzeit den Modus wechseln. Eine Mischung aus automatischer und individueller Benennung ist möglich.

=== Autofokus-Verhalten ===
Das '''Autofokus-System''' optimiert den Eingabeflow:

'''Automatischer Modus''': Fokus auf Chip-Einlesefeld (für schnelles sequenzielles Einlesen)
'''Individueller Modus''': Fokus auf Namensfeld (für neue Namenseingabe)
'''Bei Fehlern''': Fokus auf das entsprechende Korrekturfeld
'''Zweck''': Minimiert Mausklicks und ermöglicht tastaturgesteuerte Eingabe

== Chip-Anlage ==
=== Schritt-für-Schritt ===
'''Benennungsmethode auswählen''':
#* '''Automatisch''': Für Serien mit einheitlichem Präfix
#* '''Individuell''': Für spezifische, einmalige Namen
'''Benennung festlegen''':
#* '''Name''': Basisname für die Chips (z. B. <code>Büro</code>)
#* '''Index''' (!nur automatischer Modus!): Startnummer für die Durchnummerierung (z. B. <code>1</code> → <code>Büro-1</code>, <code>Büro-2</code>)
'''PIN-Optionen''':
#* '''Kein PIN''': Keine PIN erforderlich
#* '''Default PIN''': Individuell festlegbarer PIN-Wert (kann für jeden Eintrag angepasst werden)
#* '''Zufälliger PIN''': Einmaliger 6-stelliger PIN pro Chip
'''Chip einlesen''':
#* Legen Sie den RFID-Chip auf das Lesegerät
#* Der dezimale Chip-Wert wird automatisch erfasst
'''Speichern''':
#* Nach Drücken der Enter-Taste verarbeitet das System den Eintrag automatisch oder zeigt Duplikatshinweise oder Fehler an
== Duplikatsverwaltung ==
Das System erkennt automatisch Duplikate basierend auf:

'''Gleicher Chipname''' (global über alle Chargen)
'''Gleicher RFID-Wert''' (innerhalb derselben Charge)

=== Duplikatsanzeige ===
Bei erkannten Duplikaten wird der Einleseprozess '''gestoppt''' und eine Übersicht angezeigt:

[[Datei:Duplicateinfo.png|800px]]

'''„Hinzufügen"''':
** Ignoriert Duplikate und erstellt neuen Eintrag
** '''Nicht möglich''' bei gleichem Chipnamen
'''„Löschen und ersetzen"''':
** Ausgewählte Duplikate werden gelöscht
** Neuer Eintrag wird erstellt
** Erfordert Auswahl der zu löschenden Einträge
'''„Abbrechen"''':
** Bricht den aktuellen Vorgang ab
** Springt zum nächsten Eintrag (automatischer Modus) oder zurück zur Eingabe

== Export als CSV und Kentix-Import ==
=== CSV-Export ===
'''In der ausgewählten Charge''':
#* Klicken Sie auf ''„Als .CSV exportieren"''
#* Die Datei wird im Kentix-kompatiblen Format generiert:
<pre>
"emergency access";armdisarm_mode;"cloud access";"levelprofiles (comma separated)";pin;rfid_uid;rfid_data;active(0,1);"unlock at";"lock at";"user name (mandatory)";"full name (mandatory)";password;email;description;notification;is_ldap;usergroup
1;0;0;Standard;123456;A1B2C3D4;;1;;;Büro-1;Büro-1;;;;"armed:push,email;armed_warning:push,email;system:push,email;system_warning:push,email;";0;User
</pre>
Kopieren sie den gesamten Text (Tastenkombination: Strg+A) und '''Speichern Sie die Datei''' (z. B. <code>charge_hq-2024.csv</code>)
=== Import in Kentix ===
'''Kentix-Webinterface''':
#* Navigieren Sie zu ''„Benutzerverwaltung" → „CSV-Import"''
#* Wählen Sie die exportierte CSV-Datei aus
'''Feldzuordnung überprüfen''':
#* Stellen Sie sicher, dass die Spalten <code>rfid_uid</code>, <code>pin</code> und <code>user name</code> korrekt gemappt sind
'''Import starten'''
== Einträge verwalten ==
=== Einträge anzeigen ===
Alle Chips der aktuellen Charge werden in einer Tabelle angezeigt:

=== Einträge löschen ===
'''Tabelle der Einträge''':

[[Datei:Chargeinfo.png|600px]]

#* Markieren Sie die gewünschten Chips über die Checkboxen
'''Klicken Sie auf''' ''„Ausgewählte Einträge löschen"''
#* Bestätigung erfolgt durch Anzeige der Anzahl gelöschter Einträge
== PIN-Verwaltung ==
=== PIN-Optionen im Detail ===

'''Kein PIN''': Leeres PIN-Feld im Export
'''Default PIN''':
** '''Nicht''' ein fester PIN für alle Chips
** Individuell festlegbarer Wert, der als Vorlage dient
** Kann für jeden Eintrag einzeln angepasst werden
** Ermöglicht konsistente PIN-Vergabe bei Bedarf
'''Zufälliger PIN''': Automatisch generierter 6-stelliger Zufallscode pro Chip

== Häufige Fragen und Fehlerbehebung ==
=== Fehlermeldungen ===

'''„Keine Charge gefunden"''': Stellen Sie sicher, dass die Charge im Dropdown-Menü ausgewählt ist
'''„Der Name für diesen Eintrag wird bereits verwendet"''': Chipname bereits global vergeben
'''„Bitte geben Sie einen gültigen Namen ein"''': Namensfeld darf nicht leer sein

=== Technische Hinweise ===

'''Little-Hex-Konvertierung''': Erfolgt automatisch 
'''CSV-Format''': Kompatibel mit Kentix-Importspezifikation

== Siehe auch ==