要求のバインド 

外部デバイスをペアリングします。

識別子: request_binding

元素

  • device_id: ペアリングするデバイスの ID。xBandsの場合、これはバンドに添付されたデータ行列コードです。
    • 必須: True
    • デフォルト値: 空
  • timeout_ms: イベントが開始されるまでのタイムアウト (ミリ秒単位)。
    • 必須: 場合による
    • デフォルト値: 空

アウトプット

  • タイムアウト: 指定された時間内に成功がない場合は、タイムアウトイベントが開始されます。

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

接続の検証

アクションには「SUCCESS」出力がないため、接続を検証する必要があります。これは、次の例に示すように実行できます。

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

Zebraプリンターの接続

印刷コンテンツを Zebra プリンターに接続して送信しようとします。

識別子: print_zebra_label

アクションの種類

  • print_zebra_label:
    • 必須: はい

パラメーター

  • 種類: プリンターとの接続の種類
    • 種類:
    • 必須: はい
    • 既定値: 空の文字列
    • 有効値: TCP、Bluetooth
  • format: プリンターが使用するように設定されている形式
    • 種類:
    • 必須: はい
    • 既定値: 空の文字列
    • 有効値: ZPL、CPCLの
  • コンテンツ: 印刷用に送信されるデータ(プリンターラベルなど)
    • 種類:
    • 必須: はい
    • 既定値: 空の文字列

TCP接続タイプの場合

  • IPアドレス:
    • 種類:
    • 必須: はい
    • 既定値: 空の文字列
  • 港: プリンタが使用するように設定されているポート
    • 種類:
    • 必須: いいえ
    • 既定値: 指定しない場合は、9100 (ZPL) または 6101 (CPCL) が使用されます

Bluetooth接続タイプの場合

  • マック: 「:」区切り記号の有無にかかわらず使用されるプリンターの Bluetooth MAC アドレス
    • 種類:
    • 必須: はい
    • 既定値: 空の文字列
  • bt_secure:両方のデバイスでペアリング要求を受け入れる必要がある安全な接続を確立するために使用されます
    • 種類: ブーリアン
    • 必須: いいえ
    • 既定値:

最小TCPの例:

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

最小限の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" +
"SPEED 98\r\n" +
"T 4 0 0 80 TEST 1234\r\n" +
"FORM\r\n" +
"PRINT";
msg
}?]]></param>

</actionです>

リリースバインディング

指定したデバイスのペアリングを解除します。

: すべての外部デバイスを解放する場合は、代わりに release_all_bindings アクションを使用します 。

識別子: release_binding

元素

  • device_id: 解放する外部デバイスの ID が含まれます。
    • 必須: はい
    • デフォルト値: 空

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

外部デバイス設定の送信

デバイスに対するxBandの動作(バイブレーションやビープ音など)を設定できます。

識別子: send_external_device_configuration

元素

  • configuration: コンマで区切られた設定値 (下記参照) が含まれます。
    • 必須: はい

構成値

: リストにスペースがなく、すべてのキーの値が指定されていることを確認してください。

  • DEFAULT_SCAN_BEEP: 各スキャン後にxBandデバイスが鳴らすビープ音を構成するために使用されます。
    • 設定可能な値: NONE、、 SHORT POSITIVE、 NEGATIVE、、  CONNECTDISCONNECT
  • POSITIVE_BEEP: ワークフローが xBand に肯定的なコマンドを送信した場合のビープ音を構成するために使用されます。
  • 設定可能な値: NONE、、 SHORT POSITIVE、 NEGATIVE、、  CONNECTDISCONNECT
  • NEGATIVE_BEEP: ワークフローが xBand に負のコマンドを送信した場合のビープ音を構成するために使用されます。
  • 設定可能な値: NONE、、 SHORT POSITIVE、 NEGATIVE、、  CONNECTDISCONNECT
    • DEFAULT_SCAN_VIBRATION: 各スキャン後にxBandが発する振動を構成するために使用されます。
    • 設定可能な値: NONE、、SHORT、  LONG DOUBLE
  • POSITIVE_VIBRATION: ワークフローが xBand に正のコマンドを送信する場合のバイブレーションを構成するために使用します。
  • 設定可能な値: NONE、、SHORT、  LONG DOUBLE
    • NEGATIVE_VIBRATION: ワークフローが xBand に負のコマンドを送信する場合のバイブレーションを構成するために使用します。
    • 設定可能な値: NONE、、SHORT、  LONG DOUBLE

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

外部デバイスコマンドの送信

外部デバイスにコマンドを送信します。

識別子: send_external_device_commands

元素

  • device_id: コマンドを受信する外部デバイスの ID が含まれます。
    • 必須: いいえ
    • 既定値: 空
  • commands: 外部デバイスに送信されるコマンドのリストが含まれます。
    • 必須: はい
    • 既定値: 空

:コマンドを送信するデバイスを指定しなかった場合、コマンドは接続されているすべてのデバイスに送信されます。

サポートされているコマンド名

  • P: 外部デバイスの電源を設定します。
    • 設定可能な値: [0, 20]
  • A: ライセンスに使用されます (ユーザーがアクセス権を持っているかどうかをバンドに通知します)。
  • R: 帯域の範囲を変更します(電力が直接制御しているため、現在は使用されていません)。
  • D: バンドの一般的な動作を定義する構成のキーが含まれています。
  • V: xBandデバイスを振動させます。
  • B: xBandデバイスにビープ音を鳴らします。
  • N: xBandの通知(正しい選択など)が含まれます。
  • X: タグ バッファーをリセットして、同じコードが再び受け入れられるようにします。

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

すべてのバインドを解放

接続されているすべてのデバイスへのバインドを解放します。

識別子: release_all_bindings

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