Documentation vitefait3 (ViteFait3.pdf)

Vitefait3 - programme Dictionnaire
Version beta 2

Jacques Adamski1

17 mai 2004

1Merci à Denis Bitouzé pour son aide sur la documentation

Table des matières

1 Objet 2

2 Principes 3

3 Création de formulaire 4
3.1 Les touches standards de Vitefait/Dict « formulaire » . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.2 Les champs de Vitefait/Dict « formulaire » . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.3 Création de champs à l'intérieur du formulaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.3.1 Les touches standards de Vitefait/Dict champs . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.3.2 Les champs de Vitefait/Dict champs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Chapitre 1

Objet

Vitefait version 3 introduit une nouvelle possibilité de création d'application sans aucune programmation. Cette op-
tion appelée Dict est une option de supplémentaire de Vitefait, néanmoins il est toujours possible avec Vitefait3 de
travailler en mode « programmation » de Vitefait.
L'option Dict génère d'ailleurs de manière transparente des programmes Vitefait.

Chapitre 2

Principes

Avec Vitefait/Dict on déclare ses formulaires et ses champs en répondant à des questions, on demande « générer » et
l'application intranet générée peut être immédiatement testée. Les applications générées intègrent la gestion totale de tables
SQL (quelle que soit la base de données choisie), des fonctions de recherches évoluées, l'ensemble des tests nécéssaires à la
validation des données entrées, l'enchainement de formulaires...

Chapitre 3

Création de formulaire

Pour créer votre premier formulaire à l'aide de Vitefait/Dict démarrer Vitefait et connectez-vous à votre serveur
par http://nomdemachine/vitefait2/dict puis mettez votre code et mot de passe. Le premier formulaire de Vitefait apparaît
comme sur la figure 3.1 page suivante.

3.1 Les touches standards de Vitefait/Dict « formulaire »

Sur ce premier formulaire, vous avez un certain nombre de touches de fonction. Les touches voir, ajouter, modifier,
supprimer , lister vous servent à voir un questionnaire existant (en mettant le nom du formulaire), ajouter, modifier, ou
supprimer un formulaire, lister les formulaires existant en table. La touche champs vous permet de passer à la description
des champs de votre formulaire.
Si avant de passer en Vitefait sous Linux vous avez installé une version sous Windows, vous verrez quelques exemples
de formulaire.
La touche generer vous permet de générer tout le code nécéssaire au traitement de votre formulaire, ainsi que la table
SQL associée. Vous pouvez lancer la génération autant de fois que vous le souhaitez, mais la table SQL ne sera pas détruite
lors de la regénération. Si vous avez ajouté des champs, changé un type ou nom de champ, il faudra détruire la table SQL

FIG. 3.1 Premier formulaire

avec la touche detruire_table avant de procéder à la génération.
Une fois la génération terminée, vous pourrez utiliser l'application avec la touche tester.
Mais votre application sera aussi disponible à partir de tout votre réseau par http://nomdemachine/vitefait2/vitefait_prog/
nomdeformulaire_prog

3.2 Les champs de Vitefait/Dict « formulaire »

Formulaire : le nom du formulaire, commence par une lettre et peut contenir lettres, chi ffres et caractère souligné. Ne peut
pas contenir d'espace ni d'accentué ;

Titre : ce que vous voulez, y compris des balises HTML ;

Touches à gérer : les touches que vous voulez inclure dans votre application :

1. pour les touches voir, ajouter, modifier, supprimer, voir plus haut ;

2. la touche valider remplace les touches ajouter et modifier elle crée servira à créer un nouvel enregistrement
s'il n'existe pas en table ou à le modifier s'il existe ;

3. la clé de recherche sera donnée dans le formulaire champs ;

4. la touche rab servira à remettre à blanc le formulaire de votre application.

3.3 Création de champs à l'intérieur du formulaire

Une fois que vous aurez ajouté votre formulaire, vous pourrez aller y ajouter des champs en cliquant sur le bouton
champs .
Les images ( 3.2 page suivante, 3.3 page 8, 3.4 page 9 et 3.5 page 10) vous présentent la totalité du formulaire champs.

C'est au niveau des champs que vous pourrez décrire totalement votre application.
Tous les champs décrits seront associés à votre formulaire et leur ordre de présentation sera définit par leur « rang ».

FIG. 3.2 formulaire champs partie 1

FIG. 3.3 formulaire champs partie 2

FIG. 3.4 formulaire champs partie 3

FIG. 3.5 formulaire champs partie 4

Si vous aviez déjà ajouté des champs dans votre formulaire, vous trouveriez la liste de ces champs en haut (voir 3.1 page 5).
Dans ce cas vous pourriez cliquer sur le champs que vous souhaitez modifier.

3.3.1 Les touches standards de Vitefait/Dict champs

Ce sont les touches voir, ajouter, modifier, supprimer telles que décrites précédemment ainsi que la touche
retour qui vous permet de retourner au formulaire « formulaire ».

3.3.2 Les champs de Vitefait/Dict champs

Formulaire : le nom du formulaire sur lequel vont être ajoutés les champs, ce nom est rempli automatiquement. Ce champ
est vide si vous n'avez pas sélectionné de formulaire sur l'image « formulaire ». Dans ce cas vous ne pourriez pas
ajouter des champs ;
Rang : l'ordre d'apparition de votre champ dans le formulaire, rang doit être composé obligatoirement de 4 chi ffres. Il est
possible de laisser des trous dans la numérotation pour insérer des champs par la suite dans le formulaire ;

Nom de la question : le nom que vous avez choisi de donner à votre question. Doit commencer par un lettre et peut contenir
lettres, chi ffres et et caractère souligné. Ne peut pas contenir d'espace ni d'accentué. Si vous ne mettez pas de nom à
votre question, seul le titre sera généré dans le formulaire ;

Titre : ce que vous voulez, y compris des balises HTML. Le titre pour les cases à cocher et bouton radio doit contenir le titre
de chacune de ses occurrences (cf. 3.3.2 page suivante) ;

Type : vous choississez le type de votre question, les types date et objet ne sont pas valables pour la base de données
intégrée à Vitefait (Gadfly). Ils nécessitent une base Postgresql, Mysql, Oracle... Les types

1. « textes », « nombre entier », « nombre » « réel », « objet » génèrent des champs de type chaine de caractères ;

2. « texte non modifiable » un champ chaine de caractères non modifiable

3. « bouton radio » et « case à cocher » génèrent des choix (uniques ou multiples)

4. « liste » une liste déroulante.

Doit être rempli.

Longueur : non nécéssaire pour les boutons radio et case à cocher. C'est le nombre de caractères de votre champs. Doit
être numérique si présent. Par défaut 1.

Nombre de lignes : nombre de lignes pour les champs texte. Par défaut 1.

Occurrences : nombre d'occurences pour les cases à cocher et bouton radio. Doit être numérique. Nécéssaire pour ces
types de champs. le nombre d'occurence doit se retrouver dans le titre. Pour les boutons radios et cases à cocher le
titre s 'écrit sous la forme « Titre :valeur1 /valeur2/.../valeurN », par exemple : Sexe:Homme/Femme.
Caractéristiques de champs : (Serviront de critère de recherche pour les modification.)

Champ de la clé : « est un champ de la clé »

Champ non clé « est un champ non clé ».

Champ non modifiable (sera un champ de la table non mis à jour par ce formulaire) « est un champ non modifiable »

N'est pas un champ de la table : (sera un simple champ de calcul) « n'est pas un champs de la table »

Choisissez l'option qui vous intéresse.

Tests ou traitements : grâce à cette liste de choix vous pourrez choisir un certain nombre de tests et traitements à appliquer
à votre question :
1. « non vide », « alphabétique », « alphanumérique », « date » (au format jj /mm/aaaa), « numérique », « chiffres »,
« LettreOuChi ffre » pour les plus simples ;
2. « non existant en table » fera la recherche d'existance en table SQL avec comme critère de recherche l'ensemble
des champs définis comme clé ;
3. « date /heure auto » remplira automatiquement ce champs avec la date et l'heure au format
aaaa/mm/jj hh:mm:ss.ccc GMT +x

4. « utilisateur auto » remplira le champs avec le nom de l'utilisateur ;

5. « critère de liste » vous présentera avant le formulaire une liste avec toutes les lignes correspondants au criitères
de liste cochés ;

6. « critère de recherche égal » générera le code qui permettra à la touche liste de faire des sélections si le champ
est rempli ;

7. « critère de recherche like » générera le code qui permettra à la touche liste de faire des sélections si le champ
est rempli. ces recherche s 'e ffectueront selon le mode like de SQL, c'est à dire contenant le texte. N'est pas
utilisable avec la base intégrée.

Nom de table, critères, nom des questions de cette table : ces champs ne servent qu'aux question de type « liste » elles
remplissent la liste avec une extraction sur une autre table (créée elle aussi avec Vitefait/Dict).

ATTENTION ! Pour les noms de questions qui auront reçu le type « clé » il faudra préfixer le nom par k_.

EXEMPLE 1. La question nom sera appelée par k_nom.

Les questions de la table seront séparées par des virgules. Les critères de recherches seront conformes à ceux décrits dans
la doc Vitefait et eux aussi séparés par des virgules. Le préfixe k_ doit être aussi indiqué dans les critères de recherches
si la question servant de critère est de type clé. Par défaut la valeur rendue au formulaire afin d'être stockée en table sera la
juxtaposition de tous les champs séparés par un espace. Si on met la liste de champs sous forme nom,prenom:numero la
liste a ffichera nom et prenom mais rendra le numero de la ligne choisie.

EXEMPLE 2 (RECHERCHE DANS UNE TABLE CLIENT DE TOUS LES « DUPONTS »).
Table : clients ;

Nom de table : clients ;

Critères : eq_k_nom=zonenom ;

Nom des questions : k_nom , k_prenom, email : nom et prenom font partie de la clé, email ne fait pas partie de la
clé.

Autre tests ou traitements : permet d'ajouter des tests au format Vitefait2 (voir documentation Vitefait2).

Calculs avant écriture : idem mais juste avant l'écriture ou réécriture.

Calculs avant visualisation : idem mais juste avant la visualisation.

Calculs avant liste : idem mais avant l'appel de la fonction de liste.