File

4D v19.8

File


File ( ruta \| archivo4D {; tipoRuta \| *} ) -> Resultado

Parámetro	Tipo	Descripción
ruta \| archivo4D	Texto, Entero largo	Ruta de archivo o constante de archivo 4D
tipoRuta \| *	Entero largo, Operador	Si se pasó ruta: fk ruta posix (predeterminada) o fk ruta plataforma Si se pasó archivo4D: * para devolver el archivo de la base local
Resultado	Objeto	Nuevo objeto archivo

Descripción

El comando File crea y devuelve un nuevo objeto del tipo File. El comando acepta dos sintaxis.

Archivo (ruta{; tipoRuta})

En el parámetro ruta, pase una ruta de archivo. Puede utilizar una cadena personalizada o un filesystem (ej. "/DATA/myfile.txt").

Nota: solo se admiten las rutas de acceso absolutas con el comando File. Para más información, consulte la página Rutas de objetos archivo y carpeta.

Por defecto, 4D espera una ruta expresada con la sintaxis POSIX. Si trabaja con rutas de plataforma (Windows o macOS), debe declararlo utilizando el parámetro tipoRuta. Las siguientes constantes están disponibles en el tema de constantes File and Folder:

Constante	Tipo	Valor	Comentario
fk platform path	Entero largo	1	Ruta expresada con una sintaxis específica de la plataforma (obligatoria en el caso de la ruta de plataforma)
fk posix path	Entero largo	0	Ruta expresada con la sintaxis POSIX (por defecto)

Archivo (archivo4D{; *})

En el parámetro archivo4D, pase un archivo integrado 4D o sistema, utilizando una de las siguientes constantes:

Constante	Valor	Comentario
Backup history file	19	Archivo de historial de la copia de seguridad (ver Configuración y archivos de seguimiento). Almacenado en la carpeta de destino de backup.
Backup log file	13	Archivo de historial de la copia de seguridad actual. Almacenado en la carpeta Logs junto al archivo de estructura de la base. Si no se ha creado ningún archivo de historial o no existe, se devuelve una ruta vacía. No se generan errores.
Backup settings file	18	Archivo Backup.xml, almacenado en la carpeta Preferencias/Backup junto al archivo de estructura de la base
Backup settings file for data	17	Archivo Backup.xml, almacenado en la carpeta Preferencias/Backup junto al archivo de estructura de la base
Build application log file	14	Archivo de historial actual en formato xml del generador de aplicaciones. Almacenado en la carpeta Logs junto al archivo de estructura de la base. Si no se ha creado ningún archivo de historial o no existe, se devuelve una ruta vacía. No se generan errores.
Build application settings file	20	Archivo de configuración predeterminado del generador de aplicaciones ("buildApp.4DSettings"). Almacenado en la carpeta Configuración de la base.
Compacting log file	6	Archivo de historial de la compactación más reciente de la base, creada por el comando Compact data file o por el Centro de seguridad y mantenimiento (CSM). Almacenado en la carpeta Logs junto al archivo de estructura de la base. Si no se ha creado ningún archivo de historial o no existe, se devuelve una ruta vacía. No se generan errores.
Current backup settings file	1	Archivo Backup.xml, almacenado en la carpeta Preferencias/Backup junto al archivo de estructura de la base
Debug log file	12	Archivo de historial creado por el comando SET DATABASE PARAMETER (Debug log recording). Almacenado en la carpeta Logs junto al archivo de estructura de la base. Si no se ha creado ningún archivo de historial o no existe, se devuelve una ruta vacía. No se generan errores.
Diagnostic log file	11	Archivo de historial creado por SET DATABASE PARAMETER(Diagnostic log recording). Almacenado en la carpeta Logs junto al archivo de estructura de la base. Si no se ha creado ningún archivo de historial o no existe, se devuelve una ruta vacía. No se generan errores.
Directory file	16	Archivo directorio.json, que contiene la descripción de usuarios y grupos (si los hay) para la base proyecto. Se puede ubicar en la carpeta de configuración de la base del usuario (predeterminada, global para el proyecto) o en la carpeta de configuración de datos (específica de un archivo de datos).
HTTP debug log file	9	Archivo de historial creado por el comando WEB SET OPTION(Web debug log). Almacenado en la carpeta Logs junto al archivo de estructura de la base. Si no se ha creado ningún archivo de historial o no existe, se devuelve una ruta vacía. No se generan errores.
HTTP log file	8	Archivo de historial creado por el comando WEB SET OPTION(Web log recording). Almacenado en la carpeta Logs junto al archivo de estructura de la base. Si no se ha creado ningún archivo de historial o no existe, se devuelve una ruta vacía. No se generan errores.
IMAP Log file	23	Archivo de historial creado por el comando SET DATABASE PARAMETER(IMAP Log). Se almacena en la carpeta Logs de la base de datos
Last backup file	2	Último archivo de copia de seguridad, llamado <nombreBase>[bkpNum].4BK, almacenado en una ubicación personalizada
Last journal integration log file	22	Ruta completa del último archivo de registro de la integración del historial (almacenado en la carpeta Logs de la aplicación restaurada), si lo hay. Este archivo se crea, en modo de reparación automática, tan pronto como una integración de un archivo de historial ocurre (ver Restauración Automática).
Repair log file	7	Archivo de historial de las reparaciones realizadas a la base por el Centro de mantenimiento y seguridad (CMS). Almacenado en la carpeta Logs junto al archivo de estructura de la base. Si no se ha creado ningún archivo de historial o no existe, se devuelve una ruta vacía. No se generan errores.
Request log file	10	Archivo de peticiones cliente/servidor estándar (excluyendo peticiones web) creado por los comandos SET DATABASE PARAMETER(4D Server log recording) o SET DATABASE PARAMETER(Client log recording). Si se ejecuta en el servidor, se devuelve el historial del servidor. Almacenado en la carpeta Logs en el servidor. Si se ejecuta en el cliente, se devuelve el historial del cliente. Almacenado en la carpeta Logs en el cliente. Si no existe ningún archivo de historial, se devuelve una ruta vacía.
SMTP log file	15	Archivo de historial creado por el comando SET DATABASE PARAMETER(SMTP Log). Se almacena en la carpeta Logs junto al archivo de estructura de la base. Si no se ha creado ningún archivo de registro SMTP o no existe, se devuelve una ruta vacía. No se generan errores.
User settings file	3	El archivo settings.4DSettings para los archivos de datos, almacenado en la carpeta Settings junto al archivo estructura de la base si se activa
User settings file for data	4	settings.4DSettings para el archivo de datos actual, almacenado en la carpeta Settings junto al archivo de datos.
Verification log file	5	Archivos de historial creados por los comandos VERIFY CURRENT DATA FILE y VERIFY DATA FILE o el Centro de mantenimiento y seguridad (CMS). Almacenado en la carpeta Logs junto al archivo de estructura de la base. Si no se ha realizado ninguna verificación o no existe ningún archivo de historial, se devuelve una ruta vacía. No se generan errores.

Si el objetivo archivo4D no existe, se devuelve un objeto null. No se generan errores.

Si se llama al comando desde un componente, pase el parámetro opcional * para obtener la ruta de la base local. De lo contrario, si omite el parámetro *, siempre se devolverá un objeto null.