Knowledge base

Enlace de solicitud

Empareja un dispositivo externo.

Identificador: request_binding

Elementos

• device_id: El ID del dispositivo que desea emparejar. En el caso de las xBands, este es el código de matriz de datos adjunto a la banda.
  • Obligatorio: Verdadero
  • Valor predeterminado: Vacío
• timeout_ms: Tiempo de espera en milisegundos después del cual se inicia un evento.
  • Obligatorio: Depende
  • Valor predeterminado: Vacío

Salida

• INTERRUPCIÓN: Si no hay éxito dentro del tiempo especificado, se iniciará un evento de tiempo de espera.

Ejemplo

<action id="bind_device" type="request_binding">
    <param name="device_id">#{external_device_id}</param>
    <param name="timeout_ms" type="long">10000</param>
</action>

Validación de la conexión

Dado que la acción no tiene salida "SUCCESS", debe validar la conexión. Esto se puede hacer como se muestra en este ejemplo:

<rule id="device_connected">
    <expression> <![ CDATA[#{extdevices. CONNECTION_STATUS} == #{const:extdevices. CONNECTED}]]> </expression>
    <actions>
        <action ref="my_action" />
    </actions>
</rule>

Conexión de la impresora Zebra

Intenta conectar y enviar contenido de impresión a una impresora Zebra.

Identificador: print_zebra_label

Tipo de acción

• print_zebra_label:
  • Obligatorio: Sí

Parámetros

• tipo: El tipo de conexión que se realizará con la impresora
  • Tipo: Cuerda
  • Obligatorio: Sí
  • Valor predeterminado: Cadena vacía
  • Valores válidos: TCP, Bluetooth
• format: El formato que está configurada para usar la impresora
  • Tipo: Cuerda
  • Obligatorio: Sí
  • Valor predeterminado: Cadena vacía
  • Valores válidos: ZPL, CPCL
• contenido: Los datos enviados para ser impresos (es decir, una etiqueta de impresora)
  • Tipo: Cuerda
  • Obligatorio: Sí
  • Valor predeterminado: Cadena vacía

Para el tipo de conexión TCP

• Dirección IP:
  • Tipo: Cuerda
  • Obligatorio: Sí
  • Valor predeterminado: Cadena vacía
• puerto: El puerto para el que está configurada la impresora
  • Tipo: Cuerda
  • Obligatorio: No
  • Valor predeterminado: Si no se especifica, se utilizará 9100 (ZPL) o 6101 (CPCL)

Para el tipo de conexión Bluetooth

• Mac: La dirección MAC de Bluetooth de la impresora utilizada con o sin separador ':'
  • Tipo: Cuerda
  • Obligatorio: Sí
  • Valor predeterminado: Cadena vacía
• bt_secure: Se utiliza para establecer una conexión segura que requiere aceptar una solicitud de emparejamiento en ambos dispositivos
  • Tipo: Booleano
  • Obligatorio: No
  • Valor predeterminado: Falso

Ejemplo de TCP mínimo:

<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" +
"TONO 99\r\n" +
"VELOCIDAD 98\r\n" +
"T 4 0 0 80 PRUEBA 1234\r\n" +
"FORMA\r\n" +
"IMPRIMIR";
msg}? ]]></param></acción>

Ejemplo de Bluetooth mínimo:

<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" +
"TONO 99\r\n" +
"VELOCIDAD 98\r\n" +
"T 4 0 0 80 PRUEBA 1234\r\n" +
"FORMA\r\n" +
"IMPRIMIR";
msg
}? ]]></param>

</acción>

Enlace de liberación

Libera el emparejamiento del dispositivo especificado.

Identificador: release_binding

Elementos

• device_id: Contiene el ID del dispositivo externo que desea liberar.
  • Obligatorio: Sí
  • Valor predeterminado: Vacío

Ejemplos

<action id="release_device" type="release_binding">
    <param name="device_id">#{external_device_id}</param>
</action>

Enviar configuración de dispositivo externo

Le permite configurar el comportamiento de la xBand en sus dispositivos (por ejemplo, vibraciones y pitidos).

Identificador: send_external_device_configuration

Elementos

• configuration: Contiene los valores de configuración (ver más abajo) separados por comas.
  • Obligatorio: Sí

Valores de configuración

• DEFAULT_SCAN_BEEP: Se utiliza para configurar el pitido que emite el dispositivo xBand después de cada escaneo.
  • Valores posibles: NONE, SHORT, POSITIVE, NEGATIVE, CONNECT, , DISCONNECT
• POSITIVE_BEEP: Se utiliza para configurar el pitido si el flujo de trabajo envía un comando positivo a la xBand.
• Valores posibles: NONE, SHORT, POSITIVE, NEGATIVE, CONNECT, , DISCONNECT
• NEGATIVE_BEEP: Se utiliza para configurar el pitido si el flujo de trabajo envía un comando negativo a la xBand.
• Valores posibles: NONE, SHORT, POSITIVE, NEGATIVE, CONNECT, , DISCONNECT
  • DEFAULT_SCAN_VIBRATION: Se utiliza para configurar la vibración que hace la xBand después de cada escaneo.
  • Valores posibles: NONE, SHORT, , LONGDOUBLE
• POSITIVE_VIBRATION: Se utiliza para configurar la vibración en los casos en los que el flujo de trabajo envía un comando positivo a la xBand.
• Valores posibles: NONE, SHORT, , LONGDOUBLE
  • NEGATIVE_VIBRATION: Se utiliza para configurar la vibración en los casos en los que el flujo de trabajo envía un comando negativo a la xBand.
  • Valores posibles: NONE, SHORT, , LONGDOUBLE

Ejemplo

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

Enviar comandos de dispositivos externos

Envía un comando al dispositivo externo.

Identificador: send_external_device_commands

Elementos

• device_id: Contiene el ID del dispositivo externo que recibe los comandos.
  • Obligatorio: No
  • Valor predeterminado: Vacío
• commands: Contiene la lista de comandos que se enviarán al dispositivo externo.
  • Obligatorio: Sí
  • Valor predeterminado: Vacío

Nombres de comandos admitidos

• P: Ajusta la alimentación del dispositivo externo.
  • Valores posibles: [0, 20]

• R: Se utiliza para la concesión de licencias (informa a la banda si el usuario tiene acceso o no).
• R: Cambia el rango de la banda (actualmente no se usa ya que la potencia la controla directamente).
• D: Contiene la clave para las configuraciones que definen el comportamiento de la banda en general.
• V: Permite que el dispositivo xBand vibre.
• B: Permite que el dispositivo xBand emita un pitido.
• N: Contiene las notificaciones de la xBand (por ejemplo, la selección correcta).
• X: Restablece el búfer de etiquetas, de modo que se vuelve a aceptar el mismo código.

Ejemplos

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