なにがでるか

 ここのところずっと Node-RED のサンプルを見ながら各ノードの使い方を確認しています。 頭出しの記事はこちら をご確認ください。今回も 前回 に引き続きDelayノードを使ってみます。 遅延中に中断・即時実行する 最初のサンプルは「 flows > node-red > function > delay > 03 - Reset or flush pending message 」です。resetということは遅延中に中断ができるようです。flushというのはトイレの水を流すアレですね。 「 Hello World! 」を実行すると、1分間の遅延を経てログ「 Goodbye, World! 」を出力します。遅延中に reset を実行すると、中断しそれ以降のフローは実行されません。一方、遅延中に flush を実行すると、遅延が即時実行されます。冒頭で書いたとおり、トイレの水を流すイメージです。ポイントとしては「 msg.reset 」や「 msg.flush 」に「 true 」を設定してDelayノードに流し込むと、制御できる点です。resetはJavaScriptで言うところの clearTimeout()関数 的な位置付けですかね。 ちなみに、「Hello World!」Injectノードを連打して、遅延中にflushすると溜まっていいたフローが一気にまとめて実行されます。別の処理を待ちたいけど、フロー終了する際に全部終わるの待ってらんない、ってときにresetやflushして即時終了させる、みたいな用途で使うのかもしれません。 メッセージの実行速度を制限する 次のサンプルは「 flows > node-red > function > delay > 04 - Limit message rate 」です。実行速度を制御できるようです。 フローの頭から順番に見ていきます。まずはInjectノードから。msg.payloadに0〜9の数字を要素に持つ配列をJSON形式で設定しています。 続いてSplitノード。msg.payloadの配列を固定長1で分割してそれぞれmsg.payloadに設定してフローを流す、ということになるみたいです。これでSplitノードの出力ポートから10個のmsgオブジェ...

ここのところずっと Node-RED のサンプルを見ながら各ノードの使い方を確認しています。 頭出しの記事はこちら をご確認ください。今回はDelayノードを使ってみます。要はJavaScriptで言うところの「 setTimeout() 」みたいなものかと思います。 指定した時間メッセージを遅延させる 最初のサンプルは「 flows > node-red > function > delay > 01 - Delay message 」です。フローを実行すると、delayノードで遅延が発生して、時間差でログが出力されます。 Delayノードのプロパティを見ると、指定した時間（3秒）だけメッセージが遅延するようです。ここは特に解説の必要はないと思います。 msgオブジェクトのプロパティ値により遅延させる 次のサンプルは「 flows > node-red > function > delay > 02 - Delay message by message property 」です。先程と同じくDelayノードのプロパティを見てみます。ポイントは以下の2点です。 msg.delay値により遅延時間が決定される 「 時間 」の指定は無視される Injectノードでは「 msg.delay 」に遅延時間1000（ミリ秒）が設定されています。実行すると1秒遅延します。「 msg.delay 」に10000（ミリ秒）を設定すると10秒遅延します。サンプル01では遅延時間がDelayノードの設定で固定されていたのが、サンプル02ではmsg.delayの値に応じて遅延時間が変更可能になっています。 まとめ Delayノードを使うことによりフローを遅延させることができます。以下、2種類の挙動を実現できます。 Delayノードのプロパティに設定した値で遅延時間を固定する msg.delayの値に応じて遅延時間を可変にする 次回もDelayノードを見ていきます。

前回 に引き続きTemplateノードを使ってみます。 JSON形式のテンプレート 最初のサンプルは「 flows > node-red > function > template > 02 - Parse result as JSON 」です。Templateノードのプロパティを見てみます。ポイントは以下の2点です。 テンプレートがJSON形式で記述されている 出力形式の設定がJSONになっている 実行結果は以下の通りで、msg.playloadにテンプレートが適用されたJSONオブジェクトが格納されていることが確認できます。 期待通りかと思うので、ここはサラッと流して次のサンプルを見てみます。 YAML形式のテンプレート 次のサンプルは「 flows > node-red > function > template > 03 - Parse result as YAML 」です。先程と同じくTemplateノードのプロパティを見てみます。ポイントは以下の2点です。 テンプレートがYAML形式で記述されている 出力形式の設定がYAMLになっている 実行結果は、先程のサンプル02と同じく、msg.payloadにテンプレートが適用されたJSONオブジェクトが設定されます。 ここで違和感があったのが「 出力形式 」の設定が違っていてもmsg.payloadに設定される結果は変わらないということです。「 出力形式 」って表現から、msg.payloadにテンプレートを適用した結果の形式がYAMLになるものだと勘違いしていましたが、どうやらそうではなく、 テンプレートを適用した結果をどういう形式で扱うか ってことみたいです。例えば、HTML形式のテンプレートを書きたい場合は、 出力形式を平文 に設定しておけばいい感じかもしれません。それにしても、ユーザに選択させる必要性がよくわかりませんでした。自動で認識してよって感じです。 まとめ まとめます。 「出力形式」はTemplateノードの出力形式を変更するものではなく、テンプレートを適用した結果をどういう形式で扱うか指定するもの 出力形式は平文、JSON、YAMLをサポートしている 利用者に出力形式を選択させる意味がよくわからない（自動で認識して欲しい）

今回はTemplateノードを使ってみます。 Mustacheテンプレート 最初のサンプルは「 flows > node-red > function > template > 01 - Use mustache syntax 」です。置換したいパラメータを「 {{}} 」で括ってテンプレート上に記述するMustache形式が利用できるとのこと。 まずはInjectノードを見てみます。msg.payloadにJSONオブジェクトが、msg.topicに文字列「 Fruits 」が設定されています。 msg.payloadの内容が見づらいのでJSONエディタで開いてみると、以下のように name と price をプロパティに持つJSONオブジェクトが配列形式になっています。 続いて、templateノードを見てみます。わりと盛りだくさんですが、次の情報が読み取れます。 テンプレートが適用された文字列は「 プロパティ 」で指定した「 msg.payload 」に格納されます テンプレートエディタのハイライト（見やすいよう色付け）は「 構文 」で指定した「 mustache 」が適用されます テンプレート内の「 {{topic}} 」の部分に「 msg.topic 」の値（ Fruits ）が埋め込まれます 「 {{#payload}}〜{{/payload}} 」が「 JSON配列 」として評価され、テンプレート内で繰り返されます 「 {{name}} 」と「 {{price}} 」の部分に「 msg.payload 」のJSON配列の各値が埋め込まれます テンプレートは「 Mustacheテンプレート 」として評価されます 「 平文 」として出力されます 実行結果は、以下の通りです。期待通り。 templateノードの「 プロパティ 」を変えてみたらどういう結果になるでしょうか。試しに「 msg.hoge 」としてみます。 わかりやすいようにdebugノードの出力対象をmsgオブジェクト全体としてみます。 結果は以下の通りです。 msg.payload と msg.topic にはinjectノードで指定した値（それぞれJSON配列と文字列）がそのまま格納されている msg.hoge にはテンプレートが適用された文字列が格納されている まとめ...

引き続きサンプルフローを見ていきます。 Range ノードシリーズ2回目にして最終回です。 入力値を制限する 最初のサンプルは「 flows > node-red > function > range > 03 - Limit input value 」です。入力値を指定した範囲内になるよう制限するようです。 「 動作 」の設定は 前回 紹介したRangeノードのサンプル01と同じく「 入力値の範囲外の値を最小値/最大値とし拡大/縮小 」です。違うのは入力値の範囲と出力値の範囲のみ。 実行結果は、以下の通りです。 入力0→出力0 入力10→出力9 入力100→出力90 「 入力値の範囲を出力値の範囲にマッピングして按分計算（上下限を超えた値はサチる） 」 ってことですね。これ以上の説明は不要かと思います。 入力値の範囲外の値を範囲幅で割った余りとし拡大/縮小 次のサンプルは「 flows > node-red > function > range > 04 - Scale and wrap input value 」です。挙動の一部はよくわからない上に、利用する場面もイマイチよくわかりませんでした。プロパティを見ていくと、「 動作 」の設定が「 入力値の範囲外の値を範囲幅で割った余りとし（「て」が抜けてる？）拡大/縮小 」となっている以外、Rangeノードサンプル03と同じです。 実行すると、以下のような結果になります。 入力0→出力0 入力10→出力10 入力100→出力10 「 入力値の範囲外の値を範囲幅で割った余りとし拡大/縮小 」の表現をそのまま素直に読み解くと、 入力値の範囲外の値：10 （出力値の？）範囲幅：90 「入力値の範囲外の値」を「（出力値の？）範囲幅」で割った余りとし（て？）拡大/縮小：10÷90の余り：10 続いて、 入力値の範囲外の値：100 （出力値の？）範囲幅：90 「入力値の範囲外の値」を「（出力値の？）範囲幅」で割った余りとし（て？）拡大/縮小：100÷90の余り：10 計算通りになっているようです。ところで、「 入力値の範囲内 」の値を入力したらどうなるんでしょう。 入力値：5 （出力値の？）範囲幅：90 「入力値の範囲外の値」を「（出力値の？）範囲幅」で割った余りとし（て？）拡大/...

 引き続きサンプルフローを見ていきます。今回から Range ノードシリーズ開幕です。今回のサンプルは、挙動を見ていると理解できても、言葉で表現するのが難しかったです。 入力値の範囲を出力値の範囲にマッピングして按分計算（上下限を超えた値はサチる） 最初のサンプルは「 flows > node-red > function > range > 01 - Scale input value 」です。入力値をスケールして出力するらしいです。 「 動作 」の設定は「 入力値の範囲外の値を最小値/最大値とし拡大/縮小 」となっています。 実行するとこんな感じで、入力値が出力値の範囲の割合で按分され、出力値の範囲内の値が出るようです。 そうなると、このサンプルフローでは入力値として範囲（0〜1023）外の値を与えているわけではないので、画面の説明が不正確な気もします。意味合い的には、 「 入力値の範囲を出力値の範囲にマッピングして按分計算（上下限を超えた値はサチる） 」 みたいな感じでしょうか。文章にすると表現は難しいですが、感じ取りましょう。ちなみに、入力値の上限である1023より大きい値を与えたところ、出力は5になりました。 入力値の範囲を出力値の範囲にマッピングして按分計算（上下限を超えた値はサチらず倍率計算） 次のサンプルは「 flows > node-red > function > range > 02 - Scale input and round to integer 」です。 「 動作 」の設定は「 msg.payloadの値を拡大/縮小 」となっています。 実行すると、以下のような結果になります。 どうやら、「 入力値の範囲 」に対する「 入力値 」の倍率を出力値の範囲に倍率計算した値を出力するようです。例えば、入力値99の場合、入力値の範囲の上限9を11倍超えているので、「 出力値の範囲 」の上限128に11をかけた値「1408」が出力値となります。言葉で説明すると難しいですが、一つ前に紹介したサンプルの表現に沿うと意味合い的には 「 入力値の範囲を出力値の範囲にマッピングして按分計算（上下限を超えた値はサチらず倍率計算） 」 といったところでしょうか。 ところで、「 msg.payloadの値を拡...

Change ノードの最終回です。 プロパティの削除 最初のサンプルは「 flows > node-red > function > change > 06 - Delete message property 」です。msgプロパティを削除できるようです。へー。 削除したプロパティにアクセスすると例外は発生せず「 undefined 」になります。JavaScriptだと一般的な挙動ですね。 プロパティの移動 次のサンプルは「 flows > node-red > function > change > 07 - Move message property 」です。 Injectノード では msg.topicに文字列「Hello」 を設定しています。 Changeノードでは、msg.topicの値をmsg.payloadに移動しています。 フローを実行すると、msg.payloadの値に「Hello」が設定されていることが確認できます。 ところで、移動元のmsg.topicの値はどうなったんでしょう？疑問に思ったので、以下のようにDebugノードを追加してmsg.topicの値を出力してみます。 フローを実行すると、msg.topicは「undefined」になりました。「値の移動」とは文字通り「移動」ということのようです（コピーではない）。 まとめ 以上でChangeノードのサンプル確認は終了です。今回の内容をまとめます。 プロパティの値は削除できる 削除したプロパティはundefinedになる プロパティの値は移動できる 移動元はundefinedになる 文字通り値が移動する（コピーではない） Changeノードでできる操作は、サンプルでは利用していないもの含め以下の4つのようです。 値の代入 値の置換 値の削除 値の移動