Base de connaissances

Retour à la vue d’ensemble de l’assistance

Demander une liaison 

Permet de coupler un périphérique externe.

Identifiant : request_binding

Éléments

  • device_id : ID de l’appareil que vous souhaitez coupler. Pour les xBands, il s’agit du code Datamatrix attaché à la bande.
    • Obligatoire : Vrai
    • Valeur par défaut : vide
  • timeout_ms : Délai d’expiration, en millisecondes, après quoi un événement est lancé.
    • Requis : Dépend
    • Valeur par défaut : vide

Sortie

  • TIMEOUT: S’il n’y a pas de succès dans le délai spécifié, un événement de délai d’expiration est démarré.

Exemple

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

Validation de la connexion

Étant donné que l’action n’a pas de sortie « SUCCESS », vous devez valider la connexion. Cela peut être fait comme indiqué dans cet exemple :

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

Connexion de l’imprimante Zebra

Tente de connecter et d’envoyer du contenu d’impression à une imprimante Zebra.

Identifiant : print_zebra_label

Type d’action

  • print_zebra_label :
    • Obligatoire: Oui

Paramètres

  • type: Le type de connexion qui sera établi avec l’imprimante
    • Type: Corde
    • Obligatoire: Oui
    • Valeur par défaut: Chaîne vide
    • Valeurs valides : TCP, Bluetooth
  • format : format que l’imprimante est configurée pour utiliser
    • Type: Corde
    • Obligatoire: Oui
    • Valeur par défaut: Chaîne vide
    • Valeurs valides : ZPL, CPCL
  • contenu: Les données envoyées à imprimer (c’est-à-dire une étiquette d’imprimante)
    • Type: Corde
    • Obligatoire: Oui
    • Valeur par défaut: Chaîne vide

Pour le type de connexion TCP

  • Adresse IP :
    • Type: Corde
    • Obligatoire: Oui
    • Valeur par défaut: Chaîne vide
  • port: Port que l’imprimante est configurée pour utiliser
    • Type: Corde
    • Obligatoire: Non
    • Valeur par défaut: S’il n’est pas spécifié, 9100 (ZPL) ou 6101 (CPCL) sera utilisé

Pour le type de connexion Bluetooth

  • Mac: L’adresse MAC Bluetooth de l’imprimante utilisée avec ou sans séparateur ' :'
    • Type: Corde
    • Obligatoire: Oui
    • Valeur par défaut: Chaîne vide
  • bt_secure : Utilisé pour établir une connexion sécurisée qui nécessite l’acceptation d’une demande d’appariement sur les deux appareils
    • Type: Booléen
    • Obligatoire: Non
    • Valeur par défaut: Faux

Exemple de TCP minimal :

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

Exemple de Bluetooth minimal :

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

Reliure de dégagement

Libère l’appairage de l’appareil spécifié.

Remarque : Si vous souhaitez libérer tous les périphériques externes, utilisez plutôt l’action release_all_bindings .

Identifiant : release_binding

Éléments

  • device_id : contient l’ID du périphérique externe que vous souhaitez libérer.
    • Requis : Oui
    • Valeur par défaut : vide

Exemples

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

Envoyer la configuration d’un périphérique externe

Vous permet de configurer le comportement de la bande x sur vos appareils (par exemple, les vibrations et les bips).

Identifiant : send_external_device_configuration

Éléments

  • configuration : Contient les valeurs de configuration (voir ci-dessous) séparées par des virgules.
    • Requis : Oui

Valeurs de configuration

Remarque : Assurez-vous qu’il n’y a pas d’espace dans la liste et que les valeurs de toutes les clés sont indiquées.

  • DEFAULT_SCAN_BEEP : Permet de configurer le bip sonore émis par l’appareil xBand après chaque balayage.
    • Valeurs possibles : NONE, SHORT, POSITIVE,NEGATIVE  CONNECT, , DISCONNECT
  • POSITIVE_BEEP : Permet de configurer le bip sonore si le workflow envoie une commande positive au xBand.
  • Valeurs possibles : NONE, SHORT, POSITIVE,NEGATIVE  CONNECT, , DISCONNECT
  • NEGATIVE_BEEP : Permet de configurer le bip sonore si le workflow envoie une commande négative au xBand.
  • Valeurs possibles : NONE, SHORT, POSITIVE,NEGATIVE  CONNECT, , DISCONNECT
    • DEFAULT_SCAN_VIBRATION : Permet de configurer la vibration émise par le xBand après chaque balayage.
    • Valeurs possibles : NONE, SHORT,LONG ,  DOUBLE
  • POSITIVE_VIBRATION : Permet de configurer la vibration dans les cas où le workflow envoie une commande positive au xBand.
  • Valeurs possibles : NONE, SHORT,LONG ,  DOUBLE
    • NEGATIVE_VIBRATION : Permet de configurer la vibration dans les cas où le workflow envoie une commande négative au xBand.
    • Valeurs possibles : NONE, SHORT,LONG ,  DOUBLE

Exemple

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

Envoyer des commandes de périphériques externes

Envoie une commande à l’appareil externe.

Identifiant : send_external_device_commands

Éléments

  • device_id : contient l’ID du périphérique externe recevant les commandes.
    • Obligatoire : Non
    • Valeur par défaut : Vide
  • commandes : contient la liste des commandes à envoyer à l’appareil externe.
    • Requis : Oui
    • Valeur par défaut : Vide

Remarque : Si vous ne spécifiez pas l’appareil auquel vous souhaitez envoyer votre commande, celle-ci sera envoyée à tous les appareils connectés.

Noms de commandes pris en charge

  • P : Règle l’alimentation du périphérique externe.
    • Valeurs possibles : [0, 20]
  • R : Est utilisé pour l’octroi de licences (informe la bande si l’utilisateur y a accès ou non).
  • R : Modifie la portée de la bande (actuellement non utilisée puisque l’alimentation contrôle directement celle-ci).
  • D : Contient la clé pour les configurations qui définissent le comportement de la bande en général.
  • V : Permet à l’appareil xBand de vibrer.
  • B : Permet à l’appareil xBand d’émettre un bip.
  • N : Contient les notifications pour le xBand (par exemple, le choix correct).
  • X : réinitialise le tampon de balise, de sorte que le même code soit à nouveau accepté.

Exemples

<action id="send_power_config_command » type="send_external_device_commands">
    <list name="commandes » listType="NAMED">
        <param name="p">#{code}</param>
    </list>
</action>

<action id="send_external_device_beep » type="send_external_device_commands">
    <list name="commandes » listType="NAMED">
        <param name="b">1</param>
    </list>
</action>

<action id="send_external_device_correct_pick » type="send_external_device_commands">
    <list name="commandes » listType="NAMED">
        <param name="n">1</param>
    </list>
</action>

<action id="send_external_device_wrong_pick » type= » send_external_device_commands">
    <list name="commandes » listType="NAMED">
        <param name="n">2</param>
    </list><
/action>

<action id="send_external_device_vibrate » type="send_external_device_commands">
    <list name="commandes » listType="NAMED">
        <param name="v">1</param>
    </ list>
</action>

<action id="reset_external_device_tag_buffer » type="send_external_device_commands"><
    list name="commandes » listType="NAMED">
        <param name="x">0</param>
    </list><
/action>

Relâcher toutes les fixations

Libère les liaisons vers tous les appareils connectés.

Identifiant : release_all_bindings

Exemple

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