RFID-Chip-Tool: Unterschied zwischen den Versionen

Aus Agilos Wiki
Zur Navigation springen Zur Suche springen
Marcel.koerper (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
Marcel.koerper (Diskussion | Beiträge)
 
(14 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
[[Kategorie:Dokumentation]]
[[Kategorie:Dokumentationen]]
 
[https://agikoerper.webseite.online/chip.php Link zum RFID-Tool]


= RFID-Chip-Chargen anlegen und in Kentix importieren =
= 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.
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.




Zeile 11: Zeile 12:


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


Die generierte CSV-Datei kann direkt in Kentix importiert werden, um Zugangsberechtigungen zu verwalten.
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


=== Eindeutigkeit der Daten ===


'''Chipname''': Muss '''global einzigartig''' sein (Über alle Chargen hinweg nur einmal vergeben.)


'''RFID-Wert''': Muss nur '''innerhalb der Charge''' einzigartig sein (Kann jedoch trotzdem nach Bestätigung zur Charge hinzugefügt werden.)
** Mehrere Einträge für denselben Chip können in verschiedenen Chargen unter verschiedenen Namen angelegt werden


== Chargenverwaltung ==
== Chargenverwaltung ==
Zeile 30: Zeile 34:
'''Klicken Sie auf''' ''„Neue Charge erstellen"''
'''Klicken Sie auf''' ''„Neue Charge erstellen"''
#* Die Charge wird angelegt, und Sie werden automatisch weitergeleitet
#* Die Charge wird angelegt, und Sie werden automatisch weitergeleitet
=== Bestehende Charge auswählen ===
=== Bestehende Charge auswählen ===
'''Dropdown-Menü''': Wählen Sie eine vorhandene Charge aus der Liste
'''Dropdown-Menü''': Wählen Sie eine vorhandene Charge aus der Liste
'''Klicken Sie auf''' ''„Auswählen"''
'''Klicken Sie auf''' ''„Auswählen"''
=== URL-Parameter für Chargenauswahl ===
=== URL-Parameter für Chargenauswahl ===
Sie können Chargen auch direkt über URL-Parameter auswählen:
Sie können Chargen auch direkt über URL-Parameter auswählen:


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




Zeile 45: Zeile 53:
== Benennungsmethoden ==
== Benennungsmethoden ==
'''Wichtig''': Die Auswahl der Benennungsmethode ist der '''erste Schritt''' bei der Chip-Anlage und bestimmt den gesamten Workflow.
'''Wichtig''': Die Auswahl der Benennungsmethode ist der '''erste Schritt''' bei der Chip-Anlage und bestimmt den gesamten Workflow.
=== Automatischer Modus ===
=== Automatischer Modus ===
'''Funktionsweise''':
'''Funktionsweise''':
** Der Name setzt sich aus '''Basisname + Index''' zusammen. (z. B. <code>Büro-1</code>)
** Der Name setzt sich aus '''Basisname + Index''' zusammen. (z. B. <code>Büro-1</code>)
Zeile 55: Zeile 63:
** Ermöglicht schnelles, sequenzielles Einlesen ohne manuelle Namenseingaben.
** Ermöglicht schnelles, sequenzielles Einlesen ohne manuelle Namenseingaben.
** Workflow: ''Basisname + Index festlegen → Chips nacheinander einlesen''
** Workflow: ''Basisname + Index festlegen → Chips nacheinander einlesen''


=== Individueller Modus ===
=== Individueller Modus ===
'''Funktionsweise''':
'''Funktionsweise''':
** Für jeden Eintrag gibt es nur ein '''Namensfeld''', welches nach jedem Eintrag geleert wird.
** Für jeden Eintrag gibt es nur ein '''Namensfeld''', welches nach jedem Eintrag geleert wird.
Zeile 66: Zeile 74:
** Entsprechende Namen für spezifische Anwendungsfälle
** Entsprechende Namen für spezifische Anwendungsfälle
** Workflow: ''Name eingeben → Chip einlesen → Name für nächsten Chip eingeben''
** Workflow: ''Name eingeben → Chip einlesen → Name für nächsten Chip eingeben''


=== Modus wechseln ===
=== Modus wechseln ===
Klicken Sie auf ''„Typ wechseln"'', um zwischen den Modi zu 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.
Sie können jederzeit den Modus wechseln. Eine Mischung aus automatischer und individueller Benennung ist möglich.


=== Autofokus-Verhalten ===
=== Autofokus-Verhalten ===
Zeile 76: Zeile 85:


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




Zeile 85: Zeile 96:
== Chip-Anlage ==
== Chip-Anlage ==
=== Schritt-für-Schritt ===
=== Schritt-für-Schritt ===
'''Seite öffnen''':
#* '''https://agikoerper.webseite.online/chip.php'''
'''Benennungsmethode auswählen''':
'''Benennungsmethode auswählen''':
#* '''Automatisch''': Für Serien mit einheitlichem Präfix
#* '''Automatisch''': Für Serien mit einheitlichem Präfix
Zeile 96: Zeile 109:
#* '''Zufälliger PIN''': Einmaliger 6-stelliger PIN pro Chip
#* '''Zufälliger PIN''': Einmaliger 6-stelliger PIN pro Chip
'''Chip einlesen''':
'''Chip einlesen''':
#* Stellen Sie sicher, dass das Chip-Einlesefeld korrekt ausgewählt und fokussiert wurde.
#* Legen Sie den RFID-Chip auf das Lesegerät
#* Legen Sie den RFID-Chip auf das Lesegerät
#* Der dezimale Chip-Wert wird automatisch erfasst
#* Der dezimale Chip-Wert wird automatisch erfasst
'''Speichern''':
'''Speichern''':
#* Nach Drücken der Enter-Taste verarbeitet das System den Eintrag automatisch oder zeigt Duplikatshinweise oder Fehler an
#* Nach Drücken der Enter-Taste verarbeitet das System den Eintrag automatisch oder zeigt Duplikatshinweise oder Fehler an




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


=== Duplikatsanzeige ===
=== Duplikatsanzeige ===
Zeile 124: Zeile 138:
'''„Abbrechen"''':
'''„Abbrechen"''':
** Bricht den aktuellen Vorgang ab
** Bricht den aktuellen Vorgang ab
** Springt zum nächsten Eintrag (automatischer Modus) oder zurück zur Eingabe
** Springt zurück zur Eingabe
 
== Einträge verwalten ==
=== Einträge anzeigen ===
Alle Chips der aktuellen Charge werden in einer Tabelle, am unteren Ende der Seite angezeigt:
 
 
=== Einträge löschen ===
'''Tabelle der Einträge''':
 
[[Datei:Chargeinfo.png|450px]]


#* 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




Zeile 139: Zeile 166:
</pre>
</pre>
Kopieren sie den gesamten Text (Tastenkombination: Strg+A) und '''Speichern Sie die Datei''' (z. B. <code>charge_hq-2024.csv</code>)
Kopieren sie den gesamten Text (Tastenkombination: Strg+A) und '''Speichern Sie die Datei''' (z. B. <code>charge_hq-2024.csv</code>)
=== Import in Kentix ===
=== Import in Kentix ===
'''Kentix-Webinterface''':
'''Kentix-Webinterface''':
Zeile 146: Zeile 175:
#* Stellen Sie sicher, dass die Spalten <code>rfid_uid</code>, <code>pin</code> und <code>user name</code> korrekt gemappt sind
#* Stellen Sie sicher, dass die Spalten <code>rfid_uid</code>, <code>pin</code> und <code>user name</code> korrekt gemappt sind
'''Import starten'''
'''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




Zeile 180: Zeile 182:


'''„Keine Charge gefunden"''': Stellen Sie sicher, dass die Charge im Dropdown-Menü ausgewählt ist
'''„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
'''„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
'''„Bitte geben Sie einen gültigen Namen ein"''': Namensfeld darf nicht leer sein


=== Technische Hinweise ===
=== Technische Hinweise ===
'''Little-Hex-Konvertierung''': Erfolgt automatisch  
'''Little-Hex-Konvertierung''': Erfolgt automatisch  


'''CSV-Format''': Kompatibel mit Kentix-Importspezifikation
'''CSV-Format''': Kompatibel mit Kentix-Importspezifikation






== Siehe auch ==
== Siehe auch ==

Aktuelle Version vom 28. Mai 2025, 08:00 Uhr


Link zum RFID-Tool

RFID-Chip-Chargen anlegen und in Kentix importieren

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

Chipname: Muss global einzigartig sein (Über alle Chargen hinweg nur einmal vergeben.)

RFID-Wert: Muss nur innerhalb der Charge einzigartig sein (Kann jedoch trotzdem nach Bestätigung zur Charge hinzugefügt werden.)

    • Mehrere Einträge für denselben Chip können in verschiedenen Chargen unter verschiedenen Namen angelegt werden

Chargenverwaltung

[Bearbeiten]

Neue Charge erstellen

[Bearbeiten]

Feld "Charge wählen": Geben Sie im Textfeld einen Namen für die neue Charge ein (z. B. QFD_2024) Klicken Sie auf „Neue Charge erstellen"

    • Die Charge wird angelegt, und Sie werden automatisch weitergeleitet


Bestehende Charge auswählen

[Bearbeiten]

Dropdown-Menü: Wählen Sie eine vorhandene Charge aus der Liste Klicken Sie auf „Auswählen"


URL-Parameter für Chargenauswahl

[Bearbeiten]

Sie können Chargen auch direkt über URL-Parameter auswählen:

Bestehende Charge: chip.php?Charge=ChargenName

Nicht-existierende Charge: Wird automatisch als Name für eine neue Charge vorgeschlagen

    • Ermöglicht das direkte Verlinken und Bookmarking von Chargen


Benennungsmethoden

[Bearbeiten]

Wichtig: Die Auswahl der Benennungsmethode ist der erste Schritt bei der Chip-Anlage und bestimmt den gesamten Workflow.

Automatischer Modus

[Bearbeiten]

Funktionsweise:

    • Der Name setzt sich aus Basisname + Index zusammen. (z. B. Büro-1)
    • 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

[Bearbeiten]

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. Haupteingang, Lager)
    • 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

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

Schritt-für-Schritt

[Bearbeiten]

Seite öffnen:

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. Büro)
    • Index (!nur automatischer Modus!): Startnummer für die Durchnummerierung (z. B. 1 → Büro-1, Büro-2)

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:

    • Stellen Sie sicher, dass das Chip-Einlesefeld korrekt ausgewählt und fokussiert wurde.
    • 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

[Bearbeiten]

Das System erkennt automatisch Duplikate basierend auf:

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


Duplikatsanzeige

[Bearbeiten]

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

„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 zurück zur Eingabe

Einträge verwalten

[Bearbeiten]

Einträge anzeigen

[Bearbeiten]

Alle Chips der aktuellen Charge werden in einer Tabelle, am unteren Ende der Seite angezeigt:


Einträge löschen

[Bearbeiten]

Tabelle der Einträge:

    • 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


Export als CSV und Kentix-Import

[Bearbeiten]

CSV-Export

[Bearbeiten]

In der ausgewählten Charge:

    • Klicken Sie auf „Als .CSV exportieren"
    • Die Datei wird im Kentix-kompatiblen Format generiert:
"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

Kopieren sie den gesamten Text (Tastenkombination: Strg+A) und Speichern Sie die Datei (z. B. charge_hq-2024.csv)


Import in Kentix

[Bearbeiten]

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 rfid_uid, pin und user name korrekt gemappt sind

Import starten


Häufige Fragen und Fehlerbehebung

[Bearbeiten]

Fehlermeldungen

[Bearbeiten]

„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

[Bearbeiten]

Little-Hex-Konvertierung: Erfolgt automatisch

CSV-Format: Kompatibel mit Kentix-Importspezifikation


Siehe auch

[Bearbeiten]