|
|
|
|
|
|
|
|
|
|
- Caractéristiques du fichier de données créé
- Les différents fichiers créés
- Gestion du mot de passe
- Gestion des erreurs fatales lors de la création d'un fichier de données
- Gestion des alphabets non latins
- Réplication : Plage d'identifiants
- Priorité pour la définition de l'emplacement des fichiers du journal
- Création ou ouverture d'une table existante
- Gestion des index
- Création du fichier de données à partir de sa description
HCréationSiInexistant (Fonction) En anglais : HCreationIfNotFound
 Non disponible avec ce type de connexion
Effectue les opérations suivantes : - Si le fichier de données n'existe pas, crée à vide un fichier de données (fichier d'extension ".FIC") avec le fichier d'index et le fichier mémo si nécessaire.
La fonction est équivalente à la fonction HCréation. - Si le fichier de données existe, ouvre le fichier de données.
La fonction est alors équivalente à la fonction HOuvre.
Pour optimiser l'appel à la fonction HCréationSiInexistant, l'ouverture du fichier de données peut être également réalisée uniquement au premier accès réalisé sur le fichier de données (en utilisant la constante hOuvertureDifférée).
Remarque : Il est possible d'activer la création automatique des fichiers de données inexistants lors de la description du projet (onglet "Fichiers" de la description du projet, option "Créer les fichiers de données automatiquement au moment de leur ouverture"). La fonction HCréationSiInexistant est automatiquement utilisée si le fichier de données n'existe pas lors de sa première manipulation.
HCréationSiInexistant("*", "PSW")
HCréationSiInexistant(Commande)
Syntaxe
<Résultat> = HCréationSiInexistant([<Fichier de données> [, <Mot de passe> [, <Chemin du fichier JNL> [, <Chemin du fichier JournalOperation>]]] [, <Option>]])
<Résultat> : Booléen - Vrai si le fichier de données a été créé ou ouvert,
- Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur. En cas d'erreur fatale, un traitement spécifique est nécessaire pour continuer le programme et vérifier si le fichier de données a été créé (voir Notes).
<Fichier de données> : Chaîne de caractères optionnelle Nom du fichier de données à utiliser. - Si ce nom n'est pas spécifié, la fonction HCréationSiInexistant va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
- Si ce paramètre est égal à "*", tous les fichiers de données de l'analyse en cours seront créés ou ouverts. Si un mot de passe est précisé, ce mot de passe est utilisé pour tous les fichiers de données.
Cas des projets multi-analyses : Tous les fichiers de données de toutes les analyses seront créés ou ouverts. - Ce paramètre peut également correspondre au nom d'un groupe de fichiers (ou perso-dossier) défini dans l'analyse (non disponible en Android et Android Widget). Si un mot de passe est précisé, ce mot de passe est utilisé pour tous les fichiers de données du groupe.
<Mot de passe> : Chaîne de caractères optionnelle - Mot de passe associé au fichier de données.
- Chaîne vide ("") si aucun mot de passe n'est utilisé.
<Chemin du fichier JNL> : Chaîne de caractères optionnelle Chemin d'accès au fichier JNL associé au fichier de données journalé. Ce paramètre est pris en compte uniquement si le fichier de données est journalé. Dans ce cas, le fichier <Nom du fichier>JNL.fic sera créé à l'emplacement spécifié.
<Chemin du fichier JournalOperation> : Chaîne de caractères optionnelle Chemin d'accès du fichier JournalOperation et du fichier JournalIdentification associé au fichier de données journalé. Le fichier JournalOperation contient toutes les opérations effectuées sur le fichier de données journalé. Ce paramètre est pris en compte uniquement si le fichier de données est journalé.
<Option> : Constante optionnelle Optimisation de l'ouverture des fichiers de données existants. | | | hChangeAlphabet | L'alphabet défini avec la fonction ChangeAlphabet sera pris en compte dans le nouveau fichier de données. Les tris, recherches (ou autres) sur des clés de type chaîne (chaînes, caractères, date et heure) seront effectuées selon cet alphabet. | | hOuvertureDifférée | Si le fichier de données existe déjà , il ne sera ouvert que lors du premier accès au fichier de données. Si le fichier de données n'existe pas, il est créé et ouvert. | | hSansLiaison | Gestion de l'intégrité : Les liaisons ne sont pas mises à jour sur le serveur (création, modification, suppression selon le cas).
Rappel : Par défaut, lors de la création d'un fichier de données, les liaisons sont mises à jour sur le serveur.
|
Remarques Gestion du mot de passe Le mot de passe peut être défini : - directement à la création ou à l'ouverture du fichier de données avec la fonction HCréationSiInexistant.
- avant la création du fichier de données grâce à la fonction HPasse.
Attention : Le mot de passe est indépendant du cryptage des données. Le cryptage des données doit être configuré lors de la description du fichier de données dans l'éditeur d'analyses (Onglet "Détail").
Gestion des erreurs fatales lors de la création d'un fichier de données En cas d'erreur fatale lors de la création d'un fichier de données, il peut être intéressant de continuer le programme tout en vérifiant si le fichier de données a tout de même été créé. Pour cela, il est conseillé de faire le traitement d'exception suivant :
QUAND EXCEPTION DANS
HCréationSiInexistant(PERE)
FAIRE
Erreur("Erreur HFSQL : " + HErreur())
SINON
Trace("fichier créé")
FIN
Création du fichier de données à partir de sa description Il est possible de créer directement le fichier de données à vide à partir de sa description dans l'éditeur d'analyses. Il suffit de sélectionner l'option "Créer le fichier des données" du menu contextuel du fichier de données (dans le graphe de l'analyse) et de sélectionner le répertoire dans lequel le fichier de données doit être créé.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|