OUVRIR FICHIER DONNEES

4D v16.3


OUVRIR FICHIER DONNEES ( cheminAccès )

Paramètre	Type	Description
cheminAccès	Chaîne	Nom ou chemin d’accès complet du fichier de données à ouvrir

Description

La commande OUVRIR FICHIER DONNEES permet de changer à la volée le fichier de données ouvert par l’application 4D.

Vous passez dans le paramètre cheminAccès le nom ou le chemin d’accès complet du fichier de données à ouvrir (fichier suffixé ".4DD"). Si vous passez uniquement un nom de fichier, il doit être placé à côté du fichier de structure de la base.

Si ce chemin d’accès désigne un fichier de données valide, 4D quitte la base en cours et la rouvre avec le fichier de données spécifié. En mode monoposte, la Méthode base Sur fermeture et la Méthode base Sur ouverture sont successivement appelées.

Attention : Comme cette commande provoque la fermeture préalable de l'application, elle doit être utilisée avec précaution dans la Méthode base Sur ouverture ou une méthode appelée par cette méthode base afin de ne pas générer de boucle sans fin.

La commande est exécutée de manière asynchrone : après son appel, 4D continue d’exécuter le reste de la méthode. Ensuite, l’application se comporte comme si la commande Quitter avait été sélectionnée dans le menu Fichier : les boîtes de dialogue ouvertes sont annulées, les process ouverts ont 10 secondes pour se terminer avant d’être tués, etc.

Avant de lancer l’opération, la commande teste la validité du fichier de données spécifié. En outre, si le fichier a déjà été ouvert, la commande vérifie qu’il correspond bien à la structure courante.

Si vous passez une chaîne vide dans cheminAccès, la commande rouvre la base sans changer de fichier de données.

4D Server : A compter de 4D v13, cette commande peut être exécutée avec 4D Server. Dans ce contexte, elle effectue en interne un appel à QUITTER 4D sur le serveur (entraînant l’apparition, sur chaque poste distant, d’une boîte de dialogue signalant que le serveur est en train de quitter) avant d'ouvrir le fichier désigné.

Exemple

Dans le contexte du déploiement d'une application fusionnée, vous souhaitez ouvrir ou créer le fichier de données utilisateur dans la méthode base Sur ouverture. Cet exemple utilise le fichier de données par défaut (cf. Gestion du fichier de données dans les applications finales) :

 Si(Fichier donnees="@default.4dd")

    Si(Type version?? Application fusionnée)

       Si(Fichier donnees verrouille)

          $dataPath:=Dossier 4D(Dossier 4D actif)+"data.4dd"

  //Si un fichier de données local existe déjà

          Si(Tester chemin acces($dataPath)=Est un document)

             OUVRIR FICHIER DONNEES($dataPath) // on l'ouvre

          Sinon

             CREER FICHIER DONNEES($dataPath) //on le crée

          Fin de si

       Fin de si

    Fin de si

 Fin de si

Voir aussi

CREER FICHIER DONNEES