Base de conhecimento

Voltar à visão geral do suporte

Vinculação de solicitação 

Emparelha um dispositivo externo.

Senha: request_binding

Elementos

  • device_id: O ID do dispositivo que você deseja emparelhar. Para xBands, este é o código de matriz de dados anexado à banda.
    • Obrigatório: True
    • Valor padrão: Vazio
  • timeout_ms: Tempo limite em milissegundos após o qual um evento é iniciado.
    • Obrigatório: Depende
    • Valor padrão: Vazio

Saída

  • TIMEOUT: Se não houver êxito dentro do tempo especificado, um evento de tempo limite será iniciado.

Exemplo

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

Validando a conexão

Como a ação não tem saída "SUCCESS", você precisa validar a conexão. Isso pode ser feito como mostrado neste exemplo:

<rule id="device_connected">
    <expressão> <![ CDATA[#{extdevices. CONNECTION_STATUS} == #{const:extdevices. CONECTADO}]]> </expressão>
    <ações>
        <ação ref="my_action" />
    </actions>
</rule>

Conectando a impressora Zebra

Tenta conectar e enviar conteúdo de impressão para uma impressora Zebra.

Senha: print_zebra_label

Tipo de ação

  • print_zebra_label:
    • Necessário: Sim

Parâmetros

  • tipo: O tipo de conexão que será feita com a impressora
    • Tipo: Corda
    • Necessário: Sim
    • Valor padrão: Cadeia de caracteres vazia
    • Valores válidos: TCP, Bluetooth
  • format: O formato que a impressora está definida para usar
    • Tipo: Corda
    • Necessário: Sim
    • Valor padrão: Cadeia de caracteres vazia
    • Valores válidos: ZPL, CPCL
  • conteúdo: Os dados enviados para impressão (ou seja, uma etiqueta de impressora)
    • Tipo: Corda
    • Necessário: Sim
    • Valor padrão: Cadeia de caracteres vazia

Para o tipo de conexão TCP

  • Endereço IP:
    • Tipo: Corda
    • Necessário: Sim
    • Valor padrão: Cadeia de caracteres vazia
  • porta: A porta que a impressora está configurada para usar
    • Tipo: Corda
    • Necessário: Não
    • Valor padrão: Se não for especificado, então 9100 (ZPL) ou 6101 (CPCL) serão usados

Para o tipo de conexão Bluetooth

  • Mac: O endereço MAC Bluetooth da impressora usada com ou sem separador ':'
    • Tipo: Corda
    • Necessário: Sim
    • Valor padrão: Cadeia de caracteres vazia
  • bt_secure: Usado para fazer uma conexão segura que requer a aceitação de uma solicitação de paring em ambos os dispositivos
    • Tipo: Booleano
    • Necessário: Não
    • Valor padrão: Falso

Exemplo 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" +
"TONE 99\r\n" +
"VELOCIDADE 98\r\n" +
"T 4 0 0 80 TESTE 1234\r\n" +
"FORM\r\n" +
"PRINT";
msg}? ]]></param></ação>

Exemplo mínimo de Bluetooth:

<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" +
"VELOCIDADE 98\r\n" +
"T 4 0 0 80 TESTE 1234\r\n" +
"FORM\r\n" +
"PRINT";
msg
}? ]]></param>

</ação>

Vinculação de versão

Libera o emparelhamento do dispositivo especificado.

Observação: se você quiser liberar todos os dispositivos externos, use a ação release_all_bindings em vez disso.

Identificador: release_binding

Elementos

  • device_id: Contém a ID do dispositivo externo que você deseja liberar.
    • Obrigatório: Sim
    • Valor padrão: Vazio

Exemplos

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

Enviar configuração de dispositivo externo

Permite configurar o comportamento da xBand para seus dispositivos (por exemplo, vibrações e sons sonoros).

Identificador: send_external_device_configuration

Elementos

  • configuration: Contém os valores de configuração (veja abaixo) separados por vírgulas.
    • Obrigatório: Sim

Valores de configuração

Nota: Certifique-se de que não há espaços na lista e os valores para todas as chaves são fornecidos.

  • DEFAULT_SCAN_BEEP: Usado para configurar o som de bipe que o dispositivo xBand emite após cada varredura.
    • Valores possíveis: NONE,SHORT ,POSITIVE ,NEGATIVE , ,  CONNECTDISCONNECT
  • POSITIVE_BEEP: Usado para configurar o som de bipe se o fluxo de trabalho enviar um comando positivo para a xBand.
  • Valores possíveis: NONE,SHORT ,POSITIVE ,NEGATIVE , ,  CONNECTDISCONNECT
  • NEGATIVE_BEEP: Usado para configurar o som de bipe se o fluxo de trabalho enviar um comando negativo para a xBand.
  • Valores possíveis: NONE,SHORT ,POSITIVE ,NEGATIVE , ,  CONNECTDISCONNECT
    • DEFAULT_SCAN_VIBRATION: Usado para configurar a vibração que a xBand faz após cada varredura.
    • Valores possíveis: NONE, SHORT, LONG, ,DOUBLE
  • POSITIVE_VIBRATION: Usado para configurar a vibração para casos em que o fluxo de trabalho envia um comando positivo para a xBand.
  • Valores possíveis: NONE, SHORT, LONG, ,DOUBLE
    • NEGATIVE_VIBRATION: Usado para configurar a vibração para casos em que o fluxo de trabalho envia um comando negativo para o xBand.
    • Valores possíveis: NONE, SHORT, LONG, ,DOUBLE

Exemplo

<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,NONE,NONE</param>
    </list>
</action>

Enviar comandos de dispositivo externo

Envia um comando para o dispositivo externo.

Senha: send_external_device_commands

Elementos

  • device_id: Contém o ID do dispositivo externo que recebe os comandos.
    • Obrigatório: Não
    • Valor padrão: Vazio
  • comandos: contém a lista de comandos a serem enviados para o dispositivo externo.
    • Obrigatório: Sim
    • Valor padrão: Vazio

Nota: Se você não especificar o dispositivo para o qual deseja enviar o comando, o comando será enviado para todos os dispositivos conectados.

Nomes de comando suportados

  • P: Define a alimentação do dispositivo externo.
    • Valores possíveis: [0, 20]
  • R: É utilizado para licenciamento (informa à banda se o usuário tem acesso ou não).
  • R: Altera o alcance da banda (atualmente não é usado já que a potência está controlando diretamente isso).
  • D: Contém a chave para configurações que definem o comportamento da banda em geral.
  • V: Permite que o dispositivo xBand vibre.
  • B: Permite que o dispositivo xBand emita um bipe.
  • N: Contém as notificações para a xBand (por exemplo, a escolha correta).
  • X: Redefine o buffer de tags para que o mesmo código seja aceito novamente.

Exemplos

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


Liberar todas as ligações

Libera as ligações para todos os dispositivos conectados.

Identificador: release_all_bindings

Exemplo

<action id="release_devices" type="release_all_bindings"/>