Executando e Explorando a Amostra de Leilão

Depois de iniciar o servidor, você pode executar e explorar o aplicativo. Você pode executar as seguintes tarefas com o aplicativo de Web site de Leilão:

Executando o Aplicativo

Para executar o aplicativo:

  1. Verifique se o WebSphere Application Server está sendo executado.
  2. No Explorador de Projetos, expanda Projetos Dinâmicos da Web, clique com o botão direito do mouse no projeto AuctionV60Web e clique em Executar > Executar no Servidor.

A home page de Leilão é aberta no navegador interno. Observe que isso pode levar algum tempo porque os arquivos JSP são compilados na primeira vez em que ela é executada. Se você desejar executar a amostra em um navegador externo, utilize este URL: http://localhost:9080/AuctionV60Web.

Explorando o Web Site de Leilão

O Web site de Leilão é um Web site funcional. Você pode executar as seguintes tarefas:

Localizando Itens de Leilão

Você pode localizar itens no catálogo, procurando itens específicos ou procurando pelo preço máximo de itens.

  1. Para procurar itens específicos por palavras-chave, execute uma das etapas a seguir:
    • Na home page de Leilão, digite a palavra-chave de procura no campo Digitar Palavras de Procura e clique em Ir.
    • Clique na guia Procurar, em seguida, digite a palavra-chave de procura no campo Procurar Descrições, selecione Expiração ou Valor para especificar a ordem na qual os resultados de procura devem ser listados e clique em Ir.
  2. Para localizar todo os itens disponíveis com um valor inferior a um valor específico, clique na guia Procurar, digite o valor máximo no campo Preço Máximo, selecione Expiração ou Valor para especificar a ordem na qual os resultados de procura devem ser listados e clique em Ir. O mecanismo de procura procura descrições de itens.
  3. Para ver todos os itens em uma categoria, na Home Page, clique na categoria desejada.

    A Lista de Itens exibe os itens que atendem aos critérios de procura ou que estão listados na categoria selecionada, incluindo descrição do item, valor, data e hora de expiração e imagem (se disponível).

  4. Clique no item. A página Detalhes do Item é aberta e exibe o número, nome e descrição do item e as informações sobre lances.

Efetuando Login no Web Site de Leilão

Embora seja possível procurar itens no Web site de Leilão sem efetuar login, você deve efetuar login como um usuário ou administrador para executar outras tarefas.

  1. Clique na guia Login. A página Login é aberta.
  2. Execute uma das etapas a seguir:
    • Para oferecer lance para itens ou incluir itens no leilão, efetue login como um usuário. Digite jack@acme.com ou jill@xyz.com no campo ID do Usuário e digite jack para senha do Jack ou jill para senha do Jill no campo Senha.
    • Para executar tarefas administrativas, como configuração do item ou gerenciamento de usuários, efetue login como administrador. Digite dale@yahoo.com no campo ID do Usuário e digite dale no campo Senha.
  3. Clique em Ir.

Se você efetuou login como um administrador, então dois links aparecerão no canto superior direito de cada página de Leilão: Configuração e User Admin.

Oferecendo Lance para Itens de Leilão

Você pode oferecer lance para itens no catálogo de Leilão.

Pré-requisito: Para oferecer lance para um item de leilão, é necessário primeiro efetuar login no site. Você pode efetuar login antes de localizar o item ou quando começar a oferecer o lance. Também é necessário Localizar o Item para o qual você deseja oferecer o lance.

  1. Abra a página Detalhes do Item. A página Detalhes lista o lance mínimo, lance atual e a data em que o item não estará mais disponível.
  2. Clique em Lance.
  3. Digite um único valor de lance no campo Lance. Os valores de lance são gerenciados por meio das funções de validação do JSF. Os lances devem ser pelo menos um dólar a mais que o lance atual e ser um valor inteiro de dólar. Por exemplo, se você digitar 26.01, o aplicativo truncará o valor para 26.
  4. Clique em Ir.

A página Detalhes do Item exibe seu lance no campo Lance Atual.

Vendendo Itens no Web Site de Leilão

Você pode incluir itens no catálogo do Web site de Leilão.

Pré-requisito: Para vender um item de leilão, é necessário primeiro efetuar login no site.

  1. Clique na guia Vender para abrir a página Vender.
  2. Digite as informações para o item:
    1. Selecione a categoria para o item na lista Categoria.
    2. Digite o nome e a descrição do item no campo Nome do Item.
    3. Digite a descrição do item no campo Descrição.
    4. Digite o menor lance válido no campo Lance Mínimo.
    5. Digite o valor do item no campo Valor Estimado.
    6. Selecione a data para o item ser disponibilizado para venda no campo Iniciar Lances.
    7. Selecione a data de expiração do item no campo Encerrar Lances.
    8. Opcional: Se você tiver uma foto do item, digite os URLs nos campos URL de Imagem Pequena e URL de Imagem Grande.
  3. Clique em Ir para incluir o item na listagem do catálogo.

Gerenciando Contas do Usuário

Você pode incluir, modificar e excluir contas do usuário com a função User Admin.

Pré-requisito: Para gerenciar contas do usuário, é necessário primeiro efetuar login no site como um administrador.

O aplicativo User Admin é um cliente EJB Swing, implementado no cliente utilizando a tecnologia Java Web Start. A tecnologia Java Web Start é incluída quando você instala o JRE v1.4. Na primeira vez em que o aplicativo User Admin é executado, algum software de tempo de execução requerido é instalado no cliente. Depois que o software de tempo de execução requerido é instalado, ativações subseqüentes executam diretamente o aplicativo User Admin.

Iniciando a Função User Admin

  1. Para executar a função User Admin pela primeira vez, execute as etapas a seguir:
    1. Clique no link User Admin no canto superior direito de qualquer página de Leilão. A página User Admin é aberta.
    2. Clique em Ir para iniciar a função User Admin.
    3. Se o JRE v1.4 não estiver instalado, clique no link JRE v1.4 na página User Admin para instalá-lo. O JRE v1.4 inclui o gerenciador de aplicativos do Java Web Start, que é requerido para ativar a função User Admin.
    4. Clique em Instalar na janela Aviso de Segurança, que é aberta ao instalar o tempo de execução do Cliente do WebSphere Application Server na máquina local.
    5. Clique em Aceitar na janela Acordo de Licença de Software para aceitar a licença. A função User Admin não funcionará se você recusar.
    6. Clique em Iniciar na janela Aviso de Segurança, que concede privilégios de acesso para o aplicativo User Admin.
    7. Após a instalação do tempo de execução requerido, o aplicativo User Admin é aberto. Você pode explorar o aplicativo User Admin.
  2. Para executar a função User Admin em Admin posteriormente, clique no link User Admin no canto superior direito de qualquer página de Leilão. O aplicativo User Admin é ativado.

Visualizando Informações do Usuário

A janela User Admin exibe informações básicas do usuário na lista de usuários, incluindo o nome do usuário, o endereço de e-mail e posição.

Para visualizar informações adicionais do usuário, siga estas etapas:

  1. Na janela User Admin, clique no usuário para o qual você deseja visualizar informações.
  2. Clique na guia Usuário para visualizar o nome, a senha, o endereço de e-mail, o número do cartão de crédito e o tipo de cartão de crédito do usuário.
  3. Clique na guia Endereço para visualizar o endereço de remessa do usuário.
  4. Clique na guia Contas a Pagar para visualizar informações da conta.

Incluindo Usuários

Para incluir um usuário:

  1. Na janela User Admin, clique em Incluir Usuário. A janela Incluir Usuário é aberta.
  2. Digite o nome do usuário no campo Nome.
  3. Digite o endereço no campo Endereço.
  4. Clique em OK. A janela Incluir Usuário é fechada e o novo usuário aparece na lista de usuários na janela User Admin.
  5. Clique em Aplicar para salvar o novo usuário.

Modificando Usuários

Para modificar um usuário:

  1. Clique no usuário na lista.
  2. Modifique as informações apropriadas nas páginas Usuário e Endereço.
  3. Clique em Aplicar para salvar as alterações.

Excluindo Usuários

Para manter a integridade dos dados, não é possível remover um usuário do banco de dados. A função de exclusão marca o usuário como inativo.

Para excluir um usuário:

  1. Clique no usuário na lista.
  2. Clique em Excluir Usuário.
  3. Clique em Aplicar.

Classificando Usuários na Lista

Para exibir apenas um subconjunto de usuários, selecione Nome, Posição ou e-mail na lista drop-down e digite o texto apropriado. Por exemplo, se você selecionar Nome e digitar j, apenas os usuários cujos nomes iniciam com a letra "j" aparecerão na lista de usuários.

Alterando Datas de Expiração de Itens

Por padrão, a data de expiração para todos os itens fornecidos no banco de dados original é definida para 1 de maio de 2007. Você pode reconfigurar essas datas.

Pré-requisito: Para alterar datas de expiração de itens, é necessário primeiro efetuar login no site como um administrador.

  1. Clique no link Configuração no canto superior direito em qualquer página de Leilão. A página Configuração é aberta.
  2. No campo Duração, digite durante quanto tempo você deseja que o item seja listado no leilão antes de expirar. É possível especificar de 1 a 99 dias a partir da data atualmente exibida. Por exemplo, se a data atualmente exibida for 15/04/05 e você especificar 30 dias para a alteração da data de expiração, as datas de expiração para todos os itens no catálogo serão alteradas para 15 de maior de 2005.
  3. Clique em Inicializar o Banco de Dados. A expiração de todos os itens é alterada com base no número de dias especificados.

Removendo a Amostra de Leilão

Para remover a amostra de Leilão:

  1. Feche o aplicativo da Web de Leilão no navegador.
  2. Remova a implementação do arquivo EAR com as seguintes etapas:
    1. Clique com o botão direito do mouse em WebSphere Application Server v6.0 na visualização Servidores e clique em Incluir e Remover Projetos. A janela Incluir e Remover Projetos é aberta.
    2. Selecione o projeto AuctionV60EAR e clique em Remover para removê-lo da lista de projetos.
    3. Clique em Concluir e a janela Incluir e Remover Projetos é fechada.
  3. Exclua os projetos de Leilão com as etapas a seguir:
    1. Clique em Janela > Outras Perspectivas > Recurso para comutar para a perspectiva Recurso.
    2. Na visualização Navigator, exclua os projetos a seguir:
      • Todos os projetos com nomes que iniciam com "AuctionV60"
      • OIDGenerator
      • OIDGeneratorClient

Reinstalando a Amostra de Leilão Padrão

Pré-requisito: Você deve primeiro remover a amostra antes de poder reinstalá-la.

Para reinstalar a amostra de Leilão, siga estas etapas:

  1. Clique em Ajuda > Samples Gallery. A Samples Gallery é aberta.
  2. Expanda Amostras de Demonstração, expanda Aplicativo de Leilão, expanda Construção e, em seguida, clique em Aplicativo da Web.
  3. Clique em Importar para importar a amostra novamente.
  4. Clique em Instruções de Configuração e siga as instruções para configurar a amostra novamente.

Nota: O banco de dados do leilão não é reinstalado e terá os mesmos dados.

Se você fez uma cópia do plugin de banco de dados, com.ibm.etools.auction.sampledb_6.0.0/db/AUCTION60, e o colocou em outro diretório, pode restaurá-lo.

Para restaurar o banco de dados padrão, siga estas etapas:

  1. Pare o servidor da Web.
  2. Verifique se nenhum outro aplicativo está conectado ao banco de dados.
  3. Substitua o banco de dados alterado pela cópia do banco de dados original.
  4. Reinicie a Software Development Platform com a opção -clean.

Resolvendo Problemas do Aplicativo de Leilão

Se parecer que o aplicativo não está sendo executado, verifique os seguintes itens:

O Servidor Está em Execução

Para verificar se o servidor está em execução, procure na visualização Console pela cadeia "Servidor server1 aberto para e-business".

A Construção Automática Está Ativada

Para verificar se a construção automática está ativada, clique em Projeto > Construir Automaticamente. Se não estiver ativada, clique em Projeto > Construir Tudo para construir todos os arquivos de projeto e reimplementar.

O Aplicativo da Web Está em Execução no Servidor de Aplicativos

Para verificar se o aplicativo da Web está em execução no servidor de aplicativos:

  1. Na visualização Servidor, clique com o botão direito do mouse em WebSphere Application Server v6.0 e clique em Executar Console Administrativo. O console administrativo é aberto.
  2. Digite um ID de usuário no campo ID do Usuário e, em seguida, clique em Efetuar Login. Esse ID do usuário é utilizado para identificar quem fez as alterações. Ele também aparece em mensagens.
  3. Expanda Aplicativos e clique em Aplicativos Corporativos.
  4. Se AuctionV60EAR não estiver listado, você deve especificar com.ibm.etools.auction.sampledb_6.0.0/db/AUCTION60 como a origem de dados.
  5. Se AuctionV60EAR estiver listado, mas não iniciado, clique em Iniciar.

Banco de Dados do Leilão Conectado

Se o aplicativo estiver sendo executado, mas nenhuma categoria aparecer na home page, corrija os problemas com a conexão para o banco de dados de Leilão:

  1. Se uma outra ferramenta estiver conectada ao banco de dados, pare a outra ferramenta.
  2. Para configurar uma origem de dados diferente do WAS (WebSphere Application Server), pré-configurado para ser executado no servidor de teste do WAS 6:
    1. Comute para a perspectiva J2EE.
    2. No Explorador de Projetos, expanda Aplicativos Corporativos, expanda AuctionV60EAR e selecione Descritor de Implementação.
    3. Selecione a guia Implementação e, em seguida, selecione Fornecedor de JDBC Cloudscape na lista de fornecedores de JDBC. O caminho da origem de dados está sob as Propriedades de Recurso definidas na origem de dados selecionada acima na coluna Valor.

Utilizando a Amostra Leilão como Usuário Não-Root no Linux

Se você instalar o produto como root e executar como um usuário não-root, deverá alterar as permissões para a pasta de banco de dados do Leilão. O banco de dados está em sdpinstall/rwd/eclipse/plugins/com.ibm.etools.auction.sampledb/db. Para definir as permissões, execute chmod 777 AUCTION60.