File

Valores que outro programa grava num arquivo de uma pasta local ou de rede (o CSV de uma máquina de ensaio, o registro de um datalogger, um resultado em JSON ou XML) lidos como tags, e linhas ou arquivos inteiros gravados para outro programa ler: os cartões Pasta e arquivo, Texto do arquivo e Escrita, o que uma tag lê em cada formato, a pasta de entrada, a varredura que oferece uma tag por coluna ou campo, três exemplos completos e o que o driver não faz.

O driver File lê os valores que outro programa grava num arquivo: o CSV em que uma máquina de ensaio acrescenta uma linha depois de cada amostra, o registro de um datalogger, um arquivo de resultado em JSON ou XML, um arquivo de texto que só traz o código de um lote. Cada tag lê um valor do arquivo, e os valores chegam onde chegam os de toda outra tag: no Logic, nos dashboards, nas execuções de uma bancada de teste do Process. Onde o dispositivo permite, o driver também grava para outro programa ler: uma linha acrescentada a um arquivo, ou um arquivo inteiro substituído.

Ler é o uso principal, e pede três respostas: a pasta, o arquivo e o formato dele. Como o texto do arquivo se lê (a codificação, o separador de colunas, o separador decimal) vem do próprio arquivo enquanto fica em detectar, a varredura oferece uma tag por coluna ou campo, e toda tag nasce somente leitura. O que é de escrita só aparece depois que a escrita é ligada no dispositivo.

Um dispositivo deste driver é uma pasta e o arquivo que ele lê nela: dois arquivos da mesma pasta são dois dispositivos. A pasta é uma unidade e uma pasta (C:\TestMachine\Logs) ou um compartilhamento de rede e uma pasta dentro dele (\\lab-pc\results), e a estação a acessa com as permissões do Windows da conta em que roda. Os dispositivos ficam sob o driver e podem ser arquivados em pastas, Driver → Pasta → Dispositivo → Tag, como em todo driver sem linha serial nem broker.

A página do driver

A linha sob o cabeçalho diz "Cada dispositivo lê um arquivo, ou os arquivos que chegam a uma pasta. Acrescente um dispositivo, informe a pasta, o arquivo e o formato, e depois varra-o para acrescentar os valores como tags." Para Configurar Connector, a página traz o cartão Escopo da varredura próprio do driver, com o arquivo que a varredura lê (veja Descoberta). Abaixo dele fica a tabela Dispositivos de qualquer driver (veja A tabela de dispositivos), que cresce com Acrescentar dispositivo, à direita do título; vazia, diz "Nenhum dispositivo ainda." A barra do driver traz Descobrir, cinza até o cartão Escopo da varredura estar completo. O driver aparece em Arquivos e bancos de dados, a categoria que fica entre Web e APIs e Teste em toda lista de drivers.

Dispositivo

Um dispositivo deste driver não tem cartão Conexão: o cartão Pasta e arquivo fica no lugar dele, seguido do cartão Texto do arquivo e, num dispositivo que lê um arquivo, do cartão Escrita. O Intervalo de leitura (ms) do cartão Dispositivo, 1000 por padrão, diz de quanto em quanto tempo as tags leem o arquivo, com cada tag podendo sobrescrevê-lo como em qualquer driver.

Um dispositivo novo não tem pasta: diz "Pasta ainda não informada", a página dele diz "A estação não lê este dispositivo enquanto ele não tiver uma pasta, então nada é lido dele ainda e não há erro a mostrar. Informe a pasta no cartão Pasta e arquivo abaixo e a estação começa a lê-lo." e nada é lido até a pasta ser informada. A Base URI que o cabeçalho mostra é o endereço de runtime, com a pasta e o nome escritos em forma de URI, e depois deles o que não está em detectar: file://single?folder=C%3A%5CTestMachine%5CLogs&name=Log_%7Byyyy-MM-dd%7D.csv&format=delimited, ou file://inbox?... para uma pasta de entrada.

O cartão Pasta e arquivo

Um nome com uma parte de data é escrito entre chaves com um formato .NET de data e hora, no relógio da própria estação: Log_{yyyy-MM-dd}.csv é Log_2026-10-03.csv hoje e o arquivo do dia seguinte depois da meia-noite, e Data_{yyyy-MM}.txt muda todo mês. Abaixo da caixa, o cartão mostra qual arquivo é esse agora: "Hoje: Log_2026-10-03.csv". Chaves dobradas {{ e }} são chaves do nome. Uma parte de data nunca escreve dois-pontos, que nenhum nome de arquivo aceita: {HH-mm}, não {HH:mm}.

Quando o dispositivo roda, o cartão diz qual arquivo ele lê:

Uma configuração que o cartão não aceita é dita abaixo dos cartões, e o dispositivo não é salvo até ela ser corrigida:

O salvamento segue as mesmas regras, e o feed diz quando recusa uma: "O dispositivo 'Tensile tester' tem uma configuração de arquivo que o driver não consegue usar. Abra-o e corrija o campo que o painel marca."

O cartão Texto do arquivo

Como se leem os caracteres, as colunas e os números do arquivo. Toda configuração começa em Detectar pelo arquivo, e o driver a lê do arquivo em uso. Abaixo de uma configuração deixada assim, depois que o dispositivo leu o arquivo, uma linha diz o que ele encontrou, como "Encontrado no arquivo: UTF-8". Qualquer configuração pode ser fixada escolhendo-a, para um arquivo cujas primeiras linhas não dizem.

O cartão Escrita

Um dispositivo que lê um arquivo traz o cartão Escrita; uma pasta de entrada só é lida e não tem esse cartão.

A escrita só é desligada quando nenhuma tag do dispositivo escreve. Enquanto alguma ainda escreve, o interruptor continua desenhado e cinza, e diz por quê: "2 tags deste dispositivo escrevem no arquivo. Deixe-as somente leitura antes de desligar a escrita." ("Uma tag deste dispositivo escreve no arquivo. Deixe-a somente leitura antes de desligar a escrita." para uma).

Online, aguardando e offline

Endereçamento de tags

O que uma tag lê

Uma tag deste driver não tem caixa de endereço própria: o cartão Origem dela pergunta o que ela lê e, para um valor, onde o valor está no formato do dispositivo.

Um tipo em que a origem não é lida é recusado com os tipos em que ela é: "Escolha um dos tipos de dado em que isto é lido: Int64." Escolher outra origem traz o tipo dela. O texto tirado de um arquivo é lido no tipo da tag do jeito que o driver serial e TCP genérico lê uma mensagem, com o separador decimal do arquivo: um Boolean lê 1, true, on ou yes e 0, false, off ou no, um inteiro lê um número inteiro, e um String pega os caracteres como estão, então um código como 0412 só mantém o zero da frente como String.

Toda tag nasce Somente leitura, e num dispositivo que não permite escrita o campo Acesso não oferece outra coisa. Quando o dispositivo permite escrita, uma tag que lê Valor ou Arquivo inteiro pode ser Leitura e escrita ou Somente escrita, e uma tag que lê Nome do arquivo Leitura e escrita; os dados do arquivo (existe, tamanho, última alteração, contagem de linhas) nunca são escritos: "Um dado do arquivo não pode ser escrito. Deixe a tag somente leitura."

CSV e texto em colunas

Um campo entre aspas duplas pode conter o separador; um campo que contém uma quebra de linha não é lido. Uma tag cujos campos não funcionam não é salva, e a página dela diz o que falta:

A linha somente leitura Endereço de origem (barramento) mostra o que o driver recebe: column?name=Force para o Force da última linha, column?number=3&row=number&rowNumber=5 para a terceira coluna da quinta linha, column?name=Force&row=match&key=Sample&equals=0412 para a linha da amostra 0412.

Texto livre

Posições e campos contam a partir de 1, um padrão é uma expressão regular .NET com exatamente um grupo de captura em volta do valor, e uma linha que ele leva mais de 250 ms para ler não é lida. As recusas são as do próprio driver genérico, como "Informe o primeiro caractere do valor, contando a partir de 1." ou "O padrão precisa de exatamente um grupo de captura, em volta do valor." O endereço de barramento diz line seguido do que se aplica, por exemplo line?row=match&contains=Result&extract=regex&pattern=....

JSON e XML

Um número JSON, true ou false é pego como está, e uma string é lida no tipo da tag; um objeto ou uma lista só se lê como String, o JSON dele. Um documento JSON ou XML é lido inteiro quando mudou, no máximo 4 MiB, e nenhuma DTD é lida. O endereço de barramento é json?path=result.force ou xml?path=Result%2FForce.

Leitura

A cada leitura o driver pergunta ao Windows o tamanho e as horas do arquivo, o que funciona num compartilhamento de rede, onde os avisos de mudança do Windows falham, e só abre o arquivo quando um deles mudou. Ele sempre o abre compartilhando leitura, escrita e exclusão, então o programa que grava o arquivo nunca é bloqueado.

Toda leitura é datada pela última alteração do arquivo, não pelo momento em que foi lida, então o registro da execução coloca uma amostra no momento em que o outro programa a gravou.

A pasta de entrada

Ler de Pasta de entrada é para a máquina que grava um arquivo por amostra (Test_0412.json, Test_0413.json...): cada arquivo novo que casa com o padrão é lido uma vez, na ordem de chegada.

Nada é excluído nunca: a subpasta Processed cresce até alguém esvaziá-la. Uma pasta de entrada nunca é escrita.

Escrita

Num dispositivo que lê um arquivo e permite escrita, uma tag que lê Valor ou Arquivo inteiro cujo acesso escreve diz o que uma escrita faz:

{value:FORMAT} aceita um formato numérico .NET, {datetime:FORMAT} um formato .NET de data e hora, no relógio da estação, yyyy-MM-dd HH:mm:ss quando nenhum é dado. Um número é escrito com o separador decimal do arquivo, então o mesmo modelo escreve 12,50 num arquivo que usa a vírgula. O modelo de uma tag Boolean pode deixar {value} de fora: escrita como verdadeiro, ela acrescenta a linha, como um comando. Um modelo que o driver não consegue preencher é recusado na página da tag:

A pasta e as subpastas para as quais um nome aponta são criadas quando uma escrita precisa delas, sempre dentro da pasta do dispositivo.

Descoberta

O cartão Escopo da varredura

Para Configurar Connector, a página do driver traz o cartão Escopo da varredura dele, sob a linha "Lê um arquivo e oferece uma tag para cada coluna ou campo que encontra, e para os dados do arquivo. Escolha um dispositivo para ler o arquivo dele, ou digite uma pasta, um arquivo e um formato."

O que ainda falta no escopo é dito em vermelho abaixo do cartão, e o Descobrir fica cinza até ele estar completo:

Quando o dispositivo a varrer tem uma edição que não pode ser salva, a varredura não começa: "A descoberta não começou porque a edição do dispositivo a varrer não pôde ser salva."

O que a varredura oferece

A varredura lê o arquivo que um dispositivo de um arquivo lê agora, ou o arquivo mais novo de uma pasta de entrada, que ela não move; um arquivo que não está lá, uma pasta que não pode ser acessada e um documento que não se lê encerram a varredura com o motivo. Ela oferece um candidato, com os valores que encontrou como tags candidatas, todas Somente leitura:

Uma varredura oferece no máximo 500 valores, as colunas de um arquivo CSV incluídas. Uma varredura cortada ali diz isso na linha que a encerra e acima dos seus resultados: "A varredura de result.json parou antes. Uma varredura oferece no máximo 500 valores: acrescente os outros como tags pela coluna, pelo caminho JSON ou pelo caminho XML."

O candidato de um arquivo digitado recebe o nome do arquivo (run para run.csv), ou o da pasta para um nome com parte de data ou uma pasta de entrada. Um candidato cuja pasta, nome e Ler de um dispositivo do driver já lê (o dispositivo varrido, ou outro igual) aparece como Já configurado: o cartão dele lista só os valores que nenhuma tag daquele dispositivo lê ainda, marcados, e Acrescentar tags, antes de Abrir, acrescenta os marcados àquele dispositivo, somente leitura. O resto do comportamento da varredura está em Descoberta.

A própria página de um dispositivo faz o mesmo sem a página do driver: Descobrir tags, no cabeçalho do cartão Tags dele, lê o arquivo daquele dispositivo como ele está salvo e oferece só os valores para os quais ele ainda não tem tag (veja Descobrir as tags de um dispositivo).

Exemplo: o CSV diário de uma máquina de ensaio

Uma máquina de tração grava um CSV por dia em C:\TestMachine\Logs, chamado Log_2026-10-03.csv, com uma linha de cabeçalho Sample;Force;Elongation e uma linha como 0412;12,5;3,1 depois de cada amostra. Leia-o pelo caminho simples:

1. Na página do driver, Acrescentar dispositivo; dê o nome Tensile tester.
2. No cartão Pasta e arquivo informe Caminho da pasta C:\TestMachine\Logs e Nome do arquivo Log_{yyyy-MM-dd}.csv; mantenha Um arquivo e CSV e texto em colunas. O cartão mostra "Hoje: Log_2026-10-03.csv", e quando o dispositivo o lê, "Lendo agora: Log_2026-10-03.csv". Deixe o cartão Texto do arquivo em Detectar pelo arquivo: ele encontra o ponto e vírgula e a vírgula decimal.
3. Na página do driver, escolha Tensile tester em Arquivo a varrer e Descobrir. O candidato aparece Já configurado e lista Sample (String, mantendo o zero de 0412), Force e Elongation (Double), e os dados do arquivo. Acrescentar tags.

Cada tag lê a última linha; Última alteração muda a cada amostra nova, e é assim que uma ação do Logic sabe que uma chegou. À meia-noite o dispositivo passa para o arquivo do dia seguinte, e até a máquina gravá-lo, os valores ficam sem leitura e O arquivo existe lê falso. Um agente faz o mesmo com as ferramentas:

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

Exemplo: uma pasta de entrada de arquivos de resultado JSON

Uma célula de ensaio deixa um arquivo de resultado por amostra em C:\Results\Inbox, como Test_0413.json com {"sample":"0413","result":{"force":12.5,"ok":true}}:

1. Acrescentar dispositivo; dê o nome Results, Caminho da pasta C:\Results\Inbox, Ler de Pasta de entrada, Arquivos a ler Test_*.json, Formato do arquivo JSON.
2. Acrescentar tag Force, Caminho JSON result.force, Double; Acrescentar tag Pass, Caminho JSON result.ok, Boolean; Acrescentar tag Sample, Caminho JSON sample, String.
3. Acrescentar tag Source file, Lê Nome do arquivo: ela mostra de qual arquivo vieram os valores.

Cada arquivo é lido uma vez, depois de ficar parado 1 s e sem nenhum programa o mantendo aberto para gravar, na ordem em que os arquivos chegaram; cada um é uma leitura própria, datada pela hora do arquivo; depois que toda tag o leu, ele vai para C:\Results\Inbox\Processed. Nada é excluído. Com as ferramentas:

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

Exemplo: acrescentar uma linha para outro programa

Outro programa lê D:\Records\run.csv, uma linha por segundo com a hora e a pressão:

1. Acrescentar dispositivo; dê o nome Run log, Caminho da pasta D:\Records, Nome do arquivo run.csv.
2. No cartão Escrita ligue Permitir escrita e informe Texto do cabeçalho Time;Pressure.
3. Acrescentar tag Line, Double, Acesso Somente escrita, Uma escrita Acrescentar uma linha, Modelo de linha {datetime};{value:0.00}.

Escrever 12.5 em Line acrescenta 2026-10-03 14:05:12;12.50, com a vírgula onde o arquivo já usa uma ou onde Separador decimal diz Vírgula decimal (12,5); um arquivo que a escrita cria recebe Time;Pressure primeiro. Escritas que vêm uma atrás da outra são todas mantidas, em ordem. Para gravar um arquivo por execução, acrescente uma tag File, Lê Nome do arquivo, Leitura e escrita: o Logic escreve o número de série com .csv quando uma execução começa, e as linhas vão para esse arquivo. Com as ferramentas:

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

Ferramentas do agente

driver_capabilities descreve este driver em file: o caminho simples, cada campo do dispositivo, a regra da pasta e o confinamento a ela, as formas do nome do arquivo, os dois jeitos de ler, os formatos com a gramática de endereço de cada um, as origens e os tipos delas, as configurações de texto, como leituras e escritas se comportam, a descoberta e três exemplos completos. device_upsert driver=File aceita fileFolder, fileName, fileMode (SingleFile, o padrão, ou Inbox), fileFormat (Delimited, o padrão, Text, Json ou Xml), fileEncoding (Automatic, Utf8 ou Windows1252), fileSeparator (Automatic, Semicolon, Comma ou Tab), fileDecimal (Automatic, Point ou Comma), fileHeaderRow (de 0 a 1000), fileWrites, e com a escrita ligada fileHeaderText e fileLineEnd (Automatic, CrLf ou Lf); um dispositivo que ele devolve traz file, com fileStatus, o que o driver em execução encontrou: o arquivo em uso, se ele existe, a codificação, os separadores e o fim de linha que leu, e os arquivos aguardando numa pasta de entrada. tag_upsert aceita fileSource (Value, WholeFile, Exists, Size, Modified, Name ou Lines), fileRow (Last, Number ou Matching), fileRowNumber, fileKeyColumn, fileMatchText, fileWriteMode (AppendLine ou ReplaceFile) e fileLineTemplate; a coluna ou o caminho é o address, um valor de texto livre usa os valueExtraction, valueStart, valueLength, valueSeparator, valueField e valuePattern do driver genérico, e uma tag nova é somente leitura e recebe o tipo próprio da origem, a menos que opcUaType diga outra coisa. device_discover driver=File lê ou fileDevice, o nome de um dispositivo do driver, ou fileFolder, fileName, fileMode e fileFormat digitados para a varredura; as tags que faltam a um dispositivo configurado são acrescentadas com tag_upsert. connector_browse devolve fileFolder, fileName, fileMode e fileFormat de cada dispositivo. As outras ferramentas estão em Ferramentas do agente.

Limites que vale conhecer

• Pastas de trabalho do Excel não são lidas: uma pasta de trabalho é lida depois que o programa dela a salva como CSV.
• O driver nunca exclui um arquivo. Uma pasta de entrada move o que leu para Processed, e só o arquivo temporário de uma substituição que falhou é removido.
• "O arquivo mais novo da pasta" não é um jeito de ler: ele perde arquivos que chegam juntos e pode mostrar os valores da amostra anterior. Uma máquina que grava um arquivo por amostra é lida por uma pasta de entrada.
• Um valor não é mudado no lugar dentro de um arquivo (uma célula de um CSV, um membro do JSON de outro programa): uma escrita acrescenta uma linha ou substitui o arquivo inteiro, porque dois programas gravando o mesmo arquivo podem perder a mudança um do outro.
• Um compartilhamento de rede é acessado com as permissões do Windows da conta em que a estação roda: o dispositivo não guarda usuário nem senha, então o compartilhamento precisa deixar essa conta entrar (para ler, e para gravar e mover num dispositivo que escreve ou numa pasta de entrada).
• O driver nunca mexe em nada fora da pasta dele: um nome que aponta para outro lugar é recusado onde é digitado e onde é escrito.
• O arquivo é olhado a cada leitura: uma mudança é vista na leitura seguinte, nunca no instante em que o outro programa a grava.
• Um campo de CSV que contém uma quebra de linha não é lido, e uma tag JSON, XML ou de arquivo inteiro lê no máximo 4 MiB.