デバイス
[デバイス]タブでは、取引デバイスの追加、編集、有効化、無効化、削除を行えます。 取引デバイスの接続タイプ設定し、取引情報のフィルタ条件を定義し、カメラをペアリングし、そして、オンスクリーン ディスプレイのスタイルを選びます。
デバイスを追加する
取引デバイスの追加方法:
- [追加] をクリックします。 [取引デバイスの追加のウィザード]ウィンドウが開きます。
- このデバイスを識別するための名前を [名前]欄に入力します。
- [Transactions ソース] ドロップダウンメニューから取引ソースを選択します。 取引ソースはデバイスを特定するための1つの方法で、実際の操作には影響しません。
- 以下の接続タイプのうちの1つを[接続タイプ]ドロップダウン メニューから選択します。
- TCP: ソースのネットワーク情報を[IP アドレス]および[ポート]のフィールドに入力します。
- シリアル ポート: すべての設定が接続ソースに一致していることを確認してください。
- Surveillance Station WebAPI: IP アドレスとポートを入力して、接続ステータスをチェックしてください。 これらは必須フィールドではありませんが、不正確な設定は切断やその他の問題の原因になることがあります。 詳細は下記のSurveillance Station WebAPIのセクションを参照してください。
- [次へ]をクリックしてデータ定義の設定で続行します。 接続タイプとして Surveillance Station WebAPI を選択した場合、ディスプレイ設定に案内されます。
- 正しいエンコード方法を選択し、[生データの収集を開始]をクリックしてデバイス側のデータを入力します。 受信したデータが[生データ]欄に表示されます。
- 取引の開始と終了の規則を設定してください。
- 上右隅のボタンをクリックすることによって、フィルタ規則を加えることができます。 文字を無視して、文字を改行またはその他の文字と交換することができます。
- フィルタにかけられたデータの結果は直接[フィルタにかけられたデータ]欄に表示されます。 対応するデータが[元のデータ]にマークされます。
- [次へ] をクリックしてディスプレイ設定に進みます。
- このデバイスにペアリング済みカメラをセットアップするかどうかを [ペアリングしたカメラ]から選択します。
- [オンスクリーン ディスプレイ]で、取引データがライブ ビューとビデオ クリップで表示されるように設定できます。
- [完了] をクリックして、設定を完了してください。
制限:
- デバイスの名前は大文字と小文字を区別します。 使用できるのは以下の記号を除く 1~32 字の Unicode 文字です:
! " # $ % & ' ( ) * + , / : ; < = > ? @ [ ] \ ^ ` { } | ~
- エンコード リストで使用しているエンコードがない場合、手動でそれを入力できます
- フィルタ条件として、コントロール文字をフィルタにかけたい場合、「<」と「>」を使用して文字を囲んでください。
- ペアリングしたカメラをセットアップするときに、カメラと取引データをライブ ビューおよび関連の録画クリップで見ることができます。
デバイスの編集
取引デバイスの編集方法:
- 修正するデバイスを選択し、[編集] をクリックします。 または、デバイスをダブルクリックして設定を変更します。
- [詳細設定]ページでユーザー定義のイベントをセットアップします。 これは、アクション規則、ライブビュー アラート、および通知で使用できます。
- [完了] をクリックして、変更を保存します。
デバイスの有効化または無効化
サポートされるすべてのアクションを管理する前に、新しいデバイスを有効化しなければなりません。
デバイスの有効化または無効化の方法:
- 有効化または無効化したいデバイスを選択し、[有効化] ドロップダウン メニューから [有効化] または [無効化] を選択します。
デバイスの削除
- 削除するデバイスを選択し、[削除]をクリックします。
- 確認ウィンドウが表示されます。 デバイスの取引を保持することを選択した場合、[はい]をクリックして続行します。
注意:
- デバイスを削除するときに、すべての取引の削除を選択した場合は、ロックされた取引も永久に Surveillance Station から削除されます。
Surveillance Station Web API
Surveillance Station Web API はデバイスを接続したり、Web API リクエストを仕様に一致するフォーマットで送信したり、あるいは取引データを記録する上でより便利な方法を提供します。
Web API リクエストを送信する標準的フォーマット:
- API: SYNO.SurveillanceStation。取引情報を記録するために、Transactions は4タイプの方法 (Begin (開始)、Complete (完了)、Cancel (キャンセル)、そしてAppendData (データ追加)) を提供します。
Begin (開始):
Surveillance Station に取引の開始を通知します。 次のパラメータを含みます。
- device_name: ストリング タイプ。Surveillance Station 上の取引デバイスの名前。
- session_id: ストリング タイプ。取引セッションの ID。
- timeout: 整数タイプ。取引時間制限 (秒)。 取引時間制限を超えると取引は自動的に終了します。
Complete (完了):
Surveillance Station に取引を終了することを通知し取引が完了します。 次のパラメータを含みます。
- device_name: ストリング タイプ。Surveillance Station 上の取引デバイスの名前。
- session_id: ストリング タイプ。取引セッションの ID。
キャンセル:
Surveillance Station に取引を終了することを通知し取引がキャンセルされます。 次のパラメータを含みます。
- device_name: ストリング タイプ。Surveillance Station 上の取引デバイスの名前。
- session_id: ストリング タイプ。取引セッションの ID。
AppendData (データ追加):
Surveillance Station に取引の内容を記録するよう通知します。 次のパラメータを含みます。
- device_name: ストリング タイプ。Surveillance Station 上の取引デバイスの名前。
- session_id: ストリング タイプ。取引セッションの ID。
- content: ストリング タイプ。取引の内容。 受信データは別々のラインになりますが、\ n を使用して受信データの改行を行うことができます。
- 基本リクエスト フォーマット:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="{method}"&version=1&device_name="{device name}"&session_id="{session id}"
Web API リクエストの例:
- 取引の開始:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Begin"&version=1&device_name="POS01"&session_id="1"&timeout=300
- 取引の記録:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Start\n2017/01/01"
- 取引の記録:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Pen $40\nBook $300"
- 取引の記録:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Total $340\nEnd"
- 取引の終了:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Complete"&version=1&device_name="POS01"&session_id="1"
注意:
- Surveillance Station WebAPI リクエストを送信する前にセッションにログインする必要があります。 詳細なログイン方法は、Web API ドキュメントを参照してください。
- Session_id は異なる取引イベントを区別するのに使用されます。 同じ device_name と session_id は同じ記録として扱われます。 同じパラメータが再送信されると、取引が完了、キャンセル、または取引時間制限を超えるまで、Begin (開始)方法が無視されます。 その後、session_id を再利用できます。
- 取引開始後、時間制限がComplete (完了)またはCancel (キャンセル)の方法の受信前に超えられた場合、取引記録が保存され [未完了] としてマークされます。