- Home
- Beaver IoT
- 4.5 ワークフロー
4.5 ワークフロー
ワークフローとは、デバイス、データ、サービス間の相互作用を定義、管理、自動化するための論理的なプロセスです。ワークフローは、複数の事前定義されたルールやタスクを直列に接続することで、しきい値アラームやスケジュール切り替えなど、豊富で柔軟な機能を実装できます。
ワークフローの追加
- Workflow ページに移動し、+Add をクリックしてワークフローを追加します。
- 必要に応じてこのワークフローの開始ノードを選択し、Create をクリックします。
| 開始ノード | 説明 |
|---|---|
| Timer | スケジュール時間または周期に基づいてワークフローをトリガーします。例：スケジュール切り替え。 |
| Trigger | ダッシュボード上のトリガーウィジェットでワークフローをトリガーします。例：ボタン切り替え。 |
| Entity Listener | エンティティデータが変更された際にワークフローをトリガーします。例：閾値アラーム。 |
| MQTT Listener | MQTTブローカーとして動作し、受信MQTTメッセージを監視して実行中のワークフローをトリガーします。 |
| HTTP Listener | HTTPサーバーとして動作し、受信MQTTメッセージを監視して実行中のワークフローをトリガーします。 |
- 開始ノードの後に他のノードを追加し、各ノードを接続します。
- ノードをダブルクリックすると内容を編集できます。削除する場合は、対象ノードを右クリックし Deleteをクリックします。
- 上部の Saveボタンをクリックしてワークフローを保存します。
テストとログ
テスト
ワークフローテスト: Test をクリックし、ノードの有効性やワークフローの正常動作を確認します。
ノードテスト: Webhook、コード、メール通知ノードでは、Test the Node ボタンをクリックし設定の正常動作を確認できます。
ログ
実行ログ: ワークフローがトリガーされるたびに実行ログが生成され、実行状態・入力・出力・その他の情報が記録されます。
テストログ：ワークフローをテストするために [Test]をクリックすると、テストログが生成され、実行状態、入力、出力、その他の情報が記録されます。
ワークフローのエクスポートとインポート
エクスポート：対象のワークフローを選択し、 [Export]をクリックすると、ワークフローがJSON形式のファイルとしてエクスポートされます。
インポート： [Import from DSL]をクリックしてJSON形式のワークフローファイルをアップロードし、 [Confirm]をクリックして設定を保存します。
ワークフローの削除
単一ワークフローの削除： 対象ワークフローの Delete アイコンをクリックして削除します。
一括ワークフロー削除： 対象ワークフローのチェックボックスを選択し、上部の Delete ボタンをクリックして削除します。
注意
- 有効化されているワークフローは削除できません。
ノードの概要
ノードはワークフローの基本単位です。Beaver IoTでは以下のノードを直列に接続し、柔軟なアプリケーション構築のためのワークフローを構築できます。
開始ノード:
| ノード | 説明 |
|---|---|
| Timer | スケジュール時間または周期に基づいてワークフローをトリガーします。例: スケジュールスイッチ。 |
| Trigger | ダッシュボード上のトリガーウィジェットによってワークフローをトリガーします。例: ボタンスイッチ。 |
| Entity Listener | エンティティデータが変更された際にワークフローをトリガーします。例: 閾値アラーム。 |
| MQTT Listener | MQTTブローカーとして機能し、受信MQTTメッセージを監視して実行中のワークフローをトリガーします。 |
| HTTP Listener | HTTPサーバーとして動作し、受信MQTTメッセージを監視して実行中のワークフローをトリガーします。 |
外部ノード:
| ノード | 説明 |
|---|---|
| Email Notification | SMTPプロトコルに基づき受信者にメール通知を送信します。件名と通知内容はカスタマイズ可能で、メール本文には本ワークフローの変数挿入をサポートします。送信前にSMTPクライアント設定の構成が必要です。 |
| Webhook Push | 事前設定されたWebhook URLアドレスへペイロード値をプッシュします。ペイロードが空の場合、ワークフローは前工程ノードからの全出力内容をWebhook URLアドレスへプッシュします。 |
| HTTP Request | 外部HTTP APIを呼び出します。 |
| Output | ワークフローの変数を出力します。このノードは開始ノードがトリガーの場合に利用可能です。 |
WebhookプッシュノードにSecretKeyを入力した場合、リクエストのヘッダーには正当性検証のため以下のフィールドが含まれます：SignatureTimestampNonce
検証方法：
- ステップ1：
Payload=Timestamp + Nonce + Request Body - ステップ2：
SecretKeyとHmac256アルゴリズムを用いてペイロードの結果を計算し、結果を16進形式の文字列に変換します。 - ステップ3：計算結果が
Signatureと一致するか確認。一致する場合、リクエストは正当と判定される。
アクションノード：
| ノード | 説明 |
|---|---|
| Entity Assigner | 前工程ノードの出力を指定エンティティに割り当てます。 |
| Entity Selection | 本ワークフローに受け渡すエンティティを選択し、後続ノードの引数として機能させます。 |
| Service Invocation | エンティティまたは他ワークフローからサービスを呼び出します。 |
| Code | 柔軟なデータ処理機能を実現するためのコードを記述します。Beaver IoTでは以下の言語をサポートしています：JavaScript (ES6)、Python 3、Groovy(4.0.26)、MVEL(2.5.2)。記述前に、コード内で使用する入力引数を定義する必要があります。また、出力結果を後続ノードに渡す必要がある場合は、出力変数も定義する必要があります。 |
制御ノード：
| ノード | 説明 |
|---|---|
| IF/ELSE | 論理条件が満たされた場合（IF）または満たされない場合（ELSE）に、このワークフローの後のノードが実行されます。1つのノードで最大5つの論理条件を追加でき、1つの論理条件は複数のサブ条件をサポートし、これらのサブ条件はANDまたはORの関係で接続できます。さらに、Beaver IoTでは以下の言語による論理条件の記述をサポートしています：JavaScript (ES6)、Python(2.7)、Groovy(4.0.26)、およびMVEL(2.5.2)。 |
