Création avec l'aide de l'ide : − Le Wiki Gambas

Création d'une base de données à l'aide de l'IDE :

Vous devez commencer par cocher les composants suivants dans votre projet :
gb.db pour accéder aux éléments des bases de données
gb.db.form pour accéder à des contrôles graphiques liés aux bases de données, à intégrer dans un formulaire.
Lorsque ce composant est activé, des contrôles spécifiques apparaissent alors dans la boite à outils sous l'onglet Données : DataBrowser, DataCombo, DataContol, DataSource, DataView, DataComboView.

L'intérêt de ces outils graphiques résident dans la facilité d'affichage et de manipulation des enregistrements de votre base de données.
Mais il faut au minimum, créer une connection, une base de données (ou en utiliser une toute prête) et une table.
Après avoir créé une connexion nous devons créer une base de données puis nous alimenterons une table de champs.

Étapes :

1 créer la connection par un clique droit sur connexions, puis nouvelle : ici, hConn
2 ouvrir hConn
3 dans la partie droite de l'IDE apparaît un tableau représentant la connexion
4 cliquer dans ce tableau sur le menu : nouvelle table
5 donner un nom : ici, hTable
6 nous pouvons créer nos champs les uns après les autres en donnant les propriétés de chacun.

7 nous créons la base de données. Pour cela, cliquer droit sur la connexion puis choisir "propriétés"

Bien renseigner les informations surtout l'emplacement de la base.
Ajouter un "/." à la fin permet d'être certain que la base sera bien trouvée quand on utilise le répertoire Données de l'IDE, avec la limitation suivante : utilisation de notre programme uniquement sur notre machine, un paquet d'installation ne créera pas la base de données.

Voici ce que génère l'IDE, avec les informations renseignées dans l'image précédente :

1 2 3 4 5 6 7 8 9 10 11	`# Gambas Connection File 3.0 [Connection] Type="sqlite" NoPassword=FALSE RememberPassword=FALSE IgnoreCharset=FALSE DisplayMetadata=FALSE RememberTemplate=TRUE Database="LaBase" Requests=[""] Path="."`

Repérer la dernière ligne qui correspond à l'emplacement de la base, il faut que cela soit un emplacement relatif et non une adresse absolue qui ne renvoie qu'à votre machine.
L'image semble donc convertir les adresses absolues qu'on lui fourni en adresses relatives avec une limite il faut que la base se trouve déjà à l'endroit envisagé. Si vous donnez l'adresse de votre home celle-ci sera transformée ainsi : Path="~"

Paquet de distribution :

Pour pouvoir utiliser un autre répertoire à créer au moment du lancement du programme et pouvoir créer un paquet de distribution, il convient de manœuvrer ainsi :
- créer la connexion dans l'IDE
- créer la base de données dans le répertoire Données de l'IDE, pour cela clique droit sur la connexion, renseigner l'adresse par défaut du projet (c'est la même adresse que dans l'image précédente sans "/.") et sélectionner la base
- dans votre programme avant le lancement du formulaire (un module de démarrage), il faut redéfinir la connexion :

1
2
3
4
5 'cette ligne ne sert qu'à aligner la ligne suivante (petit bug d'affichage du site). Connections["hConn"].Host = User.home &/ T2 '<----' On choisit l'endroit qu'on veut Connections["hConn"].Name = "LaBase" '<-------------' On redonne le nom de la base Connections.Create("hConn") '<---------------------------' On recréer la connexion avec ces nouvelles informations WAIT 0.5 '<--------------------------------------------------------' On attend bien la fin de la création

1 2 3 4 5	`'cette ligne ne sert qu'à aligner la ligne suivante (petit bug d'affichage du site). Connections["hConn"].Host = User.home &/ T2 '<----' On choisit l'endroit qu'on veut Connections["hConn"].Name = "LaBase" '<-------------' On redonne le nom de la base Connections.Create("hConn") '<---------------------------' On recréer la connexion avec ces nouvelles informations WAIT 0.5 '<--------------------------------------------------------' On attend bien la fin de la création`

Ici T2 est un string représentant l'emplacement de dépôt de votre base, bien sûr il convient auparavant de vérifier et créer le dit répertoire de dépôt.
Avec "Create" toute la structure est créée et la connexion est ouverte.

Utilisation des éléments graphiques :

Avec l'IDE nous allons utiliser les objets graphiques mis à notre disposition pour afficher et même alimenter les enregistrements de notre base de données

Sur notre formulaire nous déposons d'abord un conteneur de données : le DataSource qui comme son nom l'indique est la source de nos données.

Puis nous allons glisser un contrôle dans ce conteneur pour accéder, afficher et éditer nos données de la base.
Dans l'image au dessus nous avons intégré un DataBrowser.

On obtient une sorte de navigateur au sein des données de la base :

Au final, nous n'avons pas écrit une seule ligne de code, encore (sauf pour le module de démarrage si nous voulons distribuer un paquet d'installation), et, pourtant nous pouvons lancer notre programme pour alimenter et gérer notre base de données.

Je vous propose d'utiliser l'exemple qui nous a servi, ici : BaseIDE et d'ajouter les composants de base de données que nous n'avons pas testés, à savoir : DataCombo, DataContol, DataView, DataComboView.

Gambas France BETA