File

4D v19.8

File


File ( rota\|4Dfile {; tipoRotah \| *} ) -> Resultado

Parâmetro	Tipo	Descrição
rota\|4Dfile	Texto, Inteiro longo	Rota arquivo ou constante 4D file
tipoRotah \| *	Inteiro longo, Operador	Se passar rota: rota fk posix (padrão) ou rota fk platform Se passar 4Dfile: *para retornar arquivo ou database host
Resultado	Objeto	novo objeto arquivo

Descrição

O comando File cria e devolve um novo objeto de tipo File. O comando aceita duas sintaxe.

File (path{; pathType})

No parâmetro rota, passe uma rota de arquivo. Pode utilizar uma string personalizada ou um filesystem (ex. "/DATA/myfile.txt").

Nota: apenas são admitidas as rotas de acesso absolutas com o comando File. Para saber mais, consulte a página Rotas de objetos arquivo e pasta.

Normalmente, 4D espera uma rota expressa com a sintaxe POSIX. Se trabalhar com rotas de plataforma (Windows ou macOS), deve declarar utilizando o parâmetro tipoRota. As constantes abaixo estão disponíveis no tema de constantes Arquivos e pastas:

Constante	Tipo	Valor	Comentário
fk platform path	Inteiro longo	1	Rota expressada com uma sintaxe específica da plataforma (obrigatória no caso da rota de plataforma)
fk posix path	Inteiro longo	0	Rota expressada com a sintaxe POSIX (padrão)

File (4Dfile{; *})

No parâmetro 4Dfile, passe um arquivo integrado 4D ou sistema, utilizando uma das constantes abaixo:

Constante	Valor	Comentário
Backup history file	19	Arquivo de histórico da cópia de seguranca atual. Armazenado na pasta Logs do lado do arquivo de estrutura de banco de dados. Se nenhum arquivo de histórico tiver sido criado ou existir, uma rota vazia é retornada. Não cria erros..
Backup log file	13	Arquivo de histórico da cópia de seguranca atual. Armazenado na pasta Logs do lado do arquivo de estrutura de banco de dados. Se nenhum arquivo de histórico tiver sido criado ou existir, uma rota vazia é retornada. Não cria erros..
Backup settings file	18	Arquivo Backup.xml, armazenado na pasta Preferencias/Backup junto ao arquivo de estrutura do banco de dados
Backup settings file for data	17	Arquivo Backup.xml, armazenado na pasta Preferencias/Backup junto ao arquivo de estrutura do banco de dados
Build application log file	14	Arquivo de histórico atual em formato xml del gerador de aplicacoes. Armazenado na pasta Logs ao lado do arquivo de estrutura do banco de dados. Se nao tiver criado nenhum arquivo de histórico ou nao existir, se devolver uma rota vazia. Nao sao gerados erros.
Build application settings file	20	Arquivo de configuração predeterminado do gerador de aplicações ("buildApp.4DSettings"). Armazenado na pasta Configuração do banco de dados.
Compacting log file	6	Arquivo de histórico do compactamento mais recente criado pelo comando Compact data file ou pelo Centro de seguranca e manutenção (CSM) Armazenado na pasta Logs do lado do arquivo de estrutura de banco de dados. Se nenhum arquivo de histórico tiver sido criado ou existir, uma rota vazia é retornada. Não cria erros.
Current backup settings file	1	Arquivo Backup.xml, armazenado na pasta Preferencias/Backup junto ao arquivo de estrutura do banco de dados
Debug log file	12	Arquivo de histórico criado pelo comando SET DATABASE PARAMETER(Debug log recording). Armazenado na pasta Logs ao lado do arquivo de estrutura de banco de dados. Se nenhum arquivo de histórico tiver sido criado ou existir, uma rota vazia é retornada. Não cria erros.
Diagnostic log file	11	Arquivo de histórico criado pelo comando SET DATABASE PARAMETER(Diagnostic log recording).. Armazenado na pasta Logs ao lado do arquivo de estrutura de banco de dados. Se nenhum diagnóstico tiver sido criado ou existir, uma rota vazia é retornada. Não cria erros.
Directory file	16	Arquivo diretório.json, que contém a descrição de usuários e grupos (se houver) para o banco de dados projeto. Se puder localizar na pasta de configuração do banco de dados de usuário (predeterminada, global para o projeto) ou na pasta de configuração de dados (específica de um arquivo de dados).
HTTP debug log file	9	Arquivo de histórico criado pelo comando WEB SET OPTION(Web debug log).. Armazenado na pasta Logs ao lado do arquivo de estrutura de banco de dados. Se nenhum arquivo de debug tiver sido criado ou existir, uma rota vazia é retornada. Não cria erros.
HTTP log file	8	Arquivo de histórico criado pelo comando WEB SET OPTION(Web log recording). Armazenado na pasta Logs junto ao arquivo de estrutura do banco de dados. Se não tiver criado nenhum arquivo de histórico ou não existir, se devolve uma rota vazia. Não gera erros
IMAP Log file	23	Arquivo de histórico criado pelo comando SET DATABASE PARAMETER(IMAP Log). Armazenado na pasta Logs do banco de dados
Last backup file	2	Último arquivo de cópia de segurança, chamado <nomeBanco>[bkpNum].4BK, armazenado em uma localização personalizada
Last journal integration log file	22	Rota completa do último arquivo de integração do diário (armazenado na pasta Logs da aplicação restaura), se houver. Esse arquivo é criado, em modo auto-reparo, logo que ocorrer uma integração de arquivos log (ver Restituição automática).
Repair log file	7	Arquivo de histórico de reparos realizados no banco de dados pelo Centor de manutenção e segurança (CMS) Armazenado na pasta Logs ao lado do arquivo de estrutura de banco de dados. Se nenhum arquivo de histórico existir, uma rota vazia é retornada. Nenhum erro é criado.
Request log file	10	Arquivo de petições cliente\servidor padrão (excluindo petições web) criado pelos comandos SET DATABASE PARAMETER(4D Server log recording) ou SET DATABASE PARAMETER(Client log recording) . Se executado no servidor, o histórico do servidor é retornado. Armazenado na pasta Logs no servidor. Se for executado no cliente, devolve o histórico do cliente. Armazenado na pasta Logs no cliente. Se nenhum arquivo de histórico tiver sido criado ou existir, uma rota vazia é retornada.
SMTP log file	15	Arquivo de histórico criados pelo comando SET DATABASE PARAMETER(SMTP Log) . Armazenado na pasta Logs ao lado do arquivo de estrutura de banco de dados. Se nenhum arquivo log SMTP foi criado ou não existir, uma rota vazia é retornada. Nenhum erro é criado
User settings file	3	O arquivo settings.4DSettings para os arquivos de dados, armazenado na pasta Settings junto ao arquivo estrutura do banco de dados se for ativado
User settings file for data	4	settings.4DSettings para o arquivo de dados atual, armazenado na pasta Settings junto ao arquivo de dados.
Verification log file	5	Arquivos de histórico criados pelos comandos VERIFY CURRENT DATA FILE e VERIFY DATA FILE ou o Centro de manutenção e seguraça (CMS).. Armazenado na pasta Logs ao lado do arquivo de estrutura de banco de dados. Se nenhuma verificação tiver sido feita ou nenhum arquivo de histórico existir, uma rota vazia é retornada. Nenhum erro é criado.

Se o alvo 4Dfile não existir, um objeto null é retornado. Nenhum erro é levantado.

Se chamar ao comando desde um componente, passe o parâmetro opcional * para obter a rota do banco de dados local. Do contrário, se omitir o parâmetro *, sempre se devolverá uma string vazia.