====== KeyboardEmulator konfigurieren ======

===== Ziel =====
Damit Barcode-Scans auf zuverlässig in **COBI.wms** ankommen, muss die App **keyboardemulator** so konfiguriert werden, dass sie die Scandaten per **BroadcastReceiver** an COBI.wms übergibt.

===== Voraussetzungen =====
  * App keyboardemulator (getestet mit Version v11.4.3.M)
  * COBI.wms ist installiert
  * Nach Möglichkeit: COBI.wms während der Einrichtung geschlossen

===== Übersicht der erforderlichen Einstellungen =====
  * **Function**: Scanner aktivieren, **Barcode2D** aktivieren, KeyCode setzen
  * **AppSettings**: **BroadcastReceiver** aktivieren und Broadcast-Action/Key setzen
  * Optional/empfohlen: **End mark = Enter**

----

===== 1) Scanner aktivieren und Barcode2D konfigurieren (Tab „Function“) =====

{{:de:cobi.wms:honeywell_mde:keyboardemulator1.png?400|}}

  - Öffne keyboardemulator.
  - Wechsel in den Tab Function.
  - Setze/prüfe folgende Werte:
    - Barcode2D: aktivieren (Haken setzen).  (siehe Markierung 1)
    - KeyCode: auf 293 setzen.  (siehe Markierung 2)
    - Enable Scanner: auf AN (Ein).  (siehe Markierung 3)

> Hinweis: Je nach Geräte-Setup kann Barcode1D ebenfalls genutzt werden. Für COBI.wms ist entscheidend, dass die Scans korrekt ausgelöst und anschließend per Broadcast übergeben werden (siehe nächster Schritt).

----

===== 2) BroadcastReceiver für COBI.wms konfigurieren (Tab „AppSettings“) =====

{{:de:cobi.wms:honeywell_mde:keyboardemulator2.png?800|}}

  - Wechsel in den Tab AppSettings. (siehe Markierung 1)
  - Wähle als Ausgabeart BroadcastReceiver. (siehe Markierung 2)
  - Konfiguriere im Abschnitt Barcode:
    * Broadcast name: de.cobi.wms.action.KEYBOARDEMULATOR_BARCODE (siehe Markierung 3)
    * Key: data
  - (Optional/empfohlen) Im Abschnitt End mark:
    * Enter aktivieren
    * TAB deaktiviert lassen

> Wichtig: Der Broadcast-Name muss exakt so eingetragen werden, inkl. Groß-/Kleinschreibung und Unterstrichen.

----

===== 3) Funktionstest in COBI.wms =====
  - Öffne COBI.wms.
  - Navigiere in ein Eingabefeld (z. B. Login, Artikel-/Barcodefeld).
  - Scanne einen Barcode.
  - Erwartetes Ergebnis: Der Wert wird in COBI.wms übernommen bzw. der Artikel wird gefunden.

Falls nichts ankommt:
  * COBI.wms vollständig schließen (App-Switcher) und erneut öffnen
  * Prüfen, ob BroadcastReceiver ausgewählt ist (nicht „Keyboard input“)
  * Prüfen, ob Broadcast name und Key korrekt sind

----

===== Troubleshooting (häufige Ursachen) =====
  * **Keine Reaktion in COBI.wms**
    - BroadcastReceiver nicht aktiv / falscher Broadcast-Name
    - COBI.wms lief während der Umstellung → App einmal neu starten
  * **Scans landen „irgendwo“ als Tastatureingabe**
    - Ausgabe steht auf „Keyboard input“ statt „BroadcastReceiver“
  * **Scan wird übertragen, aber ohne Inhalt**
    - „Key“ muss data sein (COBI.wms liest den Wert aus diesem Feld)