File

4D v19.8

File


File ( chemin \| fichier4D {; typeChemin \| *} ) -> Résultat

Paramètre	Type	Description
chemin \| fichier4D	Texte, Entier long	Chemin du fichier ou constante du fichier 4D
typeChemin \| *	Entier long, Opérateur	Si chemin est passé : fk chemin posix (par défaut) ou fk chemin plateforme Si fichier4D est passé : * pour retourner le fichier de la base hôte
Résultat	Objet	Nouvel objet fichier

Description

La commande File crée et retourne un nouvel objet de type Fichier. La commande accepte deux syntaxes.

Fichier (chemin{; typeChemin})

Dans le paramètre chemin, passez un chemin fichier. Vous pouvez utiliser une chaine personnalisée ou un "filesystem" (ex : "/DATA/myfile.txt").

Note : Seuls les chemins absolus sont pris en charge avec la commande File. Pour plus d'informations, veuillez consulter la page Chemins des objets fichier et dossier.

Par défaut, 4D attend un chemin exprimé dans une syntaxe POSIX. Si vous travaillez avec des chemins de plateforme (Windows ou macOS), vous devez les déclarer à l'aide du paramètre typeChemin. Les constantes suivantes sont disponibles dans le thème de constantes Fichier et Dossier :

Constante	Type	Valeur	Comment
fk platform path	Entier long	1	Chemin exprimé dans une syntaxe spécifique à la plateforme (obligatoire en cas de chemin de plateforme)
fk posix path	Entier long	0	Chemin exprimé dans la syntaxe POSIX (par défaut)

Fichier (fichier4D{; *})

Dans le paramètre fichier4D, passez un fichier intégré ou un fichier système, à l'aide de l'une des constantes :

Constante	Valeur	Comment
Backup history file	19	Fichier historique des sauvegardes (voir Fichiers de configuration et de suivi). Stocké dans le dossier de destination de sauvegarde.
Backup log file	13	Fichier de journal des sauvegardes courant. Stocké dans le dossier Logs à côté du fichier de structure de la base. Si aucun fichier de journal des sauvegardes n'existe ou n'a été créé, un chemin vide est retourné (aucune erreur n'est générée).
Backup settings file	18	Fichier Backup.4Dsettings par défaut, stocké dans le dossier Settings de la base.
Backup settings file for data	17	Fichier Backup.xml, stocké dans le dossier Preferences/Backup à côté du fichier structure de la base.
Build application log file	14	Fichier d'historique courant au format xml du générateur d'application. Stocké dans le dossier Logs à côté du fichier de structure de la base. Si aucun fichier d'historique n'a été créé, un chemin vide est retourné (aucune erreur n'est générée).
Build application settings file	20	Fichier de configuration par défaut du générateur d'application (buildApp.4DSettings). Stocké dans le dossier Settings de la base.
Compacting log file	6	Fichier de compte-rendu du compactage de plus récent de la base, créé par la commande Compact data file ou le Centre de sécurité et de maintenance (CSM). Stocké dans le dossier Logs à côté du fichier de structure de la base. Si aucun fichier de compte-rendu de compactage n'a été créé, un chemin vide est retourné (aucune erreur n'est générée).
Current backup settings file	1	Fichier backup.4DSettings utilié par l'application. Il peut s'agir du fichier backup.4DSettings par défaut ou d'un fichier de configuration utilisateur.
Debug log file	12	Fichier d'enregistrement des événements pour le débogage créé par la commande SET DATABASE PARAMETER(Debug log recording). Stocké dans le dossier Logs de la base, à côté du fichier de structure. Si aucune fichier de débogage n'a été créé, un chemin vide est retourné (aucune erreur n'est générée).
Diagnostic log file	11	Fichier de diagnostic de 4D, créé par la commande SET DATABASE PARAMETER(Diagnostic log recording). Stocké dans le dossier Logs de la base, à côté du fichier de structure. Si aucun fichier de diagnostic n'a été créé, un chemin vide est retourné (aucune erreur n'est générée).
Directory file	16	Fichier directory.json, contenant la description des groupes et des utilisateurs (le cas échéant) pour les bases projets. ll se situe soit dans le dossier Settings de la base de l'utilisateur (par défaut, s'applique à tout le projet), soit dans le dossier de configuration des données (spécifique à un fichier de données).
HTTP debug log file	9	Fichier de débogage des requêtes HTTP, créé par la commande WEB SET OPTION(Web debug log). Stocké dans le dossier Logs de la base, à côté du fichier de structure. Si aucun fichier de débogage des requêtes HTTP n'a été créé, un chemin vide est retourné (aucune erreur n'est générée).
HTTP log file	8	Fichier d'enregistrement des requêtes Web créé par la commande WEB SET OPTION(Web log recording). Stocké dans le dossier Logs à côté du fichier de structure de la base. Si aucun fichier d'enregistrement des requêtes Web n'a été créé, un chemin vide est retourné (aucune erreur n'est générée).
IMAP Log file	23	Fichier journal créé par la commande SET DATABASE PARAMETER(IMAP Log). Stocké dans le dossier Logs de la base
Last backup file	2	Dernier fichier de sauvegarde généré, nommé <NomBase>[NumBkp].4BK, stocké à un emplacement personnalisé.
Last journal integration log file	22	Chemin complet du dernier fichier journal d'intégration de l'historique (stocké dans le dossier Logs de l'application restaurée), le cas échéant. Ce fichier est créé en mode auto-repair, dès qu'une intégration de fichier d'historique a lieu (voir Restitution automatique).
Repair log file	7	Fichier de compte-rendu des réparations effectuées sur la base par le Centre de maintenance et de réparation (CSM). Stocké dans le dossier Logs à côté du fichier de structure de la base. Si aucun fichier de compte-rendu de réparation n'a été créé, un chemin vide est retourné (aucune erreur n'est générée).
Request log file	10	Fichier des requêtes client/serveur standard (hors requêtes Web), créé par SET DATABASE PARAMETER(4D Server log recording) ou SET DATABASE PARAMETER(Client log recording). Si la commande est appelée sur le serveur, le chemin du fichier des requêtes du serveur est retourné (stocké dans le dossier Logs de la base, à côté du fichier de structure). Si la commande est appelée sur lun client, le chemin du fichier des requêtes du client est retourné (stocké dans le dossier Logs de la base locale). S'il n'existe aucun fichier de requêtes, un chemin vide est retourné (aucune erreur n'est générée).
SMTP log file	15	Fichier des requêtes SMTP créé par la commande SET DATABASE PARAMETER(SMTP Enreg historique). Stocké dans le dossier Logs à côté du fichier de structure de la base. Si aucun fichier de requêtes SMTP n'existe ou n'a été créé, un chemin vide est retourné (aucune erreur n'est générée).
User settings file	3	settings.4DSettings pour tous les fichiers de données (si activé), stocké dans le dossier Preferences à côté du fichier de structure de la base
User settings file for data	4	settings.4DSettings pour le fichier de données courant, stocké dans le dossier Preferences à côté du fichier de données.
Verification log file	5	Fichier de compte-rendu de vérification le plus récent de la base, créé par les commandes VERIFY CURRENT DATA FILE et VERIFY DATA FILE ou via le Centre de sécurité et de maintenance de la base (CSM). Stocké dans le dossier Logs à côté du fichier de structure de la base. Si aucun fichier compte-rendu de vérification n'a été créé, un chemin vide est retourné (aucune erreur n'est générée).

Si le fichier4D cible n'existe pas, un objet null est retourné. Aucune erreur n'est générée.

Si la commande est appelée à partir d'un composant, passez le paramètre optionnel * pour lire le chemin de la base hôte. Sinon, si vous omettez le paramètre * , un objet null est systématiquement retourné.