59 lines
4.9 KiB
HTML
59 lines
4.9 KiB
HTML
<!--
|
||
Copyright JS Foundation and other contributors, http://js.foundation
|
||
|
||
Licensed under the Apache License, Version 2.0 (the "License");
|
||
you may not use this file except in compliance with the License.
|
||
You may obtain a copy of the License at
|
||
|
||
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
||
Unless required by applicable law or agreed to in writing, software
|
||
distributed under the License is distributed on an "AS IS" BASIS,
|
||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
See the License for the specific language governing permissions and
|
||
limitations under the License.
|
||
-->
|
||
|
||
<script type="text/html" data-help-name="file">
|
||
<p><code>msg.payload</code>をファイルに書き出します。書き出しは、ファイルの最後に追記もしくは既存の内容の置き換えを選択できます。その他、ファイルの削除を行うことも可能です。</p>
|
||
<h3>入力</h3>
|
||
<dl class="message-properties">
|
||
<dt class="optional">filename <span class="property-type">文字列</span></dt>
|
||
<dd>更新するファイルの名前は、ノード設定やメッセージのプロパティで指定できます。デフォルトでは、<code>msg.filename</code>が使われますが、ノード内でカスタマイズすることも可能です。
|
||
</dd>
|
||
<dt class="optional">encoding <span class="property-type">文字列</span></dt>
|
||
<dd>エンコーディングをmsgで設定する構成にした際は、この任意のプロパティでエンコーディングを設定できます。</dt>
|
||
</dl>
|
||
<h3>出力</h3>
|
||
<p>書き込みの完了時、入力メッセージを出力端子に送出します。</p>
|
||
<h3>詳細</h3>
|
||
<p>入力メッセージのペイロードをファイルの最後に追記します。改行(\n)を各データの最後に追加することもできます。</p>
|
||
<p><code>msg.filename</code>を使う場合、書き込みを行う毎にファイルをクローズします。より良い性能を得るためにはファイル名をノードに設定してください。</p>
|
||
<p>追記を行う代わりに、ファイル全体を上書きするように設定することもできます。例えば、画像のようなバイナリデータをファイルに書き出す場合は、このオプションを指定し、改行を追記するオプションを指定しないようにします。</p>
|
||
<p>ファイル出力の際のエンコーディングは、エンコーディングリストから選択できます。</p>
|
||
<p>その他、ファイルの削除を行うことも可能です。</p>
|
||
</script>
|
||
|
||
<script type="text/html" data-help-name="file in">
|
||
<p>ファイルの内容を文字列もしくはバイナリバッファとして読み出します。</p>
|
||
<h3>入力</h3>
|
||
<dl class="message-properties">
|
||
<dt class="optional">filename <span class="property-type">文字列</span></dt>
|
||
<dd>読み込むファイルの名前は、ノード設定やメッセージのプロパティで指定できます。デフォルトでは、<code>msg.filename</code>が使われますが、ノード内でカスタマイズすることも可能です。
|
||
</dd>
|
||
</dl>
|
||
<h3>出力</h3>
|
||
<dl class="message-properties">
|
||
<dt>payload <span class="property-type">文字列 | バッファ</span></dt>
|
||
<dd>ファイルの内容を文字列もしくはバッファで表現します。</dd>
|
||
<dt class="optional">filename <span class="property-type">文字列</span></dt>
|
||
<dd>読み出し対象のファイル名をノードに設定していない場合、この任意のプロパティでファイルの名前を指定します。</dd>
|
||
</dl>
|
||
<h3>詳細</h3>
|
||
<p>ファイルネームは絶対パスでの指定を推奨します。絶対パスを指定しない場合は、Node-REDプロセスのワーキングディレクトリからの相対パスとして扱います。</p>
|
||
<p>Windowsではパスの区切り文字を(例えば、<code>\\ユーザー\\名前</code>のように)エスケープする必要があります。</p>
|
||
<p>テキストファイルの場合、行毎に分割して各々メッセージを送信することができます。また、バイナリファイルの場合、小さな塊のバッファに分割して送信できます。バッファの分割単位はオペレーティングシステム依存ですが、一般に64k(Linux/Mac)もしくは41k(Windows)です。</p>
|
||
<p>複数のメッセージに分割する場合、各メッセージには<code>parts</code>プロパティが設定され、メッセージ列を構成します。</p>
|
||
<p>出力形式が文字列の場合、入力データのエンコーディングをエンコーディングリストから選択できます。</p>
|
||
<p>エラーはcatchノードで補足して処理することを推奨します。</p>
|
||
</script>
|