COBISOFT Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== Honeywell MDE: KeyboardEmulator konfigurieren ======

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

===== Voraussetzungen =====
  * Honeywell MDE (Android)
  * 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)

====== Honeywell MDE: Configure KeyboardEmulator ======

===== Purpose =====
To ensure barcode scans on Honeywell MDE devices are received correctly by **COBI.wms**, the **keyboardemulator** app must be configured to send scan data via **BroadcastReceiver** to COBI.wms.

===== Prerequisites =====
  * Honeywell MDE (Android)
  * **keyboardemulator** app (verified with **v11.4.3.M**)
  * COBI.wms installed
  * Recommended: close COBI.wms while applying the settings

===== Required Settings (Summary) =====
  * **Function**: enable scanner, enable **Barcode2D**, set KeyCode
  * **AppSettings**: enable **BroadcastReceiver** and set action/key
  * Optional/recommended: **End mark = Enter**

----

===== 1) Enable Scanner and configure Barcode2D (Tab “Function”) =====

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

  - Open **keyboardemulator**.
  - Go to the **Function** tab.
  - Apply/verify the following:
    - **Barcode2D**: enable (check the box).  *(see marker 1)*
    - **KeyCode**: set to **293**.  *(see marker 2)*
    - **Enable Scanner**: set to **AN** (On).  *(see marker 3)*

> Note: Depending on the device setup, Barcode1D may also be used. For COBI.wms it is essential that scans are triggered and then forwarded via Broadcast (next step).

----

===== 2) Configure BroadcastReceiver for COBI.wms (Tab “AppSettings”) =====

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

  - Switch to the **AppSettings** tab. *(see marker 1)*
  - Select **BroadcastReceiver** as the output mode. *(see marker 2)*
  - In section **Barcode**, set:
    * **Broadcast name**: **de.cobi.wms.action.KEYBOARDEMULATOR_BARCODE** *(see marker 3)*
    * **Key**: **data**
  - (Optional/recommended) In section **End mark**:
    * Enable **Enter**
    * Keep **TAB** disabled

> Important: The broadcast name must match **exactly**, including capitalization and underscores.

----

===== 3) Test in COBI.wms =====
  - Open **COBI.wms**.
  - Navigate to a field where scanning is expected (e.g., login, item/barcode field).
  - Scan a barcode.
  - Expected result: COBI.wms receives the value and processes it (e.g., item is found).

If nothing is received:
  * fully close COBI.wms (task switcher) and reopen it
  * verify **BroadcastReceiver** is selected (not “Keyboard input”)
  * verify **Broadcast name** and **Key** are correct

----

===== Troubleshooting (common causes) =====
  * **No reaction in COBI.wms**
    - BroadcastReceiver not enabled / wrong broadcast name
    - COBI.wms was running during changes → restart the app
  * **Scans appear as normal keyboard typing**
    - output mode is set to “Keyboard input” instead of “BroadcastReceiver”
  * **Scan is sent but value is empty**
    - the extra “Key” must be **data** (COBI.wms reads the barcode value from this field)