一般的なイベント (デフォルト)

サーバーが警報システム、アクセス制御デバイス、監視システム等の外部システムから HTTPWeb サーバと Web クライアントの間でデータの送受信を行うために用いられるプロトコルリクエストを受信した場合に発生します。これはデフォルトのイベントです。

Nx Witness では、第三者のシステムやデバイスが「イベント作成」API コールと呼ばれる HTTP 文字列を送信できます。

イベント作成リクエストは、サーバーで読み込まれるために適切なフォーマットに従い、ルール内のイベントフィールドは処理される HTTP リクエスト内の対応するフィールドに一致する必要があります。

完全なサーバー API ドキュメントは、http://<サーバーipaddress>:<サーバーnetworkポート>/stデバイスic/api.xml からインストールされている任意のサーバー上でアクセスできます。

「サーバーのウェブインターフェイスの使用」を参照してください。

注意 : イベントフィールドの値はケースセンシティブで、空の文字列はワイルドカードとして機能し、任意の値は一致と見なされます。

基本のパラメーター

各リクエストには以下のフィールドが含まれています。

ソース

キャプションに含まれる

説明に含まれる

メタデータ – イベントが制限されるデバイス(カメラ、I/Oモジュール等) を指定するデバイス識別子を渡すのに使用されます。
- デバイス識別子を取得は以下の手順で実施します。

デバイスを右クリックし、[カメラ設定] をクリックします。
[一般] タブで、デバイス識別子はカメラ/デバイス ID として表示されます。
デバイス識別子は、{"cameraRefs":["<id>"]} のフォーマットで渡す必要があります。
HTML エンコーディングでは、{%22cameraRefs%22:[%22<id>%22]} のようになります。

重要 : 一般的なイベントが通知にリンクされている場合はデバイスの指定が必要となり、「要確認」オプションも必要となります。

この場合、通知があるとブックマークが作成されて、指定されたデバイスにリンクされます。詳細は、「表示通知」を参照してください。

発生/開始/停止 – これは [状態] のオプションのフィールドです。HTTP リクエストに [state] フィールドがない場合、一次的なするイベントと見なされます。

指定されると、継続的なイベントと見なされ、ルールは「状態 = アクティブ (開始)」または「状態 = 非アクティブ (停止)」の属性を必要とします。
「状態 = アクティブ」を含む一般的なイベントを受信した場合、「状態 = 非アクティブ」を含む同じパラメーターを持つ一般的なイベントを受信するまで、その結果として生じるアクションが継続します。

注意 :「デバイス録音」や「リピート音」等の継続的なアクションが ([状態] フィールドを持たない)一次的に発生する一般的なイベントに関連付けられる場合、ルールが機能しません。

(継続的なイベントおよび一次的なイベントの詳細については、「イベントルールフォームを使用するには」を参照してください。)

例

http://127.0.0.1:7001/api/createEvent?source=%22Door%22&caption=%22Knock%20Knock%22&説明=%22Visitor!%22&metadata={%22cameraRefs%22:[%22066fbf9c-2e11-a501-6e15-dfb0fb97c7cb%22]} この HTTP は以下をリクエストします。

IP アドレス「127.0.0.1」およびポート「7001」のサーバーへデータを送信。
ソース –"Door"
キャプションに含まれる – "Knock Knock"
説明に含まれる – "Visitor!"
状態 – 使用されない、即時。
カメラ識別 ID – 066fbf9c-2e11-a501-6e15-dfb0fb97c7cb

[一般イベント] のフィールドは対応する HTTP リクエストに一致し、ケースセンシティブであることに注意してください。

例えば、[ソース] "foo"、[キャプションに含まれる] "bar"、および [説明に含まれる] "" (空) のとおり設定されたイベントは以下のようになります。

以下のデータを持つ HTTP リクエストは、一般的なイベントを実行します。	以下のデータを持つ HTTP リクエストは一般的なイベントを実行しません。
[ソース] – "foo12345" ("foo"を含む)	[ソース] – "Foo12345" ("foo"の代わりに"Foo"を含む)
[キャプションに含まれる] – "bartender" ("bar"を含む)	[キャプションに含まれる] – "bデバイスender" ("bar"を含まない)
[説明に含まれる] – (空の文字列はすべての値の一致を意味します。)	[説明に含まれる] – "Lorem ipsum dolor sit amet" (空の文字列はすべての値の一致を意味します。)

詳細パラメーター

ログインを省略 – 選択されると、一般的なイベントはイベントログに追加されません。

このオプションを使うと、連続して、またはデータベース呼び出しやデータベースストレージなしで実行される非常に高い頻度で実行されるアクションが、イベントログの望ましくない「スパム行為」を引き起こす可能性があります。

("ログインを省略" チェックボックスが有効になっている場合も、"ログ書き込み" アクションを持つ一般的なイベントがまだイベントログに表示されるので注意してください。)

イベントのスケジューリング

イベントが不正に動作する理由

HTTP リクエストが正しく書かれていません。サーバー API を参照してください。

リクエストが除外されます。すべてのフィールド([ソース]、[キャプションに含まれる]、[説明に含まれる]) をクリアし、HTTP リクエストを再び実行します。

HTTP リクエストは継続的なアクションのタイプに関連付けられますが、[状態] フィールドを含みません。

デバイスは指定されませんが、イベントは通知に関連付けられ、"要確認" オプションが設定されます。

このイベントの「全体通知」が無効化されています。