4D v14.3

SET FIELD RELATION

Página Inicial

 
4D v14.3
SET FIELD RELATION

SET FIELD RELATION 


 

SET FIELD RELATION ( tabelaN | campoN ; um ; muitos ) 
Parâmetro Tipo   Descrição
tabelaN | campoN  Tabela, Campo in Tabela de início das relações ou Campo de início da relação
um  Inteiro longo in Estado da relação Muitos a Um a partir do campo ou das relações Muitos a Um da tabela
muitos  Inteiro longo in Estado da relação Um a Muitos a partir do campo ou das relações Um a Muitos da tabela

O comando SET FIELD RELATION permite definir separadamente o estado automático/manual de cada relação do banco para o processo atual, sem considerar seu estado inicial definido no ambiente Desenho na janela de propriedades das relações.

Passe no primeiro parâmetro, um nome de tabela ou campo:

  • Se passa um nome de campo (campoN), o comando se aplicará unicamente à relação a partir do campo Muitos especificado.
  • Se passa um nome de tabela (tabelaN), o comando se aplicará a todas as relações a partir da tabela Muitos especificada.
  • Se não houver nenhuma relação a partir do campo campoN ou da tabela tabelaN, os parâmetros um e muitos devolvem 0, se gera o erro de sintaxe No. 16 (“O campo não tem relação”) e a variável sistema OK toma o valor 0.
Passe nos parâmetros um e muitos, os valores que indicam o cambio de estado automático/manual a aplicar respectivamente a(s) relação(es) de tipo Muitos a Um e Um a Muitos. Pode utilizar as constantes do tema “Relações”:
  • Do not modify (0) = Não modificar o estado atual da(s) relação(es).
  • Structure configuration (1) = Utilizar a configuração definida para a(s) relação(es) na janela de estrutura da aplicação.
  • Manual (2) = Transformar em manuais as relações no processo atual.
  • Automatic (3) = Transformar automáticas as relações no processo atual.
Nota: as mudanças realizadas com este comando só aplicam ao processo atual. A configuração das relações definida utilizando as opções da janela de propriedades da relação não é modificada.

Note
: Se passar True ao comando SET AUTOMATIC RELATIONS durante a mesma sessão, as chamadas ao comando SET FIELD RELATION se ignoram, sem importar se estão localizadas antes ou depois de SET AUTOMATIC RELATIONS. Para "bloquear" o modo automático e ter em conta chamadas a SET FIELD RELATION, passe False a SET AUTOMATIC RELATIONS.

Exemplo  

Este comando simplifica a gestão das relações com o editor de relatórios rápidos. Nas versões anteriores de 4D, era necessário passar todas as relações para automáticas para poder utilizá-las no editor. O  código a seguir permite definir apenas as relações úteis como automáticas:

 SET AUTOMATIC RELATIONS(False;False`Inicialização das relações
  `Só serão utilizadas as seguintes relações
 SET FIELD RELATION([Faturas]ID_Cliente;Automatic;Automatic)
 SET FIELD RELATION([Linha_Fatura]ID_Fatura;Automatic;Automatic)
 QR REPORT([Faturas];Char(1);True;True;True)

 
PROPRIEDADES 

Produto: 4D
Tema: Relações
Número 919

Este comando modifica a variável sistema OK

 
HISTÓRIA 

Criado por: 4D 2004

 
VER TAMBÉM 

GET AUTOMATIC RELATIONS
GET FIELD RELATION
GET RELATION PROPERTIES
SET AUTOMATIC RELATIONS

 
PALAVRAS CHAVES 

Lien

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)