# WriteData

WriteData 関数を使用して、ファイルにデータを書き込んだり、ローカルデバイスや FTP サーバ上のファイルにデータ文字列を追加したりします。この関数を使用すると、データの結果をログに記録してファイルに表示することができます。

注 : ファイルは、選択した保存先にオンラインまたはオフラインで保存できます。

## WriteData の入力

パラメータ | 説明
データ | テキスト文字列、またはファイルに書き込むまたは追加するテキスト文字列を含むセルへの参照を指定します。
イベント | 更新を強制するイベントを指定します。 このパラメータは、例えば、次のいずれかのタイムスタンプが含まれているイベントの参照である必要があります。 イベント 関数を含むセル。 Button 関数を含むセル。
ストレージ | データファイルをローカルデバイスに保存するか、FTP サーバに保存するかを指定します。 保存場所は、接続されているデバイスと関数の [ストレージ] 設定によって異なります。
[ストレージ] 設定 | 接続されているデバイス | 保存先
--- | --- | ---
ローカルデバイス | In-Sight デバイス | In-Sight デバイス In-Sight デバイスに取り付けられた SD カード 注 : ファイルを表示するには、FileZilla Client などの FTP ソフトウェアを使用する必要があります。詳細については、「In-Sight デバイスに保存されているファイルの表示方法」を参照してください。 SD カードストレージを使用する場合は、ジョブを実行する前に SD カードが挿入されていることを確認してください。SD カードを挿入せずに SD カードストレージを設定した場合、ジョブによってファイルが内部フラッシュドライブの /sdcard ディレクトリに保存されます。
PC | PC 注 : FTP サーバを使用した PC への保存のみがサポートされています。
FTP サーバ | 任意のデバイス | 指定した FTP サーバ
サーバ | データファイルの出力先になるネットワーク上の FTP サーバのサーバ名 (または IP アドレス) を指定します。FTP サーバとしては、ネットワーク上の In-Sight エミュレータまたは FTP サーバとして認識されるデバイスがあります。 注 : このオプションは、[ストレージ] タイプとして [FTP サーバ] を選択した場合のみ有効になります。 特定のポートが必要な場合は、サーバ名に追加することができます。例えば、FTP サーバがポート 50021 を使用する場合は、「127.0.0.1:50021」と入力します。
ユーザ名 | FTP サーバのユーザ名を指定します。このフィールドを空白のままにすると、「admin」が使用されます。 注 : このオプションは、[ストレージ] タイプとして [FTP サーバ] を選択した場合のみ有効になります。
パスワード | FTP サーバのパスワードを指定します。パスワードでは大文字と小文字が区別されます。FTP サーバにパスワードがない場合は、このフィールドを空白のままにしておくことができます。 注 : このオプションは、[ストレージ] タイプとして [FTP サーバ] を選択した場合のみ有効になります。 セキュリティの目的から、入力されたパスワードは WriteData 関数のプロパティシートや数式バー内では「*」の表示でマスクされます。 パスワードは、暗号化されたフォーマットでジョブファイルに保存されます。
ファイルパス | ファイルを保存する場所を指定します。 PC に保存する場合は、オペレーティングシステムの書き込み権限がある任意の場所にファイルを書き込むことができます。このフィールドには、ハードコードされたパス (X:/、X:/Subdir など)、UNC パス (//Cognex/shared/ など)、マップされたドライブ (M:/Subdir など)、または相対パス (../../Subdir) を入力できます。 パスが In-Sight デバイスまたは PC に存在しない場合、この関数は #ERR を返します。パスまたは FTP 資格情報が FTP サーバで無効な場合、この関数は #ERR を返しません。 このフィールドを空白のままにすると、ファイルは次のいずれかのデフォルトの場所に送信されます。 In-Sight デバイス:デバイスのルートディレクトリ。 FTP サーバ:指定した FTP サーバのデフォルトのディレクトリ。
ファイル名 | データファイルの名前を指定します。 注 : 有効な文字に関するオペレーティングシステムの制限に従ってください。
データフォーマット | ファイルの指定されたタイプ。各タイプに応じた拡張子が、自動的にファイル名に付加されます。
0 = TXT (デフォルト) | 標準 ASCII フォーマットのテキストファイル (.txt)。
1 = HTML | 標準 HTML フォーマットのファイル (.html)。
2 = XML | 標準 XML フォーマットのファイル (.xml)。
3 = CSV | 標準 CSV フォーマットのファイル (.csv)。
追記 | データをファイルに出力する方法を指定します。
0 = OFF | ファイル内の既存のデータを上書きします。
1 = ON (デフォルト) | ファイルの最後にテキスト文字列を追記します。

## WriteData の出力

戻り値 | 参照先のイベントがトリガされるたびに、データパラメータに含まれているデータ文字列をローカルデバイスまたは FTP サーバに書き込む WriteData データ構造体。 入力パラメータが無効な場合、またはファイルキューが満杯の場合、#ERR を返します。 注 : FTP サーバ、パスまたはファイル名が無効でも、#ERR を返しません。