File

ほかのプログラムがローカルまたはネットワークのフォルダーのファイルに書く値（試験機の CSV、データロガーのログ、JSON や XML の結果）をタグとして読み、ほかのプログラムのために行やファイル全体を書きます。「フォルダーとファイル」「ファイルのテキスト」「書き込み」のカード、各書式でタグが読むもの、受信フォルダー、列やフィールドごとにタグを提案するスキャン、3 つの完全な例、そしてドライバーがしないことです。

File ドライバーは、ほかのプログラムがファイルに書く値を読みます。試験機がサンプルごとに 1 行を追加する CSV、データロガーのログ、JSON や XML の結果ファイル、ロット番号だけが書かれたテキストファイルなどです。各タグはファイルの値を 1 つ読み、値はほかのどのタグの値とも同じところに届きます。Logic、ダッシュボード、そして Process の試験台の実行記録です。機器が許可していれば、ドライバーはほかのプログラムのためにも書きます。ファイルへの 1 行の追加、またはファイル全体の置き換えです。

主な用途は読み取りで、必要な答えは 3 つです。フォルダー、ファイル、その書式です。ファイルのテキストの読み方（文字コード、列の区切り文字、小数点の記号）は、判定のままにしておけばファイル自体から読み取り、スキャンが列やフィールドごとにタグを提案し、どのタグも読み取りのみで作られます。書き込みに関するものは、機器で書き込みをオンにしたときにだけ現れます。

このドライバーの機器は、1 つのフォルダーと、そこで読むファイルです。同じフォルダーの 2 つのファイルは 2 つの機器になります。フォルダーはドライブとフォルダー（C:\TestMachine\Logs）、またはネットワーク共有とその下のフォルダー（\\lab-pc\results）で、ステーションはそれを実行しているアカウントの Windows の権限でアクセスします。機器はドライバーの下に置かれ、フォルダーに整理でき、シリアル回線もブローカーも持たないどのドライバーとも同じく ドライバー → フォルダー → 機器 → タグ となります。

ドライバーのページ

見出しの下の行には「各機器は 1 つのファイル、または 1 つのフォルダーに届くファイルを読み取ります。機器を追加し、フォルダー、ファイル、書式を入力してからスキャンすると、値をタグとして追加できます。」と書かれています。Connector の構成の権限があるとき、ページにはこのドライバー独自のスキャンの範囲のカードがあり、スキャンが読むファイルを持ちます（機器検出を参照）。その下には、どのドライバーとも同じ機器の表（機器の表を参照）があり、タイトルの右にある機器を追加で増やします。空のときは「機器はまだありません。」と表示します。ドライバーのバーには機器検出があり、スキャンの範囲のカードがそろうまで灰色です。このドライバーはファイルとデータベースの下にあり、ドライバーのどの一覧でも、このカテゴリーは Web と API とテストの間にあります。

機器

このドライバーの機器には「接続」のカードがありません。その位置にフォルダーとファイルのカードがあり、続いてファイルのテキストのカード、1 つのファイルを読む機器ではさらに書き込みのカードがあります。「機器」のカードの読み出し周期（ms）は既定で 1000 で、タグがファイルを読む頻度を表し、どのドライバーとも同じように各タグで上書きできます。

新しい機器にはフォルダーがありません。「フォルダーがまだ入力されていません」と表示し、ページには「フォルダーが入力されるまで、ステーションはこの機器を読み取りません。そのため、まだ何も読み取っておらず、表示するエラーもありません。下の「フォルダーとファイル」カードでフォルダーを入力すると、ステーションが読み取りを始めます。」と表示され、フォルダーが入力されるまで何も読みません。見出しに表示される基準 URI は実行時のアドレスで、フォルダーと名前を URI の形で書き、その後に判定以外に設定したものが続きます。file://single?folder=C%3A%5CTestMachine%5CLogs&name=Log_%7Byyyy-MM-dd%7D.csv&format=delimited、受信フォルダーなら file://inbox?... です。

「フォルダーとファイル」のカード

日付の部分を持つ名前は、波かっこの中に .NET の日付と時刻の書式で書き、ステーション自身の時計で決まります。Log_{yyyy-MM-dd}.csv は今日なら Log_2026-10-03.csv で、午前 0 時を過ぎると翌日のファイルになり、Data_{yyyy-MM}.txt は毎月変わります。入力欄の下に、カードは今それがどのファイルかを表示します。「今日: Log_2026-10-03.csv」。二重の波かっこ {{ と }} は名前の中の波かっこです。日付の部分にコロンは書きません。ファイル名に使えないからです。{HH:mm} ではなく {HH-mm} と書きます。

機器が動き出すと、カードは読んでいるファイルを伝えます。

カードが受け付けられない設定はカードの下に表示され、直すまで機器は保存されません。

保存もカードと同じ規則を守り、拒否したときは操作ログ帯がそう伝えます：「機器 'Tensile tester' に、ドライバーが使えないファイルの設定があります。開いて、パネルが示す欄を直してください。」

「ファイルのテキスト」のカード

ファイルの文字、列、数値の読み方です。どの設定もファイルから判定から始まり、ドライバーが使用中のファイルから読み取ります。そのままにした設定の下には、機器がファイルを読んだ後、見つけたものを伝える行が表示されます（例:「ファイルから検出: UTF-8」）。最初の数行からはわからないファイルのために、どの設定も選んで固定できます。

「書き込み」のカード

1 つのファイルを読む機器には書き込みのカードがあります。受信フォルダーは読み取りだけなので、このカードはありません。

書き込みは、機器のどのタグも書き込まなくなってからでないとオフにできません。まだ書き込むタグがある間は、スイッチは表示されたまま灰色になり、理由を伝えます：「この機器のタグ 2 個がファイルに書き込みます。書き込みをオフにする前に、それらを読み取りのみにしてください。」（1 つなら「この機器のタグ 1 つがファイルに書き込みます。書き込みをオフにする前に、そのタグを読み取りのみにしてください。」）。

オンライン、待機、オフライン

タグのアドレス

タグが読むもの

このドライバーのタグには自分のアドレス入力欄がありません。信号源のカードが何を読むかを尋ね、値なら、機器の書式のどこに値があるかを尋ねます。

信号源が読めない型は、読める型を示して拒否されます：「これを読み取れるデータ型のいずれかを選んでください: Int64。」別の信号源を選ぶと、その型になります。ファイルから取り出したテキストは、Generic serial and TCP ドライバーがメッセージを読むのと同じようにタグの型として読み、ファイルの小数点の記号を使います。Boolean は 1、true、on、yes と 0、false、off、no を読み、整数は整数を読み、String は文字をそのまま受け取るので、0412 のようなコードは String のときだけ先頭のゼロを保ちます。

どのタグも読み取りのみで作られ、書き込みを許可していない機器では、アクセスの欄はほかを提示しません。機器が書き込みを許可すると、値かファイル全体を読むタグは読み書きか書き込みのみに、ファイル名を読むタグは読み書きにできます。ファイルの情報（有無、サイズ、最終更新、行数）は決して書き込みません：「ファイルの情報には書き込めません。タグを読み取りのみのままにしてください。」

CSV と列形式のテキスト

二重引用符で囲んだフィールドは区切り文字を含めます。改行を含むフィールドは読みません。欄が成り立たないタグは保存されず、ページに足りないものが表示されます。

読み取りのみの取得元のアドレス（バス上）の行は、ドライバーが受け取るものを示します。column?name=Force は最後の行の Force、column?number=3&row=number&rowNumber=5 は 5 行目の 3 列目、column?name=Force&row=match&key=Sample&equals=0412 はサンプル 0412 の行です。

自由形式のテキスト

位置と項目は 1 から数え、パターンは値を囲むキャプチャグループをちょうど 1 つ持つ .NET の正規表現で、読むのに 250 ms より長くかかる行は読みません。拒否は汎用ドライバー自身のもので、たとえば「値の最初の文字の位置を、1 から数えて入れてください。」や「パターンには、値を囲むキャプチャグループがちょうど 1 つ必要です。」です。バス上のアドレスは line に当てはまるものを続けて書きます（例: line?row=match&contains=Result&extract=regex&pattern=...）。

JSON と XML

JSON の数値、true、false はそのまま受け取り、文字列はタグの型として読みます。オブジェクトやリストは String として、その JSON だけを読めます。JSON や XML の文書は変わったときに全体を読み、最大 4 MiB で、DTD は読みません。バス上のアドレスは json?path=result.force または xml?path=Result%2FForce です。

読み取り

読み取りのたびに、ドライバーは Windows にファイルのサイズと時刻を尋ねます。これは Windows の変更通知が働かないネットワーク共有でも機能し、どれかが変わったときにだけファイルを開きます。開くときは常に読み取り、書き込み、削除の共有を許すので、ファイルを書いているプログラムが妨げられることはありません。

どの読み取り値も、読んだ時刻ではなくファイルの最終更新の時刻が付くので、実行記録はほかのプログラムが書いた時刻にサンプルを置きます。

受信フォルダー

読み取り元を受信フォルダーにするのは、サンプルごとに 1 つのファイル（Test_0412.json、Test_0413.json...）を書く機械のためです。パターンに合う新しいファイルは、それぞれ到着順に 1 回だけ読みます。

何も削除しません。サブフォルダー Processed は、誰かが空にするまで増えていきます。受信フォルダーには決して書き込みません。

書き込み

1 つのファイルを読み、書き込みを許可している機器では、値かファイル全体を読み、アクセスで書き込むタグが、書き込みで何をするかを示します。

{value:FORMAT} は .NET の数値書式、{datetime:FORMAT} は .NET の日付と時刻の書式を取り、ステーションの時計を使い、指定がなければ yyyy-MM-dd HH:mm:ss です。数値はファイルの小数点の記号で書くので、同じテンプレートでもカンマを使うファイルには 12,50 と書きます。Boolean のタグのテンプレートは {value} を省略でき、真を書き込むとコマンドのように行を追加します。ドライバーが埋められないテンプレートは、タグのページで拒否されます。

名前が指すフォルダーやサブフォルダーは、書き込みに必要になったときに作られ、常に機器のフォルダーの中にあります。

機器検出

「スキャンの範囲」のカード

Connector の構成の権限があるとき、ドライバーのページにはスキャンの範囲のカードがあり、その下の行は「1 つのファイルを読み取り、見つかった列やフィールドごと、およびファイルの情報ごとにタグを提案します。機器を選んでそのファイルを読むか、フォルダー、ファイル、書式を入力してください。」です。

範囲に足りないものはカードの下に赤字で表示され、そろうまで機器検出は灰色のままです。

スキャンする機器に保存できない編集があると、スキャンは始まりません：「スキャンする機器の編集を保存できなかったため、機器検出は始まりませんでした。」

スキャンが提示するもの

スキャンは、1 つのファイルを読む機器が今読んでいるファイル、または受信フォルダーの最も新しいファイルを読みます（そのファイルは移動しません）。ファイルがない、フォルダーにアクセスできない、文書を解析できない、のいずれかなら、スキャンは理由を付けて終わります。候補を 1 つ提示し、見つかった値を候補のタグとし、どれも読み取りのみです。

スキャンが示す値は CSV ファイルの列も含めて 500 個までで、そこで打ち切られたスキャンは、スキャンを締めくくる行と結果の上で「result.json のスキャンは途中で止まりました。スキャンが示す値は 500 個までです。ほかの値は、列、JSON パスまたは XML パスを指定してタグとして追加してください。」と伝えます。

入力したファイルの候補はファイルの名前（run.csv なら run）、日付の部分を持つ名前や受信フォルダーならフォルダーの名前を付けます。フォルダー、名前、読み取り元をこのドライバーの機器がすでに読んでいる候補（スキャンした機器、または同じ別の機器）は設定済みと表示されます。そのカードには、その機器のどのタグもまだ読んでいない値だけがチェックされた状態で並び、開くの前にあるタグにして追加が、チェックしたものを読み取りのみでその機器に追加します。スキャンのほかの動作は機器検出にあります。

機器自身のページでも、ドライバーのページを使わずに同じことができます。「タグ」のカードの見出しにあるタグ検出は、その機器のファイルを保存されているとおりに読み、まだタグがない値だけを出します（機器のタグを検出するを参照）。

例：試験機の毎日の CSV

引張試験機が毎日 1 つの CSV を C:\TestMachine\Logs に書きます。名前は Log_2026-10-03.csv で、見出し行は Sample;Force;Elongation、サンプルごとに 0412;12,5;3,1 のような行を書きます。簡単な手順で読みます。

1. ドライバーのページで機器を追加し、名前を Tensile tester にします。
2. フォルダーとファイルのカードで、フォルダーのパスに C:\TestMachine\Logs、ファイル名に Log_{yyyy-MM-dd}.csv を入力し、1 つのファイルと CSV と列形式のテキスト はそのままにします。カードは「今日: Log_2026-10-03.csv」と表示し、機器がそれを読むと「読み取り中: Log_2026-10-03.csv」と表示します。ファイルのテキストのカードはファイルから判定のままにします。セミコロンと、小数点としてのカンマを見つけます。
3. ドライバーのページで、スキャンするファイルに Tensile tester を選び、機器検出を押します。候補は設定済みで、Sample（String で、0412 のゼロを保ちます）、Force と Elongation（Double）、そしてファイルの情報を並べます。タグにして追加を押します。

各タグは最後の行を読みます。最終更新は新しいサンプルのたびに変わり、Logic のアクションはそれでサンプルが届いたとわかります。午前 0 時に機器は翌日のファイルに移り、試験機がそれを書くまで、値には読み取り値がなく、ファイルの有無は偽を読みます。エージェントもツールで同じことができます。

device_upsert name="Tensile tester" driver=File fileFolder="C:\TestMachine\Logs" fileName="Log_{yyyy-MM-dd}.csv" fileFormat=Delimited
device_discover driver=File fileDevice="Tensile tester"
tag_upsert device="Tensile tester" name=Force address=Force opcUaType=Double
tag_upsert device="Tensile tester" name=Sample address=Sample opcUaType=String
tag_upsert device="Tensile tester" name="Last change" fileSource=Modified

例：JSON の結果ファイルの受信フォルダー

試験セルがサンプルごとに 1 つの結果ファイルを C:\Results\Inbox に置きます。たとえば {"sample":"0413","result":{"force":12.5,"ok":true}} を含む Test_0413.json です。

1. 機器を追加し、名前を Results、フォルダーのパスを C:\Results\Inbox、読み取り元を受信フォルダー、読み取るファイルを Test_*.json、ファイルの書式を JSON にします。
2. タグを追加で Force、JSON パス result.force、Double。タグを追加で Pass、JSON パス result.ok、Boolean。タグを追加で Sample、JSON パス sample、String。
3. タグを追加で Source file、読み取る内容はファイル名です。値がどのファイルから来たかを示します。

各ファイルは、1 秒間動かず、書き込みのために開いているプログラムがなくなってから、届いた順に 1 回だけ読みます。それぞれが独立した読み取り値で、ファイルの時刻が付きます。すべてのタグが読んだら C:\Results\Inbox\Processed に移ります。何も削除しません。ツールでは次のとおりです。

device_upsert name=Results driver=File fileFolder="C:\Results\Inbox" fileName="Test_*.json" fileMode=Inbox fileFormat=Json
tag_upsert device=Results name=Force address=result.force opcUaType=Double
tag_upsert device=Results name=Pass address=result.ok opcUaType=Boolean
tag_upsert device=Results name=Sample address=sample opcUaType=String
tag_upsert device=Results name="Source file" fileSource=Name

例：ほかのプログラムのために 1 行を追加する

ほかのプログラムが D:\Records\run.csv を読みます。1 秒に 1 行で、時刻と圧力です。

1. 機器を追加し、名前を Run log、フォルダーのパスを D:\Records、ファイル名を run.csv にします。
2. 書き込みのカードで書き込みを許可をオンにし、見出しの文字列に Time;Pressure を入力します。
3. タグを追加で Line、Double、アクセスは書き込みのみ、書き込み時の動作は行を追加、行のテンプレートは {datetime};{value:0.00} にします。

Line に 12.5 を書き込むと 2026-10-03 14:05:12;12.50 を追加し、ファイルがすでにカンマを使っているか、小数点の記号が小数点はカンマ (12,5) ならカンマを使います。書き込みで作られるファイルには先に Time;Pressure が書かれます。続けて素早く行う書き込みも、すべて順に残ります。実行ごとに 1 つのファイルを書くには、File というタグを追加し、読み取る内容をファイル名、読み書きにします。実行が始まると Logic がシリアル番号に .csv を付けて書き込み、行はそのファイルに書かれます。ツールでは次のとおりです。

device_upsert name="Run log" driver=File fileFolder="D:\Records" fileName=run.csv fileFormat=Delimited fileWrites=true fileHeaderText="Time;Pressure"
tag_upsert device="Run log" name=Line opcUaType=Double accessType=WriteOnly fileWriteMode=AppendLine fileLineTemplate="{datetime};{value:0.00}"
tag_upsert device="Run log" name=File fileSource=Name accessType=ReadAndWrite

エージェントのツール

driver_capabilities はこのドライバーを file の下で説明します。簡単な手順、機器の各欄、フォルダーの規則とその中だけで動く制限、ファイル名の形、2 つの読み方、書式とそれぞれのアドレスの文法、信号源とその型、テキストの設定、読み取りと書き込みの動作、機器検出、そして 3 つの完全な例です。device_upsert driver=File は fileFolder、fileName、fileMode（既定の SingleFile か Inbox）、fileFormat（既定の Delimited、Text、Json、Xml）、fileEncoding（Automatic、Utf8、Windows1252）、fileSeparator（Automatic、Semicolon、Comma、Tab）、fileDecimal（Automatic、Point、Comma）、fileHeaderRow（0 から 1000）、fileWrites、そして書き込みがオンなら fileHeaderText と fileLineEnd（Automatic、CrLf、Lf）を受け取ります。返す機器は file を持ち、その fileStatus は動作中のドライバーが見つけたものです。使用中のファイル、それがあるかどうか、読み取った文字コード、区切り文字、改行コード、そして受信フォルダーで待っているファイルです。tag_upsert は fileSource（Value、WholeFile、Exists、Size、Modified、Name、Lines）、fileRow（Last、Number、Matching）、fileRowNumber、fileKeyColumn、fileMatchText、fileWriteMode（AppendLine か ReplaceFile）、fileLineTemplate を受け取ります。列やパスは address で、自由形式のテキストの値は汎用ドライバーの valueExtraction、valueStart、valueLength、valueSeparator、valueField、valuePattern を使い、新しいタグは読み取りのみで、opcUaType で別に指定しない限り信号源自身の型になります。device_discover driver=File は、このドライバーの機器の名前である fileDevice、またはスキャンのために入力した fileFolder、fileName、fileMode、fileFormat を読みます。設定済みの機器に足りないタグは tag_upsert で追加します。connector_browse は各機器の fileFolder、fileName、fileMode、fileFormat を返します。ほかのツールはエージェントのツールにあります。

知っておきたい制限

• Excel のブックは読みません。ブックは、そのプログラムが CSV として保存してから読みます。
• ドライバーがファイルを削除することはありません。受信フォルダーは読んだものを Processed に移し、削除することがあるのは、失敗した置き換えの一時ファイルだけです。
• 「フォルダーの最も新しいファイル」は読み方の 1 つではありません。一緒に届いたファイルを失い、前のサンプルの値を見せることがあるからです。サンプルごとに 1 つのファイルを書く機械は、受信フォルダーで読みます。
• ファイルの中の値をその場で変えることはしません（CSV のセル、ほかのプログラムの JSON のメンバー）。書き込みは 1 行の追加かファイル全体の置き換えで、2 つのプログラムが同じファイルに書くと、互いの変更を失うことがあるからです。
• ネットワーク共有には、ステーションを実行しているアカウントの Windows の権限でアクセスします。機器はユーザーもパスワードも保存しないので、共有はそのアカウントを受け入れる必要があります（読み取り、そして書き込む機器や受信フォルダーでは書き込みと移動も）。
• ドライバーは自分のフォルダーの外には決して触れません。ほかの場所を指す名前は、入力したときにも書き込んだときにも拒否されます。
• ファイルは読み取りのたびに確認します。変更は次の読み取りでわかり、ほかのプログラムが書いたその瞬間にはわかりません。
• 改行を含む CSV のフィールドは読まず、JSON、XML、ファイル全体のタグが読むのは最大 4 MiB です。