Exécution et exploration de l'exemple Auction

Une fois que vous avez démarré le serveur, vous pouvez exécuter et explorer l'application. Avec l'application de site Web Auction, vous pouvez effectuer les tâches suivantes :

Exécution de l'application

Pour exécuter l'application, procédez comme suit :

  1. Vérifiez que WebSphere Application Server est en cours d'exécution.
  2. Dans la vue Explorateur de projets, développez Projets Web dynamiques, cliquez sur le projet AuctionV60Web à l'aide du bouton droit de la souris, puis cliquez sur Exécuter > Exécuter sur le serveur.

La page d'accueil de l'exemple Auction s'ouvre dans le navigateur interne. Cette opération peut prendre un certain temps car les fichiers JSP sont compilés lors de leur première exécution. Si vous souhaitez exécuter l'exemple dans un navigateur externe, utilisez l'URL suivante : http://localhost:9080/AuctionV60Web.

Exploration du site Web Auction

Le site Web Auction fonctionne réellement. Vous pouvez y effectuer les tâches suivantes :

Recherche d'articles Auction

Vous pouvez trouver des articles dans le catalogue en les recherchant spécifiquement ou par prix maximal.

  1. Pour rechercher des articles spécifiques par mots clés, utilisez l'une des procédures suivantes :
    • Dans la page d'accueil Auction, entrez le mot clé à rechercher dans la zone Enter search words, puis cliquez sur Go.
    • Cliquez sur l'onglet Browse, puis entrez le mot clé à rechercher dans la zone Search descriptions, sélectionnez Expiration ou Value pour spécifier l'ordre dans lequel les résultats de la recherche doivent être affichés, puis cliquez sur Go.
  2. Pour rechercher tous les articles disponibles dont le prix est inférieur à un montant spécifique, cliquez sur l'onglet Browse, entrez le montant maximal dans la zone Maximum price, sélectionnez Expiration ou Value pour spécifier l'ordre dans lequel les résultats de la recherche doivent être affichés, puis cliquez sur Go. Le moteur de recherche recherche les descriptions des articles.
  3. Pour afficher tous les articles d'une catégorie, dans la page d'accueil, cliquez sur la catégorie de votre choix.

    La liste des articles affiche les articles répondant à vos critères de recherche ou qui se trouvent dans la catégorie sélectionnée, avec leur description, leur valeur, leur date d'expiration et une représentation (si elle est disponible).

  4. Cliquez sur l'article. La page Item Details s'ouvre et affiche le numéro de l'article, son nom et sa description, ainsi que les informations relatives aux enchères.

Connexion au site Web Auction

Vous pouvez rechercher des articles sur le site Web Auction sans vous connecter, mais toutes les autres tâches requièrent une connexion en tant qu'utilisateur ou administrateur.

  1. Cliquez sur l'onglet Connexion. La page Connexion s'ouvre.
  2. Effectuez l'une des procédures suivantes :
    • Pour effectuer une offre d'achat sur des articles ou ajouter des articles aux enchères, connectez-vous en tant qu'utilisateur. Entrez jack@acme.com ou jill@xyz.com dans la zone Userid, puis entrez jack comme mot de passe de Jack ou jill comme mot de passe de Jill dans la zone Password.
    • Pour effectuer des tâches d'administration, telles que la configuration des articles ou la gestion des utilisateurs, connectez-vous en tant qu'administrateur. Entrez dale@yahoo.com dans la zone Userid et dale dans la zone Password.
  3. Cliquez sur OK.

Si vous vous êtes connecté en tant qu'administrateur, deux liens apparaissent dans le coin supérieur droit de chaque page Auction : Setup et User Admin.

Offre d'achat sur des articles Auction

Vous pouvez effectuer des offres d'achat sur des articles du catalogue Auction.

Condition requise : Pour effectuer une offre d'achat sur un article aux enchères, vous devez d'abord vous connecter au site. Vous pouvez vous connecter avant de rechercher l'article ou lorsque vous commencez à enchérir. Vous devez également rechercher l'article pour lequel vous souhaitez effectuer une offre d'achat.

  1. Ouvrez la page Item Details. La page Details répertorie l'offre minimale, l'offre en cours et la date à partir de laquelle l'article ne sera plus disponible.
  2. Cliquez sur Bid.
  3. Entrez une offre dans la zone Bid. Les valeurs des offres sont gérées par l'intermédiaire des fonctions de validation JSF. Les offres doivent s'élever à au moins un dollar de plus que l'offre en cours et les centimes ne sont pas admis. Par exemple, si vous entrez 26.01, l'application tronque la valeur et ne retient que 26.
  4. Cliquez sur OK.

La page Item Details affiche votre offre dans la zone Current bid.

Vente d'article sur le site Web Auction

Vous pouvez ajouter des articles au catalogue du site Web Auction.

Condition requise : Pour vendre un article aux enchères, vous devez d'abord vous connecter au site.

  1. Cliquez sur l'onglet Sell pour ouvrir la page Sell.
  2. Entrez les informations relatives à l'article :
    1. Sélectionnez la catégorie de l'article dans la liste Category.
    2. Entrez le nom de l'article et sa description dans la zone Item name.
    3. Entrez la description de l'article dans la zone Description.
    4. Entrez l'offre valide la moins élevée dans la zone Minimum bid.
    5. Entrez la valeur de l'article dans la zone Estimated value.
    6. Sélectionnez la date à laquelle l'article sera disponible à la vente dans la zone Start bidding.
    7. Sélectionnez la date d'expiration de l'article dans la zone End bidding.
    8. Facultatif : Si vous disposez d'une représentation de l'article, entrez les URL correspondantes dans les zones Small image url et Large image url.
  3. Cliquez sur Go pour ajouter l'article au catalogue.

Gestion des comptes utilisateur

Vous pouvez ajouter, modifier et supprimer des comptes utilisateur à l'aide de la fonction User Admin.

Condition requise : Pour gérer les comptes utilisateur, vous devez d'abord vous connecter au site en tant qu'administrateur.

L'application User Admin est un client EJB Swing, déployé sur le client à l'aide de la technologie Java Web Start. La technologie Java Web Start est installée avec JRE v1.4. La première fois que l'application User Admin est exécutée, un logiciel d'exécution requis est installé sur le client. Une fois ce logiciel installé, les lancements ultérieurs exécutent directement l'application User Admin.

Démarrage de la fonction User Admin

  1. Pour exécuter la fonction User Admin pour la première fois, procédez comme suit :
    1. Cliquez sur le lien User Admin dans le coin supérieur droit d'une page Auction. La page User Admin s'ouvre.
    2. Cliquez sur Go pour démarrer la fonction User Admin.
    3. Si JRE v1.4 n'est pas installé, cliquez sur le lien JRE v1.4 de la page User Admin pour l'installer. JRE v1.4 inclut le gestionnaire d'applications Java Web Start, requis pour lancer la fonction User Admin.
    4. Cliquez sur Install dans la fenêtre Security Warning, qui s'ouvre lorsque vous installez l'environnement d'exécution du client WebSphere Application Server sur la machine locale.
    5. Cliquez sur Accept dans la fenêtre Software License Agreement pour accepter la licence. Si vous ne l'acceptez pas, la fonction User Admin ne fonctionne pas.
    6. Cliquez sur Start dans la fenêtre Security Warning ; les droits d'accès sont octroyés à l'application User Admin.
    7. Une fois que l'environnement d'exécution requis est installé, l'application User Admin s'ouvre. Vous pouvez explorer l'application User Admin.
  2. Pour exécuter la fonction User Admin ultérieurement, cliquez sur le lien User Admin dans le coin supérieur droit d'une page Auction. L'application User Admin est lancée.

Affichage des informations utilisateur

La fenêtre User Admin affiche les informations de base sur les utilisateurs et notamment, le nom de l'utilisateur, son adresse électronique et son rang.

Pour afficher des informations utilisateur supplémentaires, procédez comme suit :

  1. Dans la fenêtre User Admin, cliquez sur l'utilisateur dont vous souhaitez afficher les informations.
  2. Cliquez sur l'onglet User pour afficher son nom, son mot de passe, son adresse électronique, son numéro de carte de crédit et son type de carte de crédit.
  3. Cliquez sur l'onglet Address pour afficher l'adresse de livraison de l'utilisateur.
  4. Cliquez sur l'onglet Accounts payable pour afficher les informations de règlement.

Ajout d'utilisateurs

Pour ajouter un utilisateur, procédez comme suit :

  1. Dans la fenêtre User Admin, cliquez sur Add user. La fenêtre Add user s'ouvre.
  2. Entrez le nom de l'utilisateur dans la zone Name.
  3. Entrez son adresse dans la zone Address.
  4. Cliquez sur OK. La fenêtre Add user se ferme et le nouvel utilisateur apparaît dans la liste des utilisateurs de la fenêtre User Admin.
  5. Cliquez sur Apply pour sauvegarder le nouvel utilisateur.

Modification d'utilisateurs

Pour modifier un utilisateur, procédez comme suit :

  1. Cliquez sur l'utilisateur dans la liste.
  2. Modifiez les informations appropriées dans les pages User et Address.
  3. Cliquez sur Apply pour sauvegarder les modifications.

Suppression d'utilisateurs

Pour conserver l'intégrité des données, vous ne pouvez pas supprimer un utilisateur de la base de données. La fonction de suppression marque l'utilisateur comme étant inactif.

Pour supprimer un utilisateur, procédez comme suit :

  1. Cliquez sur l'utilisateur dans la liste.
  2. Cliquez sur Delete user.
  3. Cliquez sur Apply.

Tri des utilisateurs dans la liste

Pour n'afficher qu'un sous-ensemble d'utilisateurs, sélectionnez Name, Rank, ou Email dans la liste déroulante et entrez le texte approprié. Par exemple, si vous sélectionnez Name et que vous entrez j, seuls les utilisateurs dont le nom commence par la lettre "j" apparaissent dans la liste des utilisateurs.

Modification de la date d'expiration des articles

Par défaut, la date d'expiration de tous les articles fournis avec la base de données d'origine est le 1er mai 2007. Vous pouvez modifier ces dates.

Condition requise : Pour modifier les dates d'expiration des articles, vous devez d'abord vous connecter au site en tant qu'administrateur.

  1. Cliquez sur le lien Setup dans le coin supérieur droit d'une page Auction. La page Setup s'ouvre.
  2. Dans la zone Duration, entrez la durée pendant laquelle vous souhaitez que l'article soit répertorié aux enchères. Vous pouvez spécifier 1 à 99 jours à partir de la date actuellement affichée. Par exemple, si la date actuellement affichée est le 15/04/05 et que vous spécifiez 30 jours comme modification de la date d'expiration, les dates d'expiration de tous les articles du catalogue deviennent le 15 mai 2005.
  3. Cliquez sur Initialize Database. La date d'expiration de tous les articles change en fonction du nombre de jours spécifié.

Suppression de l'exemple Auction

Pour supprimer l'exemple Auction, procédez comme suit :

  1. Fermez l'application Web Auction dans le navigateur.
  2. Annulez le déploiement du fichier EAR de la manière suivante :
    1. A l'aide du bouton droit de la souris, cliquez sur WebSphere Application Server v6.0 dans la vue Serveurs, puis cliquez sur Ajouter et supprimer des projets. La fenêtre Ajouter et supprimer des projets s'ouvre.
    2. Sélectionnez le projet AuctionV60EAR, puis cliquez sur Supprimer pour le supprimer de la liste des projets.
    3. Cliquez sur Fin ; la fenêtre Ajouter et supprimer des projets se ferme.
  3. Supprimez les projets Auction de la manière suivante :
    1. Cliquez sur Fenêtre > Autres perspectives > Ressource pour passer à la perspective Ressource.
    2. Dans la vue Navigateur, supprimez les projets suivants :
      • Tous les projets dont les noms commencent par "AuctionV60"
      • OIDGenerator
      • OIDGeneratorClient

Réinstallation de l'exemple Auction par défaut

Condition requise : Vous devez d'abord supprimer l'exemple pour pouvoir le réinstaller.

Pour réinstaller l'exemple Auction, procédez comme suit :

  1. Cliquez sur Aide > Galerie d'exemples. La galerie des exemples s'ouvre.
  2. Développez Exemples de présentations, Application Auction, Construction, puis cliquez sur Application Web.
  3. Cliquez sur Importer pour réimporter l'exemple.
  4. Cliquez sur Instructions de configuration et suivez les instructions pour reconfigurer l'exemple.

Remarque : La base de données Auction n'est pas réinstallée et contient les mêmes données.

Si vous avez effectué une copie du plug-in de la base de données (com.ibm.etools.auction.sampledb_6.0.0/db/AUCTION60) et que vous l'avez placée dans un autre répertoire, vous pouvez la restaurer.

Pour restaurer la base de données par défaut, procédez comme suit :

  1. Arrêtez le serveur Web.
  2. Vérifiez qu'aucune autre application n'est connectée à la base de données.
  3. Remplacez la base de données modifiée par la copie de la base de données d'origine.
  4. Redémarrez Software Development Platform avec l'option -clean.

Identification et résolution des incidents de l'application Auction

Si l'application ne semble pas s'exécuter, vérifiez les points suivants :

Le serveur est actif

Pour vérifier que le serveur est actif, recherchez dans la vue Console la chaîne "Serveur server1 ouvert pour e-business".

La compilation automatique est activée

Pour vérifier que la compilation automatique est activée, cliquez sur Projet > Compiler automatiquement. Si elle n'est pas activée, cliquez sur Projet > Compiler tout pour compiler tous les fichiers du projet et le redéployer.

L'application Web est active sur le serveur d'applications

Pour vérifier que l'application Web est active sur le serveur d'applications, procédez comme suit :

  1. Dans la vue Serveur, cliquez à l'aide du bouton droit de la souris sur WebSphere Application Server v6.0, puis cliquez sur Exécuter la console administrative. La console d'administration s'ouvre.
  2. Entrez un ID utilisateur dans la zone Userid, puis cliquez sur Log in. Cet ID utilisateur permet d'identifier la personne ayant apporté les modifications. Il apparaît également dans les messages.
  3. Développez Applications et cliquez sur Applications d'entreprise.
  4. Si AuctionV60EAR n'est pas répertorié, vous devez spécifier com.ibm.etools.auction.sampledb_6.0.0/db/AUCTION60 comme source de données.
  5. Si AuctionV60EAR est répertorié, mais non démarré, cliquez sur Démarrer.

La base de données Auction est connectée

Si l'application est exécutée, mais qu'aucune catégorie n'apparaît dans la page d'accueil, corrigez les erreurs de connexion à la base de données Auction :

  1. Si un autre outil est connecté à la base de données, arrêtez-le.
  2. Pour configurer une source de données autre que le serveur WebSphere Application Server (WAS) interne, qui est préconfiguré pour être exécuté sur le serveur de test WAS 6, procédez comme suit :
    1. Passez à la perspective J2EE.
    2. Dans la vue Explorateur de projets, développez Applications d'entreprise, AuctionV60EAR, puis sélectionnez Descripteur de déploiement.
    3. Sélectionnez l'onglet Déploiement, puis sélectionnez Fournisseur JDBC Cloudscape dans la liste des fournisseurs JDBC. Le chemin d'accès à la source de données se trouve sous Propriétés des ressources ; il est défini dans la source de données sélectionnée ci-dessus dans la colonne Valeur.