This page is also available in

Documentation

La documentation ci-dessous fait partie de la distribution de BeeBase. Elle est également disponible sous forme de PDF.

[ << ]

[ >> ]

[Sommaire]

[Table des matières]

[Index]

[ ? ]

13. Importer et Exporter

Pour partager vos enregistrements avec d'autres systèmes de base de données, BeeBase offre un moyen d'importer et d'exporter les enregistrements depuis et vers d'autres bases de données. L'import et l'export sont réalisés par lecture et écriture de fichiers textes. Ces fichiers doivent respecter un format particulier décrit dans la section suivante.

13.1 Format de fichier		À quoi ressemble le format
13.2 Exemple de fichier d'import		Un exemple
13.3 Importer des enregistrements		Comment importer des enregistrements
13.4 Exporter des enregistrements		Comment exporter des enregistrements

13.1 Format de fichier

Pour importer des enregistrements dans BeeBase, tous les enregistrements d'une table doivent être disponibles dans un seul fichier texte. Si vous désirez importer des enregistrements de plusieurs tables, vous devez avoir plusieurs fichiers d'import (un par table).

Un fichier d'import est constitué de lignes et de colonnes. Les lignes sont séparées par un séparateur d'enregistrement, les colonnes par un séparateur de champ. Les délimiteurs peuvent être spécifiés dans les fenêtres d'import et d'export. Comme les champs des enregistrements eux-mêmes peuvent déjà contenir ces séparateurs, il est possible d'utiliser des guillemets anglais doubles autour des champs pour les protéger.

Un fichier d'import doit posséder la structure suivante :

La première ligne contient le nom des champs, et pour chacun, un champ avec exactement le même nom doit exister pour la table dans laquelle sont importés les enregistrements. S'il existe un nom pour lequel il n'y a pas de champ correspondant dans la table, alors l'import échoue avec un message d'erreur.
Les lignes suivantes contiennent chacune un enregistrement. Comme tous les champs doivent être spécifiés au format texte, ils sont automatiquement convertis dans le type du champ de destination. Pour les champs de type booléen, la valeur doit être soit NIL ou TRUE (peu importe la casse), autrement un message d'erreur est généré. Pour les champs de type choix, le libellé (label) exact doit être spécifié (la casse est importante ici). Pour les champs de type référence, il faut indiquer le numéro de l'enregistrement référencé (à partir de 1). Pour tous les autres types, la valeur NIL est utilisée si le champ ne peut être converti vers le type requis.
Si vous utilisez des guillemets anglais doubles, tous les champs doivent être encadrés, y compris les noms des champs.

13.2 Exemple de fichier d'import

L'exemple suivant importe un fichier en utilisant respectivement \n et \t comme délimiteur d'enregistrement et délimiteur de champ, et des guillemets doubles autour de tous les champs. Le fichier peut être importé dans une table ayant les champs suivants :

Nom (texte)
NbEnfants (entier)
Femme (booléen)
Profession (choix)
Notes (mémo)


"Nom"	"NbEnfants"	"Femme"	"Profession"	"Notes"
"Janet Jackson"	"???"	"TRUE"	"Musicienne"	"Dernier CD : The velvet rope"
"Bernt Schiele"	"???"	"NIL"	"Scientifique"	"Centres de recherches :
Robotique, Autonomie et vision par ordinateur"
"Gerhard"	"0"	"NIL"	"Mécanique de précision"	""

13.3 Importer des enregistrements

Pour importer des enregistrements dans la table active, sélectionnez le menu `Table - Importer des enregistrements'. Une fenêtre s'ouvre contenant les éléments suivants :

un champ texte pour saisir le nom du fichier d'import. À droite de ce champ il y a trois boutons : le premier permet de sélectionner un fichier, le second lance la visionneuse externe pour inspecter le fichier sélectionné, et le troisième lance un éditeur pour modifier le fichier.
deux champs texte pour saisir respectivement les délimiteurs d'enregistrement et de champ. Vous pouvez saisir un caractère ou un code de contrôle tel que \n, \t, \f, \??? (code octal) ou \x?? (code héxa). Les délimiteurs doivent être des caractères ASCII 7 bits (de \x01 à \x7F inclus).
une case à cocher `Guillemets anglais doubles' pour indiquer que les champs sont protégés par des guillemets anglais doubles.
deux boutons `Importer' et `Annuler' pour fermer la fenêtre.

Si vous appuyez sur le bouton `Importer', BeeBase charge le fichier spécifié et importe tous les enregistrements trouvés. Si tout se passe correctement après le processus d'import, BeeBase demande si vous voulez vraiment ajouter les enregistrements importés dans la table. À ce point il est encore possible d'annuler l'opération. Les enregistrements écrasés, cependant, ne peuvent être récupérés qu'en restaurant le projet.

Si une erreur survient lors de la lecture du fichier d'import, un message d'erreur est affiché.

Si vous avez besoin d'un mécanisme d'import plus sophistiqué, il est recommandé d'écrire sa propre routine d'import dans un programme BeeBase.

13.4 Exporter des enregistrements

Pour exporter les enregistrements de la table active, sélectionnez le menu `Table - Exporter des enregistrements'. Une fenêtre s'ouvre contenant les éléments suivants :

un champ texte pour saisir le nom du fichier d'export avec à droite un bouton pour sélectionner un fichier.
deux champs texte pour saisir respectivement les délimiteurs d'enregistrement et de champ. Vous pouvez saisir un caractère ou un code de contrôle tel que \n, \t, \f, \??? (code octal) ou \x?? (code héxa). Les délimiteurs doivent être des caractères ASCII 7 bits.
une case à cocher `Guillemets anglais doubles' pour indiquer que les champs doivent être protégés par des guillemets anglais doubles.
deux boutons `Exporter' et `Annuler' pour fermer la fenêtre.

Si vous appuyez sur le bouton `Importer', BeeBase ouvre le fichier spécifié et y écrit les enregistrements en y incluant une ligne d'entête contenant le nom des champs. La fonction d'export écrit toujours tous les champs de la table dans le fichier d'export.

Pour un mécanisme d'export personnalisé, vous pouvez utiliser l'éditeur de requêtes de BeeBase (voir Traitement des données) ou écrire votre propre routine d'export dans un programme BeeBase.