Email Actionにおけるtextへの変数埋め込み方法につきまして

[木下裕貴]

大変お世話になっております。
AMBLの木下です。

題記の通り、Email Actionにおけるtextへの変数埋め込み方法につきまして、ご教示いただけますと幸いです。

■やりたいこと
・異常の様子が分かる情報をEMail等で伝達することを考えています。

例：
　異常状態の検知→確定をトリガーとして、以下の1つ以上をtextへ埋め込む
　　・送信タイミングでの、正常・異常カウンタ値
　　・検知、確定のタイムスタンプ
　　・スナップショットへのリンク or 実データ添付
　　・S3等のDBへのリンク

■確認したいこと
①　Email Action に対して、callbackの変数値等のプログラマブルな連携は可能ですか？ (ex. "text" = f"normal:{hoge}")
②　スナップショット・録画データへのURL等を、何かしらのActionで伝えることは可能ですか？ (ex. "text" = f"movie:{url}")
③　①②が達成できない場合、マニュアルへの導線を埋め込むになると考えてますが、ベストプラクティスはありますか？

お忙しいところ恐縮ですが、ご教示いただけますと幸いです。

以上

[ts...@edgematrix.com]

AMBL木下様、いつも大変お世話になっております。

> ①　Email Action に対して、callbackの変数値等のプログラマブルな連携は可能ですか？ (ex. "text" = f"normal:{hoge}")

工藤さん、メールアクションへの推論結果埋め込みに関するご質問ですが、

回答をお願いします。

> ②　スナップショット・録画データへのURL等を、何かしらのActionで伝えることは可能ですか？ (ex. "text" = f"movie:{url}")

スナップショットはサポートしているアクションによる添付のみ、

録画データは明確な要求があった場合のみ期限付きのURLが発行され、

メールアクションでは録画ビューへのURLを含めるかどうかは、選択可能です。

> ③　①②が達成できない場合、マニュアルへの導線を埋め込むになると考えてますが、ベストプラクティスはありますか？

セキュリティ上の検討事項も多いのですが、

どのようなユースケースでしょうか？

2023年11月9日木曜日 18:31:01 UTC+9 yuki.kin...@ambl.co.jp:

[Akira Kudo]

AMBL木下様

お世話になっております。

EMIの工藤と申します。

①　Email Action に対して、callbackの変数値等のプログラマブルな連携は可能ですか？ (ex. "text" = f"normal:{hoge}")

こちらについて下記に回答差し上げます。

現状では、アプリからのevent json文字列をそのままメール本文に代入することのみ対応しております。

メール本文中に{event_string}と入れていただくと、その部分がjsonに差し替えられてメール送信されます。

他にも{device_id}, {stream_id}などもそれぞれdevice ID, stream IDの実際の文字列に差し替えることができます。

よろしくお願いいたします。

2023年11月13日(月) 9:49 ts...@edgematrix.com <ts...@edgematrix.com>:

[木下裕貴]

各位

ご回答ありがとうございます。
以下にそれぞれの返答を記載致します。

>セキュリティ上の検討事項も多いのですが、
   どのようなユースケースでしょうか？
異常通知→異常対応時のマニュアル（録画データへのアクセス方法）への誘導を想定していました。
が、先日「メールアクションでは録画ビューへのURLを含めることが可能」という旨を共有いただきましたので、そちらで十分とのことでした。
ご指摘いただいた通り、マニュアルの置き場所に関するセキュリティが難しいので、URLを含めること、で解決できてよかったです。

>メール本文中に{event_string}と入れていただくと、その部分がjsonに差し替えられてメール送信されます。
以下認識ですが、このような形式であれば callback の変数を本文に記載可能ということでしょうか。

また、この件で気になったのでお聞きしたいのですが、event_string 等の予約語はどこかに記載ありますか？
uuid はオプション設定にすると変な動きする (v2.3) という感触でしたが、 {device_id}, {stream_id} 等知らずのうちに使ってしまいそうです。

@stream_config.json
"action": {
  "action_name": "email",
  ...
  "text": "{event_string}",
}

@callback.py
event = [
  event_items = {
    "event_string"        : f"{hoge}_{fuga}",
  }
]

2023年11月14日火曜日 15:16:11 UTC+9 Akira Kudo:

[Akira Kudo]

木下様

お世話になっております。

工藤です。

混乱させてしまったかもしれませんが、

{event_string}などはメール本文のテキストとしてコンソールからユーザーが入力するものでございます。

ユーザガイドには比較的最近追記しております。

https://sites.google.com/edgematrix.com/device-console-manual/edgeai-device-console-users-manual?authuser=0#h.xkvv868nlrd2

よろしくお願いいたします。

2023年11月16日(木) 13:45 木下裕貴 <yuki.kin...@ambl.co.jp>:

[木下裕貴]

工藤様

ご回答ありがとうございます。

コンソール側の話だったのですね。

疑問点は解消できました。

ありがとうございます。

2023年11月16日木曜日 13:50:06 UTC+9 Akira Kudo: