Anfrage Bindung
Koppelt ein externes Gerät.
Kennung: request_binding
Elemente
- geräte_id: Die ID des Geräts, das Sie koppeln möchten. Bei xBands ist dies der Data-Matrix-Code, der an dem Band angebracht ist.
- Erforderlich: Wahr
- Standardwert: Leer
- Zeitüberschreitung_ms: Timeout in Millisekunden, nach dem ein Ereignis ausgelöst wird.
- Erforderlich: Abhängig
- Standardwert: Leer
Ausgabe
- TIMEOUT: Wenn innerhalb der angegebenen Zeit kein Erfolg eintritt, wird ein Timeout-Ereignis ausgelöst.
Beispiel
<action id="bind_device" type="request_binding">
<param name="device_id">#{external_device_id}</param>
<param name="timeout_ms" type="long">10000</param>
</action>
Validierung der Verbindung
Da die Aktion keinen "SUCCESS"-Ausgang hat, müssen Sie die Verbindung validieren. Dies kann wie in diesem Beispiel gezeigt geschehen:
<rule id="device_connected">
<expression> <![CDATA[#{extdevices.CONNECTION_STATUS} == #{const:extdevices.CONNECTED}]]> </expression>
<actions>
<action ref="my_action" />
</actions>
</rule>
Anschluss eines Zebra-Druckers
Versucht, eine Verbindung zu einem Zebra-Drucker herzustellen und Druckinhalte an diesen zu senden.
Bezeichner: print_zebra_label
Art der Aktion
Parameter
- Typ: Die Art der Verbindung, die mit dem Drucker hergestellt werden soll
- Typ: String
- Erforderlich: Ja
- Standardwert: Leere Zeichenkette
- Gültige Werte: TCP, Bluetooth
- Format: Das Format, für das der Drucker eingestellt ist
- Typ: String
- Erforderlich: Ja
- Standardwert: Leere Zeichenkette
- Gültige Werte: ZPL, CPCL
- Inhalt: Die Daten, die gedruckt werden sollen (z. B. ein Druckeretikett)
- Typ: String
- Erforderlich: Ja
- Standardwert: Leere Zeichenkette
Für den TCP-Verbindungstyp
- ipAdresse:
- Typ: String
- Erforderlich: Ja
- Standardwert: Leere Zeichenkette
- Anschluss: Der Anschluss, für den der Drucker konfiguriert ist
- Typ: String
- Erforderlich: Nein
- Standardwert: Wenn nicht angegeben, wird entweder 9100 (ZPL) oder 6101 (CPCL) verwendet.
Für Bluetooth-Verbindungstyp
- mac: Die Bluetooth-MAC-Adresse des Druckers, mit oder ohne Trennzeichen ':'.
- Typ: String
- Erforderlich: Ja
- Standardwert: Leere Zeichenkette
- bt_secure: Wird verwendet, um eine sichere Verbindung herzustellen, die das Akzeptieren einer Paring-Anfrage auf beiden Geräten erfordert
- Typ: Boolesch
- Erforderlich: Nein
- Standardwert: False
Minimales TCP-Beispiel:
<action id="print_label" type="print_zebra_label">
<param name="type">tcp</param>
<param name="format">cpcl</param>
<param name="ipaddress">10.10.10.10</param>
<param name="port">2020</param>
<param name="content"><![CDATA[ ?{
var msg = "\n" +
"! 0 200 200 210 1\r\n" +
"TONE 99\r\n" +
"SPEED 98\r\n" +
"T 4 0 0 80 TEST 1234\r\n" +
"FORM\r\n" +
"PRINT";
msg
}? ]]></param>
</action>
Minimales Bluetooth-Beispiel:
<action id="print_label" type="print_zebra_label">
<param name="type">bluetooth</param>
<param name="format">cpcl</param>
<param name="mac"> 48:A4:93:02:CB:F1</param>
<param name="content"><![CDATA[ ?{
var msg = "\n" +
"! 0 200 200 210 1\r\n" +
"TONE 99\r\n" +
"SPEED 98\r\n" +
"T 4 0 0 80 TEST 1234\r\n" +
"FORM\r\n" +
"PRINT";
msg
}? ]]></param>
</action>
Freigabe Bindung
Hebt die Kopplung des angegebenen Geräts auf.
Hinweis: Wenn Sie alle externen Geräte freigeben möchten, verwenden Sie stattdessen die Aktion release_all_bindings.
Kennung: release_binding
Elemente
- geräte_id: Enthält die ID des externen Geräts, das Sie freigeben möchten.
- Erforderlich: Ja
- Standardwert: Leer
Beispiele
<action id="release_device" type="release_binding">
<param name="device_id">#{external_device_id}</param>
</action>
Externe Gerätekonfiguration senden
Ermöglicht es Ihnen, das Verhalten des xBand für Ihre Geräte zu konfigurieren (z. B. Vibrationen und Pieptöne).
Kennung: send_external_device_configuration
Elemente
- Konfiguration: Enthält die Konfigurationswerte (siehe unten), die durch Kommata getrennt sind.
Werte der Konfiguration
Hinweis: Achten Sie darauf, dass die Liste keine Leerzeichen enthält und die Werte für alle Schlüssel angegeben sind.
- DEFAULT_SCAN_BEEP: Dient zur Konfiguration des Signaltons, den das xBand-Gerät nach jedem Scanvorgang abgibt.
- Mögliche Werte:
KEINE
, KURZ
, POSITIV
, NEGATIV
, VERBINDEN
, TRENNEN
- POSITIVE_BEEP: Wird verwendet, um den Piepton zu konfigurieren, wenn der Workflow einen positiven Befehl an das xBand sendet.
- Mögliche Werte:
KEINE
, KURZ
, POSITIV
, NEGATIV
, VERBINDEN
, TRENNEN
- NEGATIVE_BEEP: Wird verwendet, um den Piepton zu konfigurieren, wenn der Workflow einen negativen Befehl an das xBand sendet.
- Mögliche Werte:
KEINE
, KURZ
, POSITIV
, NEGATIV
, VERBINDEN
, TRENNEN
- DEFAULT_SCAN_VIBRATION: Dient zur Konfiguration der Vibration, die das xBand nach jedem Scan ausführt.
- Mögliche Werte:
KEINE
, KURZ
, LANG
, DOPPELT
- POSITIVE_VIBRATION: Wird verwendet, um die Vibration für Fälle zu konfigurieren, in denen der Workflow einen positiven Befehl an das xBand sendet.
- Mögliche Werte:
KEINE
, KURZ
, LANG
, DOPPELT
- NEGATIVE_VIBRATION: Wird verwendet, um die Vibration für Fälle zu konfigurieren, in denen der Workflow einen negativen Befehl an das xBand sendet.
- Mögliche Werte:
KEINE
, KURZ
, LANG
, DOPPELT
Beispiel
<action id="set_external_device_config_beep_on_scan" type="send_external_device_configuration">
<list name="configuration" listType="NAMED">
<param name="d">SHORT,NONE,NONE,NONE,NONE,NONE</param>
</list>
</action>
Externe Gerätebefehle senden
Sendet einen Befehl an das externe Gerät.
Kennung: send_external_device_commands
Elemente
- geräte_id: Enthält die ID des externen Geräts, das die Befehle empfängt.
- Erforderlich: Nein
- Standardwert: Leer
- Befehle: Enthält die Liste der Befehle, die an das externe Gerät gesendet werden sollen.
- Erforderlich: Ja
- Standardwert: Leer
Hinweis: Wenn Sie nicht angeben, an welches Gerät Sie Ihren Befehl senden möchten, wird der Befehl an alle angeschlossenen Geräte gesendet.
Unterstützte Befehlsnamen
- P: Stellt die Leistung für das externe Gerät ein.
- A: Wird für die Lizenzierung verwendet (teilt dem Band mit, ob der Benutzer Zugang hat oder nicht).
- R: Ändert den Bereich des Bandes (derzeit nicht verwendet, da die Leistung dies direkt steuert).
- D: Enthält den Schlüssel für Konfigurationen, die das Verhalten des Bandes im Allgemeinen definieren.
- V: Lässt das xBand-Gerät vibrieren.
- B: Lässt das xBand-Gerät piepen.
- N: Enthält die Benachrichtigungen für das xBand (z. B. die richtige Auswahl).
- X: Setzt den Tag-Puffer zurück, so dass derselbe Code wieder akzeptiert wird.
Beispiele
<action id="send_power_config_command" type="send_external_device_commands">
<list name="commands" listType="NAMED">
<param name="p">#{code}</param>
</list>
</action>
<action id="send_external_device_beep" type="send_external_device_commands">
<list name="commands" listType="NAMED">
<param name="b">1</param>
</list>
</action>
<action id="send_external_device_correct_pick" type="send_external_device_commands">
<list name="commands" listType="NAMED">
<param name="n">1</param>
</list>
</action>
<action id="send_external_device_wrong_pick" type="send_external_device_commands">
<list name="commands" listType="NAMED">
<param name="n">2</param>
</list>
</action>
<action id="send_external_device_vibrate" type="send_external_device_commands">
<list name="commands" listType="NAMED">
<param name="v">1</param>
</list>
</action>
<action id="reset_external_device_tag_buffer" type="send_external_device_commands">
<list name="commands" listType="NAMED">
<param name="x">0</param>
</list>
</action>
Alle Bindungen freigeben
Gibt die Bindungen zu allen angeschlossenen Geräten frei.
Kennung: release_all_bindings
Beispiel
<action id="release_devices" type="release_all_bindings"/>