Handrückenscanner

Aktuell nur für Android

Dieses Plugin ermöglicht es zusätzliche Bildschirme (z.B. Handrückenscanner mit Bildschirm) zu verbinden und mit diesen zu kommunizieren. Details zu den Handrückenscannern sind in folgenden Artikeln beschrieben:

• Dokumentation zu NIMMSTA
• Doukmentation zu ProGlove

JavaScript API

Dieses Plugin definiert ein globales window.flxPairedDevice-Objekt, das eine API für das Darstellen von Informationen auf dem verbundenen Bildschirm bereitstellt. Obwohl das Objekt an das window-Objekt angehängt ist, ist es erst nach dem deviceeready Event verfügbar:

document.addEventListener("deviceready", onDeviceReady, false);

function onDeviceReady() {
  console.log(flxPairedDevice);
}

Initialisieren des Plugins

Die Funktion flxPairedDevice.init initialisiert den Hintergrundklasse abhängig von dem Ausgewählten Hersteller des zusätzlichen Bildschirms.

flxPairedDevice.init();

Verbinden mit Handrückenscanner

Die Funktion flxPairedDevice.connect leitet den Verbindungsvorgang des Geräts ein. Standardmäßig wird hier ein QR-Code des ausgewählten Herstellers angezeigt, welcher anschließend abgescannt werden kann, um die Verbindung herzustellen.

flxPairedDevice.connect();

Trennen des Handrückenscanners

Die Funktion flxPairedDevice.disconnect trennt die Verbindung mit dem aktuellen Gerät.

flxPairedDevice.disconnect();

Informationen auf dem Handrückenscanner anzeigen

Die Funktion flxPairedDevice.setDisplay übermittelt Daten an den Handrückenscanner, damit dort Informationen angezeigt werden oder Aktionen ausgelöst werden können. Dazu muss ein details-Objekt übergeben werden, in dem die entsprechenden Daten vorhanden sind.

Diese Daten orientieren sich an den Templates der Hersteller der Handrückenscanner. Mehr Informationen zu diesen Templates sind auch bei den Herstellern, wie zum Beispiel ProGlove direkt zu finden.

Folgende Informationen müssen im details-Objekt vorhanden sein:

• TEMPLATE: Das Template bestimmt das anzuzeigende Layout. Folgende Templates werden unterstützt: PG1, PG1E, PG1C, PG2, PG3. Die Zahl kennzeichnet jeweils wie viele Zeilen an Labels und Texten angezeigt werden. E kennzeichnet das Template als eine Fehlermeldung während C eine Erfolgsmeldung ist. Mehr Detail unten im Abschnitt Templates. (String)
• DATA: Die darzustellenden Daten, die an das Gerät übergeben werden. Format der Übergabe Zeilennummer;Label;Text Hier werden abhängig vom dem verwendeten Template mehrere Daten benötigt. (String)
• DURATION: Angabe (in Millisekunden) wie lange die Benachrichtigung angezeigt werden soll. Ein Wert von 0 steht für einen permanenten Bildschirm. Nach einer Benachrichtigung wird zu dem vorherigen Profil zurückgekehrt. (Number)
• SOUND: Optionales Feedback (Hinweiston). E = Fehler, S = Erfolg, I = Information. Mehr Detail unten im Abschnitt Benutzer-Feedback. (String)
• SEPARATOR: Der Separator, der die Datensätze von DATA voneinander trennt. Standardwert: ; (String)
• REFRESH_TYPE: Steuert die Bildschirmauffrischungsstrategie des Gerätes. Standardwert: DEFAULT (String)

Beispiele:

//Dreizeiliges Template mit 3 Datensätzen (Label + Text)
flxPairedDevice.setDisplay({
  TEMPLATE: "PG3",
  DATA: "1;HU/Lagereinheit;800000098;2;Produkt;7894;3;Von-Platz;0020-01-01-A",
  SEPARATOR: ";",
  REFRESH_TYPE: "DEFAULT",
  DURATION: 0,
  SOUND: "I",
});

//Erfolgsmeldung, die für 2 Sekunden angezeigt wird.
flxPairedDevice.setDisplay({
  TEMPLATE: "PG1C",
  DATA: "1;Erfolg;Richtiger Platz",
  DURATION: 2000,
  SOUND: "S",
});

//Zweizeiliges Template und einem anderen Seperator und einem Erfolgsfeedback
flxPairedDevice.setDisplay({
  TEMPLATE: "PG2",
  DATA: "1/Storage Unit/R15/2/Destination/A7",
  DURATION: 0,
  SOUND: "S",
  SEPARATOR: "/",
});

Benutzer-Feedback

Beim übermitteln von Informationen an den Handrückenscanner kann im SOUND-Feld ein Feedback für den Benutzer mitgegeben werden. Dies erleichtert die Nutzung des Gerätes, indem Erfolgs- oder Fehlermeldung nicht nur visuell sondern auch als Ton oder haptisches Feedback übermittelt werden.

Typ	Wiederholungen	Beschreibung	Feedback
S	1	Aktion Erfolgreich.	Aufleuchten von Grünen LEDs, Einfacher Sound und Vibration
I	2	Informationen / Nächster Schritt	Aufleuchten von Weißen LEDs, Zweifacher Sound und Vibration
E	3	Error	Aufleuchten von Roten LEDs, Dreifacher Sound und Vibration

Templates

Templates sind die verschiedenen Layouts der Bildschirme der Geräte. Auf den Handrückenscannern werden folgende Templates unterstützt.

Template ID	Beschreibung	Layout
PG1	Ein Label und ein Text. Ideal für einfache Items oder kurze Nachrichten.
PG1E	Ein Fehler-Bild und eine Textausgabe. Ideal für eine kurze Fehlermeldung.
PG1C	Ein Erfolgs-Bild und eine Textausgabe. Ideal für eine kurze Erfolgsmeldung.
PG2	Zwei Labels mit Textfeldern.
PG3	Drei Labels mit Textfeldern. Ideal für die Kommissionierung.