Web Snap

Tutoriel : Cration dune application WebSnap

Borland

Delphi 7pour Windows

COPYRIGHT 20012002 Borland Software Corporation. Tous droits rservs. Tous les produits Borland sont des marques commerciales ou des marques dposes de Borland Software Corporation aux Etats-Unis ou dans les autres pays. Toutes les autres marques sont la proprit de leurs fabricants respectifs.

D7-WS-0802

iii

Copyright 2002, Borland Software Corporation. All rights reserved. BORLAND CONFIDENTIALAugust 8, 2002 10:21 pm (C:\d7\d7-W\d7books\book_CD\WebSnap Tutorial\WebSnapTOC.fm)

Cration dune application WebSnapCration dune application WebSnap . . . . . . 2

Dmarrage de lexpert dapplication WebSnap . . . . . . . . . . . . 2

Enregistrement des fichiers gnrs et du projet . . . . . . . . . . . . . . . . . . . 2

Spcification du titre de lapplication . . . . . 3Cration de la page CountryTable . . . . . . . . 3

Ajout dun nouveau module de page Web . . 3Enregistrement dun nouveau module

de page Web . . . . . . . . . . . . . . . . . . 4Ajout des composants de donnes

au module CountryTable . . . . . . . . . . . . 5Ajout de composants orients donnes . . . . 5Spcification dun champ cl . . . . . . . . . 6Ajout dun composant adaptateur . . . . . . 6

Cration dune grille pour afficher les donnes . 7Ajout dune grille . . . . . . . . . . . . . . . . 7Ajout de commandes de modification

la grille . . . . . . . . . . . . . . . . . . . . 9

Ajout dune fiche de modification . . . . . . . . 10Ajout dun nouveau module de page Web . 10Enregistrement dun nouveau module . . . 11Mise disposition de CountryTableU

pour le nouveau module . . . . . . . . . . 11Ajout de champs de saisie . . . . . . . . . . . 11Ajout de boutons . . . . . . . . . . . . . . . . 12Liaison des actions de la fiche

avec la page de la grille . . . . . . . . . . . 13Liaison des actions de la grille

avec la page de la fiche . . . . . . . . . . . 13Excution de lapplication complte . . . . . . . 14Ajout de la gestion des erreurs . . . . . . . . . . 14

Ajout de la gestion des erreurs la grille . . 15Ajout de la gestion des erreurs la fiche . . 15Test du mcanisme de gestion des erreurs . 15

Index

Table des matires

iv

Copyright 2002, Borland Software Corporation. All rights reserved. BORLAND CONFIDENTIALAugust 8, 2002 10:21 pm (C:\d7\d7-W\d7books\book_CD\WebSnap Tutorial\WebSnapTOC.fm)

C r a t i o n d u n e a p p l i c a t i o n W e b S n a p 1

Chapitre0Cration dune application WebSnapCette section explique la manire de crer une nouvelle application WebSnap appele Country Tutorial. Cette application affiche des informations sur diffrents pays pour des utilisateurs du Web. Les utilisateurs peuvent ajouter et supprimer des pays et modifier des informations.

Suivez les instructions du tutoriel du dbut la fin. Si vous souhaitez faire une pause, vous pouvez utiliser tout moment la commande Fichier|Tout enregistrer pour enregistrer votre projet.

Lorsque vous avez termin le tutoriel, votre application doit ressembler celle de la Figure 1.

Figure 1 Application Country Tutorial termine

2 T u t o r i e l

C r a t i o n d u n e a p p l i c a t i o n W e b S n a p

Remarque Ce tutoriel est crit pour ldition Entreprise de Delphi, qui comprend les composants WebSnap. Le tutoriel suppose que vous tes familier de Windows et que vous avez lu lintroduction la programmation Delphi et lenvironnement de dveloppement dans la Prise en main.

Cration dune application WebSnapDans cette section, vous crerez et enregistrerez les fichiers de lapplication, et donnerez un titre lapplication.

Dmarrage de lexpert dapplication WebSnap

1 En utilisant lexplorateur de Windows, crez un dossier appel WebSnapTutorial. Il contiendra les fichiers du projet que vous allez crer pendant votre travail au cours du tutoriel.

2 Dmarrez lEDI de Delphi et choisissez Fichier|Nouveau|Autre.

3 Dans la bote de dialogue Nouveaux lments, slectionnez longlet WebSnap, choisissez Application WebSnap et cliquez sur OK.

4 Dans la bote de dialogue Nouvelle application WebSnap :

Slectionnez Excutable dbogueur dapplication Web. Dans le champ Nom de classe, tapez CountryTutorial. Slectionnez Module Page comme type de composant. Dans le champ Nom de page, tapez Home.

5 Cliquez sur OK.

Enregistrement des fichiers gnrs et du projet

Pour enregistrer les fichiers dunits Delphi et le projet :

1 Slectionnez Fichier|Tout enregistrer.

2 Dans la bote de dialogue denregistrement, naviguez jusqu votre dossier WebSnapTutorial.

3 Dans le champ Nom de fichier, changez unit2.pas en HomeU.pas et cliquez sur Enregistrer.

4 Dans le champ Nom de fichier, changez unit1.pas en CountryU.pas et cliquez sur Enregistrer.

5 Dans le champ Nom de fichier, changez project1.dpr en CountryTutorial.dpr et cliquez sur Enregistrer.


C r a t i o n d e l a p a g e C o u n t r y T a b l e

Spcification du titre de lapplication

Le titre de lapplication est le nom affich lutilisateur final. Pour spcifier le titre de lapplication :

1 Choisissez Voir|Gestionnaire de projet.

2 Dans le gestionnaire de projet, dveloppez CountryTutorial.exe et double-cliquez sur lentre HomeU.

3 Sur la ligne suprieure de linspecteur dobjets, choisissez ApplicationAdapter dans la liste droulante.

4 Dans longlet Proprits, saisissez Country Tutorial pour la proprit ApplicationTitle.

5 Cliquez sur longlet Prvisualiser dans la fentre de lditeur. Si longlet Prvisualiser napparat pas, utilisez la flche droite en bas pour faire dfiler les onglets. Le titre de lapplication est affich en haut de la page, avec le nom de page Home.

Cette page est trs simple. Vous pouvez lamliorer en modifiant le fichier HomeU.html, au moyen de longlet de lditeur HomeU.html ou en utilisant un diteur externe. Pour plus dinformations sur la manire de modifier le modle de page, voir la section Conception HTML avance, dans le chapitre WebSnap du Guide du dveloppeur.

Cration de la page CountryTableUn module de page Web dfinit une page publie et sert de conteneur aux composants de donnes. Chaque fois quune page Web doit tre renvoye lutilisateur final, le module de page Web extrait les informations ncessaires partir des composants de donnes quelle contient et utilise ces informations pour aider crer une page.

Nous allons ajouter ici un nouveau module de page lapplication WebSnap. Ce module de page ajoutera une deuxime page visualisable lapplication Country Tutorial. La premire page, Home, a t dfinie lorsque vous avez cr lapplication. La deuxime page, appele CountryTable, affiche la table des informations de pays.

Ajout dun nouveau module de page Web

Pour ajouter un nouveau module de page :

1 Choisissez Fichier|Nouveau|Autre.

2 Dans la bote de dialogue Nouveaux lments, slectionnez longlet WebSnap et choisissez Module de page WebSnap puis cliquez sur OK.

4 T u t o r i e l

C r a t i o n d e l a p a g e C o u n t r y T a b l e

3 Dans la bote de dialogue, initialisez le type de gnrateur AdapterPageProducer.

4 Dans le champ Nom de page, saisissez CountryTable. Notez que le titre change aussi mesure que vous tapez.

5 Laissez les autres champs vides avec leurs valeurs par dfaut.

La bote de dialogue apparat comme illustr Figure 2.

6 Cliquez sur OK.

Figure 2 Bote de dialogue Nouveau module de page WebSnap pour la page CountryTable

Le module CountryTable devrait maintenant apparatre dans lEDI. Aprs avoir enregistr le module, vous ajouterez de nouveaux composants au module CountryTable.

Enregistrement dun nouveau module de page Web

Enregistrez lunit dans le rpertoire du fichier projet. Lorsque lapplication sexcute, elle recherche le fichier CountryTableU.html dans le mme rpertoire que lexcutable.

1 Choisissez Fichier|Enregistrer.

2 Dans le champ Nom de fichier, entrez CountryTableU.pas et cliquez sur Enregistrer.


A j o u t d e s c o m p o s a n t s d e d o n n e s a u m o d u l e C o u n t r y T a b l e

Ajout des composants de donnes au module CountryTableTTable et TDataSetAdapter sont des composants orients donnes qui permettent daccder aux donnes. TTable fournit les donnes du tableau HTML. TDataSetAdapter permet au script serveur daccder au composant TTable. Nous allons ajouter ici ces composants orients donnes votre application.

Les sections suivantes prsument une certaine familiarit avec la programmation de base de donnes, mais vous nen avez pas besoin pour terminer ce tutoriel. WebSnap agit uniquement comme interface (par lintermdiaire de composants adaptateur) avec les composants de base de donnes. Pour en savoir plus sur la programmation des bases de donnes, vous pouvez vous rfrer la partie II du Guide du dveloppeur.

Ajout de composants orients donnes


2 Dans le gestionnaire de projet, dveloppez CountryTutorial.exe et double-cliquez sur lentre CountryTableU.

3 Slectionnez Voir|Arborescence dobjets. La fentre vue arborescente dobjets devient active.

4 Cliquez sur longlet BDE dans la palette de composants.

5 Slectionnez un composant Table et ajoutez-le au module de page Web CountryTable.

6 Slectionnez un composant Session et ajoutez-le au module de page Web CountryTable. Le composant Session est ncessaire, car vous utilisez un composant BDE (TTable) dans une application multithread.

7 Slectionnez le composant Session, nomm Session1 par dfaut, dans le module de page Web ou larborescence dobjets. Cela affiche les valeurs du composant Session dans linspecteur dobjets.

8 Dans linspecteur dobjets, initialisez la proprit AutoSessionName la valeur True.

9 Slectionnez le composant Table dans le module de page Web ou dans larborescence dobjets. Cela affiche les valeurs du composant Table dans linspecteur dobjets.

10 Dans linspecteur dobjets, modifiez les proprits suivantes :

Initialisez DatabaseName DBDEMOS. Dans la proprit Name, saisissez Country. Initialisez TableName country.db. Initialisez la proprit Active True.

6 T u t o r i e l

A j o u t d e s c o m p o s a n t s d e d o n n e s a u m o d u l e C o u n t r y T a b l e

Spcification dun champ cl

Le champ cl est utilis pour identifier les enregistrements dune table. Cela devient important lors de lajout dune page de modification lapplication. Pour spcifier un champ cl :

1 Dans larborescence des objets, dveloppez le nud Session et DBDemos, puis slectionnez le nud country.db. Ce nud est le composant Country Table.

2 Cliquez avec le bouton droit de la souris sur le nud country.db et slectionnez Editeur de champs.

3 Cliquez avec le bouton droit de la souris dans la fentre diteur de CountryTable.Country et choisissez Ajouter tous les champs.

4 Slectionnez le champ Name dans la liste des champs ajouts.

5 Dans linspecteur dobjets, dveloppez la proprit ProviderFlags.

6 Initialisez la proprit pfInKey True.

Ajout dun composant adaptateur

Vous avez fini dajouter les composants de base de donnes. A prsent, pour exposer les donnes de TTable par lintermdiaire dun script ct serveur, vous devez inclure un composant adaptateur densemble de donnes (TDataSetAdapter). Pour ajouter un adaptateur densemble de donnes :

1 Slectionnez le composant DataSetAdapter partir de longlet WebSnap de la palette des composants. Ajoutez-le au module Web CountryTable.

2 Modifiez les proprits suivantes dans linspecteur dobjets :

Initialisez la proprit DataSet Country.

Initialisez la proprit Name Adapter.

Lorsque vous avez fini, le module de page Web CountryTable devrait ressembler ce qui est prsent Figure 3.

Figure 3 Module de page Web CountryTable

Comme les lments du module ne sont pas visuels, lendroit o ils apparaissent dans le module importe peu. Il importe surtout que votre module contienne les composants reprsents sur la figure.


C r a t i o n d u n e g r i l l e p o u r a f f i c h e r l e s d o n n e s

Cration dune grille pour afficher les donnes

Ajout dune grille

Maintenant, ajoutez une grille pour afficher les donnes de la table des pays :



3 Choisissez Voir|Arborescence dobjets ou cliquez sur Arborescence dobjets.

4 Dveloppez le composant AdapterPageProducer. Ce composant gnre le script ct serveur permettant de construire rapidement un tableau HTML.

5 Cliquez avec le bouton droit de la souris sur lentre WebPageItems et choisissez Nouveau composant.

6 Dans la bote de dialogue Ajout de composant Web, slectionnez AdapterForm puis cliquez sur OK. Un composant AdapterForm1 apparat dans larborescence des objets.

7 Cliquez avec le bouton droit de la souris sur AdapterForm1 et slectionnez Nouveau composant.

8 Dans la fentre Ajout de composant Web, slectionnez AdapterGrid, puis choisissez OK. Un composant AdapterGrid1 apparat dans larborescence des objets.

9 Dans linspecteur dobjets, initialisez la proprit Adapter Adapter.

Pour prvisualiser la page, slectionnez longlet CountryTableU en haut de lditeur de code et slectionnez en bas longlet Prvisualiser. Si longlet Prvisualiser napparat pas, utilisez la flche droite en bas pour faire dfiler les onglets.

La prvisualisation devrait tre semblable la Figure 4.

8 T u t o r i e l


Figure 4 Onglet de prvisualisation de CountryTable

Longlet Prvisualiser vous montre quoi ressemble la page HTML statique finale dans un navigateur Web. Cette page est gnre partir dune page HTML dynamique qui inclut le script. Pour visualiser une reprsentation textuelle montrant les commandes de script, slectionnez longlet Script HTML en bas de la fentre de lditeur (voir Figure 5).

Figure 5 Onglet Script HTML de CountryTable



Longlet Script HTML montre un mlange de HTML et de script. Le code HTML et le script sont diffrencis dans lditeur par la couleur et les attributs de la police. Par dfaut, les balises HTML apparaissent en texte noir et gras, les noms dattributs HTML apparaissent en noir et les valeurs dattributs HTML en bleu. Le script, qui apparat entre les parenthses de script , est de couleur verte. Vous pouvez changer les couleurs et les attributs de la police par dfaut pour ces lments dans longlet Couleur de la bote de dialogue Proprits de lditeur, qui peut tre affiche en cliquant avec le bouton droit de la souris dans lditeur et en choisissant Proprits.

Il existe deux autres onglets dditeur lis HTML. Longlet Rsultat HTML montre le contenu HTML brut de la prvisualisation. Notez que les vues Rsultat HTML, Script HTML et Prvisualiser sont toutes en lecture seule. Vous pouvez utiliser longlet de lditeur li HTML, CountryTable.html, pour des modifications.

Si vous souhaitez amliorer lapparence de cette page, vous pouvez tout moment ajouter du code HTML en utilisant longlet CountryTable.html ou un diteur externe. Pour plus dinformations sur la manire de modifier le modle de page, voir la section Conception HTML avance, dans le chapitre WebSnap du Guide du dveloppeur.

Ajout de commandes de modification la grille

Les utilisateurs peuvent avoir besoin de mettre jour le contenu de la table en supprimant, en insrant ou en modifiant une ligne. Pour permettre aux utilisateurs deffectuer de telles mises jour, ajoutez des composants de commande.

Pour ajouter des composants de commande :

1 Dans larborescence des objets pour CountryTable, dveloppez le composant AdapterPageProducer et toutes ses branches.

2 Cliquez avec le bouton droit de la souris sur le composant AdapterGrid1 et choisissez Ajouter toutes les colonnes. Cinq colonnes sont ajoutes au groupe dadaptateur.

3 Cliquez de nouveau avec le bouton droit de la souris sur le composant AdapterGrid1 et choisissez Nouveau composant.

4 Slectionnez AdapterCommandColumn puis cliquez sur OK. Une entre AdapterCommandColumn1 est ajoute au composant AdapterGrid1.

5 Cliquez avec le bouton droit de la souris sur AdapterCommandColumn1 et choisissez Ajouter des commandes.

6 Appuyez sur la touche Ctrl et slectionnez ensemble les commandes DeleteRow, EditRow et NewRow, puis cliquez sur OK.

7 Pour prvisualiser la page, cliquez sur longlet Prvisualiser en bas de lditeur de code. Il existe maintenant trois nouveaux boutons (DeleteRow, EditRow et NewRow) la fin de chaque ligne de la table, comme indiqu Figure 6.

10 T u t o r i e l

A j o u t d u n e f i c h e d e m o d i f i c a t i o n

Lorsque lapplication sexcute, lutilisation dun de ces boutons dclenche laction associe.

Figure 6 Prvisualisation de CountryTable aprs lajout de commandes de modification

Choisissez Fichier|Tout enregistrer pour enregistrer lapplication avant de poursuivre.

Ajout dune fiche de modificationVous pouvez maintenant crer un module de page Web pour grer la fiche de modification de la table country. Les utilisateurs pourront modifier des donnes dans lapplication CountryTutorial par lintermdiaire de la fiche ddition. En particulier, lorsque lutilisateur appuiera sur les boutons EditRow ou NewRow, une fiche ddition apparatra. Lorsque lutilisateur en aura termin avec la fiche ddition, les informations modifies apparatront automatiquement dans la table.

Ajout dun nouveau module de page Web

Pour ajouter un nouveau module de page Web :

1 Choisissez Fichier|Nouveau|Autre.

2 Dans la bote de dialogue Nouveaux lments, slectionnez longlet WebSnap, choisissez Module de page WebSnap et cliquez sur OK.

3 Dans la bote de dialogue, initialisez le type de gnrateur AdapterPageProducer.



4 Initialisez le champ Nom de page CountryForm.

5 Dsactivez la case cocher Publie, afin que cette page napparaisse pas dans une liste de pages disponibles sur ce site. La fiche ddition est accessible par le bouton ddition, et son contenu dpend de la ligne de la table country qui doit tre modifie.

6 Laissez les autres champs et slections initialiss leurs valeurs par dfaut. Cliquez sur OK.

Enregistrement dun nouveau module

Enregistrez le module dans le mme rpertoire que le fichier projet. Lorsque lapplication sexcute, elle recherche le fichier CountryFormU.html dans le mme rpertoire que lexcutable.


2 Dans le champ Nom de fichier, entrez CountryFormU.pas et cliquez sur Enregistrer.

Mise disposition de CountryTableU pour le nouveau module

Ajoutez lunit CountryTableU la clause uses pour permettre au module daccder au composant adaptateur.

1 Choisissez Fichier|Utiliser lunit.

2 Slectionnez CountryTableU partir de la liste et cliquez sur OK.


Ajout de champs de saisie

Ajoutez des composants au composant AdapterPageProducer afin de gnrer les champs de saisie dans la fiche HTML.

Pour ajouter des champs de saisie :


2 Dans la fentre du gestionnaire de projet, dveloppez CountryTutorial.exe et double-cliquez sur lentre CountryFormU.

3 Dans larborescence des objets, dveloppez le composant AdapterPageProducer, cliquez avec le bouton droit de la souris sur WebPageItems et choisissez Nouveau composant.

4 Slectionnez AdapterForm et cliquez sur OK. Une entre AdapterForm1 apparat dans larborescence des objets.


12 T u t o r i e l


6 Slectionnez AdapterFieldGroup puis cliquez sur OK. Une entre AdapterFieldGroup1 apparat dans larborescence des objets.

7 Dans linspecteur dobjets, initialisez la proprit Adapter CountryTable.Adapter. Dfinissez la proprit AdapterMode Edit.

8 Pour prvisualiser la page, cliquez sur longlet Prvisualiser en bas de lditeur de code. Votre prvisualisation ressemblera celle illustre Figure 7.

Figure 7 Prvisualisation de CountryForm

Ajout de boutons

Ajoutez des composants au composant AdapterPageProducer afin de gnrer les boutons de validation dans la fiche HTML. Pour ajouter des composants :

1 Dans larborescence des objets, dveloppez le composant AdapterPageProducer et toutes ses branches.


3 Slectionnez AdapterCommandGroup puis cliquez sur OK. Une entre AdapterCommandGroup1 apparat dans larborescence des objets.

4 Dans linspecteur dobjets, initialisez la proprit DisplayComponent AdapterFieldGroup1.

5 Cliquez avec le bouton droit de la souris sur AdapterCommandGroup1 et choisissez Ajouter des commandes.

6 Appuyez sur la touche Ctrl et slectionnez ensemble les commandes Cancel, Apply et Refresh Row. Cliquez sur OK.

7 Pour prvisualiser la page, cliquez sur longlet Prvisualiser en bas de la fentre de lditeur de code. Si la prvisualisation naffiche pas la fiche



country, cliquez sur longlet Code puis de nouveau sur longlet Prvisualiser. Votre prvisualisation ressemblera celle illustre Figure 8.

Figure 8 CountryForm avec les boutons de validation

Liaison des actions de la fiche avec la page de la grille

Lorsque lutilisateur clique sur un bouton, une action dadaptateur est excute, qui effectue laction dcrite. Pour spcifier la page afficher aprs lexcution dune action dadaptateur :

1 Dans la fentre vue arborescente des objets, dveloppez AdapterCommandGroup1 afin dafficher les entres CmdCancel, CmdApply et CmdRefreshRow.

2 Slectionnez CmdCancel. Dans linspecteur dobjets, saisissez CountryTable dans la proprit PageName.

3 Slectionnez CmdApply. Dans linspecteur dobjets, saisissez CountryTable dans la proprit PageName.

Liaison des actions de la grille avec la page de la fiche

Une action dadaptateur est excute en cliquant sur un bouton de la grille. Pour spcifier la page qui est affiche en rponse laction dadaptateur :



14 T u t o r i e l

E x c u t i o n d e l a p p l i c a t i o n c o m p l t e

3 Dans larborescence des objets, dveloppez le composant AdapterPageProducer et toutes ses branches afin dafficher les entres CmdNewRow, CmdEditRow et CmdDeleteRow. Ces entres apparaissent en dessous de lentre AdapterCommandColumn1.

4 Slectionnez CmdNewRow. Dans linspecteur dobjets, saisissez CountryForm dans la proprit PageName.

5 Slectionnez CmdEditRow. Dans linspecteur dobjets, saisissez CountryForm dans la proprit PageName.

Excution de lapplication compltePour vrifier que lapplication fonctionne et que tous les boutons effectuent une action, excutez lapplication. Quand vous excutez lapplication, vous dmarrez un serveur et visualisez lapplication dans un navigateur Web.

Pour excuter lapplication :

1 Choisissez Excuter|Excuter. Une fiche apparat. Les applications dbogueur dapplication Web excutables sont des serveurs COM, et la fentre qui apparat est la fentre console du serveur COM. A la premire excution du projet, elle recense lobjet COM afin que le dbogueur dapplication Web puisse y accder directement.

2 Slectionnez Outils|Dbogueur dapplication Web.

3 Dans la fentre Dbogueur dapplication Web, cliquez sur Dbut.

4 Cliquez sur le lien URL par dfaut pour afficher la page ServerInfo. La page ServerInfo affiche le nom de tous les excutables dbogueur dapplication Web recenss.

5 Slectionnez CountryTutorial dans la liste droulante et cliquez sur le bouton de dmarrage.

Votre navigateur affiche maintenant lapplication Country Tutorial. Cliquez sur le lien CountryTable pour visualiser la page CountryTable.

Pour continuer le tutoriel, fermez la fentre du navigateur, cliquez sur Arrter dans fentre Dbogueur dapplication Web et choisissez Executer|Rinitialiser le programme.

Ajout de la gestion des erreursPour le moment, votre application naffichera pas les erreurs lutilisateur. Par exemple, si un utilisateur saisit des lettres dans le champ Area dun enregistrement de pays, il ne recevra aucune notification derreur. Vous allez prsent ajouter un composant AdapterErrorList pour afficher les erreurs qui se produisent pendant lexcution des actions dadaptateur qui modifient la table country.


A j o u t d e l a g e s t i o n d e s e r r e u r s

Ajout de la gestion des erreurs la grille

Pour ajouter la gestion des erreurs la grille :

1 Dans larborescence des objets pour CountryTable, dveloppez le composant AdapterPageProducer et toutes ses branches afin dafficher AdapterForm1.


3 Slectionnez AdapterErrorList dans la liste et cliquez sur OK. Une entre AdapterErrorList1 apparat dans larborescence des objets.

4 Dplacez AdapterErrorList1 au-dessus de AdapterGrid1 (en le faisant glisser ou en utilisant la flche oriente vers le haut dans la barre doutils de la vue arborescente des objets).

5 Dans linspecteur dobjets, initialisez la proprit Adapter Adapter.

Ajout de la gestion des erreurs la fiche

Pour ajouter la gestion des erreurs la fiche :


2 Dans le gestionnaire de projet, dveloppez CountryTutorial.exe et double-cliquez sur lentre CountryFormU.

3 Dans larborescence des objets, dveloppez le composant AdapterPageProducer et toutes ses branches afin dafficher AdapterForm1.


5 Slectionnez AdapterErrorList dans la liste et cliquez sur OK. Une entre AdapterErrorList1 apparat dans larborescence des objets.

6 Dplacez AdapterErrorList1 au-dessus de AdapterFieldGroup1 (en le faisant glisser ou en utilisant la flche oriente vers le haut dans la barre doutils de la vue arborescente des objets).

7 Dans linspecteur dobjets, initialisez la proprit Adapter CountryTable.Adapter.

Test du mcanisme de gestion des erreurs

Pour observer le mcanisme de gestion des erreurs, vous devez tout dabord apporter une petite modification lEDI. Slectionnez Outils|Options du dbogueur. Dans longlet Exceptions du langage, assurez-vous que la case cocher Arrter sur exceptions Delphi est dsactive, ce qui permettra lapplication de continuer lorsque des exceptions sont dtectes.

16 T u t o r i e l

A j o u t d e l a g e s t i o n d e s e r r e u r s

Ensuite, pour tester les erreurs de grille, procdez comme suit :

1 Excutez lapplication et placez-vous sur la page CountryTable laide du dbogueur dapplication Web. Pour des dtails sur la manire de procder, voir Excution de lapplication complte la page 14.

2 Ouvrez une autre fentre de navigateur et placez-vous sur la page CountryTable.

3 Cliquez sur le bouton DeleteRow de la premire ligne de la grille.

4 Sans actualiser le deuxime navigateur, cliquez sur le bouton DeleteRow de la premire ligne de la grille.

Un message derreur, Ligne non trouve dans Country, apparat au-dessus de la grille.

Pour tester les erreurs de fiche :

1 Excutez lapplication et placez-vous sur la page CountryTable laide du dbogueur dapplication Web.

2 Choisissez le bouton EditRow. La page CountryForm saffiche.

3 Modifiez le champ Area en abc et cliquez sur le bouton Appliquer.

Un message derreur (Valeur incorrecte pour le champ Area) sera affich au-dessus du premier champ.

Vous avez maintenant termin le tutoriel de WebSnap. Il est prfrable de ractiver la case cocher Arrter sur exceptions Delphi avant de continuer. Enregistrez galement lapplication en slectionnant Fichier|Tout enregistrer afin que votre application complte soit disponible ultrieurement.

I n d e x v

Copyright 2002, Borland Software Corporation. All rights reserved. BORLAND CONFIDENTIALaot 8, 2002 10:21 pm (C:\d7\d7-W\d7books\book_CD\WebSnap Tutorial\WebSnapIX.fm)

Bbase de donnes exemple DBDEMOS 5boutons, ajout une application 12

Ccommandes, ajout une application 9composant adaptateur densemble de donnes 6composants orients donnes 5couleurs pour HTML 9cration dun module de page Web 10

DDBDEMOS, base de donnes exemple 5

SScript HTML, onglet 9scripts ct serveur 6

Ttitre, spcification pour une application 3

Index

vi T u t o r i e l

Copyright 2002, Borland Software Corporation. All rights reserved. BORLAND CONFIDENTIALaot 8, 2002 10:21 pm (C:\d7\d7-W\d7books\book_CD\WebSnap Tutorial\WebSnapIX.fm)

Tutoriel : Cration dune application WebSnapTable des matiresCration dune application WebSnapCration dune application WebSnapDmarrage de lexpert dapplication WebSnapEnregistrement des fichiers gnrs et du projetSpcification du titre de lapplication

Cration de la page CountryTableAjout dun nouveau module de page WebEnregistrement dun nouveau module de page Web

Ajout des composants de donnes au module CountryTableAjout de composants orients donnesSpcification dun champ clAjout dun composant adaptateur

Cration dune grille pour afficher les donnesAjout dune grilleAjout de commandes de modification la grille

Ajout dune fiche de modificationAjout dun nouveau module de page WebEnregistrement dun nouveau moduleMise disposition de CountryTableU pour le nouveau moduleAjout de champs de saisieAjout de boutonsLiaison des actions de la fiche avec la page de la grilleLiaison des actions de la grille avec la page de la fiche

Excution de lapplication complteAjout de la gestion des erreursAjout de la gestion des erreurs la grilleAjout de la gestion des erreurs la ficheTest du mcanisme de gestion des erreurs

IndexB-T

Documents

Web Snap