SET FIELD RELATION

SET FIELD RELATION ( tabelaN | campoN ; um ; muitos )

Parâmetro	Tipo		Descrição
tabelaN | campoN	Tabela, Campo	→	Tabela de início das relações ou Campo de início da relação
um	Integer	→	Estado da relação Muitos a Um a partir do campo ou das relações Muitos a Um da tabela
muitos	Integer	→	Estado da relação Um a Muitos a partir do campo ou das relações Um a Muitos da tabela

Descrição

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

I código abaixo permite configurações úteis apenas no editor de Relatório Rápido:

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))[#/code4D]

Ver também

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

Propriedades

Número do comando	919
Thread-seguro	✓
Modificar variáveis	OK