Histórico da Página
customHandler.rarCopyright © 2009 TOTVS S.A. Todos os direitos reservados.
Nenhuma parte deste documento pode ser copiada, reproduzida, traduzida ou transmitida por qualquer meio eletrônico ou mecânico, na sua totalidade ou em parte, sem a prévia autorização escrita da TOTVS S.A., que reserva-se o direito de efetuar alterações sem aviso prévio. A TOTVS S.A não assume nenhuma responsabilidade pelas conseqüências de quaisquer erros ou inexatidões que possam aparecer neste documento.
TOTVS S.A.
Av. Santos Dumont, 831, Joinville, SC, CEP 89.222-900
...
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”.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas