Histórico da Página
...
Objetivo |
Ensinar como realizar a customização dos dados que serão exibidos e também armazenados no banco de dados através de uma camada intermediária, assim sendo, podendo ajustar valores dos campos ou até mesmo passar valores que não encontram-se na tabela física através dos chamados campos virtuais.
Estrutura |
O programa destinado a realizar estas customizações é dividido em 4 (quatro) procedures. São elas e seus pontos de execução:
...
Objetivo |
Tem por objetivo ser executada após todos os registros (apenas os registros da página corrente) terem sido lidos para que o usuário possa realizar customizações em registros específicos (navegar para um determinado registro, alterar informação de um registro com base no valor de outro, etc).
Parâmetros |
Parâmetro | I/O | Tipo de Dado | Conteúdo |
tableName | Input | Character | Nome da tabela em questão |
ttDataset | Input-Output | Handle | Handle da temp-table do dataset |
Exemplo |
O programa abaixo verifica o nome da tabela que está sendo lida para não realizar o processo abaixo para as tabelas de referência. Também lê todos os registros e altera a coluna “teste” com um contador que é incrementado de 9 em 9.
...
Objetivo |
Tem por objetivo ser executada após ter realizado qualquer tipo de persistência (CREATE, UPDATE e DELETE) para que possa ser realizado customizações após a realização da persistência e/ou correções na RowErrors.
Parâmetros |
Parâmetro | I/O | Tipo de Dado | Conteúdo |
pType | Input | Character | “CREATE”, “UPDATE” ou “DELETE” |
ttDataset | Input-Output | Handle | Handle da temp-table do dataset |
RowObject | Input-Output | Handle | Handle da temp-table do RowObject |
hBoHandle | Input | Handle | Handle da BO |
RowErrors | Input-Output | Table | Tabela RowErrors |
...
Objetivo |
Tem por objetivo ser executada após cada registro ter sido lido para que o usuário possa realizar customizações no registro (gerar informação de um campo virtual baseado nos valores do registro, validar a informação de uma coluna da tabela, etc)
Parâmetros |
Parâmetro | I/O | Tipo de Dado | Conteúdo |
tableName | Input | Character | Nome da tabela em questão |
ttDataset | Input-Output | Handle | Handle da temp-table do dataset |
Exemplo |
O programa abaixo verifica o nome da tabela que está sendo lida para não realizar o processo abaixo para as tabelas de referência. E também altera o valor da coluna “teste2” para o valor 15 e também adiciona na coluna “nome” o prefixo “[CUSTOM]”.
...
- before-afterPersistRecord: É executada ANTES da procedure “afterPersistRecord”.
- after-afterPersistRecord: É executada APÓS da procedure “afterPersistRecord”.
- before-beforePersistRecord: É executada ANTES da procedure “beforePersistRecord”.
- after-beforePersistRecord: É executada APÓS da procedure “beforePersistRecord”.
O Custom Handler é um programa PROGRESS que tem por objetivo disponibilizar para o usuário uma maneira para poder realizar customizações nas informações que são passadas para a o By You e também gerar os dados dos campos virtuais do Dataset.