Dossier 4D

4D v19.8

Dossier 4D


Dossier 4D {( dossier {; *} )} -> Résultat

Paramètre	Type	Description
dossier	Entier long	Type de dossier (si omis=dossier 4D actif)
*	Opérateur	Retourne le dossier de la base hôte
Résultat	Chaîne	Chemin d'accès du dossier désigné

Description

La commande Dossier 4D renvoie le chemin d'accès du dossier 4D actif de l'application courante, ou du dossier de l'environnement 4D spécifié par le paramètre dossier, s'il est passé.
Cette commande vous permet d'obtenir avec certitude le chemin d'accès réel des dossiers utilisés par l'application. En utilisant cette commande, vous êtes certain que votre code fonctionnera correctement sur toute plate-forme, quelles que soient la langue du système et l'application 4D.

Vous pouvez passer dans dossier une des constantes suivantes, placées dans le thème Environnement 4D :

Constante	Type	Valeur
Dossier 4D actif	Entier long	0
Dossier base	Entier long	4
Dossier base 4D Client	Entier long	3
Dossier base syntaxe Unix	Entier long	5
Dossier données	Entier long	9
Dossier Licenses	Entier long	1
Dossier Logs	Entier long	7
Dossier MobileApps	Entier long	10
Dossier racine HTML	Entier long	8
Dossier Resources courant	Entier long	6

Voici une description de chacun de ces dossiers :

Notes préalables sur les noms de dossiers :

{Disque} est le disque sur lequel est installé le système.
Le libellé Utilisateur représente le nom de l'utilisateur ayant ouvert la session.
Avec certaines versions de Mac OS, les noms des dossiers sont traduits :
- le dossier Library est nommé Bibliothèque,
- le dossier Application Support est nommé Support aux applications.

Dossier 4D actif

Les applications de l'environnement 4D utilisent un dossier spécifique pour stocker les informations suivantes :

Fichiers de préférences utilisés par les applications 4D
Fichier shortcuts.xml (raccourcis clavier personnalisés)
Dossier Macros v2 (macros commandes de l'éditeur de méthodes)
Dossiers Favorites v1x, par exemple Favorites v13 (chemins d'accès des bases locales et distantes ayant été ouvertes)
Dossier Logs pour les journaux de maintenance et lorsque les données sont en lecture seule

Le dossier 4D actif se trouve par défaut à l'emplacement suivant :

Sous Windows 7 et suivants : {Disque}:\Users\<nomUtilisateur>\AppData\Roaming\
Sous macOS : {Disque}:Users:<nomUtilisateur>:Library:Application Support:4D

Dossier Licenses

Dossier contenant les fichiers de licence 4D du poste.
Le dossier Licenses est situé à l'emplacement suivant :

Sous Windows 7 et suivants : {Disque}:\ProgramData\4D\Licenses
Sous OS X : {Disque}:Library:Application Support:4D:Licenses

Notes :

Dans le cas d’une application fusionnée avec un 4D Volume Desktop, le dossier des licences est inclus dans le package (progiciel) de l’applicatif.
Si le dossier des licences n’a pu être créé dans le système à cause d’un défaut d'autorisation, il est créé aux emplacements suivants :
- sous Windows 7 et suivants : {Disque}:\Users\<nomUtilisateur>\AppData\Roaming\4D\Licenses
- sous OS X : {Disque}:Users:<nomUtilisateur>:Library:Application Support:4D:Licenses

Dossier données

Dossier contenant le fichier de données courant. Le chemin du dossier est exprimé avec la syntaxe standard de la plate-forme courante.

Dossier base 4D Client (postes clients)

Dossier de la base 4D créé en local sur chaque poste client, dans lequel sont téléchargés depuis 4D Server les dossiers et fichiers relatifs à la base (ressources, plug-ins, dossier Resources, etc.).
Le dossier base 4D Client est situé à l'emplacement suivant sur chaque poste client :

Sous Windows : {Disque}:\Users\<nomUtilisateur>\AppData\Local\4D\<NomDeLaBase_Adresse_Port_clé>
Sous macOS : {Disque}:Users:<nomUtilisateur>:Library:Caches:4D:<NomDeLaBase_Adresse_Port_clé>

Note : La valeur de la clé est incrémentée (et le dossier local base 4D Client dupliqué) lorsqu'un autre lancement de l'application cliente est effectué simultanément sur le même poste.

Dossier base

Dossier contenant le fichier de structure de la base. Le chemin d’accès est exprimé avec la syntaxe standard de la plate-forme courante.
Avec l'application 4D Client, cette constante équivaut strictement à la constante précédente Dossier base 4D Client : la commande retourne le chemin d’accès du dossier créé en local.

Dossier base syntaxe Unix

Dossier contenant le fichier de structure de la base. Cette constante désigne le même dossier que la précédente, mais le chemin d’accès retourné est exprimé avec la syntaxe Unix (Posix), du type /Users/... Cette syntaxe est principalement utile lorsque vous utilisez la commande LANCER PROCESS EXTERNE sous OS X.

Dossier Resources courant

Dossier Resources de la base. Ce dossier contient les éléments additionnels (images, textes) utilisés pour l'interface de la base. Un composant peut disposer de son propre dossier Resources.
En mode client/serveur, ce dossier permet d'organiser le transfert de données personnalisées (images, fichiers, sous-dossiers...) entre le poste serveur et les postes clients. Le contenu de ce dossier est mis à jour automatiquement sur chaque client au moment de sa connexion. Tous les mécanismes de référencement associé au dossier Resources sont pris en charge en mode client/serveur (dossier .lproj, XLIFF, images...) . En outre, 4D fournit divers outils permettant de gérer et de mettre à jour dynamiquement ce dossier, notamment un Explorateur de ressources.

Note :

Si le dossier Resources n'existe pas pour la base, l'exécution de la commande Dossier 4D avec la constante Dossier Resources courant provoque sa création.
Sous Windows, dans les projets clients fusionnés, l'emplacement de ce dossier est modifié si la clé BuildApp ShareLocalResourcesOnWindowsClient est utilisée.

Dossier Logs

Dossier Logs de la base, créé au même niveau que le fichier de données, centralise les fichiers d’historique suivants de la base courante :

conversion de la base,
requêtes du serveur Web,
journal d'activités sauvegarde/restitution,
débogage des commandes,
requêtes 4D Server (généré sur les clients et sur le serveur)..

Note :

Si le dossier Logs n'existe pas pour la base, l'exécution de la commande Dossier 4D avec la constante Dossier Logs provoque sa création.
Un dossier Logs supplémentaire, situé dans le dossier des préférences utilisateur du système (Dossier 4D actif), est utilisé pour les fichiers journaux de maintenance (compactage, vérification, réparation). Il est recommandé d'appeler Fichier 4D(Fichier log compactage) par exemple lorsque vous souhaitez accéder à ces fichiers journaux. Ce dossier Logs est également utilisé dans les cas où le dossier Logs normal ne peut pas être écrit.

Dossier racine HTML

Dossier racine HTML courant de la base. Le chemin d’accès retourné est exprimé avec la syntaxe standard de la plate-forme courante. Le dossier racine HTML est le dossier dans lequel le serveur Web de 4D va chercher les pages et fichiers Web demandés. Par défaut, il est nommé DossierWeb et est placé à côté de fichier de structure (ou de sa copie locale dans le cas de 4D en mode distant). Son emplacement peut être défini dans la page Web/Configuration des Propriétés de la base ou dynamiquement via la commande WEB FIXER RACINE.
Si la commande Dossier 4D est appelée depuis un 4D distant, le chemin retourné est celui du poste distant, pas celui de 4D Server.

Le paramètre facultatif * est utile dans le cadre d'une architecture utilisant des composants : il permet de déterminer la base (hôte ou composant) dont vous souhaitez obtenir le chemin d'accès d'un dossier. Ce paramètre est valide uniquement pour les dossiers Dossier base, Dossier base syntaxe Unix et Dossier Resources courant. Il est ignoré dans les autres cas.
Lorsque la commande est appelée depuis un composant :

si le paramètre * est passé, la commande retourne le chemin d’accès du dossier de la base hôte,
si le paramètre * n’est pas passé, la commande retourne le chemin d’accès du dossier du composant.
Le dossier de la base (Dossier base et Dossier base syntaxe Unix) retourné diffère en fonction du type d’architecture du composant :
- dans le cas d’un dossier/package .4dbase, la commande retourne le chemin d’accès du dossier/package .4dbase,
- dans le cas d’un fichier .4db ou .4dc, la commande retourne le chemin d’accès du dossier “Components”,
- dans le cas d’un alias ou raccourci, la commande retourne le chemin d’accès du dossier contenant la base matrice originale. Le résultat diffère en fonction du format de cette base (dossier/package .4dbase ou fichier .4db/.4dc), comme décrit ci-dessus.
Lorsque la commande est appelée depuis la base hôte, elle retourne toujours le chemin d’accès du dossier de la base hôte, que le paramètre * soit passé ou non.

Dossier MobileApps

Dossier contenant tous les fichiers de session existants (.json) utilisés par l'application 4D pour référencer les sessions des utilisateurs d'applications mobiles (c'est-à-dire les sessions ouvertes par des apps 4D for iOS). Les fichiers de sessions sont groupés par sous-dossier d'applications et sont créés automatiquement. Pour plus d'informations, veuillez vous reporter à la documentation de 4D for iOS.

Ce dossier est situé au même niveau que le fichier de données courant.

Exemple 1

Pendant le démarrage d'une base mono-utilisateur, vous voulez charger (ou créer) vos propres paramètres et les stocker dans un dossier 4D. Pour cela, dans la Méthode base Sur ouverture, vous pouvez écrire les lignes de code similaires aux lignes suivantes :

 </span>$vsNomDocPref:=Dossier 4D+"MesPrefs.prf" // Construire le chemin d'accès au fichier Préférences

  // Vérifier si le fichier existe

 Si(Tester chemin acces($vsNomDocPref)#Est un document)

    $vtRefDocPref:=Creer document($vsNomDocPref.prf) // Si non, il faut le créer

 Sinon

    $vtRefDocPref:=Ouvrir document($vsNomDocPref.prf) // Si oui, il faut l'ouvrir

 Fin de si

 Si(OK=1)

  // Traiter le contenu du document

    FERMER DOCUMENT($vtRefDocPref)

 Sinon

  // Gérer l'erreur

 Fin de si

Exemple 2

Cet exemple illustre l’emploi de la constante Dossier base syntaxe Unix sous Mac OS pour lister le contenu du dossier de la base :

 $cheminposix:="\""+Dossier 4D(Dossier base syntaxe Unix)+"\""

 $mondossier:="ls -l "+$cheminposix

 $in:=""

 $out:=""

 $err:=""

 LANCER PROCESS EXTERNE($mondossier;$in;$out;$err)

Note : Sous Mac OS, il est nécessaire d’encadrer les chemins d’accès avec des guillemets lorsqu’ils contiennent des noms de fichiers ou de dossiers comportant des espaces. La séquence d’échappement "\" permet d’insérer le caractère guillemets dans la chaîne. Vous pouvez également utiliser l’instruction Caractere(Guillemets).

Variables et ensembles système

Si le paramètre dossier est invalide ou si le chemin d'accès retourné est vide, la variable système OK prend la valeur 0.

Voir aussi

Dossier systeme
Dossier temporaire
LISTE COMPOSANTS
Tester chemin acces
WEB FIXER RACINE