|
|
|
|
|
|
|
|
|
|
- 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
<Source>.CréationSiInexistant (Fonction) En anglais : <Source>.CreationIfNotFound
 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 <Source>.Création. - Si le fichier de données existe, ouvre le fichier de données.
La fonction est alors équivalente à la fonction <Source>.Ouvre.
Pour optimiser l'appel à la fonction <Source>.Cré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 <Source>.CréationSiInexistant est automatiquement utilisée si le fichier de données n'existe pas lors de sa première manipulation.
Client.CréationSiInexistant()
Syntaxe
<Résultat> = <Source>.CréationSiInexistant([<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).
<Source> : Type correspondant à la source spécifiée Nom du fichier de données à utiliser. <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 <Source>.CréationSiInexistant.
- avant la création du fichier de données grâce à la fonction <Source>.MotDePasse.
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
Père.CréationSiInexistant()
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…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|