Démarrage rapide : PostgreSQL

Ce didacticiel prendra 5 à 10 minutes et, à la fin, vous aurez réussi à créer une application CRUD complète.
Ce guide vous montrera comment créer une application de journal d'entretien de véhicule. Pour ce guide, nous utiliserons PostgreSQL. Dans Budibase, le processus est le même quel que soit le type de base de données que vous utilisez.

Dans ce tutoriel, nous allons créer une application de journal d'entretien de véhicule qui comprend :

Table de véhicule pour visualiser les véhicules
Tableau de journal d'entretien pour enregistrer l'historique d'entretien du véhicule
Nous utiliserons la structure de tableau suivante :

commencer

Exécutez le script
SQL suivant

CREATE TABLE public."Vehicles" (
  "id" SERIAL PRIMARY KEY,
  "Registration" TEXT NULL,
  "Make" TEXT NULL,
  "Model" TEXT NULL,
  "Colour" TEXT NULL,
  "Year" INT NULL);
  

CREATE TABLE public."ServiceLog" (
  "id" SERIAL PRIMARY KEY,
  "Description" TEXT NULL,
  "VehicleId" INT NULL,
  "ServiceDate" TIMESTAMP NULL,
  "Category" TEXT NULL,
  "Mileage" INT NULL);


INSERT INTO public."Vehicles"("Registration", "Make", "Model", "Colour", "Year")
VALUES ('FAZ 9837','Volkswagen','Polo','White',2002);
INSERT INTO public."Vehicles"("Registration", "Make", "Model", "Colour", "Year")
VALUES ('JHI 8827','BMW','M3','Black',2013);
INSERT INTO public."Vehicles"("Registration", "Make", "Model", "Colour", "Year")
VALUES ('D903PI','Volvo','XC40','Grey',2014);
INSERT INTO public."Vehicles"("Registration", "Make", "Model", "Colour", "Year")
VALUES ('YFI002','Volkswagen','Golf','Dark Blue',2018);
INSERT INTO public."Vehicles"("Registration", "Make", "Model", "Colour", "Year")
VALUES ('HGT5677','Skoda','Octavia','Graphite',2009);
INSERT INTO public."Vehicles"("Registration", "Make", "Model", "Colour", "Year")
VALUES ('PPF9276','Skoda','Octavia','Graphite',2021);
INSERT INTO public."Vehicles"("Registration", "Make", "Model", "Colour", "Year")
VALUES ('J893FT','Toyota','Corolla','Red',2015);
INSERT INTO public."Vehicles"("Registration", "Make", "Model", "Colour", "Year")
VALUES ('MJK776','Honda','HR-V','Silver',2015);


INSERT INTO public."ServiceLog"("Description", "VehicleId", "ServiceDate", "Category", "Mileage")
VALUES ('Change front brakes', 1, '2021-05-04', 'Brakes', 20667);
INSERT INTO public."ServiceLog"("Description", "VehicleId", "ServiceDate", "Category", "Mileage")
VALUES ('Tyres - full set', 1, '2021-05-04', 'Tyres', 20667);
INSERT INTO public."ServiceLog"("Description", "VehicleId", "ServiceDate", "Category", "Mileage")
VALUES ('Engine tune up', 2, '2021-07-14', 'Engine', 50889);
INSERT INTO public."ServiceLog"("Description", "VehicleId", "ServiceDate", "Category", "Mileage")
VALUES ('Replace transmission', 3, '2021-09-26', 'Transmission', 98002);

Créez un nouveau compte sur https://account.budibase.app/register (ne prend que quelques secondes)
Une fois connecté, créez une nouvelle application et nommez-la : Journal d'entretien du véhicule

Connectez-vous à votre table SQL

Lorsqu'on vous demande quelle base de données vous souhaitez utiliser, choisissez PostgreSQL
Terminez la configuration pour vous connecter à votre base de données PostgreSQL
::: conseil
Veuillez noter que si vous vous connectez à une base de données sur , votre hôte doit être défini sur , ou s'il fonctionne sur Linux. localhosthost.docker.internal172.17.0.1
:::
Après avoir ajouté les détails de connexion, cliquez sur Extraire les tables de la base de données. Cela lira la table dans la base de données.

Créer un écran à partir d'une table SQL

Une fois que Budibase connaît votre table SQL, il peut générer automatiquement des écrans (interface utilisateur) qui permettent de lister, créer, modifier et supprimer des enregistrements de la table. Bien sûr, ces écrans générés sont entièrement personnalisables - mais Budibase vous donne une longueur d'avance considérable.

Allez dans la rubrique "Conception".
Créez un nouvel écran et sélectionnez Véhicule dans la liste d'écrans générée automatiquement.

Utilisation des relations entre les tables SQL

Budibase permet de déclarer des relations entre les tables. Nous allons créer une relation un-à-plusieurs entre les véhicules et les transactions.

::: tip
Budibase ne modifie pas vos formulaires. Nous indiquons simplement à Budibase la structure de votre base de données existante.
:::
Pour définir une relation :

9. Sélectionnez votre source de données SQL
10. Cliquez sur Définir la relation et :

Définissez le type de relation sur « One to One ».
La table from("One") est "Véhicules".
La table to("Many") est "Service Logs".
"De la colonne de la table" est la façon dont votre relation est nommée dans votre table Véhicules. Nous appelons ces journaux de service.
"Vers les colonnes de la table" est la façon dont vos relations sont nommées dans la table du journal de service. Appelons-le "véhicule"
Maintenant que la relation est créée, la première colonne de chaque table sera utilisée comme colonne d'affichage par défaut.
La colonne Afficher indique à Budibase comment décrire le véhicule à partir du tableau du journal d'entretien et vice versa. Cela équivaut à un alias de colonne :

SELECT ServiceLogs.*,  Registration as Vehicle 
FROM ServiceLogs 
INNER JOIN Vehicle on ServiceLog.VehicleId = Vehicle.id

modifier les colonnes d'affichage

Sélectionnez la table du journal de service
Cliquez sur l'icône de modification à côté de la colonne Catégorie
Basculer "Utiliser comme colonnes d'affichage de tableau"
Cliquez sur "Enregistrer les colonnes" et
le tableau des véhicules devrait maintenant afficher la catégorie Journal de service au lieu de la description.

Ajouter l'écran CRUD du journal de service

Allez dans la rubrique "Conception".
Créez un nouvel écran et sélectionnez Journaux de service dans la liste d'écrans générée automatiquement.
Cliquez sur le bouton d'aperçu et affichez votre nouvelle application de journal d'entretien de véhicule
Succès
Vous disposez maintenant d'une application de journal d'entretien de véhicule entièrement fonctionnelle.

Démarrage rapide de Budibase : PostgreSQL