Project

General

Profile

Utilisation pas à pas

1. Connexion à la base de données

Si tout va bien, en ouvrant votre navigateur sur par exemple http://localhost/Zenerator (l'adresse varie bien entendu selon votre configuration), vous devriez obtenir une page comme celle-ci :

En (A), indiquez l'adresse du serveur de base de données, bien souvent, il sera installé sur votre poste de travail (sachant que bien des SGBDR refusent les connexions distantes, Zenerator ne pourrait alors pas fonctionner).
En (B), indiquez le type de SGDBR (notez que selon votre choix, vous devrez posséder une certaine extension, PDO MySQL, PDO Oracle, etc).
En (C), indiquez le nom de la base de données, et en (D) et (E) indiquez les informations de connexion à la base.
Enfin en (F), vous devez choisir le profil1. Cliquer sur "Next" pour vous connectez à la base et continuer.

2. Configuration de Zenerator & Génération des fichiers

Une fois la connexion à la base établie, vous devriez obtenir une page similaire à la suivante :

Voir la capture d'écran en taille originale

Les informations disponibles sur cette page dépendent bien évidemment de votre base de données et du profil que vous avez sélectionné.

En (A), vous avez un résumé des informations précédemment fournies. En (B), il y a un bouton vous permettant de terminer la session en cours, afin de se connecter à une autre base de données, ou de changer de profil. En (C), vous avez une liste des dossiers et fichiers que l'application va générer. Attention, d'autres fichiers seront générés selon votre sélection de tables et templates, mais cette liste là est fixe : les dossiers et fichiers présents seront créés quelque soit votre sélection.

En (D), vous devez renseigner le nom de l'application. Évitez les accents, caractères spéciaux et espaces, aucun filtrage n'est effectué sur ce champ, vous devez donc fournir un nom propre, du type Zenerator ou MyApp ou myapp. Ce nom sera entre autre utilisé pour créer des dossiers, si vous fournissez un nom avec des caractères interdits pour la création de dossier, la génération échouera.

La section (E) contient les champs personnalisés du profil, ces champs sont déterminés par le profil. Pour plus d'informations sur la nature de ces champs, placez la souris sur l'icône bleue à côté de chacun d'eux, une bulle d'aide apparaitra, contenant une description du champ. Note : ces informations sont fournies par le profil et ne dépendent en aucun cas de Zenerator, si le profil est mal fait ou incomplet, cela n'est pas la responsabilité de Zenerator. L'application ne peut afficher que les informations qui lui sont fournies.

On arrive maintenant à la partie sans doute la plus importante : la sélection des tables et templates2. Vous avez ici la liste de toutes les tables que Zenerator a trouvé dans votre base de données. Pour chacune d'elle, vous pouvez choisir de l'ignorer (élément (F)). Si une table est ignorée, aucun fichier concernant cette table ne sera généré.
Pour chaque table, vous avez une liste des templates avec une description pour chacun d'eux. Encore une fois, ces informations sont déterminées par le profil, si ce dernier ne les a pas renseignées, Zenerator ne peut pas les inventer. Vous pouvez ignorer chacun des templates, en fonction de vos besoins (élément (G)).

Enfin, il vous suffit de cliquer sur le bouton (H) pour lancer la génération des fichiers. Cela peut prendre un temps variable selon le profil et la sélection de l'utilisateur.

1 Pour en savoir plus sur les profils et leur gestion, lisez Fr_Profils
fn2. Pour en savoir plus sur les templates et leur gestion, lisez Fr_Templates