Função @CADASTRO
Revisão de 16h47min de 1 de setembro de 2026 por Endrio.korb (discussão | contribs)
A função @CADASTRO retorna o nome do cadastro (Query.Cadastro) correspondente à tela/registro atual. Diferente do nome da tabela física, o cadastro identifica a tela específica que está sendo usada — o que é útil quando várias telas compartilham a mesma tabela (por exemplo, Clientes, Fornecedores e Transportadoras usam a tabela PESSOAS, mas são cadastros diferentes: CLIENTES, FORNECEDORES, TRANSPORTADORAS).
Sintaxe
| Nome | Banco | Descrição |
|---|---|---|
| @CADASTRO | PostgreSQL | VARCHAR(40) |
| @CADASTRO | Oracle | VARCHAR2(40) |
| @CADASTRO | FireBird | VARCHAR(40) |
| @CADASTRO | SQLServer | VARCHAR |
Exemplo
Caso deseje habilitar, desabilitar ou exibir/ocultar um campo, botão, guia ou página de acordo com o cadastro em que o registro está sendo exibido, você pode usar a função na aba "condição de editabilidade" ou "condição de visibilidade" da aba comportamento do campo/botão.
Por exemplo, no cadastro de Clientes (tabela PESSOAS, compartilhada entre várias telas), para exibir um campo apenas quando o cadastro atual for o de Clientes:
@CADASTRO = 'CLIENTES'
Ou, para habilitar um botão em qualquer cadastro exceto Fornecedores:
@CADASTRO <> 'FORNECEDORES'
