製本依頼
外部デバイスをペアリングする。
識別子:request_binding
エレメント
- device_id:ペアリングしたいデバイスのID。xBandsの場合、これはバンドに付けられたデータマトリックスコードです。
- 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 "出力がないので、接続を検証する必要がある。これはこの例のように行うことができます:
<rule id="device_connected">
<expression> <![CDATA[#{extdevices.CONNECTION_STATUS} == #{const:extdevices.CONNECTED}]]> </expression>
<actions>
<action ref="my_action" />
</actions>
</rule>
ゼブラプリンタとの接続
Zebraプリンタに接続し、印刷内容を送信しようとします。
識別子:print_zebra_label
アクションタイプ
パラメータ
- タイプ: プリンターとの接続タイプ。
- タイプ 文字列
- 必須 はい
- デフォルト値: 空の文字列
- 有効な値: TCP、Bluetooth
- フォーマット:プリンターが使用するフォーマット
- タイプ 文字列
- 必須 はい
- デフォルト値: 空の文字列
- 有効な値: ZPL、CPCL
- コンテンツ: 印刷するために送信されるデータ(プリンターラベルなど)
- タイプ 文字列
- 必須 はい
- デフォルト値: 空の文字列
TCP接続の場合
- IPアドレス:
- タイプ 文字列
- 必須 はい
- デフォルト値: 空の文字列
- ポート: プリンタが使用するように設定されているポート。
- タイプ 文字列
- 必須 不要
- デフォルト値: 指定がない場合、9100(ZPL)または6101(CPCL)のいずれかが使用される。
ブルートゥース接続タイプ
- mac: プリンターのBluetooth MACアドレス。':'セパレータの有無は問わない。
- タイプ 文字列
- 必須 はい
- デフォルト値: 空の文字列
- bt_secure:両方のデバイスでパーリング要求を受け入れる必要があるセキュアな接続を行うために使用する。
- タイプ ブール型
- 必須 不要
- デフォルト値: デフォルト値: False
最小限の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>
最小限のブルートゥースの例:
<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
エレメント
- コンフィギュレーション:コンフィギュレーション値(下記参照)をカンマ区切りで記述。
設定値
注:リストに空白がなく、すべてのキーの値が与えられていることを確認すること。
- DEFAULT_SCAN_BEEP:各スキャン後にxBandデバイスが鳴らすビープ音を設定するために使用します。
- 可能な値:
none
、short
、positive
、negative
、connect
、disconnect
- POSITIVE_BEEP:ワークフローがxBandにポジティブコマンドを送信した場合のビープ音の設定に使用。
- 可能な値:
none
、short
、positive
、negative
、connect
、disconnect
- NEGATIVE_BEEP:ワークフローがxBandにネガティブコマンドを送信した場合のビープ音の設定に使用。
- 可能な値:
none
、short
、positive
、negative
、connect
、disconnect
- 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。
- コマンド:外部デバイスに送信するコマンドのリスト。
注意:コマンドを送信するデバイスを指定しなかった場合、コマンドは接続されているすべてのデバイスに送信されます。
対応コマンド名
- 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"/>