Lição 1.6: Criar uma Página de Atualização

1. Abra o arquivo update_record.jsp dando um clique duplo nele na visualização Explorador de Projetos (Project Explorer).
2. Exclua o texto padrão Conteúdo padrão para área principal (Default content for bodyarea).
3. Na visualização Paleta, clique na gaveta Dados (Data) para expandi-la.
4. Arraste o componente Registro Relacional (Relational Record) da Paleta para a área de conteúdo em branco. A janela Add Relational Record (Incluir Registro Relacional) é aberta.
5. No campo Nome (Name), digite update_record.
6. Em Criar controles para (Create controls for), clique em Atualizando um registro existente (Updating an existing record).
7. Certifique-se de que a opção Incluir controles de entrada/saída para exibir o Registro Relacional na página da Web (Add input/output controls to display the Relational Record on the web page) esteja selecionada.
8. Clique em Avançar (Next).
9. Na caixa Tabela (Table), expanda W5SAMPLE e selecione ADS.
10. Clique em Avançar (Next).A página Incluir Registro Relacional (Add Relational Record) é aberta.

Um registro relacional pode mostrar somente um registro do banco de dados. Portanto, é preciso filtrar a tabela do banco de dados para que somente um registro apareça para que o usuário o edite. (Não foi necessário filtrar o banco de dados no exercício anterior porque você criou um novo registro e, portanto, não havia resultados do banco de dados para serem filtrados.) Como cada registro no banco de dados tem um número de ID exclusivo, você filtrará os resultados para aquele com um número de ID específico.

1. A página Incluir Registro Relacional (Add Relational Record) possui uma lista de links de tarefas. Em Tarefas (Tasks), clique em Filtrar Resultados (Filter Results). A janela Filtros é aberta e insere a condição de filtro padrão ID = #{param.ID} na coluna Filter (Filtro). A janela Filtros (Filters) é semelhante a esta:
   
   Esse código filtra os registros no banco de dados para que somente o registro com o número do ID especificado apareça no registro relacional. Você aprenderá mais sobre esta condição na seção de ação Incluir uma Linha neste exercício. Clique em Fechar (Close).
2. Clique em Avançar (Next). A página Configurar Controles de Dados (Configure Data Controls) é aberta.
3. Na seção Campos a serem exibidos (Fields to display), limpe a caixa de opções próxima a todos os nomes de campos exceto os que desejar exibir em seu formulário de entrada:
   • ID
   • TÍTULO (TITLE)
   • DESCRIÇÃO (DESCRIPTION)
   • CATEGORIA PRINCIPAL (MAINCATEGORY)
   • PREÇO (PRICE)
   • FONE (PHONE)
4. Clicando em Para Cima (Up) ou Para Baixo (Down), reordene os nomes dos campos de cima para baixo, da seguinte maneira:
   • ID
   • TÍTULO (TITLE)
   • DESCRIÇÃO (DESCRIPTION)
   • CATEGORIA PRINCIPAL (MAINCATEGORY)
   • PREÇO (PRICE)
   • FONE (PHONE)
5. Para o campo de ID, selecione Campo de saída (Output field) na lista drop-down na coluna Tipo de Controle (Control Type). Embora você queira que os usuários possam visualizar o número de ID de um registro, você não deseja que eles possam atualizá-lo. Tornar o campo de ID um campo de Saída ajudará a evitar o problema de IDs duplicados.
6. Clique em Opções (Options). A janela Options (Opções) é aberta. Certifique-se de que a opção Botão Submeter (Submit button) esteja selecionada. Digite Update no campo Etiqueta (Label). Clique em OK. A janela Incluir Registro Relacional (Add Relational Record) deve ser semelhante a esta:
   
7. Clique em Concluir (Finish) para gerar seu formulário de atualização na página, conforme mostrado a seguir:
   

Novamente, incluiremos código para encaminhar o usuário à página all_records.jsp para exibir o registro alterado com todos os outros registros.

1. Clique com o botão direito do mouse no botão Atualizar (Update) que você acabou de criar na página da Web e selecione Propriedades (Properties).
2. Clique em Incluir Regra (Add Rule). A janela Incluir Regra de Navegação (Add Navigation Rule) é aberta.
3. No menu drop-down Página (Page), selecione all_records.jsp. Na caixa Esta Regra É Utilizada por (This rule is used by), clique em Essa Ação Apenas (This action only). Certifique-se de que o campo contenha: #{pc_Update_record.doUpdate_recordUpdateAction}. Clique em OK.
4. Repita as etapas 1-3 para editar o código da mesma maneira para o botão Excluir (Delete) na página da Web. Certifique-se de que o campo Esta Regra É Utilizada por (This rule is used by) contenha: #{pc_Update_record.doUpdate_recordDeleteAction}
5. Salve a página. Se você quiser tentar incluir um registro no banco de dados para verificar se você retornará para a página all_records.jsp, execute new_record.jsp no servidor de teste.

Agora você incluirá uma ação de linha à tabela em all_records.jsp para que o usuário possa selecionar um registro do banco de dados para atualizar. #{param.ID} representa o número do ID do registro que a página de atualização irá atualizar. Quando o usuário clica em uma linha, o número de ID de registro será enviado à página update_record.jsp como o parâmetro #{param.ID}. Em seguida, o registro relacional filtrado que você acabou de inserir na página update_record.jsp exibirá somente esse registro para atualização.

1. Na visualização Explorador de Projetos (Project Explorer), dê um clique duplo no arquivo all_records.jsp para abri-lo no Editor.Clique em qualquer lugar dentro da tabela de dados.Abra a visualização Propriedades (Properties).
2. Na visualização Propriedades (Properties), clique na guia Ações de Linha (Row Actions) em hx:dataTableEx na lista de tags HTML.
3. Clique em Incluir uma ação executada quando uma linha é clicada (Add an action that's performed when a row is clicked). O diálogo Configurar uma Ação de Linha (Configure a RowAction) é aberto. Selecione Clicar na linha envia um pedido ao servidor com informações da linha enviadas como parâmetros (Clicking the row sends a request to the server with row information sent as parameters) em seguida clique em OK. Uma coluna é incluída na tabela de dados.
4. Na visualização Propriedades (Properties), clique na guia hx:requestRowAction.
5. Clique em Incluir Regra (Add Rule). O diálogo Incluir Regra de Navegação (Add Navigation Rule) é aberto.
6. No drop-down Página, selecione update_record.jsp. Na caixa Esta regra é utilizada por (This rule is used by), clique em Esta ação apenas (This action only). O campo Esta Ação Apenas é automaticamente ocupado por #{pc_All_records.doRowAction1Action}, que foi criado ao incluir a ação da linha. Clique em OK. Se o campo não for automaticamente ocupado pelo método acima, digite o método no campo e inclua o seguinte em Recursos ClassifiedsTutorial/Java: src/pagecode/All_records.java:

   	public String doRowAction1Action() {
   				return "";}

7. Na visualização Propriedades (Properties), clique na guia Parâmetro (Parameter) em hx:requestRowAction. Clique em Incluir Parâmetro (Add Parameter) e, em seguida, digite o ID no campo Nome (Name). Você precisa ligar o parâmetro de ID à coluna ID. Ligar a ação de linha à coluna ID da lista de dados significa que quando a linha é clicada, o parâmetro de pedido será o ID do registro na lista.
   1. Clique em Valor (Value), em seguida, clique no botão Selecionar Objeto de Dados da Página (Select Page Data Object) .
   2. Na guia Objeto de Dados (Data Object), expanda all_recordlist (Objeto de Dados do Serviço) (Service Data Object) > all_recordlist (ADS) e selecione ID (java.lang.Integer).
   3. Clique em OK.

Você concluiu a Lição 1.6. Nela, você aprendeu como criar páginas da Web que atualizam registros de um banco de dados.