Mudanças entre as edições de "Função @CADASTRO"

(Criou página com 'A função @SETDATA permite informar uma data fixa para o comando SQL, no formato DD/MM/YYYY, que será convertida automaticamente para a sintaxe de data nativa de cada banco...')
 
 
Linha 1: Linha 1:
−
A função @SETDATA permite informar uma data fixa para o comando SQL, no formato DD/MM/YYYY, que será convertida automaticamente para a sintaxe de data nativa de cada banco de dados utilizado.
+
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'''===
 
==='''Sintaxe'''===
−
 
−
@SETDATA('DD/MM/YYYY')
 
  
 
{| class="wikitable" style="width: 100%"
 
{| class="wikitable" style="width: 100%"
Linha 10: Linha 8:
 
!Descrição
 
!Descrição
 
|-
 
|-
−
|@SETDATA
+
|@CADASTRO
 
|PostgreSQL
 
|PostgreSQL
−
|Convertido para TO_DATE('DD/MM/YYYY', 'DD/MM/YYYY')
+
|VARCHAR(40)
 
|-
 
|-
 
|-
 
|-
−
|@SETDATA
+
|@CADASTRO
 
|Oracle
 
|Oracle
−
|Convertido para TO_DATE('DD/MM/YYYY', 'DD/MM/YYYY')
+
|VARCHAR2(40)
 
|-
 
|-
−
|@SETDATA
+
|@CADASTRO
 
|FireBird
 
|FireBird
−
|Convertido para CAST('YYYY-MM-DD' AS DATE)
+
|VARCHAR(40)
 
|-
 
|-
−
|@SETDATA
+
|@CADASTRO
 
|SQLServer
 
|SQLServer
−
|Convertido para CONVERT(DATE, 'DD/MM/YYYY', 103)
+
|VARCHAR
 
|-
 
|-
 
|}
 
|}
  
 
==='''Exemplo'''===
 
==='''Exemplo'''===
−
Diferente de @MODOEDICAO, @MODOINSERCAO e @CADASTRO (usados nas condições de editabilidade/visibilidade de campos e botões), @SETDATA é usado diretamente dentro do texto de um comando SQL — em cadastros, consultas e relatórios — sempre que for necessário comparar uma data fixa sem se preocupar com a sintaxe de data de cada banco.
+
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'
  
−
Por exemplo, para filtrar pedidos emitidos a partir de 01/01/2026:
+
Ou, para habilitar um botão em qualquer cadastro exceto Fornecedores:
  
−
  SELECT * FROM PEDIDOS WHERE DATAEMISSAO >= @SETDATA('01/01/2026')
+
  @CADASTRO <> 'FORNECEDORES'

Edição atual tal como às 16h47min de 1 de setembro de 2026

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'
Disponível em "http://wiki.phsys.com.br/index.php?title=Função_@CADASTRO&oldid=7220"